Aspose.Page for Python – よくある質問

Q: Aspose.Page for Python とは何ですか?また、どのファイル形式がサポートされていますか?

A: Aspose.Page for Python は、PostScript (PS)、Encapsulated PostScript (EPS)、および XPS ドキュメントの作成、変更、変換、レンダリングを可能にするライブラリです。 PDF、XPS、PNG、JPEG、BMP、GIF、TIFF、SVG を出力し、PDF‑XObject または XPS‑Canvas オブジェクトをエクスポートできます。

Q: ライブラリを使用するには、Ghostscript や .NET ランタイムなどの外部ツールが必要ですか?

A: いいえ。必要なレンダリングと変換ロジックはすべて、実行時にaspose.pageパッケージがロードする自己完結型のネイティブ バイナリにバンドルされています。 Windows、macOS、または Linux では外部依存関係は必要ありません。

Q: Aspose.Page for Python をインストールするにはどうすればよいですか?

A: pip を使用します:

pip install aspose-page

ホイールは、ネイティブ バイナリをサイト パッケージ フォルダーに自動的に抽出します。

Q: 評価ウォーターマークを回避するためにライセンスを適用するにはどうすればよいですか?

A: .lic ファイルをアクセス可能な場所に置き、処理の前に次のコードを追加します。

import aspose.page as ap
license = ap.License()
license.set_license('Aspose.Page.Python.lic')

パスは絶対パスでも、スクリプトに対する相対パスでもかまいません。

Q: PS ファイルを PDF に変換するための最小限のコードは何ですか?

A:

import aspose.page as ap

doc = ap.Document('sample.ps')
pdf_opt = ap.save.PdfSaveOptions()
doc.save('sample.pdf', pdf_opt)

この呼び出しはデフォルトですべてのページを処理します。

Q: XPS ドキュメントの特定のページを PNG にレンダリングするにはどうすればよいですか?

A:

import aspose.page as ap

doc = ap.Document('sample.xps')
img_opt = ap.save.ImageSaveOptions(ap.SaveFormat.PNG)
img_opt.page_number = 2          # 1‑based index
doc.save('page2.png', img_opt)

必要に応じてimg_optにresolution jpeg_quality」などを設定します。

Q: 新しい PostScript ドキュメントを最初から作成できますか?

A: はい。ページ サイズを定義し、キャンバスを取得し、グラフィック オブジェクトを描画します。

import aspose.page as ap

size = ap.base.SizeF(595, 842)           # A4 in points
doc = ap.Document(size)
canvas = doc.pages[0].canvas
canvas.draw_line(ap.base.PointF(0, 0), ap.base.PointF(595, 842))
canvas.draw_string('Hello Aspose!', ap.base.Font('Arial', 24),
                   ap.base.Brushes.black, ap.base.PointF(100, 100))
doc.save('new_doc.ps', ap.save.PSOptions())

Q: 変換中にタイトルや作成者などの PDF メタデータを追加するにはどうすればよいですか?

A: PdfSaveOptions オブジェクトを使用します。

pdf_opt = ap.save.PdfSaveOptions()
pdf_opt.title = 'My Document'
pdf_opt.author = 'John Doe'
doc.save('output.pdf', pdf_opt)

Q: 複数の PS/EPS/XPS ファイルを 1 つの PDF に結合することはできますか?

A: はい。各ソースを順番にロードし、追加モードを有効にします。

options = ap.save.PdfSaveOptions()
options.append_mode = True
for src in ['a.ps', 'b.eps', 'c.xps']:
    doc = ap.Document(src)
    doc.save('merged.pdf', options)

Q: 読み込んだドキュメント内のページを削除または回転するにはどうすればよいですか?

A:

doc = ap.Document('multi_page.ps')
doc.pages.remove_at(2)          # removes the third page (0‑based)
page = doc.pages[0]
page.transform.rotate(90)       # clockwise 90°
doc.save('updated.pdf', ap.save.PdfSaveOptions())

Q: PS/EPS テンプレート内のプレースホルダー テキストを置き換えることはできますか?

A: replace_text API を使用します。

doc = ap.Document('template.eps')
doc.replace_text('{{name}}', 'John Doe')
doc.save('filled.pdf', ap.save.PdfSaveOptions())

検索可能なテキスト ストリームのみが影響を受けます。

Q: 大きな (>500MB) ドキュメントを処理する場合のメモリの考慮事項は何ですか?

A: エンジンは可能な場合にはデータをストリーミングしますが、各ページはメモリにロードされます。 RAM の使用量を低く抑えるには、ループ内で options.page_numbers = [n] を設定してページを個別に処理するか、ThreadPoolExecutor を使用してドキュメント全体を保持せずにページを並行して処理します。

Q: 多くのファイルを同時に変換する場合、マルチスレッドは安全ですか?

A: はい。各Documentインスタンスは独立しているため、個別のスレッドまたはプロセスで変換を実行できます。静的なグローバル状態が共有されないため、並列実行が簡単になります。

Q: どの Python バージョンとオペレーティング システムがサポートされていますか?

A: 64 ビット インタプリタ上の Python3.7 ～ 3.12。サポートされている OS: Windows10/11 (x64)、glibc2.17+ (x64) を搭載した Linux ディストリビューション、macOS10.15+ (x64 および Rosetta2 経由の Apple Silicon)。公式 Python イメージに基づく Docker コンテナは、すぐに使用できます。

Q: 「ImportError: No module names ‘aspose’」というメッセージが表示されます。どうすれば修正できますか?

A: 現在の環境にはパッケージがインストールされていません。スクリプトを実行する予定のものと同じインタープリター (which pythonを検証するか) を使用して、pip install aspose-pageを実行します。必要に応じて、正しい仮想環境をアクティブ化します。

Q: Linux で「システムエラー: ネイティブ ライブラリをロードできません」を解決するにはどうすればよいですか?

A: 標準 C++ ランタイムが存在すること (apt-get install libstdc++6) と、glibc バージョンが最小要件 (2.17) を満たしていることを確認してください。古いディストリビューションを使用している場合は、libc パッケージをアップグレードするか、新しいベース Docker イメージを使用します。

Q: 公式ドキュメント、コード サンプル、サポートはどこで入手できますか?

A:

• 公式ドキュメントとチュートリアル
• PyPIページ
• コミュニティサンプル (「Aspose Page Python」で検索)
• サポートと問題トラッカー: Aspose アカウント ポータル経由でチケットを送信します。 Stack Overflow の aspose-page タグも使用します。