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) | 인덱스에서 페이지 가져오기 |