Documentation

Animation

Bring your scene to life: make objects move, spin, grow, and fade over time. Animation lives in the Animation panel - a timeline shared by every object in the scene.

Clips and tracks

  • An animation clip is a named piece of motion on one object (for example “Bounce”). An object can have several clips.
  • Each clip contains property tracks - one for each thing you want to animate: Position, Rotation, Scale and Opacity (transparency).
The timeline - objects expand into property tracks with keyframe diamonds.

Adding a clip and keyframes

  1. In the Animation panel, click + next to an object to add a clip.
  2. Click + on the clip to add its four property tracks: Position, Rotation, Scale and Opacity. To remove one you do not need, right-click its name and choose Delete track, or click the × beside it. To bring one back, right-click the clip's name and choose Add track.
  3. Double-click the track at the time you want to add a keyframe, or right-click it there and choose Add keyframe here. A keyframe is a snapshot of the value at that moment, and two keyframes with different values create movement between them. Right-click an animation's own row to add a keyframe for every property it animates.
  4. Drag the diamond-shaped keyframes to change their timing.

Select a keyframe to edit its exact frame, its value (one number for Opacity, X, Y and Z for Position, Rotation and Scale) and its easing (how the motion speeds up or slows down: linear, ease in, ease out, ease in-out), or to delete it. Type a number and press Enter, or drag the X, Y or Z letter. Right-click a keyframe to delete it.

Choosing where to record

Click an animation name, its track, or a keyframe to select that animation and its object. The highlighted animation is the recording target. Clicking a name previews only that clip; the small checkboxes can add other clips to playback without changing the active target.

With the Animation panel open, turn on Auto-key, move the playhead, then move, rotate or scale the object using the viewport controls or Inspector fields, or change its Opacity in the Inspector. Each edit records the changed property in the active animation at that frame, frame 0 included; editing the same frame replaces its key. Recording never changes the object's own values. The + Key button (K) records a key for every property the active animation animates, opacity included, or Position, Rotation and Scale for an animation with no tracks yet, with the values shown at the playhead.

Dope Sheet and Graph share the active animation. Selecting another clip changes where new keys are recorded and clears the previous keyframe editor. While the Animation panel is open, the 3D view shows the animations at the playhead, frame 0 included, and turning Auto-key on or off never moves anything. With Auto-key off, a change to a property an animation moves stays shown until you move the playhead or press Play; press + Key (K) to keep it. An edit of a property no animation moves changes the object's own value; for an animated one, close the Animation panel.

Lots of objects? Turn on View selected at the top of the Animation panel to list only the animations of the selected objects. Click an object's name in the Dope Sheet to make it the active one: the others stay selected and listed. Select a Tracking image to see the animations of the objects inside it too. Your device remembers this choice.

Fading things in and out (opacity)

The Opacity track controls transparency, from 1 (solid) to 0 (invisible). Add an opacity track and set, say, opacity 0 at the start and 1 a second later to fade an object in. Drag the red playhead across the timeline to preview the fade live in the viewport. A model, picture, video or shape also has an Opacity slider in the Inspector: it sets how see-through the object is when no animation fades it, and a new opacity track starts from it. With Auto-key on, the slider adds an opacity key at the playhead instead.

To fade an object while the experience runs, without keys, use the Fade node: it fades in to the object's own opacity, or out until the object is hidden, and runs the next node when it has finished.

Playhead, loop and autoplay

  • Drag the playhead (the red line) to scrub through your animation and watch it in the viewport.
  • Play stops on the last frame and holds the pose; turn on Loop next to Play to start again from frame 0. This changes playback in the editor only, not each clip's own Loop.
  • Autoplay (▶ icon) starts the clip as soon as the scene begins. A clip started by a Play Animation action takes over what it animates from the clips already playing on that object, and when it ends the object stays on its last frame until another clip is played.
  • Loop (↻ icon) repeats it forever.
  • You can also start and stop clips on demand with Play Animation and Stop Animation actions - for example, play an animation when the user taps.

Curve editor

Switch the timeline to the Graph view to shape the exact motion curve of a value with draggable bezier handles - great for natural-feeling bounces and eases.

Animations baked into a model

If a 3D model was exported with its own animations (a walking character, a spinning part), they appear as Embedded rows. Toggle their autoplay/loop, or trigger them with a Play Animation action - AR Works plays the model's own animation directly. Embedded animations cannot receive transform keyframes; add a separate keyframe clip to animate the whole object.

The bone movement of an embedded animation can be copied into keys you can edit: see Making an imported animation editable below.

Posing a rigged model

A rigged model has an armature inside it: a skeleton of bones that bend the model, like the bones in your arm. Select one rigged model and use the Armature panel. It is a tab of the bottom panel, next to Animation: picking a bone opens it, except while the Animation tab is showing, so a bone you pose there keeps recording keys. To see both at once, drag one of them out as a window. Choose a Mode at the top:

  • Object: the model moves as one, as usual.
  • Pose: you turn and move its bones.
  • Weight paint: you paint how much each bone moves each part of the model. It is off for a model that has no skinned mesh to paint.

Picking and turning bones

Pick a bone in the Bones list, in the bone rows under the model in the Scene Hierarchy, or by clicking a bone row's name in the Animation panel. Picking a bone switches to Pose mode, where the joints show as small balls in the 3D view: click a joint to pick its bone. A model with lots of bones gets a Find a bone box.

The gizmo sits on the picked bone, with the Rotate tool chosen: drag a ring to turn the bone, and the bones further along (its children) follow, as your hand follows when you bend your elbow. Translate and Scale work too, or type exact numbers into Position, Rotation and Scale. Each drag is one undo step. Press Escape to let go of the bone, and again to go back to Object mode.

Reset bone puts the picked bone back the way the model's file has it. Reset pose does the same for every bone.

Animating bones

You animate bones with keys, just like objects, in the animation you are recording into. Key bone adds a key for the picked bone at the playhead. With the Animation panel open, pressing K in Pose mode does the same. With Auto-key on, every change you make to a bone adds a key by itself. With Auto-key off, a change sets the model's pose instead: the way it stands when no animation moves it.

Each bone that has keys gets its own rows under the animation in the Animation panel, one for each of Position, Rotation and Scale that has keys. Select, drag and delete those keys as usual. Keys very close together share one mark: zoom in to pick each one. Play Animation, Loop and Autoplay play bone keys in AR too. When an animation moves a bone, its fields are locked while you scrub: turn on Auto-key to change it.

Inverse kinematics (IK)

IK poses a whole chain of bones at once, the way your arm bends by itself when you reach for something. Pick the last bone of the chain (a hand or a foot), switch on Use IK and set Chain length: how many bones up from this one IK moves. Then click the small cube in the 3D view and drag its arrows: the chain bends to follow it. While IK is on, the bone has no gizmo of its own, so the cube is easy to click: switch IK off to turn the bone by hand again.

Note

IK is a posing tool in the editor. What plays in AR is the pose it made, or the keys it added with Auto-key on, never the cube itself.

Limit rotation

Limit rotation stops a bone turning too far, like a knee that bends only one way. Switch on X, Y or Z for the picked bone and set its Min and Max in degrees. From then on, the fields, the gizmo and IK keep to the limits. A pose or keys made before, and an animation copied with Make editable, stay as they are.

Weight paint

Each part of a rigged model follows one or more bones. In Weight paint mode you paint how strongly the picked bone pulls each part. The model shows that pull as colour: blue where the bone does not pull at all, green for half and red for full. Drag over the model to paint, with one of three Brush types:

  • Add gives the bone more pull.
  • Subtract gives it less.
  • Smooth evens out sharp changes between neighbouring points.

Radius sets the size of the brush and Strength how much each dab changes. Undo stroke and Redo stroke (or Ctrl+Z and Ctrl+Y) step back and forward through your last 50 strokes.

Painting changes the model in the editor only. Click Save as new copy to keep it: the painted model is saved as a new model in Assets, with “(weights)” after its name, and this object switches to it. Ctrl+Z switches it back, and the copy stays in Assets until you delete it. The old model stays in Assets as it was, and other objects that use it do not change. If you leave Weight paint without saving, you can save, discard or keep painting.

Note

Each point of the mesh keeps up to four bones. A model whose points follow more than four bones keeps only four in the saved copy.

Making an imported animation editable

The animations that come inside a rigged model (the Embedded rows) play the way the file has them. To change one, wait for the model to load, then click the pencil button on its row in the Animation panel, or Make editable in the Armature panel. This copies its bone movement into a new animation, with “(editable)” after its name, that you edit like any other: in Pose mode, with Key bone or Auto-key, and in its bone rows. The original stays as it is and can still be played.

Only bone movement is copied. Tiny wobbles are smoothed out so the copy fits in your project, and you will not see the difference. A very long animation may be too long to copy, and so may one that does not fit with the bone keys your project already has: you are told how many keys it would need. A model keeps bone keys in at most 256 animations, and a bone at most 2,000 keys in one animation: past that, nothing changes and you are told why. A bone that turns round too many times to store is left out of the copy, and you are told that too.