Exemples de prise en main de Pillow

Pour utiliser Pillow, vous pouvez importer le module principal de Pillow de la manière suivante :

from PIL import Image, ImageFilter, ImageDraw, ImageFont

Pillow maintient la compatibilité de l'API avec PIL, ce qui signifie que la plupart du code écrit pour PIL peut être utilisé directement avec Pillow, il suffit de changer l'instruction d'import deimport PILenfrom PIL import ...。


Opérations de base sur les images

Charger et afficher une image

Image de test (à télécharger localement pour tester) :

Exemple

from PIL import Image

# Ouvrir l'image (prend en charge JPEG, PNG, GIF, etc.)
img = Image.open("tiger.jpeg")  

# Afficher l'image (visionneuse d'images par défaut du système)
img.show()  

# Obtenir des informations sur l'image
print(Format:, img.format)  # JPEG/PNG
print(Taille:, img.size)    # (largeur, hauteur)
print(Mode:, img.mode)   # RGB/L/CMYK

Exemple de sortie :

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

Explication :

  • Image.open()Lire le fichier image, renvoyant unImageobjet.

  • show()Appelle la visionneuse d'images par défaut du système pour afficher l'image (pour le débogage uniquement, non recommandé en production).

  • format、size、modesont les attributs de métadonnées de l'image.

Enregistrer l'image

Le code suivant enregistre l'image sous forme de fichiers dans différents formats : un fichier "example.png" converti au format PNG, et un fichier "example_quality.jpg" avec la qualité JPEG définie à 95.

Exemple

from PIL import Image

# Ouvrir l'image (prend en charge JPEG, PNG, GIF, etc.)
img = Image.open("tiger.jpeg")  

# Afficher l'image (visionneuse d'images par défaut du système)
img.show()  

# Obtenir des informations sur l'image
print(Format:, img.format)  # JPEG/PNG
print(Taille:, img.size)    # (largeur, hauteur)
print(Mode:, img.mode)   # RGB/L/CMYK

# Enregistrer sous différents formats
img.save('example.png')  # Convertir au format PNG
img.save('example_quality.jpg', quality=95)  # Spécifier la qualité JPEG

Conversion de format d'image

Exemple

from PIL import Image

img = Image.open("tiger.jpeg")  
# Convertir en niveaux de gris
gray_img = img.convert("L")  
gray_img.save("tiger_gray.png")  # Enregistrer au format PNG

# Convertir en RGB (même si l'original est RGBA)
rgb_img = img.convert("RGB")  
rgb_img.save("tiger_rgb.jpg", quality=95)  # Paramètre de qualité (1-100)
  • convert("L")Convertir l'image en mode niveaux de gris (noir et blanc 8 bits).
  • save()Vous pouvez spécifier le format (via l'extension de fichier ou le paramètre format), et quality contrôle la qualité de compression JPEG.

Opérations de traitement d'image

Redimensionner l'image

Définir une hauteur et une largeur fixes :

Exemple

from PIL import Image

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

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

# Générer une miniature (conserver les proportions)
img.thumbnail((200, 200))  # Modifier sur place
img.save("cat_thumbnail.jpg")

Redimensionner proportionnellement

Définir le facteur d'échelle:

Exemple

from PIL import Image

# Ouvrir l'image (prend en charge JPEG, PNG, GIF, etc.)
img = Image.open("tiger.jpeg")  

# Redimensionner proportionnellement
width, height = img.size
scaled_image = img.resize((width//2, height//2))
scaled_image.show()

Recadrer et faire pivoter l'image

Exemple

from PIL import Image

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

# Recadrer (left, top, right, bottom)
cropped_img = img.crop((100, 100, 500, 400))  
cropped_img.save(""tiger_cropped.jpg")

# Faire pivoter (90 degrés dans le sens antihoraire)
rotated_img = img.rotate(90, expand=True) # expand empêche le recadrage
rotated_img.save("
"tiger_rotated.jpg")

Effet après recadrage :

Effet après rotation :

  • crop()Le paramètre correspond aux coordonnées de la région rectangulaire (coin supérieur gauche + coin inférieur droit).

  • rotate(角度)Par défaut, les coins sont rognés, etexpand=Truela taille du canevas est ajustée automatiquement.


Amélioration d'image et filtres

Appliquer les filtres

Exemple

from PIL import Image, ImageFilter

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

# Filtre de flou
blurred_image = img.filter(ImageFilter.BLUR)
blurred_image.show()

# Renforcement des contours
edge_enhanced = img.filter(ImageFilter.EDGE_ENHANCE)
edge_enhanced.show()

Ajuster la luminosité et le contraste

Exemple

from PIL import Image, ImageEnhance

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


# Améliorer la luminosité
enhancer = ImageEnhance.Brightness(img)
bright_image = enhancer.enhance(1.5)  # luminosité 1.5x
bright_image.show()

# Améliorer le contraste
enhancer = ImageEnhance.Contrast(img)
contrast_image = enhancer.enhance(2.0)  # contraste 2x
contrast_image.show()

Dessiner sur les images

Dessiner des formes de base

Exemple

from PIL import Image, ImageDraw

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

# Créer un objet de dessin
draw = ImageDraw.Draw(img)

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

# Dessiner une ligne
draw.line([(0, 0), (500, 500)], fill="blue", width=3)

# Dessiner un cercle
draw.ellipse([(200, 200), (400, 400)], outline="green", width=4)

img.show()

L'image générée est la suivante :

Ajouter du texte

Vous pouvez ajouter du texte à l'image. Vous devez définir un chemin d'accès à une police ou utiliser la police par défaut du système :

Exemple

from PIL import Image, ImageDraw, ImageFont

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

# Créer un objet de dessin
draw = ImageDraw.Draw(img)

# Charger la police (la police doit exister sur le système)
font_size = 80  # Définir la taille de la police
try:
    font = ImageFont.truetype("arial.ttf", font_size)
except:
    font = ImageFont.load_default(font_size)
draw.text((150, 150), "Bonjour Exemple !", fill="red", font=font)

img.show()

L'image générée est la suivante :


Exemple complet : créer une vignette et ajouter un filigrane

Exemple

from PIL import Image, ImageDraw, ImageFont

def create_thumbnail_with_watermark(input_path, output_path, size=(200, 200)):
    # Ouvrir l'image originale
    original = Image.open(input_path)
   
    # Créer une vignette
    thumbnail = original.copy()
    thumbnail.thumbnail(size)
   
    # Ajouter un filigrane
    draw = ImageDraw.Draw(thumbnail)
    try:
        font = ImageFont.truetype("arial.ttf", 20)
    except:
        font = ImageFont.load_default()
   
    # Calculer la position du texte (en bas à droite). Pour le chinois, vous devez définir une police, sinon il sera mal affiché
    text = "WWW.example.com"
    # Obtenir la taille du texte
    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
   
    # Dessiner un arrière-plan semi-transparent
    draw.rectangle([x-5, y-5, x+text_width+5, y+text_height+5], fill=(0,0,0,128))
   
    # Dessiner le texte
    draw.text((x, y), text, fill="white", font=font)
   
    # Enregistrer le résultat
    thumbnail.save(output_path)
    print(fMiniature enregistrée dans {output_path})

# Exemple d'utilisation
create_thumbnail_with_watermark("tiger.jpeg", "thumbnail.jpg")

La miniature générée est la suivante :


Questions fréquentes

Q1 : Comment gérer les formats d'image que Pillow ne reconnaît pas ?

A1 : Pillow prend en charge la plupart des formats d'image courants. Si vous rencontrez un format non pris en charge, essayez d'installer des décodeurs supplémentaires ou convertissez d'abord l'image dans un format pris en charge (comme PNG ou JPEG).

Q2 : Comment traiter par lots plusieurs fichiers image ?

A2 : Vous pouvez utiliser le module glob de Python avec une boucle pour traiter par lots :

Exemple

import glob
from PIL import Image

for file in glob.glob("images/*.jpg"):
    img = Image.open(file)
    # Traitement de l'image...
    img.save(f"processed_{file}")

Q3 : Comment traiter de grandes images sans manquer de mémoire ?

A3 : Pour les images très volumineuses, vous pouvez utiliser les méthodes de l'objet Imageload()méthode pour traiter bloc par bloc, ou utiliserImageOps.fit()pour limiter la zone de traitement.

Grâce aux exemples et explications ci-dessus, vous devriez avoir maîtrisé l'utilisation de base de Pillow. Pillow est puissant, il est donc recommandé de vous entraîner davantage et d'explorer ses fonctionnalités avancées !

Autres extensions