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 :
- Charger des fichiers de police TrueType et OpenType
- Créer des objets de police et définir la taille de police
- Calculer la taille et la disposition du texte dans les images
- et
ImageDrawCoopé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 policesize: Taille de police (pixels)index: Index de policeencoding: Encodagelayout_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 à mesurerdirection: Direction du textefeatures: Fonctionnalités OpenTypelanguage: 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
# 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
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
draw.text((50, 80), 'Bonjour', font=font, fill='black', features=['-liga'])
Prise en charge multilingue
Exemple
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
draw.text((300, 80), 'سلام', font=font, fill='red', direction='rtl')
Notes
- Chemin du fichier de police: Assurez-vous que le chemin du fichier de police fourni est correct, sinon une exception sera levée.
IOError - Taille de police: La taille de police est en pixels, pas en points (pt).
- 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.
- 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.