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)インデックスのページを取得

参照

 日本語