mirror of
https://github.com/python-pillow/Pillow.git
synced 2024-12-27 02:16:19 +03:00
38 lines
1.3 KiB
ReStructuredText
38 lines
1.3 KiB
ReStructuredText
.. py:module:: PIL.ImageGrab
|
|
.. py:currentmodule:: PIL.ImageGrab
|
|
|
|
:py:mod:`ImageGrab` Module (macOS and Windows only)
|
|
===================================================
|
|
|
|
The :py:mod:`ImageGrab` module can be used to copy the contents of the screen
|
|
or the clipboard to a PIL image memory.
|
|
|
|
.. note:: The current version works on macOS and Windows only.
|
|
|
|
.. versionadded:: 1.1.3
|
|
|
|
.. py:function:: PIL.ImageGrab.grab(bbox=None, include_layered_windows=False)
|
|
|
|
Take a snapshot of the screen. The pixels inside the bounding box are
|
|
returned as an "RGB" image on Windows or "RGBA" on macOS.
|
|
If the bounding box is omitted, the entire screen is copied.
|
|
|
|
.. versionadded:: 1.1.3 (Windows), 3.0.0 (macOS)
|
|
|
|
:param bbox: What region to copy. Default is the entire screen.
|
|
:param include_layered_windows: Includes layered windows. Windows OS only.
|
|
:return: An image
|
|
|
|
.. py:function:: PIL.ImageGrab.grabclipboard()
|
|
|
|
Take a snapshot of the clipboard image, if any.
|
|
|
|
.. versionadded:: 1.1.4 (Windows), 3.3.0 (macOS)
|
|
|
|
:return: On Windows, an image, a list of filenames,
|
|
or None if the clipboard does not contain image data or filenames.
|
|
Note that if a list is returned, the filenames may not represent image files.
|
|
|
|
On Mac, an image,
|
|
or None if the clipboard does not contain image data.
|