Animation

The Animation module OccViewer.Animation provides a way to animate 3D models interactively, allowing for smooth transitions of transformations, including rotations, translations, and scaling. The animations can be applied to individual objects and controlled via various settings, such as duration, speed, state, and pivot axes. This functionality enables users to create dynamic visualizations, providing a clearer and more engaging representation of the models. The AnimationManager OccViewer.AnimationManager controls the animations for all objects, while the ObjectAnimation OccViewer.ObjectAnimation class defines the animation specific to each object.

The animation has 4 possible states defined by the [AnimationState]( OccViewer.AnimationState) enumeration:

• Unknown: Represents an unknown state.
• Started: The animation is running.
• Paused: The animation is paused.
• Reset: The animation has been reset.

Each object animation is represented by a series of [AnimationStep]( OccViewer.AnimationStep) objects that define its transformations over time, including:

• Rotation: Rotation represented by a quaternion.
• Translation: Movement of the object in 3D space.
• Scale: Scaling of the object.
• Animation Manager:

The AnimationManager manages animations for all objects, including adding and removing object animations, querying and setting animation properties, and controlling playback. It supports the following actions:

• Start, pause, resume, stop, restart, and reset animations.
• Set and get animation duration, speed, position, and state.
• Control the pivot axes for the animations.

Object Animation Each object can have its own ObjectAnimation, which is handled by the AnimationManager. The ObjectAnimation class encapsulates specific details related to the animation of a particular object, such as the transformation steps and the ability to control the animation's position, speed, and state. You can set animation steps and pivot axes, pause, resume, or stop individual animations, and query the animation's current state.

The AnimationManager provides controls for starting, stopping, pausing, resuming, and resetting the animations. The seek method allows for jumping to a specific point in the animation timeline, while the duration, position, and speed properties control the overall playback characteristics. The ObjectAnimation allows for direct interaction with an object animation, including accessing and modifying the transformation steps, checking if the animation is valid, and managing the relationship between parent and child animations. The animations can be synchronized in time, ensuring that multiple object animations progress simultaneously, providing a coherent and synchronized visual experience. The total duration is calculated as the maximum duration of all object animations.

const anObjAxes = {
    location: object.position,
    direction: {x: 0, y: 0, z: 1},
    xDirection: {x: 1, y: 0, z: 0},
  };
const animationSteps = [];
animation = new ObjectAnimation(Viewer, object.id);
animation.animAxes = anObjAxes;
animation.animationSteps = animationSteps;
animation.duration = 6;
Copy