Module PSDraw de Pillow

PSDraw est un module de la bibliothèque Pillow de Python, spécifiquement utilisé pour générer des fichiers de dessin au format PostScript.

PostScript est un langage de description de page et un langage de programmation, largement utilisé dans la publication assistée par ordinateur et l'impression.

Le module PSDraw vous permet de :

  • Créer des graphiques vectoriels
  • Dessiner des formes de base (lignes, rectangles, cercles, etc.)
  • Ajouter du contenu textuel
  • Contrôler la mise en page et le format

Méthode d'import :

from PIL import PSDraw

Principales méthodes du module PSDraw

Voici les méthodes couramment utilisées dans le module PSDraw et leurs descriptions :

Méthode Description Parameters Valeur de retour
PSDraw.begin_document() Démarrer un nouveau document PostScript Aucune Aucune
PSDraw.end_document() Terminer le document PostScript actuel Aucune Aucune
PSDraw.setfont(font, size) Définir la police et la taille du texte font : nom de la police
size : taille de police (points)
Aucune
PSDraw.text(position, text) Dessiner du texte à la position spécifiée position : coordonnées (x,y)
text : le texte à dessiner
Aucune
PSDraw.line(from_pos, to_pos) Dessiner une ligne droite from_pos : coordonnées du point de départ
to_pos : coordonnées du point d'arrivée
Aucune
PSDraw.rectangle(box) Dessiner un rectangle box : coordonnées (x0,y0,x1,y1) Aucune
PSDraw.setink(color) Définir la couleur de dessin color : valeur de couleur (tuple RGB ou nom de couleur) Aucune
PSDraw.setfill(onoff) Définir si les formes doivent être remplies onoff : valeur booléenne (True/False) Aucune

Exemples d'utilisation de base

Création d'un document PostScript simple

Exemple

from PIL import PSDraw

# Créer un objet PSDraw
ps = PSDraw.PSDraw()  # Sortie par défaut vers la sortie standard

# Démarrer le document
ps.begin_document()

# Définir la police
ps.setfont("Helvetica", 12)

# Dessiner le texte
ps.text((100, 100), "Bonjour, PostScript !")

# Dessiner une ligne
ps.line((100, 120), (200, 120))

# Dessiner un rectangle
ps.rectangle((100, 150, 200, 200))

# Terminer le document
ps.end_document()

Sortie vers un fichier

Exemple

from PIL import PSDraw

# Créer un fichier de sortie
with open("output.ps", "wb") as f:
    ps = PSDraw.PSDraw(f)
   
    # Définir la taille de page (A4)
    ps.begin_document("A4")
   
    # Définir la couleur sur
    ps.setink("red")
   
    # Dessiner un rectangle rempli
    ps.setfill(True)
    ps.rectangle((100, 100, 300, 200))
   
    # Terminer le document
    ps.end_document()

Fonctionnalités avancées

Système de coordonnées

PS utilise le système de coordonnées par défaut de PostScript, avec l'origine (0,0) dans le coin inférieur gauche de la page, l'axe des x croissant vers la droite et l'axe des y croissant vers le haut. L'unité de coordonnée est le point (1 point = 1/72 inch).

Transformation graphique

Bien que PSDraw ne fournisse pas directement de méthodes de transformation, vous pouvez réaliser une translation, une rotation et une mise à l'échelle au moyen de commandes PostScript :

Exemple

ps.text((100, 100), "gsave rotate Hello, World! grestore")

Commandes PostScript personnalisées

PSDraw vous permet d'insérer directement des commandes PostScript brutes :

Exemple

ps.text((0, 0), "% Commandes PostScript personnalisées\n/showpage {} def")

Notes

  1. Le module PSDraw est principalement utilisé pour générer des fichiers PostScript, et non pour afficher des graphiques.
  2. Les fichiers PostScript générés peuvent être visualisés avec Ghostscript ou d'autres interpréteurs PostScript.
  3. Certaines opérations graphiques complexes peuvent nécessiter l'utilisation directe de commandes PostScript.
  4. Pour les applications modernes, envisagez d'utiliser des formats de graphiques vectoriels plus modernes tels que SVG.

En maîtrisant le module PSDraw, vous pouvez facilement générer des documents PostScript de haute qualité en Python, adaptés à l'impression et aux besoins de publication professionnelle.

Autres extensions