Pillow-Beispiele für den Einstieg

Um Pillow zu verwenden, können Sie das Hauptmodul von Pillow folgendermaßen importieren:

from PIL import Image, ImageFilter, ImageDraw, ImageFont

Pillow behält die API-Kompatibilität mit PIL bei, was bedeutet, dass der meiste für PIL geschriebene Code direkt mit Pillow verwendet werden kann; ändern Sie einfach die Import-Anweisung vonimport PILzufrom PIL import ...。


Grundlegende Bildoperationen

Bild laden und anzeigen

Testbild (zum Testen lokal herunterladen):

Beispiel

from PIL import Image

# Bild öffnen (unterstützt JPEG, PNG, GIF usw.)
img = Image.open("tiger.jpeg")  

# Bild anzeigen (Standard-Bildbetrachter des Systems)
img.show()  

# Bildinformationen abrufen
print(Format:, img.format)  # JPEG/PNG
print(Größe:, img.size)    # (Breite, Höhe)
print(Modus:, img.mode)   # RGB/L/CMYK

Beispielausgabe:

格式: JPEG
尺寸: (987, 987)
模式: RGB

Erklärung:

  • Image.open()Liest die Bilddatei und gibt einImageObjekt.

  • show()Ruft den standardmäßigen Bildbetrachter des Systems auf, um das Bild anzuzeigen (nur zum Debuggen, nicht für die Produktion empfohlen).

  • format、size、modesind die Metadatenattribute des Bildes.

Bild speichern

Der folgende Code speichert das Bild als Dateien in verschiedenen Formaten: eine "example.png"-Datei, konvertiert in das PNG-Format, und eine "example_quality.jpg"-Datei mit auf 95 gesetzter JPEG-Qualität.

Beispiel

from PIL import Image

# Bild öffnen (unterstützt JPEG, PNG, GIF usw.)
img = Image.open("tiger.jpeg")  

# Bild anzeigen (Standard-Bildbetrachter des Systems)
img.show()  

# Bildinformationen abrufen
print(Format:, img.format)  # JPEG/PNG
print(Größe:, img.size)    # (Breite, Höhe)
print(Modus:, img.mode)   # RGB/L/CMYK

# Als verschiedene Formate speichern
img.save('example.png')  # In das PNG-Format konvertieren
img.save('example_quality.jpg', quality=95)  # JPEG-Qualität angeben

Bildformatkonvertierung

Beispiel

from PIL import Image

img = Image.open("tiger.jpeg")  
# In Graustufen konvertieren
gray_img = img.convert("L")  
gray_img.save("tiger_gray.png")  # Als PNG speichern

# In RGB konvertieren (auch wenn das Original RGBA ist)
rgb_img = img.convert("RGB")  
rgb_img.save("tiger_rgb.jpg", quality=95)  # Qualitätsparameter (1-100)
  • convert("L")Konvertiert das Bild in den Graustufenmodus (8-Bit-Schwarzweiß).
  • save()Sie können das Format angeben (über die Dateiendung oder den format-Parameter), und quality steuert die JPEG-Kompressionsqualität.

Bildverarbeitungsoperationen

Bild skalieren

Feste Höhe und Breite festlegen:

Beispiel

from PIL import Image

img = Image.open("tiger.jpg")

# Skalieren
resized_img = img.resize((400, 300))  
resized_img.save("cat_small.jpg")

# Miniaturbild erzeugen (Seitenverhältnis beibehalten)
img.thumbnail((200, 200))  # An Ort und Stelle ändern
img.save("cat_thumbnail.jpg")

Proportional skalieren

Skalierungsfaktor festlegen:

Beispiel

from PIL import Image

# Bild öffnen (unterstützt JPEG, PNG, GIF usw.)
img = Image.open("tiger.jpeg")  

# Proportional skalieren
width, height = img.size
scaled_image = img.resize((width//2, height//2))
scaled_image.show()

Bild zuschneiden und drehen

Beispiel

from PIL import Image

img = Image.open("tiger.jpeg")

# Zuschneiden (links, oben, rechts, unten)
cropped_img = img.crop((100, 100, 500, 400))  
cropped_img.save(""tiger_cropped.jpg")

# Drehen (90 Grad gegen den Uhrzeigersinn)
rotated_img = img.rotate(90, expand=True) # expand verhindert das Zuschneiden
rotated_img.save("
"tiger_rotated.jpg")

Ergebnis nach dem Zuschneiden:

Ergebnis nach der Drehung:

  • crop()Der Parameter gibt die Koordinaten des rechteckigen Bereichs an (oben links + unten rechts).

  • rotate(角度)Standardmäßig werden Ecken abgeschnitten, undexpand=Truedie Leinwandgröße wird automatisch angepasst.


Bildverbesserung und Filter

Filter anwenden

Beispiel

from PIL import Image, ImageFilter

img = Image.open("tiger.jpeg")

# Weichzeichner
blurred_image = img.filter(ImageFilter.BLUR)
blurred_image.show()

# Kantenverbesserung
edge_enhanced = img.filter(ImageFilter.EDGE_ENHANCE)
edge_enhanced.show()

Helligkeit und Kontrast anpassen

Beispiel

from PIL import Image, ImageEnhance

img = Image.open("tiger.jpeg")


# Helligkeit verbessern
enhancer = ImageEnhance.Brightness(img)
bright_image = enhancer.enhance(1.5)  # 1.5x Helligkeit
bright_image.show()

# Kontrast verbessern
enhancer = ImageEnhance.Contrast(img)
contrast_image = enhancer.enhance(2.0)  # 2x Kontrast
contrast_image.show()

Auf Bildern zeichnen

Grundlegende Formen zeichnen

Beispiel

from PIL import Image, ImageDraw

img = Image.open("tiger.jpeg")

# Zeichenobjekt erstellen
draw = ImageDraw.Draw(img)

# Rechteck zeichnen
draw.rectangle([(100, 100), (300, 300)], outline="red", width=5)

# Linie zeichnen
draw.line([(0, 0), (500, 500)], fill="blue", width=3)

# Kreis zeichnen
draw.ellipse([(200, 200), (400, 400)], outline="green", width=4)

img.show()

Das generierte Bild sieht wie folgt aus:

Text hinzufügen

Sie können Text zum Bild hinzufügen. Sie müssen einen Schriftartpfad festlegen oder die Systemvorgabe verwenden:

Beispiel

from PIL import Image, ImageDraw, ImageFont

img = Image.open("tiger.jpeg")

# Zeichenobjekt erstellen
draw = ImageDraw.Draw(img)

# Schriftart laden (die Schriftart muss auf dem System vorhanden sein)
font_size = 80  # Schriftgröße festlegen
try:
    font = ImageFont.truetype("arial.ttf", font_size)
except:
    font = ImageFont.load_default(font_size)
draw.text((150, 150), "Hello Example!", fill="red", font=font)

img.show()

Das generierte Bild sieht wie folgt aus:


Umfassendes Beispiel: Miniaturansicht erstellen und Wasserzeichen hinzufügen

Beispiel

from PIL import Image, ImageDraw, ImageFont

def create_thumbnail_with_watermark(input_path, output_path, size=(200, 200)):
    # Originalbild öffnen
    original = Image.open(input_path)
   
    # Miniaturansicht erstellen
    thumbnail = original.copy()
    thumbnail.thumbnail(size)
   
    # Wasserzeichen hinzufügen
    draw = ImageDraw.Draw(thumbnail)
    try:
        font = ImageFont.truetype("arial.ttf", 20)
    except:
        font = ImageFont.load_default()
   
    # Textposition berechnen (unten rechts). Für Chinesisch müssen Sie eine Schriftart festlegen, sonst wird es unleserlich
    text = "WWW.example.com"
    # Textgröße ermitteln
    bbox = draw.textbbox((0, 0), text, font=font)
    text_width = bbox[2] - bbox[0]
    text_height = bbox[3] - bbox[1]
    x = thumbnail.width - text_width - 10
    y = thumbnail.height - text_height - 10
   
    # Halbtransparenten Hintergrund zeichnen
    draw.rectangle([x-5, y-5, x+text_width+5, y+text_height+5], fill=(0,0,0,128))
   
    # Text zeichnen
    draw.text((x, y), text, fill="white", font=font)
   
    # Ergebnis speichern
    thumbnail.save(output_path)
    print(fVorschaubild gespeichert unter {output_path})

# Verwendungsbeispiel
create_thumbnail_with_watermark("tiger.jpeg", "thumbnail.jpg")

Das generierte Vorschaubild sieht wie folgt aus:


Häufig gestellte Fragen

F1: Wie geht man mit Bildformaten um, die Pillow nicht erkennen kann?

A1: Pillow unterstützt die meisten gängigen Bildformate. Wenn Sie auf ein nicht unterstütztes Format stoßen, versuchen Sie, zusätzliche Decoder zu installieren, oder konvertieren Sie das Bild zuerst in ein unterstütztes Format (wie PNG oder JPEG).

F2: Wie lassen sich mehrere Bilddateien stapelweise verarbeiten?

A2: Sie können das glob-Modul von Python mit einer Schleife verwenden, um eine Stapelverarbeitung durchzuführen:

Beispiel

import glob
from PIL import Image

for file in glob.glob("images/*.jpg"):
    img = Image.open(file)
    # Bild verarbeiten...
    img.save(f"processed_{file}")

F3: Wie lassen sich große Bilder verarbeiten, ohne dass der Arbeitsspeicher überläuft?

A3: Bei sehr großen Bildern können Sie die Funktionen des Image-Objekts verwendenload()Methode zur blockweisen Verarbeitung oder verwenden SieImageOps.fit()um den Verarbeitungsbereich einzuschränken.

Durch die obigen Beispiele und Erklärungen sollten Sie die grundlegende Verwendung von Pillow beherrschen. Pillow ist leistungsstark, daher wird empfohlen, mehr zu üben und seine erweiterten Funktionen zu erkunden!

Andere Erweiterungen