Go to:
Related nodes. Attributes.
The character node is a special type of set. It is used to gather together
animatable attributes. These attributes can then be animated in unison
when the character is current. Character sets are also used to define a
set of attributes that a user wishes to animate using nonlinear animation clips.
Character sets may only contain animatable attributes and other
characters (called "subcharacters"). Using subcharacters, it is
possible to build hierarchical characters.
The character node manages all animation data for the attributes it
contains. When a key is set on a character, the animation curves
are connected to the character node. The
character node passes this animation data through to the character's
attributes via connections.
When animation clips are created, the character is connected to a
clipScheduler node and a clipLibrary node that manage
and evaluate the clip data. The clipScheduler node is attached
to the character via the clipEvaluate function attribute.
When a clip is created on a character, all of the animation curves
connected to the character are considered part of the new clip. The animation curves
are disconnected from the character and connected to the character's associated
clipLibrary node. The clipLibrary acts as a repository where all of the available
source clips are held. To move a clip's animation curves back onto the character,
the clip can be "activated".
Node name | Parents | MFn type | Compatible function sets |
---|
character | objectSet | kCharacter | kBase kNamedObject kDependencyNode kSet kCharacter |
Related nodes
characterMap, animClip, clipLibrary, clipScheduler
Attributes (40)
activeClipConnected, angularClipValues, angularValues, animationMapping, clipEvaluate, clipEvaluate_Hidden, clipEvaluate_Inmap, clipEvaluate_InmapFrom, clipEvaluate_InmapTo, clipEvaluate_Outmap, clipEvaluate_OutmapFrom, clipEvaluate_OutmapTo, clipEvaluate_Raw, clipIndexMap, clipStatePercentEval, clipStatePercentEval_Hidden, clipStatePercentEval_Inmap, clipStatePercentEval_InmapFrom, clipStatePercentEval_InmapTo, clipStatePercentEval_Outmap, clipStatePercentEval_OutmapFrom, clipStatePercentEval_OutmapTo, clipStatePercentEval_Raw, evalCharacterKeys, linearClipValues, linearValues, offsetNode, offsetObjectLocalXForm, offsetObjects, referenceMapping, timeClipValues, timeValues, timelineClipEnd, timelineClipStart, translationOffsetIndexX, translationOffsetIndices, translationOffsetY, translationOffsetZ, unitlessClipValues, unitlessValues
Long name (short name) | Type | Default | Flags |
---|
|
clipEvaluate
(ce )
| compound | n/a | |
|
| clipEvaluate_Hidden
(ceh )
| function | NULL | | |
|
| clipEvaluate_Raw
(cer )
| function | NULL | | |
|
| clipEvaluate_Inmap
(cei )
| compound | n/a | | |
| clipEvaluate_InmapTo
(ceit )
| short | 0 | | |
| | clipEvaluate_InmapFrom
(ceif )
| short | 0 | | |
|
|
| clipEvaluate_Outmap
(ceo )
| compound | n/a | | |
| clipEvaluate_OutmapTo
(ceot )
| short | 0 | | |
| | clipEvaluate_OutmapFrom
(ceof )
| short | 0 | | |
|
|
|
clipStatePercentEval
(cspe )
| compound | n/a | |
|
| clipStatePercentEval_Hidden
(cspeh )
| function | NULL | | |
|
| clipStatePercentEval_Raw
(csper )
| function | NULL | | |
|
| clipStatePercentEval_Inmap
(cspei )
| compound | n/a | | |
| clipStatePercentEval_InmapTo
(cspeit )
| short | 0 | | |
| | clipStatePercentEval_InmapFrom
(cspeif )
| short | 0 | | |
|
|
| clipStatePercentEval_Outmap
(cspeo )
| compound | n/a | | |
| clipStatePercentEval_OutmapTo
(cspeot )
| short | 0 | | |
| | clipStatePercentEval_OutmapFrom
(cspeof )
| short | 0 | | |
|
|
|
unitlessValues
(uv )
| double | 0.0 | |
|
|
linearValues
(lv )
| distance (double) | 0.0cm | |
|
|
angularValues
(av )
| angle (double) | 0.0deg | |
|
|
timeValues
(tv )
| time | 0film | |
|
|
unitlessClipValues
(uc )
| double | 0.0 | |
|
|
linearClipValues
(lc )
| distance (double) | 0.0cm | |
|
|
angularClipValues
(ac )
| angle (double) | 0.0deg | |
|
|
timeClipValues
(tc )
| time | 0film | |
|
|
animationMapping
(am )
| characterMapping | NULL | |
|
|
referenceMapping
(rm )
| characterMapping | NULL | |
|
|
clipIndexMap
(cim )
| intArray | empty | |
|
|
offsetObjects
(ofo )
| Message | n/a | |
|
|
offsetObjectLocalXForm
(oolx )
| matrix | identity | |
|
|
activeClipConnected
(acc )
| bool | 0 | |
|
|
evalCharacterKeys
(eck )
| bool | 1 | |
|
|
timelineClipStart
(tcs )
| time | 0film | |
|
|
timelineClipEnd
(tce )
| time | 0film | |
|
|
offsetNode
(ofn )
| Message | n/a | |
|
|
translationOffsetIndices
(toi )
| compound | n/a | |
|
| translationOffsetIndexX
(tox )
| integer | -1 | | |
|
| translationOffsetY
(toy )
| integer | -1 | | |
|
| translationOffsetZ
(toz )
| integer | -1 | | |
|