Démarrage rapide
Démarrage rapide
Cette page décrit le cycle de création/modification/enregistrement/rechargement de base : construire un PDF de deux pages, ajouter une annotation à chaque page en utilisant l’Annotation mise à jour API, générer l’apparence visible des annotations, enregistrer le document et le recharger pour confirmer que les modifications ont survécu au aller‑retour.
Prérequis
| Exigence | Détail |
|---|---|
| Python | 3.11 ou version ultérieure |
| Package | aspose-pdf-foss-for-python installé (Installation) |
1. Créer un document et ajouter des pages
Document() sans arguments crée un PDF vide en mémoire. document.pages est un PageCollection mutable; appeler add() ajoute une page blanche.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. Ajouter des annotations et générer leur apparence
La propriété annotations de chaque page est un AnnotationCollection. add() prend un nom de sous-type, un rectangle (left, bottom, right, top), du texte de contenu, et un dictionnaire properties optionnel de valeurs indexées par des noms PDF, et renvoie le nouveau Annotation. generate_appearance() rend le contenu visuel de l’annotation afin qu’il s’affiche correctement dans un visualiseur PDF.
document.pages[0].annotations.add("Square", (0, 0, 50, 50), "")
line = document.pages[1].annotations.add(
"Line", (0, 0, 50, 50), "", properties={"L": [0, 0, 50, 50]}
)
line.generate_appearance()3. Enregistrer et recharger
Document.save accepte un chemin de fichier (ou un flux d’écriture). Document.load_from lit un document à partir d’un chemin, d’octets ou d’un flux.
document.save("quickstart.pdf")
reopened = Document()
reopened.load_from("quickstart.pdf")
print("Reloaded pages:", reopened.page_count)
print("Has appearance:", reopened.pages[1].annotations[0].has_appearance)