MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING Reference page 471

preRotate
Usage
transformReference.preRotate( xAngle, yAngle, zAngle )
transformReference.preRotate( vector )
transformReference.preRotate( positionVector, directionVector, \
angle )
member( whichCastmember ).node.transform.preRotate( xAngle, \
yAngle, zAngle )
member( whichCastmember ).node.transform.preRotate( vector )
member( whichCastmember ).node.transform.preRotate\
( positionVector, directionVector, angle )
Description
3D transform command; applies a rotation before the current positional, rotational, and scale
offsets held by the referenced transform object. The rotation may be specified as a set of three
angles, each of which specify an angle of rotation about the three corresponding axes. These
angles may be specified explicitly in the form of
where the x component of the vector corresponds to the rotation about the x-axis, the y about the
y-axis, and the z about the z-axis.
Alternatively, the rotation may also be specified as a rotation about an arbitrary axis. This axis is
defined in space by
axis is specified by
may be a reference to a model, group, light, or camera
Node
Parameters
Required if applying a rotation using
xAngle
around the -axis.
x
Required if applying a rotation using
yAngle
around the -axis.
y
Required if applying a rotation using
zAngle
around the -axis.
z
Required if applying a rotation using a vector. Specifies the vector whose angles are used
vector
in the rotation.
positionVector
position offset.
directionVector
direction offset.
Required if applying a rotation about an arbitrary axis. Specifies the amount of rotation
angle
about an arbitrary axis.
Example
The following statement performs a rotation of 20° about each axis. Since the model's
property is its position, rotation, and scale offsets relative to that model's parent, and
applies the change in orientation prior to any existing effects of that model's
rotate the model in place rather than orbiting around its parent.
member("scene").model("bip01").transform.preRotate(20, 20, 20)
and
positionVector
.
angle
Required if applying a rotation about an arbitrary axis. Specifies the
Required if applying a rotation about an arbitrary axis. Specifies the
,
xAngle yAngle
. The amount of rotation about this
directionVector
-, -, and -axes. Specifies the angle of rotation
x y z
-, -, and -axes. Specifies the angle of rotation
x y z
-, -, and -axes. Specifies the angle of rotation
x y z
, and , or by a vector,
zAngle
transform
preRotate
transform
preRotate
, this will
471