XPS 변환

XPS 변환

XpsDocument은 XML Paper Specification (.xps) 파일을 로드하기 위한 진입점입니다. PsDocument와 동일한 to_pdf() 및 to_image() 인터페이스를 제공합니다.


XPS 파일 로드

XpsDocument.from_file()을(를) 사용해 파일 경로에서 로드하거나, from_bytes()을(를) 사용해 원시 바이트에서 로드합니다.

from aspose.page.xps.document import XpsDocument

xps = XpsDocument.from_file("document.xps")

PDF로 내보내기

문서를 PDF 바이트 배열로 얻으려면 to_pdf()을(를) 호출하십시오.

from pathlib import Path
from aspose.page.xps.document import XpsDocument

xps = XpsDocument.from_file("input.xps")
pdf_bytes = xps.to_pdf()
Path("output.pdf").write_bytes(pdf_bytes)

PNG 또는 JPEG로 내보내기

ImageSaveOptions 인스턴스를 to_image()에 전달하십시오:

from pathlib import Path
from aspose.page.xps.document import XpsDocument
from aspose.page.ps.output import ImageSaveOptions

xps = XpsDocument.from_file("input.xps")
opts = ImageSaveOptions(format="png", dpi=96)
Path("output.png").write_bytes(xps.to_image(opts))

페이지 관리

XpsDocument은(는) 개별 페이지를 추가, 삽입, 제거 및 검색하는 메서드를 제공합니다.

from aspose.page.xps.document import XpsDocument

xps = XpsDocument.from_file("input.xps")
page = xps.add_page(595, 842)       # add an A4 page
xps.remove_page(0)                   # remove the first page

팁 및 모범 사례

  • 업로드 또는 스트림에서 가져온 메모리 내 XPS 데이터를 위해 from_bytes()을(를) 사용하십시오.
  • add_page(), remove_page(), 및 get_page() 메서드는 내보내기 전에 페이지 수준 조작을 가능하게 합니다.
  • to_pdf()와 to_image()은(는) bytes을(를) 직접 반환합니다 — 임시 파일이 필요하지 않습니다.

일반적인 문제

문제원인수정
FileNotFoundError경로가 존재하지 않음from_file() 전에 경로 확인
출력이 비어 있음XPS 파일에 고정 페이지가 없습니다XPS 소스를 검사

FAQ

XPS를 PNG로 변환할 수 있나요?

예. ImageSaveOptions(format="png", dpi=150)를 to_image()에 전달하십시오.

페이지 제한이 있나요?

명시적인 페이지 제한은 없습니다. 메모리 사용량은 페이지 수와 DPI에 따라 증가합니다.


API Reference 요약

클래스 / 메서드설명
XpsDocument.from_file(path)파일 경로에서 XPS를 로드
XpsDocument.from_bytes(data)원시 바이트에서 XPS를 로드
XpsDocument.to_pdf(options)PDF 바이트로 내보내기
XpsDocument.to_image(options)래스터 이미지 바이트로 내보내기
XpsDocument.add_page(width, height)새 페이지 추가
XpsDocument.remove_page(index)인덱스에서 페이지 제거
XpsDocument.get_page(index)인덱스에서 페이지 가져오기

참조

 한국어