Avvio rapido
Avvio rapido
Questa pagina illustra il ciclo fondamentale crea/modifica/salva/ricarica: costruisce un PDF a due pagine, allega un’annotazione a ciascuna pagina usando l’Annotation API, genera l’aspetto visibile delle annotazioni, salva il documento e lo ricarica per confermare che le modifiche siano sopravvissute al round‑trip.
Prerequisiti
| Requisito | Dettaglio |
|---|---|
| Python | 3.11 o successive |
| Package | aspose-pdf-foss-for-python installato (Installation) |
1. Crea un documento e aggiungi pagine
Document() senza argomenti crea un PDF vuoto in memoria. document.pages è un PageCollection mutabile; chiamare add() aggiunge una pagina vuota.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. Aggiungi annotazioni e genera il loro aspetto
La proprietà annotations di ogni pagina è un AnnotationCollection. add() accetta un nome di sottotipo, un rettangolo (left, bottom, right, top), testo di contenuto e un dict opzionale properties di valori indicizzati per nome PDF, restituendo il nuovo Annotation. generate_appearance() rende il contenuto visivo dell’annotazione in modo che venga visualizzato correttamente in un visualizzatore 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. Salva e ricarica
Document.save accetta un percorso file (o un flusso scrivibile). Document.load_from legge un documento da un percorso, byte o flusso.
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)