1SoGetMatrixAction(3IV)()                              SoGetMatrixAction(3IV)()
2
3
4

NAME

6       SoGetMatrixAction — computes transformation matrix for subgraph
7

INHERITS FROM

9       SoAction > SoGetMatrixAction
10

SYNOPSIS

12       #include <Inventor/actions/SoGetMatrixAction.h>
13
14          Methods from class SoGetMatrixAction:
15
16                               SoGetMatrixAction(const        SbViewportRegion
17                                    &newRegion)
18     void                      setViewportRegion(const        SbViewportRegion
19                                    &newRegion)
20     const SbViewportRegion &  getViewportRegion() const
21     SbMatrix &                getMatrix()
22     SbMatrix &                getInverse()
23     SbMatrix &                getTextureMatrix()
24     SbMatrix &                getTextureInverse()
25
26          Methods from class SoAction:
27
28     virtual void        apply(SoNode *node)
29     virtual void        apply(SoPath *path)
30     virtual void        apply(const SoPathList &pathList, SbBool obeysRules =
31                              FALSE)
32     static SoType       getClassTypeId()
33     virtual SoType      getTypeId()
34     virtual SbBool      isOfType(SoType type)
35     virtual void        invalidateState()
36
37

DESCRIPTION

39       This action computes transformation matrices for a given  subgraph.  It
40       computes  the  cumulative  transformation matrix and its inverse, along
41       with a cumulative texture transformation matrix and its inverse.
42
43       This action is unlike most others in that it does  not  traverse  down‐
44       wards  from  groups. When applied to a node, it computes the matrix for
45       just that node. (This makes sense for transformation nodes, but not for
46       others,  really.)  It  is much more useful when applied to a path. When
47       applied to a path, it gathers the transformation info for all nodes  in
48       the  path and those that affect nodes in the path, but it stops when it
49       hits the last node in the path; it does not traverse downwards from  it
50       as  other  actions (such as rendering) do. This behavior makes the most
51       sense for this action.
52

METHODS

54                               SoGetMatrixAction(const        SbViewportRegion
55                                    &newRegion)
56          Constructor  takes  viewport  region to use for picking. Even though
57          the matrix computation may not involve a window per se,  some  nodes
58          need this information to determine their placement.
59
60     void                      setViewportRegion(const        SbViewportRegion
61                                    &newRegion)
62     const SbViewportRegion &  getViewportRegion() const
63          Sets/returns current viewport region to use for action.
64
65     SbMatrix &                getMatrix()
66     SbMatrix &                getInverse()
67          Returns cumulative transformation matrix and its  inverse.  Warning:
68          the  matrices  returned  by  these  routines  should  not be changed
69          (unless you are implementing your own transformation nodes).
70
71     SbMatrix &                getTextureMatrix()
72     SbMatrix &                getTextureInverse()
73          Returns cumulative texture transformation matrix  and  its  inverse.
74          Warning:  the  matrices  returned  by  these  routines should not be
75          changed (unless you are implementing your own transformation nodes).
76
77

SEE ALSO

79       SoGetBoundingBoxAction
80
81
82
83
84                                                      SoGetMatrixAction(3IV)()
Impressum