This page is somewhat incomplete and quite possibly incorrect – use with caution. spacer

APNG tests

For all these tests, wait at least a second after all the images have downloaded, before checking that the rendered output is correct.

Test output conventions: A solid green 128×64 rectangle means success. Any red means failure. Anything else means you need to read the instructions. "Transparent" is indicated by a light yellow background.

Sections of the relevant specifications are sometimes quoted when they clarify the expected behaviour.

Please don't link directly to the images in this page, since they may get renamed and will break any such links.

You can download the script and the source data for this page.

Valid images

Basic cases

# Trivial static image.

This should be solid green.

spacer

(source)

# Trivial animated image - one frame; using default image.

This should be solid green.

spacer

(source)

# Trivial animated image - one frame; ignoring default image.

This should be solid green.

spacer

(source)

IDAT, fdAT splitting

There may be multiple IDAT chunks; if so, they shall appear consecutively with no other intervening chunks. The compressed datastream is then the concatenation of the contents of the data fields of all the IDAT chunks.

The compressed datastream is then the concatenation of the contents of the data fields of all the `fdAT` chunks within a frame.

# Basic split IDAT.

This should be solid green.

spacer

(source)

# Split IDAT with zero-length chunk.

This should be solid green.

spacer

(source)

# Basic split fdAT.

This should be solid green.

spacer

(source)

# Split fdAT with zero-length chunk.

This should be solid green.

spacer

(source)

Dispose ops

# APNG_DISPOSE_OP_NONE - basic.

This should be solid green.

spacer

(source)

# APNG_DISPOSE_OP_BACKGROUND - basic.

This should be transparent.

spacer

(source)

# APNG_DISPOSE_OP_BACKGROUND - final frame.

This should be solid green.

spacer

(source)

# APNG_DISPOSE_OP_PREVIOUS - basic.

This should be solid green.

spacer

(source)

# APNG_DISPOSE_OP_PREVIOUS - final frame.

This should be solid green.

spacer

(source)

# APNG_DISPOSE_OP_PREVIOUS - first frame.

This should be transparent.

spacer

(source)

Dispose ops and regions

# APNG_DISPOSE_OP_NONE in region.

This should be solid green.

spacer

(source)

# APNG_DISPOSE_OP_BACKGROUND before region.

This should be transparent.

spacer

(source)

# APNG_DISPOSE_OP_BACKGROUND in region.

This should be a solid blue rectangle containing a smaller transparent rectangle.

spacer

(source)

# APNG_DISPOSE_OP_PREVIOUS in region.

This should be solid green.

spacer

(source)

Blend ops

# APNG_BLEND_OP_SOURCE on solid colour.

This should be solid green.

spacer

(source)

# APNG_BLEND_OP_SOURCE on transparent colour.

This should be transparent.

spacer

(source)

# APNG_BLEND_OP_SOURCE on nearly-transparent colour.

This should be very nearly transparent.

spacer

(source)

# APNG_BLEND_OP_OVER on solid and transparent colours.

This should be solid green.

spacer

(source)

# APNG_BLEND_OP_OVER repeatedly with nearly-transparent colours.

This should be solid green.

spacer

(source)

Blending and gamma

# APNG_BLEND_OP_OVER

This should be solid slightly-dark green.

spacer

(source)

# APNG_BLEND_OP_OVER

This should be solid nearly-black.

spacer

(source)

Chunk ordering

# fcTL before acTL.

This should be solid green.

spacer

(source)

Delays

# Basic delays.

This should flash blue for half a second, then yellow for one second, then repeat.

spacer

(source)

# Rounding of division.

This should flash blue for half a second, then yellow for one second, then repeat.

spacer

(source)

# 16-bit numerator/denominator.

This should flash blue for half a second, then yellow for one second, then repeat.

spacer

(source)

# Zero denominator.

If the denominator is 0, it is to be treated as if it were 100

This should flash blue for half a second, then yellow for one second, then repeat.

spacer

(source)

# Zero numerator.

If the the value of the numerator is 0 the decoder should render the next frame as quickly as possible, though viewers may impose a reasonable lower bound.

This should flash cyan for a short period of time (perhaps zero), then magenta for the same short period of time, then blue for half a second, then yellow for one second, then repeat.

spacer

(source)

num_plays

# num_plays = 0

This should flash yellow for one second, then blue for one second, then repeat forever.

spacer

(source)

# num_plays = 1

When first loaded, this should flash yellow for one second, then stay blue forever.

spacer

(source)

# num_plays = 2

When first loaded, this should flash yellow for one second, then blue for one second, then yellow for one second, then blue forever.

spacer

(source)

Other depths and colour types

# 16-bit colour.

This should be dark blue.

spacer

(source)

# 8-bit greyscale.

This should be a solid grey rectangle containing a solid white rectangle.

spacer

(source)

# 8-bit greyscale and alpha, with blending.

This should be solid grey.

spacer

(source)

# 2-color palette.

This should be solid green.

spacer

(source)

# 2-bit palette and alpha.

This should be solid green.

spacer

(source)

# 1-bit palette and alpha, with blending.

This should be solid dark blue.

spacer

(source)

Invalid images

It is strongly recommended that when any error is encountered decoders should discard all subsequent frames, stop the animation, and revert to displaying the default image. A decoder which detects an error before the animation has started should display the default image. An error message may be displayed to the user if appropriate.

(If some decoders accept broken images, it seems quite possible that people will create and distribute broken images, and then the error-handling would have to be reverse-engineered by other implementations; hence all these tests to ensure errors get detected properly.)

For the following images, the default image (solid green) or an error should be displayed.

Incorrect chunks

# Missing acTL.

spacer

(source)

# Repeated acTL.

spacer

(source)

# acTL after IDAT.

spacer

(source)

# Missing fcTL.

Disabled for now, since it crashes Opera 9.5 alpha 1589 (bug 287173).

# Repeated fcTL.

spacer

(source)

# Missing fdAT.

spacer

(source)

num_frames

# num_frames = 0; no default image.

0 is not a valid value.

spacer

(source)

# num_frames = 0; ignoring default image.

0 is not a valid value.

spacer

(source)

# num_frames too low.

This must equal the number of `fcTL` chunks. ... If this value does not equal the actual number of frames it should be treated as an error.

spacer

(source)

# num_frames too high by 1.

This must equal the number of `fcTL` chunks. ... If this value does not equal the actual number of frames it should be treated as an error.

spacer

(source)

# num_frames too high by 2.

This must equal the number of `fcTL` chunks. ... If this value does not equal the actual number of frames it should be treated as an error.

spacer

(source)

# num_frames outside valid range.

an "unsigned int" shall be a 32-bit unsigned integer in network byte order limited to the range 0 to (2^31)-1

spacer

(source)

Sequence numbers

# Not starting from 0.

spacer

(source)

# Gap in sequence.

spacer

(source)

# Duplicated sequence number.

spacer

(source)

# Duplicated chunk.

spacer