Module ImagePath de Pillow

Le module ImagePath est un sous-module de la bibliothèque de traitement d'images Python Pillow, principalement utilisé pour les opérations liées aux chemins d'images et aux points de coordonnées. Il fournit aux développeurs des méthodes pratiques pour créer, manipuler et transformer les données de chemin dans les images.

Le module ImagePath est particulièrement adapté aux scénarios d'application qui nécessitent de manipuler des graphiques vectoriels ou des données de chemin, tels que :

  • Annotation d'image
  • Dessin graphique
  • Transformation de chemin
  • Calcul de points de coordonnées

Principales méthodes du module ImagePath

Le tableau suivant détaille les principales méthodes du module ImagePath et leurs descriptions fonctionnelles :

Nom de la méthode Parameters Valeur de retour Description fonctionnelle
ImagePath.Path(coords) coords : séquence de coordonnées (liste ou tuple) objet Path Créer un nouvel objet chemin
getbbox() Aucune 4-uplet (x0, y0, x1, y1) Retourne la boîte englobante du chemin
tolist() Aucune Liste Convertir le chemin en une liste de points de coordonnées
compact(distance=2) distance : seuil de distance de compression Aucune Compresser le chemin en supprimant les points proches
transform(matrix) matrix : matrice de transformation Aucune Appliquer une transformation affine au chemin
map(function) function : fonction de mappage Aucune Appliquer la fonction à chaque point du chemin

Exemples d'utilisation d'ImagePath

Création et manipulation de chemins

Exemple

from PIL import ImagePath

# Créer un objet chemin
points = [10, 10, 100, 10, 100, 100, 10, 100]
path = ImagePath.Path(points)

# Obtenir la boîte englobante du chemin
bbox = path.getbbox()
print(f"Boîte englobante : {bbox}")  # Sortie : (10, 10, 100, 100)

# Convertir en liste
point_list = path.tolist()
print(f"Liste des points du chemin : {point_list}")

Transformation de chemin

Exemple

# Définir la matrice de transformation (translation)
matrix = (1, 0, 20,  # x' = 1*x + 0*y + 20
          0, 1, 30)  # y' = 0*x + 1*y + 30

# Appliquer la transformation
path.transform(matrix)

# Voir les points transformés
print(f"Chemin transformé : {path.tolist()}")

Scénarios d'application pratiques

Annotation d'image

ImagePath peut être utilisé pour dessiner des boîtes d'annotation sur des images ou marquer des régions spécifiques. L'objet Path facilite le stockage et la manipulation de ces coordonnées d'annotation.

Dessin graphique

Lorsque des graphiques complexes doivent être dessinés, ImagePath peut être utilisé pour définir le chemin de contour de la forme, puis les méthodes de dessin de PIL peuvent être utilisées pour le rendre sur l'image.

Transformation de coordonnées

Pour les applications qui nécessitent une conversion entre différents systèmes de coordonnées, la méthode transform d'ImagePath fournit une fonction pratique de transformation de coordonnées.


Remarques importantes

  1. Le format d'entrée des points de coordonnées doit être une séquence plate telle que [x0, y0, x1, y1, ...]
  2. La méthode transform modifie directement l'objet path d'origine et ne crée pas de nouvel objet
  3. Le nombre de points du chemin doit être pair, car chaque point est constitué à la fois des coordonnées x et y
  4. Pour les opérations sur un grand nombre de points de chemin, il est recommandé de compacter d'abord pour réduire les calculs
Autres extensions