MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING Reference page 961

rotation
Usage
-- Lingo syntax
spriteObjRef.rotation
// JavaScript syntax
spriteObjRef.rotation;
Description
Sprite property; controls the rotation of a QuickTime movie, animated GIF, Flash movie, or
bitmap sprite within a sprite's bounding rectangle, without rotating that rectangle or the sprite's
controller (in the case of QuickTime). Read/write.
In effect, the sprite's bounding rectangle acts as a window through which you can see the Flash or
QuickTime movie. The bounding rectangles of bitmaps and animated GIFs change to
accommodate the rotating image.
Score rotation works for a Flash movie only if
A Flash movie rotates around its origin point as specified by its
QuickTime movie rotates around the center of the bounding rectangle of the sprite. A bitmap
rotates around the registration point of the image.
For QuickTime media, if the sprite's
moves part of the image out of the viewable area; when the sprite's
the image is scaled to fit within the bounding rectangle (which may cause image distortion).
You specify the rotation in degrees as a floating-point number.
The Score can retain information for rotating an image from +21,474,836.47° to
-21,474,836.48°, allowing 59,652 full rotations in either direction.
When the rotation limit is reached (slightly past the 59,652th rotation), the rotation resets to
+116.47° or -116.48°—not 0.00°. This is because +21,474,836.47° is equal to +116.47°, and
-21,474,836.48° is equal to -116.48° (or +243.12°). To avoid this reset condition, when you use
script to perform continuous rotation, constrain the angles to ±360°.
The default value of this property is 0.
Example
This behavior causes a sprite to rotate continuously by 2° every time the playhead advances,
limiting the angle to 360°:
-- Lingo syntax
property spriteNum
on prepareFrame me
sprite(spriteNum).rotation = integer(sprite(spriteNum).rotation + 2) mod 360
end
// JavaScript syntax
function prepareFrame() {
sprite(this.spriteNum).rotation = parseInt(sprite(this.spriteNum).rotation
+ 2) % 360;
}
obeyScoreRotation
property is set to
crop
is set to .
TRUE
property. A
originMode
, rotating the sprite frequently
TRUE
property is set to
crop
,
FALSE
rotation 961