PDFium Component Docs

RenderTile Methode

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
Komponente: TPdf  ·  Unit: PDFium
Rendert einen rechteckigen Bereich einer Seite in ein neues Bitmap. Das zurückgegebene Bitmap muss manuell freigegeben werden

Syntax

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

Left, TopInteger. Obere linke Ecke des zu rendernden Kachelbereichs, in Pixeln, bezogen auf die gesamte Seite bei der angegebenen Zoomstufe
Width, HeightInteger. Größe der Kachel in Pixeln. Das zurückgegebene Bitmap hat diese Abmessungen
PageWidth, PageHeightInteger. Die vollständigen Seitendimensionen in Pixeln bei der gewünschten Zoomstufe. Daraus ergibt sich die Skala, mit der die Seite gerendert wird
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. Ein vorhandenes TBitmap, in das die Kachel gerendert wird. Das Erzeugen und Freigeben dieses Bitmaps liegt beim Aufrufer
Left, TopInteger. Obere linke Ecke des zu rendernden Kachelbereichs, in Pixeln, bezogen auf die gesamte Seite bei der angegebenen Zoomstufe
Width, HeightInteger. Größe der Kachel in Pixeln
PageWidth, PageHeightInteger. Die vollständigen Seitendimensionen in Pixeln bei der gewünschten Zoomstufe
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 applied to the bitmap before rendering. Defaults to clWhite.

Beschreibung

Rendert eine rechteckige Kachel der aktuellen Seite. Anders als RenderPage, das die ganze Seite in einer bestimmten Größe rendert, rendert RenderTile nur einen zugeschnittenen Bereich. Das ist ideal für die hochauflösende Darstellung großer Seiten, wenn das vollständige Rendern der Seite auf einmal zu viel Speicher verbrauchen würde

PageWidth / PageHeight definieren die gesamte gerenderte Seitengröße (die "Zoomstufe"), und Left / Top / Width / Height definieren das Ausgabefenster innerhalb dieser Gesamtgröße

Beispiel

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

Siehe auch

RenderPage, PageWidth