Sprite sheets — IngevoraMirage

Sprite sheetsA sprite sheet is one PNG image that holds every frame of an animation in a grid. Sprite layers play it frame by frame.Sprite layers

Product

Layer

Where it draws

Face lens

Animated sprite

On a face anchor, like a sticker, or Full frame, covering the whole picture

Screen effect

Full-screen sprite

The whole screen, with Fit: Contain or Cover

Screen effect

Sprite

Anywhere on the screen, placed like an image

An animated sprite starts by itself when Play when the lens starts is on. A screen effect's sprite that is visible at the start begins at its Start (ms). The Play sprite action plays any of them from the first frame.The sheet settings

Setting

Meaning

Frame width (px), Frame height (px)

The size of one frame, up to 1024 pixels

Frame count

How many frames, up to 256

Frames per second

From 1 to 60

Loop

Play again from the first frame, without end

After the last frame

Hold last frame, or Hide the layer. Used when Loop is off.

Frames run left to right, then top to bottom, from the top-left corner. Pixels left over at the right or bottom edge are ignored. The whole sheet must fit in 1024 × 1024 pixels, and its grid must hold at least Frame count frames; Validate reports a sheet that is too small.A sprite that is shown but not playing shows its first frame. A sprite that hid itself at its end comes back on its first frame when an action shows it, and plays from the first frame when an action plays it.The sprite sheet makerThe sprite sheet maker turns an animation into a sprite sheet inside the editor. Open it from:

the Assets tab: Create → Sprite sheet from GIF or video…, which adds a new layer;

a sprite layer's form: Make from GIF or video…, which fills that layer.

It reads:

a GIF;

a video: MP4, WebM or MOV (the sound is ignored);

an animated PNG, or an animated WebP in browsers that can read it;

several PNG frames, taken in name order (frame2 before frame10).

The source file can be up to 100 MB. It never leaves your computer: the sheet is built in your browser, and only the finished sheet is uploaded.The controlsThe dialog plays the finished sheet on a checkerboard, so transparency shows, and shows the first frame with a crop box.

Trim — where the animation starts and ends. A video is first read for its first 10 seconds at 12 fps; changing the trim or the fps reads it again.

Keep every Nth frame — fewer frames, with the fps lowered to match, so the animation keeps its length.

fps — from 1 to 60.

Largest frame side (px) — the most a frame may measure.

Crop — drag the box, or pick Original, Square or Portrait 9:16.

Loop — and, when it is off, At the end: Hold last frame or Hide.

Boomerang — play forward, then backward.

256 colours (smaller file) — one shared palette of 256 colours, with no dithering.

Add as (in a screen effect, from the Assets tab) — Full-screen sprite or Sprite. The maker suggests one from the source's transparency, and you can change it.

The maker first trims the transparent border that all frames share. Then it picks the grid with the biggest frames that fit in 1024 × 1024 pixels. It never makes frames bigger than the source.The readout and the budgetA readout shows the frames, the grid, the frame size, the length, the sheet's size in KB and your item's package total. Create is turned off when:

the package would pass its limit, with a message such as "Too big for this lens by … KB. Keep fewer frames, make frames smaller, or turn on 256 colours.";

there are more than 256 frames;

you opened the maker from the Assets tab and the item already has 8 layers.

Hints also warn you when frames come out under 96 pixels because the grid shrank them, and when an animation runs longer than its screen effect, so its end would be cut.CreateCreate uploads the sheet, named after the source file. Then, as one step you can undo, it either:

sets the image and sheet settings of the layer you opened it from, keeping that layer's other settings; or

adds a new layer with the sheet and selects it: an animated sprite on the face in a face lens, or the full-screen sprite or sprite you chose in a screen effect.

If the upload fails, the message shows and nothing changes.SizeA sheet counts toward the item's package limit: 2 MiB for a face lens, 3 MiB for a screen effect. Fewer frames, smaller frames and 256 colours all make a sheet smaller. See Rules and keep-out zones.