APNG Specification: Difference between revisions

Jump to navigation Jump to search
m
out-of-order chunk error discussion is now redundant with error handling section
(add a section on error handling)
m (out-of-order chunk error discussion is now redundant with error handling section)
Line 32: Line 32:
== Error Handling ==
== Error Handling ==


APNG is designed to allow incremental display of frames before the entire image has been read. This implies that some errors may not be detected until partway through the animation. It is recommended that when an error is encountered decoders should discard all subsequent frames, stop the animation, and revert to displaying the placeholder image if possible. An error may be displayed to the user if appropriate.
APNG is designed to allow incremental display of frames before the entire image has been read. This implies that some errors may not be detected until partway through the animation. It is strongly recommended that when an error is encountered decoders should discard all subsequent frames, stop the animation, and revert to displaying the placeholder image. An error may be displayed to the user if appropriate.


= Structure =
= Structure =
Line 71: Line 71:
     ....
     ....


APNG viewers must abandon the APNG chunks in a datastream with out-of-order APNG chunks and display the placeholder image. APNG-aware PNG editors should restore them to correct order using the sequence numbers.
Decoders must treat out-of-order APNG chunks as an error. APNG-aware PNG editors should restore them to correct order using the sequence numbers.


== `acTL`: The Animation Control Chunk ==
== `acTL`: The Animation Control Chunk ==
18

edits

Navigation menu