GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SOGETMATRIXACTION (3)

NAME

SoGetMatrixAction — computes transformation matrix for subgraph

CONTENTS

Inherits From
Synopsis
Description
Methods
See Also

INHERITS FROM

SoAction > SoGetMatrixAction

SYNOPSIS

#include <Inventor/actions/SoGetMatrixAction.h>

Methods from class SoGetMatrixAction:

       
                          
                           SoGetMatrixAction(const SbViewportRegion &newRegion)    
void    
                          
void                       setViewportRegion(const SbViewportRegion &newRegion)    
const SbViewportRegion &    
                          
const SbViewportRegion &   getViewportRegion() const    
SbMatrix &    
                          
SbMatrix &                 getMatrix()    
SbMatrix &    
                          
SbMatrix &                 getInverse()    
SbMatrix &    
                          
SbMatrix &                 getTextureMatrix()    
SbMatrix &    
                          
SbMatrix &                 getTextureInverse()

Methods from class SoAction:

    virtual void    
                    
virtual void         apply(SoNode *node)    
virtual void    
                    
virtual void         apply(SoPath *path)    
virtual void    
                    
virtual void         apply(const SoPathList &pathList, SbBool obeysRules = FALSE)    
static SoType    
                    
static SoType        getClassTypeId()    
virtual SoType    
                    
virtual SoType       getTypeId()    
virtual SbBool    
                    
virtual SbBool       isOfType(SoType type)    
virtual void    
                    
virtual void         invalidateState()

DESCRIPTION

This action computes transformation matrices for a given subgraph. It computes the cumulative transformation matrix and its inverse, along with a cumulative texture transformation matrix and its inverse.

This action is unlike most others in that it does not traverse downwards from groups. When applied to a node, it computes the matrix for just that node. (This makes sense for transformation nodes, but not for others, really.) It is much more useful when applied to a path. When applied to a path, it gathers the transformation info for all nodes in the path and those that affect nodes in the path, but it stops when it hits the last node in the path; it does not traverse downwards from it as other actions (such as rendering) do. This behavior makes the most sense for this action.

METHODS

       
                          
                           SoGetMatrixAction(const SbViewportRegion &newRegion)
Constructor takes viewport region to use for picking. Even though the matrix computation may not involve a window per se, some nodes need this information to determine their placement.

    void    
                          
void                       setViewportRegion(const SbViewportRegion &newRegion)    
const SbViewportRegion &    
                          
const SbViewportRegion &   getViewportRegion() const
Sets/returns current viewport region to use for action.

    SbMatrix &    
                          
SbMatrix &                 getMatrix()    
SbMatrix &    
                          
SbMatrix &                 getInverse()
Returns cumulative transformation matrix and its inverse. Warning: the matrices returned by these routines should not be changed (unless you are implementing your own transformation nodes).

    SbMatrix &    
                          
SbMatrix &                 getTextureMatrix()    
SbMatrix &    
                          
SbMatrix &                 getTextureInverse()
Returns cumulative texture transformation matrix and its inverse. Warning: the matrices returned by these routines should not be changed (unless you are implementing your own transformation nodes).

SEE ALSO

SoGetBoundingBoxAction

Search for    or go to Top of page |  Section 3 |  Main Index


SOGETMATRIXACTION(3IV) (-->)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.