Divoom precision manufacturing

What an Animated WebP File Can Store Beyond the Individual Frames

Written by Divoom Professional Team

Updated on

An animated WebP stores more than a stack of pictures. It can say where each frame goes on a shared canvas, how many milliseconds it lasts, whether it blends into the existing picture or replaces part of it, and what happens to that area afterward. The file can also tell the player how often to repeat the sequence and supply a background color hint.

These details matter when a transparent sprite leaves a trail, a pause disappears after export, or the last frame behaves differently in two viewers. Start by separating the final picture you see from the instructions the player uses to assemble it.

The canvas defines the display area for the entire animation

The Google WebP container specification describes a canvas that persists across frames during a pass through the animation. An individual frame can contain an image smaller than the canvas, with an offset that places its rectangle inside the larger picture. For example, a 12 by 12 pixel sparkle can change in one corner of a 64 by 64 illustration while the rest of the image comes from earlier frame data.

This means a decoded frame rectangle is sometimes only an update. If you pull that rectangle out and open it by itself, you may see the sparkle without the background, even though the complete animation clearly has one. You need the frame position and the prior canvas state to reconstruct the picture. Some editors show a list of full visible frames, even when the exported file can use small patches.

Width and height answer a separate question from duration. The canvas describes the spatial extent. The frame count describes how many updates are stored. The per-frame times tell the player when to advance. Increasing the pause on one frame changes its intended display time without requiring the canvas to be larger.

Frame duration and loop count answer different questions

Each animated frame has a duration stored in milliseconds. With three frame durations of 100 ms, 100 ms and 800 ms, one pass has a nominal duration of one second. The last frame accounts for most of that time. An equal-timing preview would make all three images look equally important even though the exported animation gives the last one a longer hold.

A WebP timeline can give each frame a rectangle and delay plus compositing instructions

The loop setting belongs to the animation as a whole. A value of zero specifies indefinite looping. A finite setting specifies a finite number of passes. The format also leaves room for implementation differences at very short frame times. If a viewer seems to hurry through the sequence or rounds a short hold, compare a copy that uses visibly different delays and observe the file in the player that will actually show it.

When one export plays in a browser but a second copy seems to have lost the long hold, check that you are comparing the same file. An editor may show its source timeline while a device app shows a converted copy with fewer frames or different timing. Compare the exported file in an independent player before changing its frame times. If the browser preserves the hold and the device preview does not, investigate the import conversion first.

An export workflow that starts with numbered stills can preserve their order while losing their timing. Before handing off a file, check both a normal transition and the longest hold. If the animation returns to frame one before a brief label can be read, extend that frame's duration and export again before adding duplicate copies.

Transparency, blend and disposal each affect the next picture

The MDN image format guide lists transparency and animation among WebP's capabilities. Transparent pixels describe coverage within an image. The frame's blend instruction tells a decoder whether to composite that frame over the existing pixels or replace its rectangle. With blending, an empty pixel in an update can leave the old canvas visible. With replacement, the incoming pixel takes the old position in that rectangle, even if it has no visible color of its own.

Disposal determines what the player does with the current frame's rectangle before drawing the next one. It can leave that rectangle in place or fill it with the animation background color according to the container instructions. This difference can determine whether a moving object leaves a trail. If an old sprite position was never cleared and a new patch only draws the sprite at its next location, the old pixels can remain visible.

The animation background field is a canvas color hint and includes alpha. A surrounding page or viewer may also draw its own background behind transparent content. Test transparent edges against both light and dark surfaces so a faint halo or a missed clear is visible. For file inspection or remuxing, the Google webpmux documentation shows how the tool reports animation properties and accepts timing, offset, disposal and blend options for each frame.

Verify the export and the destination separately

Use a small example where failure is obvious. Draw a bright icon at two locations and let its second position hold long enough to inspect. Give the surrounding canvas a contrasting color or leave it transparent where intended. Open the exported file and check the first position, the hold at the second position, any marks left behind, and the return to the start. That sequence tests distinct container instructions using the same artwork.

If storage size is the problem, inspect how much the frames actually change. Our guide to why a pixel GIF gets large describes related questions about canvas and changing regions. WebP and GIF use different container and compression rules, so a file-size result from one format does not set the result for the other.

For a 64 by 64 pixel study, the Divoom Pixoo-64 II supplies a 64 by 64 display grid to plan around. The grid does not establish animated WebP support. Before uploading to it or another pixel display, check the exact app or device import route and whether it converts animations. A still at native grid size can help preview the design while you verify the separate animation workflow.

Divoom Pixoo-64Ⅱ WiFi 64x64 ピクセル アート LED ディスプレイ & ソーシャル メディア カウンター Divoom Pixoo-64 WiFi pixel art display with 64x64 LED panel. Social media counter, custom animations, clocks, and community art. App controlled frame. $113.99 USD $149.99 USD コード適用 BF26PIXOO64 Buy now

Lit Pixoo-64 II showing a pixel moon beside an active iMac animation workspace

Keep an editable source and keep a copy of the exact export you tested. If the importer changes the result, that pair gives you a way to compare frame delay, loop behavior and the final visible composition without redrawing the animation.

A thumbnail or file extension can tell you which file you selected but may show only the first visible image. If a file opens as a still in one app, compare it in a known animation-capable viewer. A still preview alone cannot tell you whether the file contains one frame, whether playback was stopped or whether the app ignored the animation chunks.

FAQs About Animated WebP Files

Do all WebP animation frames need the same duration?

No. Each frame can have a different duration in milliseconds. A longer hold can give one frame more time on screen while leaving the number of frames unchanged.

Is the size of a stored frame the size of the full picture?

No. A stored frame can update a smaller rectangle inside the shared canvas. The player uses its position and composition rules to produce the whole visible picture.

What does a loop count of zero mean?

It means the animation is intended to repeat indefinitely. The timing of a single pass still depends on the durations of its frames.

Why can a transparent frame leave old pixels behind?

A blended transparent pixel can leave the underlying canvas visible. If disposal or a later frame does not clear an old sprite position, those pixels can persist into the new picture.

Does still WebP support guarantee animated WebP playback?

No. The destination needs to handle animation and its timing and composition, and its import path can have separate restrictions. Test the exported animated file in the destination workflow.

Conclusion

Read an animated WebP as a canvas plus a timed list of updates. If the picture, pause or loop looks wrong, inspect the frame rectangle, duration, blend and disposal before changing the art. Then verify that the destination handles the resulting animation the way you expect.

Disclaimer: This content is for general information only and is not professional or medical advice, a safety guarantee, or permission to use third-party intellectual property. Follow official product instructions and obtain any required permissions before attempting DIY projects or modifications.

Editor's Recommendation