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
# 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ückgegeben
PIL.ImageObjekt. - Andernfalls wird zurückgegeben
None。
Beispielcode:
Beispiel
# 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
# Alternativer Ansatz: zuerst grab() dann save()
screenshot = ImageGrab.grab()
screenshot.save("screenshot.png")
Praktische Anwendungsbeispiele
Zeitgesteuertes Screenshot-Tool
Beispiel
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
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
Plattformübergreifende Unterstützung:
- Windows: Vollständig unterstützt.
- macOS: Zusätzliche Berechtigungen erforderlich (aktivieren Sie das Terminal oder die IDE in
System Settings > Privacy & Security > Screen Recording). - Linux: Hängt ab von
X11oderWayland, muss möglicherweise installiert werdenscrotodermaimund andere Tools.
Leistungsoptimierung:
- Häufige Screenshots können die Systemleistung beeinträchtigen. Es wird empfohlen, ein angemessenes Screenshot-Intervall festzulegen.
Bildverarbeitung:
- Das aufgenommene Bild kann direkt mit anderen Pillow-Modulen (wie z. B.
ImageFilter) weiterverarbeitet werden.
- Das aufgenommene Bild kann direkt mit anderen Pillow-Modulen (wie z. B.
Ich hoffe, dieses Tutorial hilft Ihnen, schnellImageGrabdie Verwendung des Moduls zu meistern!