# Animation

<table>
<tr><td>

<img src="./media/image53.jpg" width="44" height="44">

</td><td>

Animations are created from sketches. The required buttons are located in the **Files** tab. Once you have created a sketch, you can create an animation while the sketch remains open, which links the two together.

</td></tr>
</table>

<img src="./media/FilesAddAnimation.png" width="250" height="">

> Multiple animations can be associated with a single sketch.
  
## Animation Player

<img src="./media/image197.png" width="737" height="56"> 

<table>
<tr><td>

<img src="./media/ButtonEdit.png" width="44" height="44">

</td><td>

**Edit** opens the animation editor.

</td></tr>
<tr><td>

<img src="./media/image198.png" width="44" height="44">

</td><td>

**Go to first** jumps to the first keyframe.

</td></tr>
<tr><td>

<img src="./media/image199.jpg" width="44" height="44">

</td><td>

**Go to previous** jumps to the previous timestamp or the beginning of the animation.

</td></tr>
<tr><td>

<img src="./media/image269.png" width="44" height="44">

</td><td>

**Play/Pause** starts or stops the animation.

</td></tr>
<tr><td>

<img src="./media/image201.jpg" width="44" height="44">

</td><td>

**Go to next** jumps to the next timestamp or the end of the animation.

</td></tr>
<tr><td>

<img src="./media/image270.png" width="44" height="44">

</td><td>

**Go to last** jumps to the last keyframe.

</td></tr>
<tr><td>

<img src="./media/image202.png" width="118" height="44">

</td><td>

**Animation timeline/slider**: drag to move the animation to the required point in time.

</td></tr>
<tr><td>

<img src="./media/image203.png" width="224" height="44">

</td><td>

**Timestamp** drop-down menu: select a timestamp to jump to.

</td></tr>
<tr><td>

<img src="./media/image204.png" width="114" height="44">

</td><td>

**Speed** drop-down menu: select the playback speed.

</td></tr>
<tr><td>

<img src="./media/ButtonZoomIn.png" width="44" height="44">

</td><td>

**Zoom in** zooms in on the timeline.

</td></tr>
<tr><td>

<img src="./media/ButtonZoomOut.png" width="44" height="44">

</td><td>

**Zoom out** zooms out on the timeline.

</td></tr>
<tr><td>

<img src="./media/image207.png" width="44" height="44">

</td><td>

**Zoom to fit** fits so the whole timeline is visible.

</td></tr>
</table>

## Animation Editor

<img src="./media/image208.png" width="729" height="73"> 

<table>
<tr><td>

</td><td>

</td></tr>

<tr><td>

<img src="./media/ButtonInspect.png" width="44" height="44">

</td><td>

**Player** goes back to animation player.

</td></tr>
<tr><td>

<img src="./media/image209.png" width="44" height="44">

</td><td>

**Magic keyframe** creates a keyframe for all currently placed objects that are selected in the animation editor hierarchy, using their current settings.

</td></tr>
<tr><td>

<img src="./media/ButtonFiveSeconds.png" width="44" height="44">

</td><td>

**Magic keyframe delay** sets the automatic delay that is added between magic keyframes. You can enter values such as `2.5 s`, `5 s`, `10 s`, or `1 min`.

</td></tr>
<tr><td>

<img src="./media/image269.png" width="44" height="44">

</td><td>

**Play/Pause** starts or stops the animation.

</td></tr>
<tr><td>

<img src="./media/image271.png" width="44" height="44">

</td><td>

**Expand/Collapse** brings up extended animation tools or closes them.

</td></tr>
<tr><td>

<img src="./media/image212.png" width="44" height="44">

</td><td>

**Add keyframe** adds a keyframe for the selected animation parameter.

</td></tr>
<tr><td>

<img src="./media/image213.png" width="44" height="44">

</td><td>

**Remove keyframe** removes the selected keyframe.

</td></tr>
<tr><td>

<img src="./media/image214.png" width="44" height="44">

</td><td>

**Remove parameter** removes the selected parameter row.

</td></tr>
<tr><td>

<img src="./media/image215.png" width="44" height="44">

</td><td>

**Transition curve view** shows the transition curves, including lines and splines, between values. Drag them to change their shape.

</td></tr>
<tr><td>

<img src="./media/ButtonZoomIn.png" width="44" height="44">

</td><td>

**Zoom in** zooms in on the timeline, centring on the currently selected position marked by the red line.

</td></tr>
<tr><td>

<img src="./media/ButtonZoomOut.png" width="44" height="44">

</td><td>

**Zoom out** zooms out on the timeline.

</td></tr>
<tr><td>

<img src="./media/ButtonAutoLabeling.png" width="44" height="44">

</td><td>

**Add timestamp**: drag and drop this button onto the timeline to create a new timestamp. A dialogue box then appears, allowing you to name the new timestamp. If you drag an existing timestamp, this icon changes into a bin icon. Dragging timestamps into it deletes them.

</td></tr>
<tr><td>

<img src="./media/image207.png" width="44" height="44">

</td><td>

**Zoom to fit** adjusts the view to display the entire timeline.

</td></tr>
</table>

### Timeline View

<table>
<tr><td>

<img src="./media/image217.png" width="177" height="168">

</td><td>

**Project tree** contains all items, parameters etc. involved in this animation.

</td></tr>
<tr><td>

<img src="./media/image218.png" width="78" height="105">

</td><td>

Displays all **Parameters** of the currently selected item in the project tree at the current timeline position. You can edit these parameters by clicking on their values.

</td></tr>
<tr><td>

<img src="./media/image219.png" width="144" height="194">

</td><td>

**Timeline**

The red line is the time slider and shows the current animation position. Drag it to change the current point in time. The blue dots are parameter keyframes for the adjacent item in the project tree; drag them to adjust their positions.

</td></tr>
</table>

## Saving the Animation
**(licence for sketching is needed)**

To save any work on animations, a sketching licence is required. An exception is the animation data from 4D System, which can be loaded and saved without a licence. Animations can be saved as **.upvf** files.

## Creating an Animation Example

1. Create a **Sketch** and place any sketch object, for example a Liebherr crane from the sketch catalogue.

2. Create an **Animation** in the same menu while the sketch is active.

3. Select the sketch object and create an animation keyframe by pressing the **Magic keyframe** button.

<img src="./media/image220.png" width="650" height="454">

4. Move the crane to the required position and press the **Magic keyframe** button again.

<img src="./media/image221.png" width="650" height="454">

5. The animation can now be played in **Player** or **Edit** mode.