PDFium Component Docs

RenderTile Metoda

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.
Komponent: TPdf  ·  Moduł: PDFium
Renderuje prostokątny obszar strony do nowej bitmapy. Zwrócona bitmapa musi zostać ręcznie zwolniona

Składnia

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

Left, TopInteger. Lewy górny róg obszaru kafelka do renderowania, w pikselach, względem całej strony przy danym poziomie powiększenia
Width, HeightInteger. Rozmiar kafelka w pikselach. Zwrócona bitmapa będzie miała te wymiary
PageWidth, PageHeightInteger. Pełne wymiary strony w pikselach przy żądanym poziomie powiększenia. Określają skalę renderowania strony
RotationTRotation. Display rotation applied to the page: ro0 (default), ro90, ro180, or ro270.
OptionsTRenderOptions. A set of TRenderOption flags controlling rendering quality and behavior.
ColorTColor. Background fill color for the bitmap before rendering. Defaults to clWhite.

 

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

BitmapTBitmap. Istniejący TBitmap, do którego ma być renderowany kafelek. Wywołujący odpowiada za utworzenie i zwolnienie tej bitmapy
Left, TopInteger. Lewy górny róg obszaru kafelka do renderowania, w pikselach, względem całej strony przy danym poziomie powiększenia
Width, HeightInteger. Rozmiar kafelka w pikselach
PageWidth, PageHeightInteger. Pełne wymiary strony w pikselach przy żądanym poziomie powiększenia
RotationTRotation. Display rotation applied to the page: ro0 (default), ro90, ro180, or ro270.
OptionsTRenderOptions. Zestaw flag TRenderOption sterujących jakością i zachowaniem renderowania
ColorTColor. Kolor wypełnienia tła bitmapy przed renderowaniem. Domyślnie clWhite

Opis

Renderuje prostokątny fragment bieżącej strony W przeciwieństwie do RenderPage, które renderuje całą stronę w zadanym rozmiarze, RenderTile renderuje tylko wycięty obszar To idealne dla wyświetlania dużych stron w wysokiej rozdzielczości, gdy renderowanie całej strony naraz zużyłoby zbyt dużo pamięci

PageWidth / PageHeight definiują całkowity renderowany rozmiar strony (poziom powiększenia), a Left / Top / Width / Height definiują okno wyjściowe w tym całkowitym rozmiarze

Przykład

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

Zobacz też

RenderPage, PageWidth