SoTransformSeparator(3iv)

1SoTransformSeparator(3IV)()                        SoTransformSeparator(3IV)()
2
3
4

NAME

6       SoTransformSeparator  —  group node that saves and restores transforma‐
7       tion state
8

INHERITS FROM

10       SoBase > SoFieldContainer > SoNode > SoGroup > SoTransformSeparator
11

SYNOPSIS

13       #include <Inventor/nodes/SoTransformSeparator.h>
14
15          Methods from class SoTransformSeparator:
16
17                         SoTransformSeparator()
18                         SoTransformSeparator(int nChildren)
19     static SoType       getClassTypeId()
20
21          Methods from class SoGroup:
22
23     void                addChild(SoNode *child)
24     void                insertChild(SoNode *child, int newChildIndex)
25     SoNode *            getChild(int index) const
26     int                 findChild(const SoNode *child) const
27     int                 getNumChildren() const
28     void                removeChild(int index)
29     void                removeChild(SoNode *child)
30     void                removeAllChildren()
31     void                replaceChild(int index, SoNode *newChild)
32     void                replaceChild(SoNode *oldChild, SoNode *newChild)
33
34          Methods from class SoNode:
35
36     void                setOverride(SbBool state)
37     SbBool              isOverride() const
38     SoNode *            copy(SbBool copyConnections = FALSE) const
39     virtual SbBool      affectsState() const
40     static SoNode *     getByName(const SbName &name)
41     static int          getByName(const SbName &name, SoNodeList &list)
42
43          Methods from class SoFieldContainer:
44
45     void                setToDefaults()
46     SbBool              hasDefaultValues() const
47     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
48     void                copyFieldValues(const  SoFieldContainer  *fc,  SbBool
49                              copyConnections = FALSE)
50     SbBool              set(const char *fieldDataString)
51     void                get(SbString &fieldDataString)
52     virtual int         getFields(SoFieldList &resultList) const
53     virtual SoField *   getField(const SbName &fieldName) const
54     SbBool              getFieldName(const SoField *field, SbName &fieldName)
55                              const
56     SbBool              isNotifyEnabled() const
57     SbBool              enableNotify(SbBool flag)
58
59          Methods from class SoBase:
60
61     void                ref()
62     void                unref() const
63     void                unrefNoDelete() const
64     void                touch()
65     virtual SoType      getTypeId() const
66     SbBool              isOfType(SoType type) const
67     virtual void        setName(const SbName &name)
68     virtual SbName      getName() const
69
70

DESCRIPTION

72       This group node is similar to the SoSeparator node  in  that  it  saves
73       state  before  traversing its children and restores it afterwards. How‐
74       ever, it saves only the current transformation; all other state is left
75       as  is.   This  node  can be useful for positioning a camera, since the
76       transformations to the camera will not affect the rest  of  the  scene,
77       even  through  the camera will view the scene. Similarly, this node can
78       be used to isolate transformations to light sources or other objects.
79

METHODS

81                         SoTransformSeparator()
82          Creates a transform separator node with default settings.
83
84                         SoTransformSeparator(int nChildren)
85          Constructor that takes approximate number of children.
86
87     static SoType       getClassTypeId()
88          Returns type identifier for this class.
89
90

ACTION BEHAVIOR

92       SoGLRenderAction,  SoCallbackAction,  SoGetBoundingBoxAction,  SoGetMa‐
93       trixAction, SoRayPickAction
94          Saves  the current transformation state, traverses all children, and
95          restores the previous transformation state.
96
97

FILE FORMAT/DEFAULTS

99       TransformSeparator {
100       }
101