Quickstart
Швидкий старт
Ця сторінка демонструє основний цикл створення/модифікації/збереження/перезавантаження: створити двосторінковий 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)