pathAnimation is undoable, queryable, and editable.
The pathAnimation command constructs the necessary graph nodes
and their interconnections for a motion path animation. Motion path
animation requires a curve and one or more other objects.
During the animation, the objects will be moved along the 3D curve
or the curveOnSurface.In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
|
-bank(-b)
|
boolean
|
|
|
If on, enable alignment of the up axis of the moving
object(s) to the curvature of the path geometry.
Default is false.
When queried, this flag returns a boolean.
|
|
-bankScale(-bs)
|
float
|
|
|
This flag specifies a factor to scale the amount of
bank angle.
Default is 1.0
When queried, this flag returns a float.
|
|
-bankThreshold(-bt)
|
angle
|
|
|
This flag specifies the limit of the bank angle.
Default is 90 degrees
When queried, this flag returns an angle.
|
|
-curve(-c)
|
string
|
|
|
This flag specifies the name of the curve for the path.
Default is NONE
When queried, this flag returns a string.
|
|
-endTimeU(-etu)
|
time
|
|
|
This flag specifies the ending time of the animation
for the u parameter.
Default is NONE.
When queried, this flag returns a time.
|
|
-endU(-eu)
|
float
|
|
|
This flag specifies the ending value of the u
parameterization for the animation.
Default is the end parameterization value of the curve.
When queried, this flag returns a linear.
|
|
-follow(-f)
|
boolean
|
|
|
If on, enable alignment of the front axis of the moving object(s).
Default is false.
When queried, this flag returns a boolean.
|
|
-followAxis(-fa)
|
string
|
|
|
This flag specifies which object local axis to be
aligned to the tangent of the path curve.
Default is y
When queried, this flag returns a string.
|
|
-fractionMode(-fm)
|
boolean
|
|
|
If on, evaluation on the path is based on the fraction
of length of the path curve.
Default is false.
When queried, this flag returns a boolean.
|
|
-inverseFront(-if)
|
boolean
|
|
|
This flag specifies whether or not to align
the front axis of the moving object(s) to the opposite direction
of the tangent vector of the path geometry.
Default is false.
When queried, this flag returns a boolean.
|
|
-inverseUp(-iu)
|
boolean
|
|
|
This flag specifies whether or not to align
the up axis of the moving object(s) to the opposite direction
of the normal vector of the path geometry.
Default is false.
When queried, this flag returns a boolean.
|
|
-name(-n)
|
string
|
|
|
This flag specifies the name for the new motion path node.
(instead of the default name)
When queried, this flag returns a string.
|
|
-startTimeU(-stu)
|
time
|
|
|
This flag specifies the starting time of the animation
for the u parameter.
Default is the the current time.
When queried, this flag returns a time.
|
|
-startU(-su)
|
float
|
|
|
This flag specifies the starting value of the u
parameterization for the animation.
Default is the start parameterization value of the curve.
When queried, this flag returns a linear.
|
|
-upAxis(-ua)
|
string
|
|
|
This flag specifies which object local axis to be
aligned a computed up direction.
Default is z
When queried, this flag returns a string.
|
|
-useNormal(-un)
|
boolean
|
|
|
This flag is now obsolete. Use -wut/worldUpType instead.
|
|
-worldUpObject(-wuo)
|
name
|
|
|
Set the DAG object to use for worldUpType "object" and
"objectrotation". See -wut/worldUpType for greater detail.
The default value is no up object, which is interpreted
as world space.
|
|
-worldUpType(-wut)
|
string
|
|
|
Set the type of the world up vector computation.
The worldUpType can have one of 5 values: "scene",
"object", "objectrotation", "vector", or "normal".
If the value is "scene", the upVector is
aligned with the up axis of the scene and
worldUpVector and worldUpObject are ignored.
If the value is "object", the upVector is
aimed as closely as possible to the
origin of the space of the worldUpObject and
the worldUpVector is ignored.
If the value is "objectrotation" then the
worldUpVector is interpreted as being in
the coordinate space of the worldUpObject, transformed into
world space and the upVector is aligned as
closely as possible to the result.
If the value is "vector", the upVector
is aligned with worldUpVector as closely as
possible and worldUpObject is ignored.
Finally, if the value is "normal" the upVector is aligned to
the path geometry.
The default worldUpType is "vector".
|
|
-worldUpVector(-wu)
|
float float float
|
|
|
Set world up vector. This is the vector in world
coordinates that up vector should align with.
See -wut/worldUpType for greater detail.
If not given at creation time, the default
value of (0.0, 1.0, 0.0) is used.
|
|