MACROMEDIA DIRECTOR MX 2004, Reference

Page: 473 / 1130

preTranslate() 473
Line 4
assigns this new transform to Moon2.
t = member("scene").model("Moon1").transform.duplicate()
t.preScale(2,2,2)
t.rotate(180,0,0)
member("scene").model("Moon2").transform = t
preTranslate()
Usage
transformReference .preTranslate( xIncrement , yIncrement , \
zIncrement )
transformReference .preTranslate( vector )
member( whichCastmember ). node .transform.preTranslate\
( xIncrement , yIncrement , zIncrement )
member( whichCastmember ). node .transform.preTranslate( vector )
Description
3D transform command; applies a translation before the current positional, rotational, and scale
offsets held by the referenced transform object. The translation may be specified as a set of three
increments along the three corresponding axes. These increments may be specified explicitly in
the form of
xIncrement
,
yIncrement
, and
zIncrement
, or by a vector, where the X component
of the vector corresponds to the translation about the X axis, the Y about the Y axis, and the Z
about the Z axis.
After a series of transformations are done, in the following order, the model’s local origin will be at
(0, 0, -100), assuming the model’s parent is the world:
model.transform.identity()
model.transform.rotate(0, 90, 0)
model.transform.preTranslate(100, 0, 0)
Had
translate()
been used instead of
preTranslate()
, the model's local origin would be at
(100, 0, 0) and the model rotated about its own Y axis by 90°. The statement
model.transform.pretranslate(x, y, z)
is equivalent to
model.translate(x, y, z)
.
Generally,
preTranslate()
is only useful when dealing with transform variables rather than
model.transform
references.
Parameters
xIncrement
Required if applying a translation using
x
-,
y
-, and
z
-axes. Specifies the translation
around the
x
-axis.
yIncrement
Required if applying a translation using
x
-,
y
-, and
z
-axes. Specifies the translation
around the
y
-axis.
zIncrement
Required if applying a translation using
x
-,
y
-, and
z
-axes. Specifies the translation
around the
z
-axis.
vector
Required if applying a translation using a vector. Specifies the vector to use in
the translation.