Pillow/docs/releasenotes/6.1.0.rst
2019-06-29 17:47:55 +10:00

48 lines
1.6 KiB
ReStructuredText

6.1.0
-----
API Additions
=============
ImageGrab.grab
^^^^^^^^^^^^^^
An optional ``include_layered_windows`` parameter has been added to ``ImageGrab.grab``,
defaulting to ``False``. If true, layered windows will be included in the resulting
image on Windows.
ImageSequence.all_frames
^^^^^^^^^^^^^^^^^^^^^^^^
A new method to facilitate applying a given function to all frames in an image, or to
all frames in a list of images. The frames are returned as a list of separate images.
For example, ``ImageSequence.all_frames(im, lambda im_frame: im_frame.rotate(90))``
could used to return all frames from an image, each rotated 90 degrees.
Variation fonts
^^^^^^^^^^^^^^^
Variation fonts are now supported, allowing for different styles from the same font
file. ``ImageFont.FreeTypeFont`` has four new methods,
:py:meth:`PIL.ImageFont.FreeTypeFont.get_variation_names` and
:py:meth:`PIL.ImageFont.FreeTypeFont.set_variation_by_name` for using named styles, and
:py:meth:`PIL.ImageFont.FreeTypeFont.get_variation_axes` and
:py:meth:`PIL.ImageFont.FreeTypeFont.set_variation_by_axes` for using font axes
instead. An ``IOError`` will be raised if the font is not a variation font. FreeType
2.9.1 or greater is required.
Other Changes
=============
ImageTk.getimage
^^^^^^^^^^^^^^^^
This function is now supported. It returns the contents of an ``ImageTk.PhotoImage`` as
an RGBA ``Image.Image`` instance.
Top To Bottom Complex Text Rendering
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Drawing text in the 'ttb' direction with ImageFont has been significantly improved
and requires Raqm 0.7 or greater.