Keyframe Animation#

Setting Keyframes#

Let’s get moving!

Most parameters in Embergen can have keyframe animation. This means you can set values on specific frames resulting in a parameter that can change over time.

Let’s say we want our sphere to move up and down.

That means we have to alter its Z-position over time.

Select the Shape: Primitive node and find the Position parameter in the Node Details tab.

Click on the circle next to it to set the override state for the parameter to Timeline Override.
Clicking on the icon next to the parameter will cycle through the different types of override states. So if you now want to get back to No Override, for example, you have to click the icon twice.

A couple of things happen when setting the override state to Timeline Override.

The parameter shows up in the Timeline tab.

The parameter shows up in the Timeline Editor.

Let’s make our sphere go up and down using keyframes!

You can add a keyframe by Double-Clicking or Shift-Clicking in the Timeline Editor.

You can also set a keyframe by changing the parameter value. Moving the sphere in the viewport or altering the value in the properties panel will set a keyframe on the frame specified by the blue playhead.

There we have it, a sphere moving up and down!

Timeline Editor#

First, let’s fit the keyframes nicely in our timeline editor. You can do this by using the icons in the top right corner.

Pan and zoom the timeline to perfectly fit all the keyframes in view.
Pan and zoom the timeline to perfectly fit the selected keyframes in view.
Reset the vertical zoom to default in the Curve Editor.
Toggle the panel to fullscreen if you want to edit your keyframes with the maximum screen space.

Using the timeline editor you can edit your keyframes to your liking. Let’s have a look at all the stuff we can do here.

Pan the timeline by holding down the middle mouse button and dragging or by using the scrollbar at the top of the timeline editor.
Zooming the timeline by holding down Ctrl and scrolling. Note that the pivot for zooming is at your cursor’s location.
Create a keyframe by double-clicking or shift-clicking.
Move keyframes around by LMB and dragging.
Box-select multiple keyframes by LMB and dragging.
Select multiple keyframes holding down Ctrl + LMB.
Select all keyframes with Ctrl + A
Copy keyframes with the right-click menu or Ctrl + C
Cut keyframes with the right-click menu or Ctrl + X
Paste keyframes with the right-click menu or Ctrl + V
Delete keyframes with the right-click menu or the Delete key.
Shift + Alt + LMB drag to scale your keyframe animation pivoting from the first keyframe. This can be helpful if you want to retime a part of your animation.
Aligning keyframes left or right by right-clicking a selection of keyframes and picking an option from the align menu. When putting keyframes on multiple parameters aligning can help to tidy up and perfect your timeline.
- Left will move all the selected keyframes to the position of the first keyframe.
- Right will move all the selected keyframes to the position of the last keyframe.

Curve Editor#

The Curve Editor can be toggled using

This editor gives a visual representation of where the values are going over time.

All the controls for the timeline editor apply here as well, but there are some extra things you can do.

Zoom the timeline vertically by holding down Ctrl + Shift and scrolling. By zooming in vertically you can more clearly view smaller changes in the graph.
Move the graph vertically offsetting all the keyframe values using Ctrl + Shift clicking and dragging.

Change the Interpolation Mode of the keyframes in the right-click menu.

The Interpolation Mode defines the method of interpolating the values from one keyframe to another.

Note that you can mix different interpolation modes on different keyframes.

The interpolation mode of the first (or left) keyframe will be used between two keyframes with different interpolation modes.
There are a few options:
- Constant will fully change the value when reaching a keyframe without any in-between values. This is the default for animating checkboxes and dropdown menus since they don’t have any in-between values.
- Linear will draw a straight line from one keyframe to another in the Curve Editor. Values will move from one keyframe to another with a constant speed.
- Smooth will generate a smooth line based from one keyframe to another. This avoids having hard transitions in values.
- Bézier will interpolate the values based on the bézier handles. When using this mode you can see the bézier handles when selecting a single keyframe. You can change the interpolation by LMB and dragging the dots at the end of the bézier handles. A flat part of the curve means the values change slowly and a steep part of the curve means the values change quickly.
  There are a few handle types you can use also found in the right-click menu.
  
  Aligned The handles can be moved freely and can have any direction and length. For this type, one handle is always in the inverted direction and has the same length as the other one.
  
  Free The handles can be moved in any way separate from each other.
  
  Auto Clamped This is the default behavior. For this type, the handles can never go beyond the previous or next keyframe. Note that when changing the handles the type will be set to Aligned.
  
  Auto Vectored This will point the left handle towards the previous keyframe and the right handle towards the next keyframe. Note that when changing the handles the type will be set to Free.
  You can always reset the bezier handles to default for the selected keyframes by clicking on Reset Handle in the right-click menu.
When in the Curve Editor two more options are added to the Align menu:
- Top will move all the selected keyframes up to the same value as the keyframe with the highest value.
- Bottom will move all the selected keyframes down to the same value as the keyframe with the lowest value.
With multiple keyframes selected you can find the Fit View options in the right-click menu to fit the selected keyframes to view either horizontally, vertically, or both.