User Guide

521
queue() (3D)
Syntax
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 modi fier command; adds the motio n specified by motionName
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.
The optional parameters of this command are as follows:
looped specifies whether the motion plays once (FALSE) or continuously (TRUE).
startTime is 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 is 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 is mult ip li e d by t he playRate pr operty of the m od el’s keyframePlayer modifier or bonesPlayer
modifier to determine the actual speed of the motions playback.
offset is 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)
The following Lingo adds the motion named Kick to the end of the bonesPlayer playlist of the
model named Walker. When all motions before Kick in the playlist have been executed, a section
of Kick will play in a continuous loop. The first iteration of the loop will begin 2000 milliseconds
from the motions beginning. All subsequent iterations of the loop will begin 1000 milliseconds
from Kicks beginning and will end 5000 milliseconds from Kicks beginning. The rate of
playback will be three times the
playRate property of the models bonesPlayer modifier.
sprite(1).member.model("Walker").bonesPlayer.queue("Kick", 1, \
1000, 5000, 3, 2000)
See also
play() (3D), playNext() (3D), playRate