Quickstart
Inicio rápido
Esta página recorre el ciclo central crear/modificar/guardar/recargar: construir un PDF de dos páginas, adjuntar una anotación a cada página usando la Annotation API actualizada, generar la apariencia visible de las anotaciones, guardar el documento y recargarlo para confirmar que los cambios sobrevivieron al viaje de ida y vuelta.
Requisitos previos
| Requisito | Detalle |
|---|---|
| Python | 3.11 o posterior |
| Package | aspose-pdf-foss-for-python instalado (Installation) |
1. Crear un documento y añadir páginas
Document() sin argumentos crea un PDF vacío en memoria. document.pages es un PageCollection mutable; llamar a add() agrega una página en blanco.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. Añadir anotaciones y generar su apariencia
La propiedad annotations de cada página es un AnnotationCollection. add() recibe un nombre de subtipo, un rectángulo (left, bottom, right, top), texto de contenido y un diccionario opcional properties de valores con claves de nombre PDF, devolviendo el nuevo Annotation. generate_appearance() renderiza el contenido visual de la anotación para que se muestre correctamente en un visor de 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. Guardar y recargar
Document.save acepta una ruta de archivo (o un flujo de escritura). Document.load_from lee un documento desde una ruta, bytes o flujo.
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)