PDFium Delphi Component Docs

RenderTile メソッド

コンポーネント: TPdf  ·  ユニット: PDFium
ページの矩形領域を新しいビットマップへレンダリングします。返されるビットマップは手動で解放する必要があります

構文

function RenderTile(Left, Top, Width, Height, PageWidth, PageHeight: Integer; Rotation: TRotation = ro0; Options: TRenderOptions = []; Color: TColor = clWhite): TBitmap;

Left, TopInteger。レンダリングするタイル領域の左上コーナー。指定ズームレベルのフルページに対するピクセル単位の相対座標です
Width, HeightInteger。タイルのサイズ (ピクセル)。返されるビットマップはこの寸法になります
PageWidth, PageHeightInteger。目的のズームレベルにおけるフルページの寸法 (ピクセル)。ページをレンダリングするスケールを決定します
RotationTRotation。ページに適用される表示回転。ro0 (既定)、ro90、ro180、ro270 のいずれか
OptionsTRenderOptions。レンダリング品質と動作を制御する TRenderOption フラグの集合
ColorTColor。レンダリング前のビットマップ背景塗り色。既定値は clWhite です

 

procedure RenderTile(Bitmap: TBitmap; Left, Top, Width, Height, PageWidth, PageHeight: Integer; Rotation: TRotation = ro0; Options: TRenderOptions = []; Color: TColor = clWhite);

BitmapTBitmap。タイルのレンダリング先となる既存の TBitmap。このビットマップの作成と解放は呼び出し側の責任です
Left, TopInteger。レンダリングするタイル領域の左上コーナー。指定ズームレベルのフルページに対するピクセル単位の相対座標です
Width, HeightInteger。タイルのサイズ (ピクセル)
PageWidth, PageHeightInteger。目的のズームレベルにおけるフルページの寸法 (ピクセル)
RotationTRotation。ページに適用される表示回転。ro0 (既定)、ro90、ro180、ro270 のいずれか
OptionsTRenderOptions。レンダリング品質と動作を制御する TRenderOption フラグの集合
ColorTColor。レンダリング前にビットマップへ適用される背景塗り色。既定値は clWhite です

説明

Color = clNone または Color = clDefault を指定すると、背景を透明にして alpha 対応の PDFium ビットマップを使います。描画されていないタイルのピクセルは、ネイティブのページ背景透過クエリーの結果にかかわらず alpha がゼロのままです。既定の clWhite は不透明な背景です

現在のページの矩形タイルをレンダリングします。指定サイズでフルページをレンダリングする RenderPage と異なり、RenderTile は切り取った領域だけをレンダリングします。フルページを一度にレンダリングするとメモリを消費しすぎるような大型ページの高解像度表示に最適です

PageWidth / PageHeight はページ全体のレンダリングサイズ (いわゆる「ズームレベル」) を定義し、Left / Top / Width / Height はその全体サイズ内の出力ウィンドウを定義します

例

// Render top-left 800x600 tile of a page scaled to 2000x2828
var Bmp: TBitmap;
Bmp := Pdf.RenderTile(0, 0, 800, 600, 2000, 2828);
try
  Image1.Picture.Assign(Bmp);
finally
  Bmp.Free;
end;

関連項目

RenderPage, PageWidth