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
# 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, devuelve
PIL.Imageobjeto. - De lo contrario, devuelve
None。
Código de ejemplo:
Ejemplo
# 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
# 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
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
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
Soporte multiplataforma:
- Windows: soporte completo.
- macOS: se requieren permisos adicionales (en
Configuración del sistema > Privacidad y seguridad > Grabación de pantallahabilitar la terminal o el IDE). - Linux: depende de
X11oWayland, puede ser necesario instalarscrotomaimherramientas como etc.
Optimización del rendimiento:
- Las capturas de pantalla frecuentes pueden afectar el rendimiento del sistema; se recomienda establecer intervalos de captura razonables.
Procesamiento de imágenes:
- La imagen capturada se puede procesar directamente con otros módulos de Pillow (como
ImageFilter) para un procesamiento posterior.
- La imagen capturada se puede procesar directamente con otros módulos de Pillow (como
Espero que este tutorial te ayude a dominar rápidamenteImageGrab¡el uso del módulo!