共通レンダリングユーティリティ
共通レンダリングユーティリティ
Aspose.Page FOSS for Python は、PsDocument と XpsDocument が内部で使用する、下位レベルのレンダリングユーティリティのセットを公開しています。出力を正確に制御する必要がある場合、これらのコンポーネントは直接使用することもできます。
RenderModelBuilder
RenderModelBuilder は RenderDocument を段階的に構築します。ページを開始するには begin_page() を呼び出し、描画コマンドを追加した後、end_page() を呼び出します。完成した RenderDocument を取得するには document() を呼び出してください。
from aspose.page.render.model import RenderModelBuilder
builder = RenderModelBuilder()
builder.begin_page(595, 842)
builder.end_page()
doc = builder.document()利用可能な描画メソッド: add_path(), add_text(), add_image(), clip(), save_state(), および restore_state()。
PdfWriter
PdfWriter シリアライズします RenderDocument PDF 1.4 バイトに PdfMetadata インスタンス。参照 PDF 出力 詳細については。
RasterRenderer
RasterRenderer は RenderDocument を RasterSurface にレンダリングします — メモリ上の RGBA ピクセルバッファです。RasterSurface は get_pixel()、set_pixel()、width、および height を提供します。
from aspose.page.render.model import RenderModelBuilder
from aspose.page.image.raster_renderer import RasterRenderer
builder = RenderModelBuilder()
builder.begin_page(400, 300)
builder.end_page()
doc = builder.document()
renderer = RasterRenderer()
surface = renderer.render(doc, page_index=0)
print(f"Pixels: {surface.width}x{surface.height}")ヒントとベストプラクティス
- 描画プリミティブからドキュメントを作成する必要がある場合は、
RenderModelBuilderを使用してください。 - ソースファイルなしでカスタム PDF を生成するために、
PdfWriterをRenderDocumentと組み合わせて使用してください。 RasterSurfaceのピクセルアクセスは、get_pixel()とset_pixel()を通じて利用可能です。
API Reference の概要
| クラス / メソッド | 説明 |
|---|---|
RenderModelBuilder.begin_page(width, height) | 新しいページを開始 |
RenderModelBuilder.end_page() | 現在のページを確定する |
RenderModelBuilder.document() | 完成した RenderDocument を取得する |
PdfWriter.write(document) | RenderDocument を PDF バイト列にシリアライズする |
RasterRenderer.render(document, page_index) | ページを RasterSurface にレンダリングする |
RasterSurface.width | ピクセルでの表面幅 |
RasterSurface.height | ピクセルでの表面高さ |