Document mct and no_jp2 options for saving JPEG 2000

This commit is contained in:
Hugo van Kemenade 2022-03-31 22:19:00 +03:00
parent 698f52916e
commit e0de5b67ce
2 changed files with 21 additions and 5 deletions

View File

@ -513,6 +513,8 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
Reversible Color Transformation. MCT works best with a ``mode`` of Reversible Color Transformation. MCT works best with a ``mode`` of
``RGB`` and is only applicable when the image data has 3 components. ``RGB`` and is only applicable when the image data has 3 components.
.. versionadded:: 9.1.0
**progression** **progression**
Controls the progression order; must be one of ``"LRCP"``, ``"RLCP"``, Controls the progression order; must be one of ``"LRCP"``, ``"RLCP"``,
``"RPCL"``, ``"PCRL"``, ``"CPRL"``. The letters stand for Component, ``"RPCL"``, ``"PCRL"``, ``"CPRL"``. The letters stand for Component,
@ -536,6 +538,8 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
saving, otherwise the extension of the filename will be used to determine saving, otherwise the extension of the filename will be used to determine
the format (default). the format (default).
.. versionadded:: 9.1.0
.. note:: .. note::
To enable JPEG 2000 support, you need to build and install the OpenJPEG To enable JPEG 2000 support, you need to build and install the OpenJPEG

View File

@ -146,12 +146,24 @@ At present, the information within each block is merely returned as a dictionary
"data" entry. This will allow more useful information to be added in the future without "data" entry. This will allow more useful information to be added in the future without
breaking backwards compatibility. breaking backwards compatibility.
Added rawmode argument to Image.getpalette() Added mct and no_jp2 options for saving JPEG 2000
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
By default, :py:meth:`~PIL.Image.Image.getpalette` returns RGB data from the palette. The :py:meth:`PIL.Image.Image.save` method now supports the following options for
A ``rawmode`` argument has been added, to allow the mode to be chosen instead. ``None`` JPEG 2000:
can be used to return data in the current mode of the palette.
**mct**
If ``1`` then enable multiple component transformation when encoding,
otherwise use ``0`` for no component transformation (default). If MCT is
enabled and ``irreversible`` is ``True`` then the Irreversible Color
Transformation will be applied, otherwise encoding will use the
Reversible Color Transformation. MCT works best with a ``mode`` of
``RGB`` and is only applicable when the image data has 3 components.
**no_jp2**
If ``True`` then don't wrap the raw codestream in the JP2 file format when
saving, otherwise the extension of the filename will be used to determine
the format (default).
Added PyEncoder Added PyEncoder
^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^