Pillow ImageGrab-Modul

ImageGrab ermöglicht es Benutzern, den Bildschirm oder einen bestimmten Bereich als Bild zu erfassen und es als Bilddatei zu speichern oder weiterzuverarbeiten.

Das ImageGrab-Modul eignet sich für Szenarien wie automatisiertes Testen, Unterstützung bei der Bildschirmaufzeichnung und Bilderkennung.

Importmethode:

from PIL import ImageGrab

ImageGrab-Kernmethoden

Die folgende Tabelle listet die Hauptmethoden des ImageGrab-Moduls und ihre Beschreibungen auf:

Methode Beschreibung Parameters Rückgabewert
ImageGrab.grab() Erfasst ein Bild des gesamten Bildschirms oder eines angegebenen Bereichs bbox(Optional): Tupel, das den Screenshot-Bereich angibt(x1, y1, x2, y2), standardmäßig auf den gesamten Bildschirm PIL.ImageObjekt
ImageGrab.grabclipboard() Ruft ein Bild aus der Systemzwischenablage ab Keine PIL.ImageObjekt (wenn die Zwischenablage ein Bild enthält), andernfallsNone
ImageGrab.grab_to_file() Erfasst den Bildschirm und speichert direkt in eine Datei (veraltet, es wird empfohlen,grab().save()) filename: Dateipfad zum Speichern Keine

Detaillierte Methodenbeschreibung

ImageGrab.grab()

Funktion:
Erfasst ein Bild des Bildschirms oder eines angegebenen Bereichs.

Parameters:

  • bbox(Optional): Ein Tupel mit vier Elementen(x1, y1, x2, y2), definiert den Screenshot-Bereich. Standardmäßig wird der gesamte Bildschirm erfasst.

Beispielcode:

Beispiel

from PIL import ImageGrab

# Den gesamten Bildschirm aufnehmen
screenshot = ImageGrab.grab()
screenshot.save("full_screen.png")

# Einen bestimmten Bereich erfassen (oben links (100, 100) bis unten rechts (500, 500))
partial_screenshot = ImageGrab.grab(bbox=(100, 100, 500, 500))
partial_screenshot.save("partial_screen.png")

ImageGrab.grabclipboard()

Funktion:
Bilddaten aus der Systemzwischenablage abrufen (z. B. nachdem ein Screenshot aufgenommen undCtrl+Ckopiertes Bild).

Rückgabewert:

  • Wenn die Zwischenablage ein Bild enthält, wird es zurückgegebenPIL.ImageObjekt.
  • Andernfalls wird zurückgegebenNone。

Beispielcode:

Beispiel

from PIL import ImageGrab

# Ein Bild aus der Zwischenablage abrufen
clipboard_image = ImageGrab.grabclipboard()

if clipboard_image:
    clipboard_image.save("clipboard_image.png")
else:
    print("Keine Bilddaten in der Zwischenablage")

ImageGrab.grab_to_file()(Veraltet)

Hinweis:
Diese Methode ist in neueren Versionen von Pillow veraltet. Es wird empfohlen,grab().save()sie als Ersatz zu verwenden.

Beispiel für Ersatzcode:

Beispiel

from PIL import ImageGrab

# Alternativer Ansatz: zuerst grab() dann save()
screenshot = ImageGrab.grab()
screenshot.save("screenshot.png")

Praktische Anwendungsbeispiele

Zeitgesteuertes Screenshot-Tool

Beispiel

import time
from PIL import ImageGrab

# Alle 5 Sekunden einen Screenshot aufnehmen, insgesamt 3 Mal
for i in range(3):
    screenshot = ImageGrab.grab()
    screenshot.save(f"screenshot_{i+1}.png")
    time.sleep(5)

Echtzeit-Bildschirmanalyse mit OpenCV

Beispiel

import numpy as np
from PIL import ImageGrab
import cv2

# Bildschirm in Echtzeit erfassen und anzeigen
while True:
    screenshot = ImageGrab.grab()
    img_np = np.array(screenshot)  # In NumPy-Array konvertieren
    cv2.imshow("Bildschirmaufnahme", cv2.cvtColor(img_np, cv2.COLOR_RGB2BGR))
   
    if cv2.waitKey(1) & 0xFF == ord('q'):  # Zum Beenden 'q' drücken
        break

cv2.destroyAllWindows()

Hinweise

  1. Plattformübergreifende Unterstützung:

    • Windows: Vollständig unterstützt.
    • macOS: Zusätzliche Berechtigungen erforderlich (aktivieren Sie das Terminal oder die IDE inSystem Settings > Privacy & Security > Screen Recording).
    • Linux: Hängt ab vonX11oderWayland, muss möglicherweise installiert werdenscrotodermaimund andere Tools.
  2. Leistungsoptimierung:

    • Häufige Screenshots können die Systemleistung beeinträchtigen. Es wird empfohlen, ein angemessenes Screenshot-Intervall festzulegen.
  3. Bildverarbeitung:

    • Das aufgenommene Bild kann direkt mit anderen Pillow-Modulen (wie z. B.ImageFilter) weiterverarbeitet werden.

Ich hoffe, dieses Tutorial hilft Ihnen, schnellImageGrabdie Verwendung des Moduls zu meistern!

Andere Erweiterungen