MACROMEDIA DIRECTOR MX 2004, Reference

Page: 448 / 1130

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)
See also
queue() (3D) , playNext() (3D) , playRate (3D) , playlist , pause() (3D) ,
removeLast() , playing (3D)
play() (DVD)
Usage
-- Lingo syntax
dvdObjRef .play()
dvdObjRef .play( beginTitle , beginChapter, endTitle, endChapter )
dvdObjRef .play( beginTimeList , endTimeList )
// JavaScript syntax
dvdObjRef .play();
dvdObjRef .play( beginTitle , beginChapter, endTitle, endChapter );
dvdObjRef .play( beginTimeList , beginTimeList );
Description
DVD method; starts or resumes playback.