Basic Features

The following is a simple procedure for playing back an animation.

For details, see AnimationDemo.

1. Gets the animation group.
   • Model::GetVisibilityAnimGroup (Example)

   The functions used differ depending on the animation target and type.

   • SkeletalModel::GetSkeletalAnimGroup
   • Model::GetVisibilityAnimGroup
   • Model::GetMaterialAnimGroup
   • Light::GetAnimGroup
   • Camera::GetAnimGroup
2. Create an instance for animation evaluation.
   • AnimEvaluator::Builder

   Use TransformAnimEvaluator::Builder for skeletal animations.

3. Bind an animation loop to the created animation evaluation instance.
   • AnimObject::Bind
4. Register the animation evaluation with the model.
   • Model::SetVisibilityAnimObject (Example)

   The functions used differ depending on the animation target and type.

   • SkeletalModel::SetSkeletalAnimObject
   • Model::SetVisibilityAnimObject
   • Model::SetMaterialAnimObject
   • Light::SetAnimObject
   • Camera::SetAnimObject

   Pass the just-created AnimEvaluator object in the AnimObject argument.
   Pass other derived classes for any subsequent blending or other such processing.

5. Update the scene each frame.
   • SceneUpdater::UpdateAll

This section describes how to play another animation for a target for which an animation is already playing.

• BaseAnimEvaluator::ChangeAnim

Switching animations is faster than re-creating an instance for evaluation.

This section describes how to control the playback frame of an animation from your program.

• To set a particular frame:
  • BaseAnimEvaluator::SetFrame
• To change the update interval of an animation:
  • BaseAnimEvaluator::SetStepFrame
• To set or cancel a loop:
  • BaseAnimEvaluator::SetPlayPolicy

This section describes how to restore status immediately after loading a model or other object.

• BaseAnimEvaluator::Reset

You must have a material buffer ready to perform this operation on a material.
For details, see BaseAnimEvaluator::Reset.

Follow these steps to remove an animation from a model.

• Call the AnimObject::Release function to remove an animation group from an animation evaluation.
• Pass NULL to the SetAnimObject or Set***AnimObject functions as described in Animation Playback to delete an animation.

Note that all steps are required here.

This section describes how to blend two or more animations with the same target.
The AnimationBlendDemo blends a walking animation and running animation.

For details, see AnimationBlendDemo.

1. Prepare two or more instances of AnimEvaluator.

   For details on creating an instance of AnimEvaluator, see Animation Playback.

2. Create an instance of AnimInterpolator with the required size and register the AnimEvaluator objects.
   • AnimInterpolator::Builder
   • AnimBlender::AddAnimObject

   In this example, the AnimObject to be registered is an AnimEvaluator object.

You can also blend an AnimBlender object using another AnimBlender.
You can also overwrite animations. For details, see Partial Animation.