diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst index 61c7ed60746..f03bb6bb8fd 100644 --- a/docs/handbook/image-file-formats.rst +++ b/docs/handbook/image-file-formats.rst @@ -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 ^^^^^^^^ diff --git a/docs/releasenotes/3.4.0.rst b/docs/releasenotes/3.4.0.rst index ef4db33220a..a6512fc1287 100644 --- a/docs/releasenotes/3.4.0.rst +++ b/docs/releasenotes/3.4.0.rst @@ -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.