MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING, Reference

Page: 486 / 1130

486 Chapter 12: Methods
See also
endTime , loopCount , loopEndTime , loopStartTime , pause() (Sound Channel) ,
play() (Sound Channel) , preLoadTime , setPlayList() , Sound Channel , startTime ,
stop() (Sound Channel)
queue() (3D)
Usage
member( whichCastmember ).model( whichModel ).bonesPlayer.queue\
( motionName {, looped , startTime, endTime, scale, offset })
member( whichCastmember ).model( whichModel ).keyframePlayer.\
queue( motionName {, looped , startTime, endTime, scale, offset })
Description
3D
keyframePlayer
and
bonesPlayer
modifier command; adds a specified motion to the end
of the modifier’s
playList
property. The motion is executed by the model when all the motions
ahead of it in the playlist are finished playing.
Parameters
motionName
Required. Specifies the name of the motion to add.
looped
Optional. Specifies whether the motion plays once (
FALSE
) or continuously (
TRUE
).
startTime
Optional. Measured in milliseconds from the beginning of the motion. When
looped
is
FALSE
, the motion begins at
offset
and ends at
endTime
. When
looped
is
TRUE
, the first
iteration of the loop begins at
offset
and ends at
endTime
. All subsequent repetitions begin at
startTime
and end at
endTime
.
endTime
Optional. Measured in milliseconds from the beginning of the motion. When
looped
is
FALSE
, the motion begins at
offset
and ends at
endTime
. When
looped
is
TRUE
, the first
iteration of the loop begins at
offset
and ends at
endTime
. All subsequent repetitions begin at
cropStart
and end at
endTime
. Set
endTime
to -1 if you want the motion to play to the end.
scale
Optional. Specifies the actual speed of the motion’s playback.
scale
is multiplied by the
playRate
property of the model’s
#keyframePlayer
modifier or
#bonesPlayer
modifier to
determine the actual speed of the motion’s playback.
offset
Optional. Measured in milliseconds from the beginning of the motion. When
looped
is
FALSE
, the motion begins at
offset
and ends at
endTime
. When
looped
is
TRUE
, the first
iteration of the loop begins at
offset
and ends at
endTime
. All subsequent repetitions begin at
startTime
and end at
endTime
.
Example
The following Lingo adds the motion named Fall to the end of the
bonesPlayer
playlist of the
model named Walker. When all motions before Fall in the playlist have been executed, Fall will
play one time from beginning to end.
sprite(1).member.model("Walker").bonesPlayer.queue\
("Fall", 0, 0, -1, 1, 0)