3D Lingo Dictionary > O-S > queue() |
![]() ![]() ![]() |
queue()
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
modifier command; adds the motion specified by motionName
to the end of the modifier's playlist. The motion is executed by the model when all of 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 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
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
This command 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)
This command 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 motion's beginning. All subsequent iterations of the loop will begin 1000 milliseconds from Kick's beginning and will end 5000 milliseconds from Kick's beginning. The rate of playback will be three times the playRate
property of the model's bonesPlayer
modifier.
sprite(1).member.model("Walker").bonesPlayer.queue("Kick", 1, 1000, 5000, 3, 2000)
See also
![]() ![]() ![]() |