Pillow/docs/reference/ImageGrab.rst

57 lines
2.1 KiB
ReStructuredText
Raw Normal View History

2013-10-13 04:22:02 +04:00
.. py:module:: PIL.ImageGrab
.. py:currentmodule:: PIL.ImageGrab
:py:mod:`~PIL.ImageGrab` Module
===============================
2013-10-13 04:22:02 +04:00
The :py:mod:`~PIL.ImageGrab` module can be used to copy the contents of the screen
2013-10-13 04:22:02 +04:00
or the clipboard to a PIL image memory.
.. versionadded:: 1.1.3
2020-06-13 05:01:38 +03:00
.. py:function:: grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=None)
Take a snapshot of the screen. The pixels inside the bounding box are
returned as an "RGBA" on macOS, or an "RGB" image otherwise.
If the bounding box is omitted, the entire screen is copied.
On Linux, if ``xdisplay`` is ``None`` and the default X11 display does not return
a snapshot of the screen, ``gnome-screenshot`` will be used as fallback if it is
installed. To disable this behaviour, pass ``xdisplay=""`` instead.
2022-06-13 03:16:30 +03:00
.. versionadded:: 1.1.3 (Windows), 3.0.0 (macOS), 7.1.0 (Linux)
:param bbox: What region to copy. Default is the entire screen.
2019-09-20 18:35:08 +03:00
Note that on Windows OS, the top-left point may be negative if ``all_screens=True`` is used.
:param include_layered_windows: Includes layered windows. Windows OS only.
2019-09-27 01:58:32 +03:00
.. versionadded:: 6.1.0
2019-09-20 18:35:08 +03:00
:param all_screens: Capture all monitors. Windows OS only.
2019-09-27 01:58:32 +03:00
.. versionadded:: 6.2.0
2019-12-09 17:55:15 +03:00
2020-06-13 05:01:38 +03:00
:param xdisplay:
2020-07-10 00:50:57 +03:00
X11 Display address. Pass :data:`None` to grab the default system screen. Pass ``""`` to grab the default X11 screen on Windows or macOS.
2020-06-13 05:01:38 +03:00
You can check X11 support using :py:func:`PIL.features.check_feature` with ``feature="xcb"``.
2019-12-09 17:55:15 +03:00
2020-02-15 07:35:12 +03:00
.. versionadded:: 7.1.0
:return: An image
2020-06-13 05:01:38 +03:00
.. py:function:: grabclipboard()
Take a snapshot of the clipboard image, if any.
On Linux, ``wl-paste`` or ``xclip`` is required.
.. versionadded:: 1.1.4 (Windows), 3.3.0 (macOS), 9.4.0 (Linux)
: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.
On Linux, an image.