Module ImageColor de Pillow

ImageColor est un sous-module de la bibliothèque de traitement d'images Python Pillow, spécifiquement utilisé pour gérer les opérations liées aux couleurs.

ImageColor fournit une série de méthodes pour convertir des chaînes de caractères de couleur en tuples au format RGB ou RGBA, prenant en charge plusieurs formats de représentation des couleurs.

Bien que le module ImageColor soit petit, il joue un rôle important dans le traitement d'images, en particulier dans les scénarios où les couleurs doivent être spécifiées dynamiquement.

Vous pouvez importer le module ImageColor de la manière suivante :

from PIL import ImageColor

Méthodes principales du module ImageColor

Le tableau suivant répertorie les principales méthodes du module ImageColor et leurs descriptions fonctionnelles :

Nom de la méthode Parameters Valeur de retour Description
getrgb(color) color: Chaîne de couleur Tuple RGB (r, g, b) Convertir une chaîne de couleur en tuple RGB
getcolor(color, mode) color: Chaîne de couleur
mode: Mode de couleur cible
Tuple de valeur de couleur Convertir une chaîne de couleur en une valeur dans le mode de couleur spécifié
colormap Aucune Dictionnaire Renvoie la table de correspondance des couleurs prise en charge par Pillow

Descriptions détaillées des méthodes et exemples

Méthode getrgb()

getrgb()Cette méthode est la plus couramment utilisée ; elle convertit les chaînes de couleur de divers formats en tuples RGB standard.

Les formats pris en charge incluent ::

  • Code de couleur hexadécimal :"#RRGGBB"ou"#RGB"
  • Représentation de la fonction RGB :"rgb(255, 0, 0)"
  • Représentation de la fonction HSL :"hsl(0, 100%, 50%)"
  • Nom de couleur :"red", "blue"wait

Exemple de code:

Exemple

from PIL import ImageColor

# Couleur hexadécimale
print(ImageColor.getrgb("#ff0000"))  # Sortie : (255, 0, 0)
print(ImageColor.getrgb("#f00"))    # Sortie : (255, 0, 0)

# Fonction RGB
print(ImageColor.getrgb("rgb(255, 0, 0)"))  # Sortie : (255, 0, 0)

# Nom de couleur
print(ImageColor.getrgb("red"))    # Sortie : (255, 0, 0)
print(ImageColor.getrgb("blue"))   # Sortie : (0, 0, 255)

Méthode getcolor()

getcolor()La méthode est similaire àgetrgb()la méthode getrgb(), mais vous pouvez spécifier le mode de couleur cible.

Les modes pris en charge incluent ::

  • "RGB"
  • "RGBA"
  • "L"(niveaux de gris)
  • "CMYK"
  • "HSV"

Exemple de code:

Exemple

from PIL import ImageColor

# Convertir en RGBA
print(ImageColor.getcolor("red", "RGBA"))  # Sortie : (255, 0, 0, 255)

# Convertir en niveaux de gris
print(ImageColor.getcolor("red", "L"))    # Sortie : 76 (la valeur du rouge en niveaux de gris)

Propriété colormap

colormapIl s'agit d'un dictionnaire qui contient toutes les couleurs nommées prises en charge par Pillow et leurs valeurs hexadécimales correspondantes.

Exemple de code:

Exemple

from PIL import ImageColor

# Obtenir la table de correspondance des couleurs
color_map = ImageColor.colormap

# Afficher le nombre de couleurs
print(f"Pillow prend en charge {len(color_map)} couleurs nommées")

# Afficher une couleur spécifique
print("Valeur hexadécimale du rouge :", color_map["red"])  # Sortie : #ff0000

Exemples d'applications pratiques

Créer une image de couleur unie

Exemple

from PIL import Image, ImageColor

# Utiliser ImageColor pour obtenir la couleur
color = ImageColor.getrgb("lightblue")

# Créer une image de couleur unie de 200x200
img = Image.new("RGB", (200, 200), color)
img.show()

Définir dynamiquement les couleurs de dessin

Exemple

from PIL import Image, ImageDraw, ImageColor

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

# Dessiner des formes avec différentes couleurs
colors = ["red", "#0080FF", "rgb(0, 0, 255)", "hsl(30, 100%, 50%)"]

for i, color_str in enumerate(colors):
    color = ImageColor.getrgb(color_str)
    draw.rectangle([50 + i*80, 50, 100 + i*80, 150], fill=color)

img.show()

Notes

  1. Format de chaîne de couleur: Assurez-vous que le format de la chaîne de couleur est correct, sinon une exception sera levée.ValueError
  2. Prise en charge du mode couleur: Tous les modes de couleur ne prennent pas en charge toutes les conversions de couleur
  3. Considérations de performance: Des appels fréquents aux méthodes de conversion de couleur peuvent affecter les performances ; il est recommandé de convertir et de stocker à l'avance les couleurs couramment utilisées.
  4. Limitations des noms de couleurs: Les noms de couleurs pris en charge par Pillow sont limités ; la liste complète peut être consultée viaImageColor.colormapla propriété colormap.

En maîtrisant le module ImageColor, vous pouvez utiliser de manière plus flexible diverses méthodes de représentation des couleurs dans le traitement d'images avec Pillow, ce qui ajoute plus de possibilités à vos programmes de traitement d'images.

Autres extensions