2013-10-13 04:22:02 +04:00
|
|
|
.. py:module:: PIL.ImageGrab
|
|
|
|
|
.. py:currentmodule:: PIL.ImageGrab
|
|
|
|
|
|
2013-10-13 09:17:45 +04:00
|
|
|
:py:mod:`ImageGrab` Module (Windows-only)
|
|
|
|
|
=========================================
|
2013-10-13 04:22:02 +04:00
|
|
|
|
|
|
|
|
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 Windows only.
|
|
|
|
|
|
|
|
|
|
.. versionadded:: 1.1.3
|
|
|
|
|
|
2013-10-13 20:56:33 +04:00
|
|
|
.. py:function:: PIL.ImageGrab.grab(bbox=None)
|
|
|
|
|
|
|
|
|
|
Take a snapshot of the screen. The pixels inside the bounding box are
|
|
|
|
|
returned as an "RGB" image. If the bounding box is omitted, the entire
|
|
|
|
|
screen is copied.
|
|
|
|
|
|
|
|
|
|
.. versionadded:: 1.1.3
|
|
|
|
|
|
|
|
|
|
:param bbox: What region to copy. Default is the entire screen.
|
|
|
|
|
:return: An image
|
|
|
|
|
|
|
|
|
|
.. py:function:: PIL.ImageGrab.grabclipboard()
|
|
|
|
|
|
|
|
|
|
Take a snapshot of the clipboard image, if any.
|
|
|
|
|
|
|
|
|
|
.. versionadded:: 1.1.4
|
|
|
|
|
|
|
|
|
|
:return: 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.
|
