クイックスタート
クイックスタート
このページでは、基本的な作成/変更/保存/再読み込みサイクルを順に説明します:2ページの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)