User Guide

448 Chapter 12: Methods

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 with all subsequent repetitions

beginning at

startTime and end at endTime. Set endTime to -1 if you want the motion to play to

the end.

playRate Optional. Specifies the actual speed of the motion’s playback. playRate is multiplied

by the model’s

#keyframePlayer or #bonesPlayer modifier’s playRate property 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 with all subsequent repetitions

beginning at

startTime and end at cropEnd. You can alternately specify the offset parameter

with a value of

#synchronized in order to start the motion at the same relative position in its

duration as the currently playing animation is through its own duration.

Example

This command causes the model named Walker to begin playback of the motion named Fall.

After playing this motion, the model will resume playback of any previously playing motion.

sprite(1).member.model("Walker").bonesPlayer.play("Fall", 0, \

0, -1, 1, 0)

This command causes the model named Walker to begin playback of the motion named Kick. If

Walker is currently executing a motion, it is interrupted by Kick and 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.play("Kick", 1, \

1000, 5000, 3, 2000)