Module ImageFont de Pillow

ImageFontLe module est un composant central de Pillow spécialement dédié à la gestion des polices et au rendu du texte.

Le module ImageFont permet aux développeurs d'ajouter du contenu textuel de styles variés aux images, et constitue un outil essentiel pour l'annotation d'images, la génération de CAPTCHA, la création de filigranes et d'autres fonctions.


Fonctionnalités principales

ImageFontLe module fournit principalement les fonctions suivantes :

  1. Charger des fichiers de police TrueType et OpenType
  2. Créer des objets de police et définir la taille de police
  3. Calculer la taille et la disposition du texte dans les images
  4. etImageDrawCoopérer avec d'autres modules pour le rendu du texte

Explication détaillée des méthodes principales

Les suivantes sontImageFontles méthodes les plus couramment utilisées dans le module et leurs descriptions :

Nom de la méthode Description du paramètre Valeur de retour Description de la fonction
truetype(font=None, size=10, index=0, encoding='', layout_engine=None) font: Chemin du fichier de police
size: Taille de police (pixels)
index: Index de police
encoding: Encodage
layout_engine: Moteur de mise en page
ImageFontobjet Charger les fichiers de police TrueType ou OpenType
load(filename) filename: Chemin du fichier de police ImageFontobjet Charger une police bitmap (format spécifique à PIL)
load_path(filename) filename: Chemin du fichier de police ImageFontobjet Charger le fichier de police depuis le chemin spécifié
getsize(text, direction=None, features=None, language=None) text: Texte à mesurer
direction: Direction du texte
features: Fonctionnalités OpenType
language: Code de langue
tuple (width, height) Obtenir la taille du texte rendu
getmask(text, mode='', direction=None, features=None, language=None) Comme ci-dessus Imageobjet Obtenir le masque bitmap du texte
getbbox(text, direction=None, features=None, language=None) Comme ci-dessus tuple (left, top, right, bottom) Obtenir la boîte englobante du texte

Exemples d'utilisation de base

Charger la police et dessiner du texte

Exemple

from PIL import Image, ImageDraw, ImageFont

# Créer une image vide
image = Image.new('RGB', (400, 200), color='white')

# Charger la police
font = ImageFont.truetype('arial.ttf', size=40)

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

# Dessiner le texte
draw.text((50, 80), 'Hello Pillow!', font=font, fill='black')

# Enregistrer l'image
image.save('text_image.png')

Obtenir la taille du texte

Exemple

text = "Texte d'exemple"
width, height = font.getsize(text)
print(f"Largeur du texte : {width}, Hauteur du texte : {height}")

Fonctionnalités avancées

Utilisation des fonctionnalités OpenType

Exemple

font = ImageFont.truetype('arial.ttf', size=40)
draw.text((50, 80), 'Bonjour', font=font, fill='black', features=['-liga'])

Prise en charge multilingue

Exemple

# Rendu de texte chinois
font = ImageFont.truetype('msyh.ttc', size=30)
draw.text((50, 120), 'Bonjour, le monde !', font=font, fill='blue')

Contrôle de la direction du texte

Exemple

# Texte de droite à gauche
draw.text((300, 80), 'سلام', font=font, fill='red', direction='rtl')

Notes

  1. Chemin du fichier de police: Assurez-vous que le chemin du fichier de police fourni est correct, sinon une exception sera levée.IOError
  2. Taille de police: La taille de police est en pixels, pas en points (pt).
  3. Considérations de performance: La création fréquente d'objets de police peut affecter les performances ; il est recommandé de réutiliser les objets de police.
  4. Compatibilité multiplateforme: Différents systèmes d'exploitation peuvent avoir différentes polices installées par défaut ; l'empaquetage des polices doit être pris en compte lors du déploiement.

Résumé

ImageFontLe module offre de puissantes capacités de rendu de texte pour le traitement d'images en Python. En utilisant ce module de manière appropriée, les développeurs peuvent facilement répondre à divers besoins de traitement d'images liés au texte. MaîtriserImageFontson utilisation est une étape importante pour le traitement d'images de niveau professionnel.

Autres extensions