SoComposeMatrix(3iv)

1SoComposeMatrix(3IV)()                                  SoComposeMatrix(3IV)()
2
3
4

NAME

6       SoComposeMatrix — composes a transformation matrix
7

INHERITS FROM

9       SoBase > SoFieldContainer > SoEngine > SoComposeMatrix
10

SYNOPSIS

12       #include <Inventor/engines/SoCompose.h>
13
14          Inputs from class SoComposeMatrix:
15
16     SoMFVec3f           translation
17     SoMFRotation        rotation
18     SoMFVec3f           scaleFactor
19     SoMFRotation        scaleOrientation
20     SoMFVec3f           center
21
22          Outputs from class SoComposeMatrix:
23
24     (SoMFMatrix)        matrix
25
26          Methods from class SoComposeMatrix:
27
28                         SoComposeMatrix()
29
30          Methods from class SoEngine:
31
32     static SoType       getClassTypeId()
33     virtual int         getOutputs(SoEngineOutputList &list) const
34     SoEngineOutput *    getOutput(const SbName &outputName) const
35     SbBool              getOutputName(const  SoEngineOutput  *output,  SbName
36                              &outputName) const
37     SoEngine *          copy() const
38     static SoEngine *   getByName(const SbName &name)
39     static int          getByName(const SbName &name, SoEngineList &list)
40
41          Methods from class SoFieldContainer:
42
43     void                setToDefaults()
44     SbBool              hasDefaultValues() const
45     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
46     void                copyFieldValues(const  SoFieldContainer  *fc,  SbBool
47                              copyConnections = FALSE)
48     SbBool              set(const char *fieldDataString)
49     void                get(SbString &fieldDataString)
50     virtual int         getFields(SoFieldList &resultList) const
51     virtual SoField *   getField(const SbName &fieldName) const
52     SbBool              getFieldName(const SoField *field, SbName &fieldName)
53                              const
54     SbBool              isNotifyEnabled() const
55     SbBool              enableNotify(SbBool flag)
56
57          Methods from class SoBase:
58
59     void                ref()
60     void                unref() const
61     void                unrefNoDelete() const
62     void                touch()
63     virtual SoType      getTypeId() const
64     SbBool              isOfType(SoType type) const
65     virtual void        setName(const SbName &name)
66     virtual SbName      getName() const
67
68

DESCRIPTION

70       This engine has inputs that specify values for  translation,  rotation,
71       scale, and center of transformation. As output, it produces a transfor‐
72       mation matrix that transforms objects into the space specified  by  the
73       scale, rotation, and translation inputs (in that order).
74
75       The  input fields can have multiple values, allowing the engine to com‐
76       pose several matrices in parallel. Some inputs  may  have  more  values
77       than  others.  In such cases, the last value of the shorter inputs will
78       be repeated as necessary.
79

INPUTS

81     SoMFVec3f           translation
82          Translation in x, y, and z.
83
84     SoMFRotation        rotation
85          Rotation.
86
87     SoMFVec3f           scaleFactor
88          Scale factors in x, y, and z.
89
90     SoMFRotation        scaleOrientation
91          Rotational space for scaling.
92
93     SoMFVec3f           center
94          Center point for scaling and rotating.
95
96

OUTPUTS

98     (SoMFMatrix)        matrix
99          Transformation matrix that transforms from  object  space  into  the
100          space specified by the inputs.
101
102

METHODS

104                         SoComposeMatrix()
105          Constructor
106
107

FILE FORMAT/DEFAULTS

109       ComposeMatrix {
110          translation       0 0 0
111          rotation          0 0 1  0
112          scaleFactor       1 1 1
113          scaleOrientation  0 0 1  0
114          center            0 0 0
115     }
116