Модуль Pillow ImageGrab

ImageGrab позволяет пользователям захватывать экран или указанную область в виде изображения и сохранять его как файл изображения или выполнять дальнейшую обработку.

Модуль ImageGrab подходит для таких сценариев, как автоматизированное тестирование, помощь при записи экрана и распознавание изображений.

Способ импорта:

from PIL import ImageGrab

Основные методы ImageGrab

В следующей таблице перечислены основные методы модуля ImageGrab и их описания:

Метод Описание Parameters Возвращаемое значение
ImageGrab.grab() Захватить изображение всего экрана или указанной области bbox(Необязательно): кортеж, задающий область снимка экрана(x1, y1, x2, y2), по умолчанию — весь экран PIL.ImageObject
ImageGrab.grabclipboard() Получить изображение из системного буфера обмена Отсутствует PIL.ImageОбъект (если в буфере обмена есть изображение), в противном случаеNone
ImageGrab.grab_to_file() Захватить экран и сохранить напрямую в файл (устарело, рекомендуется использоватьgrab().save()) filename: Путь к файлу для сохранения Отсутствует

Подробное описание метода

ImageGrab.grab()

Функция:
Захватить изображение экрана или указанной области.

Parameters:

  • bbox(Необязательно): кортеж из четырёх элементов(x1, y1, x2, y2), определяет область скриншота. По умолчанию захватывает весь экран.

Пример кода:

Пример

from PIL import ImageGrab

# Захват всего экрана
screenshot = ImageGrab.grab()
screenshot.save("full_screen.png")

# Захват указанной области (от верхнего левого угла (100, 100) до нижнего правого (500, 500))
partial_screenshot = ImageGrab.grab(bbox=(100, 100, 500, 500))
partial_screenshot.save("partial_screen.png")

ImageGrab.grabclipboard()

Функция:
Получить данные изображения из системного буфера обмена (например, после создания скриншота и нажатияCtrl+Cскопированное изображение).

Возвращаемое значение:

  • Если буфер обмена содержит изображение, возвращаетPIL.Imageобъект.
  • В противном случае возвращаетNone。

Пример кода:

Пример

from PIL import ImageGrab

# Получить изображение из буфера обмена
clipboard_image = ImageGrab.grabclipboard()

if clipboard_image:
    clipboard_image.save("clipboard_image.png")
else:
    print("В буфере обмена нет данных изображения")

ImageGrab.grab_to_file()(Устарело)

Примечание:
Этот метод устарел в более новых версиях Pillow. Рекомендуется использоватьgrab().save()в качестве замены.

Пример кода замены:

Пример

from PIL import ImageGrab

# Альтернативный подход: сначала grab(), затем save()
screenshot = ImageGrab.grab()
screenshot.save("screenshot.png")

Примеры практического применения

Инструмент создания скриншотов по расписанию

Пример

import time
from PIL import ImageGrab

# Делать снимок экрана каждые 5 секунд, всего 3 раза
for i in range(3):
    screenshot = ImageGrab.grab()
    screenshot.save(f"screenshot_{i+1}.png")
    time.sleep(5)

Анализ экрана в реальном времени с OpenCV

Пример

import numpy as np
from PIL import ImageGrab
import cv2

# Захват и отображение экрана в реальном времени
while True:
    screenshot = ImageGrab.grab()
    img_np = np.array(screenshot)  # Преобразовать в массив NumPy
    cv2.imshow("Захват экрана", cv2.cvtColor(img_np, cv2.COLOR_RGB2BGR))
   
    if cv2.waitKey(1) & 0xFF == ord('q'):  # Нажмите 'q' для выхода
        break

cv2.destroyAllWindows()

Примечания

  1. Кроссплатформенная поддержка:

    • Windows: Полностью поддерживается.
    • macOS: требуются дополнительные разрешения (включите терминал или IDE вSystem Settings > Privacy & Security > Screen Recording).
    • Linux: зависит отX11илиWayland, возможно, потребуется установитьscrotилиmaimи другие инструменты.
  2. Оптимизация производительности:

    • Частые скриншоты могут повлиять на производительность системы. Рекомендуется установить разумный интервал между скриншотами.
  3. Обработка изображений:

    • Полученное изображение можно напрямую обработать с помощью других модулей Pillow (таких какImageFilter) для дальнейшей обработки.

Надеюсь, этот учебник поможет вам быстро освоитьImageGrabиспользование модуля!

Другие расширения