XPS 変換
XPS 変換
XpsDocument は XML Paper Specification (.xps) ファイルを読み込むためのエントリーポイントです。PsDocument と同じ to_pdf() と to_image() のインターフェースを提供します。
XPS ファイルの読み込み
ファイルパスから読み込むには XpsDocument.from_file() を使用し、RAW バイトから読み込むには 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) | インデックスのページを取得 |