Модуль 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), определяет область скриншота. По умолчанию захватывает весь экран.
Пример кода:
Пример
# Захват всего экрана
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。
Пример кода:
Пример
# Получить изображение из буфера обмена
clipboard_image = ImageGrab.grabclipboard()
if clipboard_image:
clipboard_image.save("clipboard_image.png")
else:
print("В буфере обмена нет данных изображения")
ImageGrab.grab_to_file()(Устарело)
Примечание:
Этот метод устарел в более новых версиях Pillow. Рекомендуется использоватьgrab().save()в качестве замены.
Пример кода замены:
Пример
# Альтернативный подход: сначала grab(), затем save()
screenshot = ImageGrab.grab()
screenshot.save("screenshot.png")
Примеры практического применения
Инструмент создания скриншотов по расписанию
Пример
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
Пример
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()
Примечания
Кроссплатформенная поддержка:
- Windows: Полностью поддерживается.
- macOS: требуются дополнительные разрешения (включите терминал или IDE в
System Settings > Privacy & Security > Screen Recording). - Linux: зависит от
X11илиWayland, возможно, потребуется установитьscrotилиmaimи другие инструменты.
Оптимизация производительности:
- Частые скриншоты могут повлиять на производительность системы. Рекомендуется установить разумный интервал между скриншотами.
Обработка изображений:
- Полученное изображение можно напрямую обработать с помощью других модулей Pillow (таких как
ImageFilter) для дальнейшей обработки.
- Полученное изображение можно напрямую обработать с помощью других модулей Pillow (таких как
Надеюсь, этот учебник поможет вам быстро освоитьImageGrabиспользование модуля!