DOCS
Editor

Frames & animation

Animate a small sprite, adjust its timing, and define named ranges.

The frame strip is at the bottom of the editor. Each thumbnail is a complete frame of the sprite, with its layers composited together. Click one to edit it.

Tutorial: animate the potion bubble

Start with the bottle from Your first sprite, or download the finished asset to inspect it. The finished asset already has four frames; start from your own one-frame bottle if you want to follow the steps below.

  1. On frame 1, select Highlights. Keep the two-pixel reflection at (5,9) and (5,10), and put the bubble at (8,11).
  2. Click Duplicate in the frame header. It copies the frame's pixels on every layer.
  3. On the new frame, erase only the bubble and draw it one pixel higher, at (8,10).
  4. Duplicate again, moving the bubble to (8,9), then once more to (8,8). You now have four frames with the same bottle and a rising bubble.
  5. Shift-click from the first thumbnail to the last to select the four frames. Click the duration button in the header (for example, 100 ms ▾), enter 150 in Duration (ms), and press Enter. The value applies to the selected frames.
  6. Press P to preview. The bubble rises and starts again. Press P to pause.

Keep the highlight in the same place in each frame. If you accidentally paint the bottle instead, check the active layer before continuing.

The potion animation with the Frame timing popup open, showing duration and default FPS controls.
Timing belongs to individual frames. Changing preview speed doesn't rewrite these durations. Click the image for full size.

Timing and onion skins

The duration button opens Frame timing. Editing Duration (ms) changes the selected frames. Default FPS controls timing for new blank frames; changing it alone doesn't retime existing ones. Use Use Default for Selected Frames or Apply Default to All Frames when you want that default applied to existing artwork. Duplicate keeps the copied frame's duration.

Toggle Onion to see adjacent frames while drawing. Previous is red; next is blue. Its arrow opens direction, opacity and draw-order options. Enable Show on top to see the guides over the current artwork; leave it off to draw them behind it. With the option off, an opaque background can hide the guides. They don't wrap around at the ends and don't appear in exported sprites or scene previews.

KuroganeSamurai during its attack, with red previous-frame and blue next-frame guides behind the current pose.
The attack poses make the neighboring frames easy to see. Enable Show on top when you need the guides over opaque pixels. Click the image for full size.

Organize the frames

  • Add inserts a blank frame after the active frame.
  • Duplicate copies selected frames as a block after the last selected frame.
  • Delete removes selected frames. You must keep at least one.
  • Shift-click selects a contiguous range; Cmd/Ctrl-click toggles individual frames.
  • Ctrl/Cmd-drag from a thumbnail to select a continuous span. The canvas shows the frame under the pointer. Drag back toward the starting frame to shrink the selection; cross it to select in the other direction. This replaces the previous frame selection.
  • Drag thumbnails without Ctrl/Cmd to reorder frames. A selected block moves together in timeline order. Dragging near an edge scrolls the strip in either mode.

Painting and selection operations affect all selected frames and layers. Click a single thumbnail without modifiers to return to editing one frame. Duplicate, delete and timing also use the selected frames; export scope is configured separately in the Export window. See editing several frames and layers before making a shared change across an animation.

Named animation ranges

A range names an inclusive span of frames in the same asset. For example, KuroganeSamurai contains Idle and Attack in one .pixart file.

Select the frames, then click All ▾ (or the current range name) in the frame header and New Range. First and last are filled from the earliest and latest selected frames. The range includes everything between them, even if your selection has gaps. Enter a name, adjust the boundaries if needed, select Loop / Once / Ping-pong, and press Create Range. For the potion, use Bubble, frames 1–4, and Loop.

Creating a range takes its frames out of older ranges. An overlap at either end shortens the older range. If it takes frames from the middle and leaves two separate pieces, the older range is deleted entirely. A fully covered range is deleted too. This removes the range definition; all artwork stays in the timeline.

For an existing Idle, frames 1–10:

New rangeWhat happens to Idle
Attack, 1–3Idle becomes 4–10
Attack, 8–12Idle becomes 1–7
Attack, 4–6Idle is deleted
Attack, 1–10Idle is deleted

One Undo removes the new range and restores every older range it changed. This takeover happens when you create a range; editing an existing range or reordering frames keeps the existing boundary behavior.

KuroganeSamurai with the Attack animation selected and its first frame, last frame and playback mode visible in the range popup.
Ranges refer to existing frames. They don't duplicate the artwork. Click the image for full size.

Clicking a thumbnail switches playback to a range containing that frame. A frame outside every range switches to All Frames. If ranges overlap, Pixart keeps the current range when it contains the frame; otherwise it chooses the first matching range in the dropdown.

You can also select a range from the Animation dropdown to preview only that span, or choose All Frames to preview the whole timeline. The previous/next buttons and comma/period keys stay within that choice. Save Range updates its definition; Delete Range deletes the definition and leaves the frames intact.

Ranges follow their boundary frames when you reorder the timeline. Frames inserted between those boundaries join the range. Deleting a boundary shrinks it to surviving frames; deleting its last remaining frame removes the range. Names must be unique, ignoring case.

Playback controls

Use previous, play/pause, stop and next in the header. Comma / period step frames and P toggles playback. Space stays assigned to canvas panning.

Loop repeats; Once plays through the final frame's hold and stops; Ping-pong travels forward and backward without holding the endpoints twice. The playback popup also has a preview-speed multiplier. A named range uses its saved mode; All Frames has its own preview mode.

Drawing or selecting a thumbnail pauses preview so you edit a fixed frame. This editor preview is independent from animation in your scene. To run the animation in a game, continue with runtime playback.

On this page