SoResetTransform(3iv)

1SoResetTransform(3IV)()                                SoResetTransform(3IV)()
2
3
4

NAME

6       SoResetTransform — node that resets the current transformation to iden‐
7       tity
8

INHERITS FROM

10       SoBase > SoFieldContainer > SoNode > SoTransformation  >  SoResetTrans‐
11       form
12

SYNOPSIS

14       #include <Inventor/nodes/SoResetTransform.h>
15
16     enum ResetType {
17          SoResetTransform::TRANSFORM  Reset  the  current  transformation  to
18                                            identity
19          SoResetTransform::BBOX       Reset the bounding box to empty
20     }
21
22          Fields from class SoResetTransform:
23
24     SoSFBitMask         whatToReset
25
26          Methods from class SoResetTransform:
27
28                         SoResetTransform()
29     static SoType       getClassTypeId()
30
31          Methods from class SoNode:
32
33     void                setOverride(SbBool state)
34     SbBool              isOverride() const
35     SoNode *            copy(SbBool copyConnections = FALSE) const
36     virtual SbBool      affectsState() const
37     static SoNode *     getByName(const SbName &name)
38     static int          getByName(const SbName &name, SoNodeList &list)
39
40          Methods from class SoFieldContainer:
41
42     void                setToDefaults()
43     SbBool              hasDefaultValues() const
44     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
45     void                copyFieldValues(const  SoFieldContainer  *fc,  SbBool
46                              copyConnections = FALSE)
47     SbBool              set(const char *fieldDataString)
48     void                get(SbString &fieldDataString)
49     virtual int         getFields(SoFieldList &resultList) const
50     virtual SoField *   getField(const SbName &fieldName) const
51     SbBool              getFieldName(const SoField *field, SbName &fieldName)
52                              const
53     SbBool              isNotifyEnabled() const
54     SbBool              enableNotify(SbBool flag)
55
56          Methods from class SoBase:
57
58     void                ref()
59     void                unref() const
60     void                unrefNoDelete() const
61     void                touch()
62     virtual SoType      getTypeId() const
63     SbBool              isOfType(SoType type) const
64     virtual void        setName(const SbName &name)
65     virtual SbName      getName() const
66
67

DESCRIPTION

69       This node resets the current transformation to identity. It can be used
70       to  apply  an  absolute  world space transformation afterwards, such as
71       translating to a specific point from within a  hierarchy.  An  SoReset‐
72       Transform node should probably be used under an SoSeparator or SoTrans‐
73       formSeparator so it won't change transformations for the  rest  of  the
74       scene  graph.  An  SoResetTransform  node can also be used to reset the
75       current bounding box to empty during traversal of an  SoGetBoundingBox‐
76       Action, if the whatToReset field has the BBOX bit set.
77

FIELDS

79     SoSFBitMask         whatToReset
80          Specifies which items to reset when the node is traversed.
81
82

METHODS

84                         SoResetTransform()
85          Creates a reset transformation node with default settings.
86
87     static SoType       getClassTypeId()
88          Returns type identifier for this class.
89
90

ACTION BEHAVIOR

92       SoGLRenderAction, SoCallbackAction, SoRayPickAction
93          If specified, resets current transformation matrix to identity.
94
95     SoGetBoundingBoxAction
96          If  specified,  resets current transformation matrix to identity and
97          current computed bounding box to be empty.
98
99     SoGetMatrixAction
100          Returns identity matrix.
101
102

FILE FORMAT/DEFAULTS

104       ResetTransform {
105          whatToReset  TRANSFORM
106     }
107