User Guide

Animation modifiers 373
You can add the Keyframe player modifier at runtime to a model created in Director, but you
cannot add the Bones player modifier at runtime. The Bones player modifier is automatically
attached to models with bones animation exported from a 3D modeling application. Since the
required bones information can’t be assigned in Director, it has to exist before the model
is imported into Director.
Bones player methods
Use these methods to work with bones animations:
Method Description Returns
whichModel.bonesPlayer.
play(“name”, looped, startTime,
endTime, playRate, timeOffset)
Plays the motion named name starting at
the time
timeOffset, with the currently
playing motion being pushed down the
play list. If
looped is FALSE (0), the
preceding motion begins again when
this motion completes.
StartTime can be an integer number of
milliseconds, or it can be the symbol
#synchronized. Use #synchronized to
start this new motion at the same
relative time offset to it's total duration
as the currently playing motion is to it's
total duration. The
playRate parameter
indicates how fast to play the motion. A
value of 2 doubles the speed of the
motion. This value is multiplied by the
value of the
bonesPlayer.playRate
property.
If blending is enabled, blending begins
the instant
play() is called.
Nothing
whichModel.bonesPlayer.
playNext()
Ends the currently playing motion,
removes it from the play list, and begins
the next motion.
if blending is enabled, blending begins
the instant
playNext() is called.
Nothing
whichModel.bonesPlayer.
queue(“name”, looped, startTime,
endTime, playRate, timeOffset)
Adds the specified motion to the end of
the play list. The parameters are same as
those for the
play() method.
Nothing
whichModel.bonesPlayer.
removeLast()
Removes the most recently added
motion from the play list. The motion will
be removed from the play list even if it is
also the currently playing motion.
Nothing
whichModel.bonesPlayer.
pause()
Pauses the Bones player. Nothing