Skip to content

Commit

Permalink
Merge pull request #8504 from radarhere/mpo
Browse files Browse the repository at this point in the history
Move MPO into "Fully supported formats"
  • Loading branch information
hugovk authored Oct 26, 2024
2 parents 35ddbb4 + e1f4b5a commit 81a3bf5
Showing 1 changed file with 24 additions and 24 deletions.
48 changes: 24 additions & 24 deletions docs/handbook/image-file-formats.rst
Original file line number Diff line number Diff line change
Expand Up @@ -692,6 +692,30 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
you fail to do this, you will get errors about not being able to load the
``_imaging`` DLL).

MPO
^^^

Pillow reads and writes Multi Picture Object (MPO) files. When first opened, it loads
the primary image. The :py:meth:`~PIL.Image.Image.seek` and
:py:meth:`~PIL.Image.Image.tell` methods may be used to read other pictures from the
file. The pictures are zero-indexed and random access is supported.

.. _mpo-saving:

Saving
~~~~~~

When calling :py:meth:`~PIL.Image.Image.save` to write an MPO file, by default
only the first frame of a multiframe image will be saved. If the ``save_all``
argument is present and true, then all frames will be saved, and the following
option will also be available.

**append_images**
A list of images to append as additional pictures. Each of the
images in the list can be single or multiframe images.

.. versionadded:: 9.3.0

MSP
^^^

Expand Down Expand Up @@ -1435,30 +1459,6 @@ Note that there may be an embedded gamma of 2.2 in MIC files.

To enable MIC support, you must install :pypi:`olefile`.

MPO
^^^

Pillow identifies and reads Multi Picture Object (MPO) files, loading the primary
image when first opened. The :py:meth:`~PIL.Image.Image.seek` and :py:meth:`~PIL.Image.Image.tell`
methods may be used to read other pictures from the file. The pictures are
zero-indexed and random access is supported.

.. _mpo-saving:

Saving
~~~~~~

When calling :py:meth:`~PIL.Image.Image.save` to write an MPO file, by default
only the first frame of a multiframe image will be saved. If the ``save_all``
argument is present and true, then all frames will be saved, and the following
option will also be available.

**append_images**
A list of images to append as additional pictures. Each of the
images in the list can be single or multiframe images.

.. versionadded:: 9.3.0

PCD
^^^

Expand Down

0 comments on commit 81a3bf5

Please sign in to comment.