pyAPNG

.. image:: https://travis-ci.org/eight04/pyAPNG.svg?branch=master :target: https://travis-ci.org/eight04/pyAPNG

.. image:: https://readthedocs.org/projects/pyapng/badge/?version=latest :target: http://pyapng.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status

A Python module to deal with APNG file.

Features

• Merge multiple images into one APNG file. (It use Pillow to convert images 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 <https://github.com/python-pillow/Pillow>__ - Optional. You can still use pyAPNG without PIL but it can only read PNG files.

Development dependencies

• pngcheck <http://www.libpng.org/pub/png/apps/pngcheck.html>_
• See requirements.txt for other dev-dependencies.

Installation

From pypi <https://pypi.org/project/apng/>__::

pip install apng

Usage

Convert a series of images into APNG animation:

.. code:: python

from apng import APNG

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

Use different delays:

.. code:: python

from apng import APNG

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

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

Extract frames from an APNG file:

.. code:: python

from apng import APNG

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

Add a text chunk to the PNG file:

.. code:: python

from apng import PNG, make_text_chunk

im = PNG.open("image.png") im.chunks.append(make_text_chunk(key="Comment", value="Some text")) im.save("image.png")

Performance

If you want to convert some large JPGs into animation, the library has to convert your JPGs into PNGs then merge them into a single animation APNG file. The problems are:

1. It is extremely slow.
2. The file size of the APNG is extremely large. Probably 5x of the original or more.

In this case, I suggest trying an animation format called "ugoira", which is implemented by Pixiv.net. There is also an image viewer named "HoneyView" which can view it locally.

Document

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

Todos

• Add optimizer?

Changelog

• 0.3.4 (Mar 11, 2020)

  • Fix: exclude test files from the package.

• 0.3.3 (Feb 11, 2019)

  • Fix: failed to extract frames containing multiple fdAT chunks.

• 0.3.2 (Jul 20, 2018)

  • Add: make_text_chunk function.
  • Add: Chunk data class.
  • Change: now parse_chunks yields Chunk instead of a tuple. This should be safe since Chunk is a namedtuple.

• 0.3.1 (May 13, 2018)

  • Add: universal wheel.

• 0.3.0 (May 13, 2018)

  • Support Python 2.
  • Add: PNG method open_any, from_bytes.
  • Add: APNG method append_file, from_bytes.
  • Add: module function parse_chunks.
  • Drop: module function is_png and chunks.
  • Change: PNG.open now only reads PNG images. To read non-PNG images, use PNG.open_any.
  • Change: APNG.append now only accepts PNG instance. To append PNG files, use APNG.append_file.

• 0.2.1 (Apr 19, 2018)

  • Add: support num_plays. (#4 <https://github.com/eight04/pyAPNG/issues/4>_)

• 0.2.0 (Dec 8, 2017)

  • Add test.
  • Add documents.
  • Add: support path-like object.
  • Fix: some chunks must appear before IDAT. (#1 <https://github.com/eight04/pyAPNG/issues/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 <https://github.com/eight04/pyAPNG/pull/2>_)

• 0.1.0 (May 30, 2016)

  • First release.