release notes, docs

This commit is contained in:
wiredfool 2016-10-03 07:05:03 -07:00
parent 90b1d68d80
commit 69ff457f2e
2 changed files with 36 additions and 1 deletions

View File

@ -540,6 +540,11 @@ Saving Tiff Images
The :py:meth:`~PIL.Image.Image.save` method can take the following keyword arguments:
**save_all**
If true, Pillow will save all frames of the image to a multiframe tiff document.
.. versionadded:: 3.4.0
**tiffinfo**
A :py:class:`~PIL.TiffImagePlugin.ImageFileDirectory_v2` object or dict
object containing tiff tags and values. The TIFF field type is
@ -659,9 +664,10 @@ DDS
DDS is a popular container texture format used in video games and natively
supported by DirectX.
Currently, only DXT1 and DXT5 pixel formats are supported and only in ``RGBA``
Currently, DXT1, DXT3, and DXT5 pixel formats are supported and only in ``RGBA``
mode.
.. versionadded:: 3.4.0 DXT3
FLI, FLC
^^^^^^^^

View File

@ -14,6 +14,20 @@ two times shorter window than ``BILINEAR``. It can be used for image reduction
providing the image downscaling quality comparable to ``BICUBIC``.
Both new filters don't show good quality for the image upscaling.
Deprecation Warning when Saving JPEGs
=====================================
JPEG images cannot contain an alpha channel. Pillow prior to 3.4.0
silently drops the alpha channel. With this release Pillow will now
issue a ``DeprecationWarning`` when attempting to save a ``RGBA`` mode
image as a JPEG. This will become an error in Pillow 3.7.
New DDS Decoders
================
Pillow can now decode DXT3 images, as well as the previously support
DXT1 and DXT5 formats. All three formats are now decoded in C code for
better performance.
Append images to GIF
====================
@ -26,3 +40,18 @@ Note that the ``append_images`` argument is only used if ``save_all`` is also
in effect, e.g.::
im.save(out, save_all=True, append_images=[im1, im2, ...])
Save multiple frame TIFF
========================
Multiple frames can now be saved in a TIFF file by using the ``save_all`` option.
e.g.::
im.save("filename.tiff", format="TIFF", save_all=True)
Image.core.open_ppm removed
===========================
The nominally private/debugging function ``Image.core.open_ppm`` has
been removed. If you were using this function, please use
``Image.open`` instead.