PDFiumPas 文件

RenderTile 方法

元件: TPdf  ·  單元: PDFium
將頁面的矩形區域繪製成新的點陣圖,回傳的點陣圖需要手動釋放

Syntax

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(預設)、ro90ro180ro270
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(預設)、ro90ro180ro270
OptionsTRenderOptions。一組控制算繪品質與行為的 TRenderOption 旗標
ColorTColor。算繪前套用到點陣圖的背景填色。預設為 clWhite

Description

算繪目前頁面的一個矩形圖塊。RenderPage 會以指定大小算繪整個頁面,RenderTile 則只算繪 裁切後的區域。這非常適合大頁面的高解析度顯示,因為 一次算繪整頁會耗用過多記憶體

PageWidth / PageHeight 定義頁面算繪後的 總尺寸(「縮放層級」),而 Left / Top / Width / Height 定義該總尺寸內的 輸出視窗

Example

// 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;

See Also

RenderPage, PageWidth