Быстрый старт
Быстрый старт
Эта страница пошагово проходит основной цикл создание/изменение/сохранение/перезагрузка: создает PDF из двух страниц, добавляет аннотацию к каждой странице с использованием обновлённого Annotation API, генерирует видимое отображение аннотаций, сохраняет документ и загружает его заново, чтобы подтвердить, что изменения сохранились после прохода.
Требования
| Требование | Подробность |
|---|---|
| Python | 3.11 или новее |
| Package | aspose-pdf-foss-for-python установлен (Installation) |
1. Создать документ и добавить страницы
Document() без аргументов создаёт пустой PDF в памяти. document.pages — это изменяемый PageCollection; вызов add() добавляет пустую страницу.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. Добавить аннотации и сгенерировать их отображение
Свойство annotations каждой страницы является AnnotationCollection. add() принимает имя подтипа, (left, bottom, right, top) прямоугольник, текст содержимого и необязательный словарь properties со значениями, ключами которых являются имена PDF, возвращая новую Annotation. generate_appearance() рендерит визуальное содержимое аннотации, чтобы оно корректно отображалось в 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. Сохранить и перезагрузить
Document.save принимает путь к файлу (или поток для записи). Document.load_from считывает документ обратно из пути, байтов или потока.
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)