NAME

       SoGetMatrixAction — computes transformation matrix for subgraph

INHERITS FROM

       SoAction > SoGetMatrixAction

SYNOPSIS

       #include <Inventor/actions/SoGetMatrixAction.h>

          Methods from class SoGetMatrixAction:

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

          Methods from class SoAction:

     virtual void        apply(SoNode *node)
     virtual void        apply(SoPath *path)
     virtual void        apply(const SoPathList &pathList, SbBool obeysRules = FALSE)
     static SoType       getClassTypeId()
     virtual SoType      getTypeId()
     virtual SbBool      isOfType(SoType type)
     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                      setViewportRegion(const SbViewportRegion &newRegion)
     const SbViewportRegion &  getViewportRegion() const
          Sets/returns current viewport region to use for action.

     SbMatrix &                getMatrix()
     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 &                getTextureMatrix()
     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

                                                                                        SoGetMatrixAction(3IV)()