User Guide

380 Chapter 16: Working with Models and Model Resources
Keyframe player events
These events are generated by keyframe animations:
Mesh deform modifier properties
The mesh deform modifier lets you alter an existing model resource’s geometry at runtime. You
can create twist, bend, and ripple effects. Unlike other modifiers, the mesh deform modifier
directly affects model resources as well as the models that use those resources. For example, if
three car models share the same model resource, adding this modifier to one model and then
deforming it will deform all the car models.
The mesh deform modifier is complex and is primarily useful for users with a thorough
understanding of 3D geometry. However, you can take advantage of much of the modifier’s
potential by using only the
vertexList property.
Use these properties to work with the mesh deform modifier:
Event name Description
#animation
Started
This is a system-defined notification event triggered when a motion
begins playing. If looping is on, this event is triggered only by the first
playthrough. During a blend of two animations, this event will be
triggered as the blend begins.
#animationEnded
This is a system-defined notification event triggered when a
motion ends. If looping is on, this event is triggered only by the
first playthrough. If blending is on, this event will be generated for the first
animation when the blend is complete. There may be some latency
because of the overhead of scheduling all other Director events.
Property Access Description
whichModel.
meshDeform.
mesh.count
Get Returns the number of meshes in a model.
whichModel.
meshDeform.
mesh[index].
vertexList
Get and set Returns a list of the vertices for the specified mesh.
To modify the vertices in this mesh, set this property
to a list of modified vertex positions, or modify
individual vertices using bracket analysis.
whichModel.
meshDeform.
mesh[index].
normalList
Get and set Returns a list of the normals for the specified mesh.
whichModel.
meshDeform.
mesh[index].
texture
CoordinateList
Get and set Returns a list of the texture coordinates for the
specified mesh.
whichModel.
meshDeform.
mesh[index].
face.count
Get Returns the number of triangular faces in a given
mesh.