Aspose.PDF FOSS
Getting Started
Quickstart

Quickstart

시작하기

이 페이지는 핵심 create/modify/save/reload 사이클을 단계별로 안내합니다: 두 페이지 PDF를 만들고, 업데이트된 Annotation API을 사용해 각 페이지에 주석을 첨부하고, 주석의 표시 모습을 생성한 뒤, 문서를 저장하고, 다시 로드하여 변경 사항이 라운드‑trip을 통해 유지되었는지 확인합니다.

필수 조건

요구 사항세부 사항
Python3.11 이상
Packageaspose-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-name 키 값 사전을 받아 새 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)

참조

 한국어