1SoTransformerManip(3IV)()                            SoTransformerManip(3IV)()
2
3
4

NAME

6       SoTransformerManip  —  transform  node  with  3D interface for changing
7       scaling, rotation, and translation
8

INHERITS FROM

10       SoBase > SoFieldContainer > SoNode > SoTransformation >  SoTransform  >
11       SoTransformManip > SoTransformerManip
12

SYNOPSIS

14       #include <Inventor/manips/SoTransformerManip.h>
15
16          Fields from class SoTransform:
17
18     SoSFVec3f           translation
19     SoSFRotation        rotation
20     SoSFVec3f           scaleFactor
21     SoSFRotation        scaleOrientation
22     SoSFVec3f           center
23
24          Methods from class SoTransformerManip:
25
26                         SoTransformerManip()
27     static SoType       getClassTypeId()
28     void                setLocateHighlighting(SbBool onOff )
29     SbBool              isLocateHighlighting()
30     void                unsquishKnobs()
31
32          Methods from class SoTransformManip:
33
34     SoDragger *         getDragger()
35     SbBool              replaceNode(SoPath *p )
36     SbBool              replaceManip(SoPath *p, SoTransform *newOne ) const
37
38          Methods from class SoTransform:
39
40     void                pointAt(const   SbVec3f   &fromPoint,  const  SbVec3f
41                              &toPoint)
42     void                getScaleSpaceMatrix(SbMatrix  &mat,  SbMatrix   &inv)
43                              const
44     void                getRotationSpaceMatrix(SbMatrix  &mat, SbMatrix &inv)
45                              const
46     void                getTranslationSpaceMatrix(SbMatrix   &mat,   SbMatrix
47                              &inv) const
48     void                multLeft(const SbMatrix &mat)
49     void                multRight(const SbMatrix &mat)
50     void                combineLeft(SoTransformation *nodeOnRight)
51     void                combineRight(SoTransformation *nodeOnLeft)
52     void                setMatrix(const SbMatrix &mat)
53     void                recenter(const SbVec3f &newCenter)
54
55          Methods from class SoNode:
56
57     void                setOverride(SbBool state)
58     SbBool              isOverride() const
59     SoNode *            copy(SbBool copyConnections = FALSE) const
60     virtual SbBool      affectsState() const
61     static SoNode *     getByName(const SbName &name)
62     static int          getByName(const SbName &name, SoNodeList &list)
63
64          Methods from class SoFieldContainer:
65
66     void                setToDefaults()
67     SbBool              hasDefaultValues() const
68     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
69     void                copyFieldValues(const  SoFieldContainer  *fc,  SbBool
70                              copyConnections = FALSE)
71     SbBool              set(const char *fieldDataString)
72     void                get(SbString &fieldDataString)
73     virtual int         getFields(SoFieldList &resultList) const
74     virtual SoField *   getField(const SbName &fieldName) const
75     SbBool              getFieldName(const SoField *field, SbName &fieldName)
76                              const
77     SbBool              isNotifyEnabled() const
78     SbBool              enableNotify(SbBool flag)
79
80          Methods from class SoBase:
81
82     void                ref()
83     void                unref() const
84     void                unrefNoDelete() const
85     void                touch()
86     virtual SoType      getTypeId() const
87     SbBool              isOfType(SoType type) const
88     virtual void        setName(const SbName &name)
89     virtual SbName      getName() const
90
91

DESCRIPTION

93       This  is a new manipulator with some improvements over the older inven‐
94       tor manips. It has the  following  features:  [1]  full  interface  for
95       rotate,  translate,  and  scale,  [2] better feedback, [3] locate high‐
96       lighting.
97
98       SoTransformerManip is derived from SoTransform (by way of  SoTransform‐
99       Manip).  When  its fields change, nodes following it in the scene graph
100       rotate, scale, and/or translate.
101
102       As a subclass of SoTransformManip,  this  manipulator  also  has  a  3D
103       interface to edit some of its fields. In this case, the interface edits
104       the scaleFactor, rotation and translation fields.
105
106       A manipulator differs from a dragger. When you move a dragger, no other
107       nodes are affected. When you move an SoTransformManip, other nodes move
108       along with it. (See the reference page for SoTransformManip).
109
110       The interface for an SoTransformerManip is exactly the same as that  of
111       the SoTransformerDragger. To find out more about the interface, see the
112       reference page for SoTransformerDragger. To find out how the  manipula‐
113       tor uses a dragger to provide its interface, see the reference page for
114       SoTransformManip.
115
116       On screen, this manipulator will surround the objects influenced by its
117       motion. This is because it turns on the surroundScale part of the drag‐
118       ger (See the reference page for SoSurroundScale)
119

METHODS

121                         SoTransformerManip()
122          Constructor.
123
124     static SoType       getClassTypeId()
125          Returns type identifier for this class.
126
127     void                setLocateHighlighting(SbBool onOff )
128     SbBool              isLocateHighlighting()
129          Controls whether or not the dragger inside this manip  will  perform
130          locate highlighting is used. Default is TRUE.
131
132     void                unsquishKnobs()
133          Tells  the  dragger  inside  this manip to unsquish its rotation and
134          scale knobs during the next traversal.  Ordinarily,  the  knobs  are
135          only  unsquished  upon readin from file and when the mouse button is
136          released at the end of a drag. If  you  want  this  to  happen  more
137          often, then you should call this method.
138
139

FILE FORMAT/DEFAULTS

141       TransformerManip {
142          translation       0 0 0
143          rotation          0 0 1  0
144          scaleFactor       1 1 1
145          scaleOrientation  0 0 1  0
146          center            0 0 0
147     }
148

SEE ALSO

150       SoTransformerDragger, SoTransform, SoCenterballManip, SoHandleBoxManip,
151       SoJackManip,  SoTabBoxManip,   SoTrackballManip,   SoTransformBoxManip,
152       SoTransformManip
153
154
155
156
157                                                     SoTransformerManip(3IV)()
Impressum