Lingo Dictionary > T-Z > translation

 

translation

Syntax

member(whichQuickTimeMember).translation
the translation of member whichQuickTimeMember
sprite(whichQuickTimeSprite).translation
the translation of sprite whichQuickTimeSprite

Description

QuickTime cast member and sprite property; controls the offset of a QuickTime sprite's image within the sprite's bounding box.

This offset is expressed in relation to the sprite's default location as set by its center property. When center is set to TRUE, the sprite is offset relative to the center of the bounding rectangle; when center is set to FALSE, the sprite is offset relative to the upper left corner of the bounding rectangle.

The offset, specified in pixels as positive or negative integers, is set as a Director list: [xTrans, yTrans]. The xTrans parameter specifies the horizontal offset from the sprite's default location; the yTrans parameter specifies the vertical offset. The default setting is [0,0].

When the sprite's crop property is set to TRUE, the translation property can be used to mask portions of the QuickTime movie by moving them outside the bounding rectangle. When the crop property is set to FALSE, the translation property is ignored, and the sprite is always positioned at the upper left corner of the sprite's rectangle.

This property can be tested and set.

Example

This frame script assumes that the center property of the cast member of a 320-pixel-wide QuickTime sprite in channel 5 is set to FALSE, and its crop property is set to TRUE . It keeps the playback head in the current frame until the movie's horizontal translation point has moved to the right edge of the sprite, in 10-pixel increments. This has a wipe right effect, moving the sprite out of view to the right. When the sprite is out of view, the playback head continues to the next frame.

on exitFrame
	horizontalPosition = sprite(5).translation[1]
	if horizontalPosition < 320 then
		sprite(5).translation = sprite(5).translation + [10, 0]
		go the frame
	end if
end