Adobe Director Basics

ADOBE DIRECTOR BASICS
3D: Controlling action
Bones
When you import a W3D file containing bones animation, each bone may appear as a separate model. To discover
which models are the bones of a particular modelResource, you can use modelResource.getBoneID(), using the name
of each model in turn. If the result is a non-zero integer, the named model is a bone in the modelResource.
You can work out the parent-child hierarchy of bones by checking the parent of each of the bone models.
To see an example of this, download and launch the movie MotionTest.dir. Watch the output in the Message window
as the movie launches.
The MotionTest.dir movie contains a very basic bones animation
Bone properties
model.bonesPlayer.bone[boneId].transform indicates the transform of the bone relative to the parent bone.
You can find the boneId value from the name of the bone by using the modelResource.getBoneID() method of the
model resource.
You can read the properties of a bone's transform, but you cannot set any of its properties directly. You can however
replace the bone's transform with a standard transform which you can then control.
When you set the transform of a bone, it is no longer controlled by the current motion, and cannot be returned to
the control of the motion. To end manual control, you can use model.bonesPlayer.playNext() to remove the bone
from the playList. Manual control will end automatically when the current motion ends. You can experiment with
this in the MotionTest.dir movie
model.bonesPlayer.bone[boneId].worldTransform returns the world-relative transform of the bone. This
property gives you a means to attach a model to a bone. For example, on every exitFrame, you can set the
transform of a Hat model to the worldTransform of a character's Head bone.
See the MotionTest.dir movie for an example.
Motion mapping
You can create new motions by combining existing motions. For example, a walking motion can be combined with a
shooting motion to produce a walk-and-shoot motion. This is available only with Bones player animations.
See motion.map() for more details.
Last updated 8/26/2011
277