man SoGetMatrixAction () - computes transformation matrix for subgraph

NAME

SoGetMatrixAction - computes transformation matrix for subgraph

INHERITS FROM

SoAction > SoGetMatrixAction

SYNOPSIS

#include <Inventor/actions/SoGetMatrixAction.h> Methods from class SoGetMatrixAction: c } c } SoGetMatrixAction(const SbViewportRegion &newRegion)

c } c } setViewportRegion(const SbViewportRegion &newRegion)

c } c } getViewportRegion() const

c } c } getMatrix()

c } c } getInverse()

c } c } getTextureMatrix()

c } c } getTextureInverse() Methods from class SoAction: c } c } apply(SoNode *node)

c } c } apply(SoPath *path)

c } c } apply(const SoPathList &pathList, SbBool obeysRules = FALSE)

c } c } getClassTypeId()

c } c } getTypeId()

c } c } isOfType(SoType type)

c } c } 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

c } c } 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. c } c } setViewportRegion(const SbViewportRegion &newRegion)

c } c } getViewportRegion() const

Sets/returns current viewport region to use for action. c } c } getMatrix()

c } c } 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). c } c } getTextureMatrix()

c } c } 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