> For the complete documentation index, see [llms.txt](https://video-copilot.gitbook.io/element2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://video-copilot.gitbook.io/element2/animating-3d-objects/animation-engine.md).
# Animation Engine
## WHAT IS THE ANIMATION ENGINE?
The animation engine allows you to intelligently blend, or interpolate the "STATE" of objects in one group into the "STATE" of objects in another Group. For example if the objects in Group 1 form a ring and the objects in Group 2 form a box, the animation engine will animate the position from the ring to the box.
{% hint style="info" %}
[](https://www.videocopilot.net/help/element/tutorial/basic/animation_engine/)
**Animation Engine**\
\
• Particle replicator vs particle look options\
• Animating in a single group\
• Using multiple groups to animate a single object\
\
[**WATCH NOW!**](https://www.videocopilot.net/help/element/tutorial/basic/animation_engine/)
{% endhint %}
***
#### Group Selection
Choose what groups you want to animate between with the Start Group and Finish Group options.
#### Animation Type
Particle animations can be animated using various transition types such as Directional, Radial, Random or Linear.
{% hint style="info" %}
When you check the Enable button, the Finish group will disappear and only be visible when you keyframe the Animation value to 100%.
{% endhint %}
#### Uniform
Particles animate from one group to the next in a striaght forward manner.
#### Directional
Particles animate in a single direction that can be controlled with the Yaw and Pitch.
#### Radial
Particles animate in a spherical pattern. You can control the position and change the direction from Outward to Inward.
#### Random
The random transition mode moves particles in a random pattern.
#### Shape Order
Particles animate altogether at the same time.
***
#### ANIMATION TYPE
Control the animation between the two Replicator Shapes. 0% is the Start Group and 100% is the Finish Group.
#### SMOOTHNESS
This controls how fluidly the animation goes from one state to another. A Lower number of Smoothness will be a more sequential movement, whereas a higher number will have a more fluid together animation.
#### RANDOMNESS
Change how the randomness affects the animation.
#### EASE TYPE
Control the transition smoothing of the in and out points of the animation.
#### GROUP DIRECTION
Control which group the animation starts with. Choose Backwards to reverse the Start and Finish groups.
#### PARTICLE COUNT FROM
Because the Animation Engine is a way of animating a certain number of particles from one shape to another, this let you decide which group’s amount of particles to use. Lets you choose either from the Start Group or the Finish Group.
#### DISCONNECT MULTI-OBJECT
Uses multi-object pieces in animation.
#### SEED
Change the Random Seed of the animation.
#### DIRECTIONAL OPTIONS
Change the Yaw (Horizontal) and the Pitch (Vertical) angle of the animation.
#### DUAL ANIMATION MODE
Allows particles to start animating with a specific Blend mode like Radial but finish using a different sequence like Direction. You can also use the dual sequence mode with directional to have 2 separate blending directions for outgoing and incoming particles.
***
### TIME DELAY
Offset how the Position, Duration, Scale, Material, and Multi-Object transitions from one state to another when animating.
#### Duration
Control how smooth the animation transition is.
#### Offset
Offset the animation if the Duration is set lower.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://video-copilot.gitbook.io/element2/animating-3d-objects/animation-engine.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
