Módulo Pillow ImageGrab

ImageGrab permite a los usuarios capturar la imagen de la pantalla o de un área específica, guardarla como archivo de imagen o procesarla posteriormente.

El módulo ImageGrab es adecuado para escenarios como pruebas automatizadas, asistencia de grabación de pantalla, reconocimiento de imágenes, etc.

Método de importación:

from PIL import ImageGrab

Métodos principales de ImageGrab

La siguiente tabla enumera los métodos principales del módulo ImageGrab y su descripción:

Método Descripción Parámetros Valor de retorno
ImageGrab.grab() Captura la imagen de toda la pantalla o de un área especificada bbox(Opcional): tupla que especifica el área de captura(x1, y1, x2, y2), por defecto pantalla completa PIL.Imageobjeto
ImageGrab.grabclipboard() Obtiene una imagen del portapapeles del sistema Ninguno PIL.Imageobjeto (si el portapapeles tiene una imagen), de lo contrarioNone
ImageGrab.grab_to_file() Captura la pantalla y la guarda directamente en un archivo (obsoleto, se recomienda usargrab().save()) filename: la ruta del archivo guardado Ninguno

Explicación detallada de los métodos

ImageGrab.grab()

Función:
Captura la imagen de la pantalla o de un área especificada.

Parámetros:

  • bbox(Opcional): una tupla de cuatro elementos(x1, y1, x2, y2), que define el área de captura. Por defecto captura toda la pantalla.

Código de ejemplo:

Ejemplo

from PIL import ImageGrab

# Capturar toda la pantalla
screenshot = ImageGrab.grab()
screenshot.save("full_screen.png")

# Capturar un área específica (esquina superior izquierda (100, 100) a esquina inferior derecha (500, 500))
partial_screenshot = ImageGrab.grab(bbox=(100, 100, 500, 500))
partial_screenshot.save("partial_screen.png")

ImageGrab.grabclipboard()

Función:
Obtiene datos de imagen del portapapeles del sistema (por ejemplo, después de tomar una captura de pantalla y presionarCtrl+Cla imagen copiada).

Valor de retorno:

  • Si hay una imagen en el portapapeles, devuelvePIL.Imageobjeto.
  • De lo contrario, devuelveNone。

Código de ejemplo:

Ejemplo

from PIL import ImageGrab

# Obtener imagen del portapapeles
clipboard_image = ImageGrab.grabclipboard()

if clipboard_image:
    clipboard_image.save("clipboard_image.png")
else:
    print("No hay datos de imagen en el portapapeles")

ImageGrab.grab_to_file()(Obsoleto)

Nota:
Este método está obsoleto en las versiones más recientes de Pillow, se recomienda usargrab().save()como alternativa.

Código de reemplazo de ejemplo:

Ejemplo

from PIL import ImageGrab

# Alternativa: primero grab() y luego save()
screenshot = ImageGrab.grab()
screenshot.save("screenshot.png")

Ejemplos de aplicación práctica

Herramienta de captura de pantalla programada

Ejemplo

import time
from PIL import ImageGrab

# Tomar una captura cada 5 segundos, 3 veces en total
for i in range(3):
    screenshot = ImageGrab.grab()
    screenshot.save(f"screenshot_{i+1}.png")
    time.sleep(5)

Análisis de pantalla en tiempo real con OpenCV

Ejemplo

import numpy as np
from PIL import ImageGrab
import cv2

# Capturar la pantalla en tiempo real y mostrarla
while True:
    screenshot = ImageGrab.grab()
    img_np = np.array(screenshot)  # Convertir a un array de NumPy
    cv2.imshow("Screen Capture", cv2.cvtColor(img_np, cv2.COLOR_RGB2BGR))
   
    if cv2.waitKey(1) & 0xFF == ord('q'):  # Pulsar 'q' para salir
        break

cv2.destroyAllWindows()

Precauciones

  1. Soporte multiplataforma:

    • Windows: soporte completo.
    • macOS: se requieren permisos adicionales (enConfiguración del sistema > Privacidad y seguridad > Grabación de pantallahabilitar la terminal o el IDE).
    • Linux: depende deX11oWayland, puede ser necesario instalarscrotomaimherramientas como etc.
  2. Optimización del rendimiento:

    • Las capturas de pantalla frecuentes pueden afectar el rendimiento del sistema; se recomienda establecer intervalos de captura razonables.
  3. Procesamiento de imágenes:

    • La imagen capturada se puede procesar directamente con otros módulos de Pillow (comoImageFilter) para un procesamiento posterior.

Espero que este tutorial te ayude a dominar rápidamenteImageGrab¡el uso del módulo!

Otras extensiones