User Guide

376 Chapter 16: Working with Models and Model Resources
Bones player events
These events are generated by bones animations:
whichModel.
bonesPlayer.
rotationReset
Get and set Normally a model snaps back to its
original rotation after a motion finishes
playing. This property maintains any or
all of the rotational changes after playing
is complete.
The values are as follows:
#none
#x
#y
#z
#xy
#xz
#all
#all
whichModel.
bonesPlayer.
lockTranslation
Get and set Defines the axis of translation to ignore
when playing back a motion.
The values are as follows:
#none
#x
#y
#z
#xy
#xz
#all
To keep a model locked to a
ground plane with the top pointing along
the z-axis, set
lockTranslation to #z.
lockTranslation = #all is equivalent to
rootLock = TRUE (1).
#none
Event name Description
#animation
Started
This is a system-defined notification event triggered when a motion begins
playing. If looping is on, this event is triggered only by the first playthrough.
During a blend of two animations, this event is triggered as the blend begins.
#animation
Ended
This is a system-defined notification event triggered when a motion ends. If
looping is on, this event is triggered only by the first playthrough. If blending
is on, this event is generated for the first animation when the blend is
complete. There may be some latency because of the overhead of
scheduling all other Director events.
Property Access Description Default