MACROMEDIA DIRECTOR MX-USING DIRECTOR MX, Use Manual

Page: 498 / 624

Chapter 19 498
Modifiers
Modifiers control how a model is rendered or how it animates. They are attached to a model with
the
addModifier()
command. Once a modifier has been attached, its properties can be
manipulated with Lingo. The tables that follow detail the properties of the modifiers included
with Director MX.
Level of detail (LOD) modifier properties
The level of detail (LOD) modifier provides per-model control over the number of polygons used
to render a model, based on the model’s distance from the camera. This modifier is attached to all
imported models.
translate
(
xIncrement,
yIncrement,
zIncrement,
relativeTo
)
Moves the group forward by
xIncrement
along the x-axis,
yIncrement
along the y-axis, and
zIncrement
along the
z-axis.
The
relativeTo
parameter is optional. It determines how
arguments are interpreted. The possible values are as follows:
#self
: the default. Increments are applied relative to the
group’s local coordinate system.
#parent
: increments are relative to the group’s parent’s
coordinate system.
#world
: increments are relative to the world coordinate
system. Equivalent to
#parent
if parent is the world.
node (group, light, camera, or group): increments are relative
to the coordinate system of the argument object.
Nothing
translate
(
direction
Vector, relativeTo
)
Moves the group
directionVector.length()
in the
direction of the vector
directionVector
. The
relativeTo
argument is optional and defaults to
#self
.
Nothing
translate
(
x,y,z,
relativeTo
)
Moves the group distance
x
along the x-axis, distance y along
the y-axis, and distance z along the z-axis. The
relativeTo
argument is optional and defaults to
#self
.
This command can also be written as
translate(vector( x,y,z ) relativeTo ) .
Nothing
rotate(
x,y,z,
relativeTo
)
Rotates the group by
x
degrees around the x-axis, y degrees
around the y-axis, and z degrees around the z-axis.
The
relativeTo
argument is optional and defaults to
#self
. If included, it defines the coordinate space of the axes.
This command can also be written as
rotate(vector( x,y,z ) relativeTo )
.
Nothing
rotate ( position,
axis, angle, relativeTo
)
Rotates the group around the axis vector in the specified
position the specified number of degrees. The
relativeTo
argument is optional and defaults to
#self
.
Nothing
pointAt(
world
Position, worldUp
)
Rotates the model until it points at the world-relative position
worldPosition. The optional
worldUp
argument gives the
general position of the model’s Up axis. The exact position
can’t be determined using this method.
Both the object-relative axes are defined by the
pointAtOrientation
property. Default values are an
object-relative forward direction of vector (
0
,
0
,
-1
) and an
object-relative up direction of vector (
0
,
1
,
0
).
Nothing
getWorld
Transform()
Calculates and returns a transform that converts object-
relative positions for this group into world-relative positions. A transform object
Command Description Returns