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