apng 0.2.1

A Python module to deal with APNG file.

A Python module to deal with APNG file.

Features

• Merge multiple images into one APNG file. (It use Pillow to convert image into PNG format)

• Read APNG file and extract each frames into PNG file.

• It doesn’t do any optimization but only concat the images. This might be changed in the future.

Dependencies

• Pillow - Optional. You can still use pyAPNG without PIL but it can only read PNG files.

Development dependencies

• pngcheck

• See requirements.txt for other dev-dependencies.

Install

pip install apng

Usage

Convert a series of images into APNG animation:

from apng import APNG

APNG.from_files(["1.jpg", "2.jpg", "3.jpg"], delay=100).save("result.png")

Use different delay:

from apng import APNG

files = [
    ("1.jpg", 100),
    ("2.jpg", 200),
    ("3.jpg", 300)
]

im = APNG()
for file, delay in files:
    im.append(file, delay=delay)
im.save("result.png")

Extract frames from APNG file:

from apng import APNG

im = APNG.open("animation.png")
i = 0
for png, control in im.frames:
    png.save("{i}.png".format(i=i))
    i += 1

Document

http://pyapng.readthedocs.io/en/latest/

Todos

• Add optimizer?

Changelog

• 0.2.1 (Apr 19, 2018)

  • Add: support num_plays. (#4)

• 0.2.0 (Dec 8, 2017)

  • Add test.

  • Add documents.

  • Add: support path-like object.

  • Fix: some chunks must appear before IDAT. (#1)

  • Fix: change chunks order in APNG. Some chunks are moved to the end of the file.

  • Fix: remove tRNS hack.

  • Fix: is_png shouldn’t move file pointer. (#2)

• 0.1.0 (May 30, 2016)

  • First release.