Lingo Dictionary > L-N > loopBounds |  |

loopBounds

Syntax

    sprite(whichQuickTimeSprite).loopBounds
    the loopBounds of sprite whichQuickTimeSprite

Description

QuickTime sprite property; sets the internal loop points for a QuickTime cast member or sprite. The loop points are specified as a Director list: [`startTime`, `endTime`].

The `startTime` and `endTime` parameters must meet these requirements:

| Both parameters must be integers that specify times in Director ticks.
| The values must range from 0 to the duration of the QuickTime cast member.
| The starting time must be less than the ending time.

If any of these requirements is not met, the QuickTime movie loops through its entire duration.

The `loopBounds` property has no effect if the movie's `loop` property is set to `FALSE`. If the `loop` property is set to `TRUE` while the movie is playing, the movie continues to play. Director uses these rules to decide how to loop the movie:

| If the ending time specified by `loopBounds` is reached, the movie loops back to the starting time.
| If the end of the movie is reached, the movie loops back to the start of the movie.

If the `loop` property is turned off while the movie is playing, the movie continues to play. Director stops when it reaches the end of the movie.

This property can be tested and set. The default setting is [0,0].

Example

This sprite script sets the starting and ending times for looping within a QuickTime sprite. Notice that the times are set by specifying seconds, which are then converted to ticks by multiplying by 60.

    on beginSprite me
    	sprite(me.spriteNum).loopBounds = [(16 * 60),(32 * 60)]
    end