Module ImageDraw de Pillow

ImageDraw est un module de Pillow (un fork de PIL), une bibliothèque de traitement d'images Python, utilisé pour dessiner diverses formes et du texte sur des images.

ImageDraw offre de riches capacités de dessin, notamment des lignes, des rectangles, des cercles, des polygones, du texte, etc., adaptées à l'annotation d'images, à la génération de graphiques ou à la conception graphique simple.

ImageDrawLes principales fonctionnalités du module incluent :

  • Prend en charge le dessin sur des images existantes
  • Peut créer des canevas vierges entièrement nouveaux
  • Fournit plusieurs primitives de dessin (points, lignes, rectangles, ellipses, etc.)
  • Prend en charge le dessin de texte et les paramètres de police
  • Permet des couleurs et des styles de dessin personnalisés

Utilisation de base d'ImageDraw

Création d'un objet Draw

Avant d'utiliser ImageDraw, vous devez d'abord créer unImageDraw.Drawobjet, en passant unImageobjet comme base pour le dessin.

Exemple

from PIL import Image, ImageDraw

# Créer une image vierge (fond blanc)
image = Image.new("RGB", (400, 300), "white")

# Créer un objet Draw
draw = ImageDraw.Draw(image)

Dessiner des formes de base

ImageDraw prend en charge plusieurs méthodes de dessin, telles que :

  • Dessiner des lignes:line()
  • Dessiner des rectangles:rectangle()
  • Dessiner des cercles/ellipses:ellipse()
  • Dessiner des polygones:polygon()
  • Dessiner du texte:text()

Méthodes courantes d'ImageDraw

Méthode Description Exemple
line(xy, fill=None, width=1) Dessiner une ligne,xyest un tuple de coordonnées ((x1, y1, x2, y2)) draw.line([(10, 10), (100, 50)], fill="red", width=2)
rectangle(xy, fill=None, outline=None, width=1) Dessiner un rectangle,xysont les coordonnées des coins supérieur gauche et inférieur droit draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black")
ellipse(xy, fill=None, outline=None, width=1) Dessiner une ellipse ou un cercle draw.ellipse([(100, 100), (200, 200)], fill="green")
polygon(xy, fill=None, outline=None) Dessiner un polygone draw.polygon([(50, 50), (100, 20), (150, 50)], fill="yellow")
text(xy, text, fill=None, font=None) Dessiner du texte sur une image draw.text((50, 50), "Hello Pillow!", fill="black")
arc(xy, start, end, fill=None, width=1) Dessiner un arc draw.arc([(50, 50), (150, 150)], 0, 90, fill="red")
chord(xy, start, end, fill=None, outline=None) Dessiner une corde (arc + ligne de connexion) draw.chord([(50, 50), (150, 150)], 0, 180, fill="blue")
pieslice(xy, start, end, fill=None, outline=None) Dessiner une part de tarte draw.pieslice([(50, 50), (150, 150)], 0, 90, fill="green")
textbbox() Utilisé pour calculer la boîte englobante occupée par un texte donné lorsqu'il est dessiné sur une image draw.textbbox((50, 50), "Hello Pillow!", font=font)

Exemple complet

L'exemple complet suivant montre comment utiliser ImageDraw pour dessiner plusieurs formes et du texte :

Exemple

from PIL import Image, ImageDraw, ImageFont

# Créer une image vide
image = Image.new("RGB", (500, 400), "white")
draw = ImageDraw.Draw(image)

# Dessiner une ligne
draw.line([(10, 10), (490, 10)], fill="red", width=3)

# Dessiner un rectangle
draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black")

# Dessiner un cercle
draw.ellipse([(200, 50), (300, 150)], fill="vert")

# Dessiner un polygone
draw.polygon([(350, 50), (400, 100), (450, 50), (400, 150)], fill="jaune")

# Dessiner le texte
font = ImageFont.load_default()
draw.text((50, 200), "Hello Pillow!", fill="black", font=font)

# Enregistrer l'image
image.save("draw_example.png")

Après exécution, un fichier image contenant plusieurs formes sera généré.draw_example.png。


Résumé

ImageDraw est un module de dessin très pratique de Pillow, adapté pour :

  • Annotation d'images (comme l'ajout de texte, de flèches)
  • Générer des graphiques ou des diagrammes simples
  • Dessin de formes personnalisées

En maîtrisantline()、rectangle()、ellipse()、text()et d'autres méthodes, vous pouvez facilement répondre à divers besoins de dessin.

Si vous avez besoin de fonctionnalités de dessin plus avancées, vous pouvez combinerImageFont(paramètres de police) ouImageFilter(effets de filtre) pour étendre davantage les fonctionnalités.

J'espère que ce tutoriel vous aidera à démarrer rapidement avec le module ImageDraw de Pillow !

Autres extensions