PDFium Delphi Component Docs

Methode RenderTile

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, relativ zur vollständigen Seite bei der gegebenen Zoomstufe
Width, HeightInteger. Größe der Kachel in Pixeln. Die zurückgegebene Bitmap erhält diese Abmessungen
PageWidth, PageHeightInteger. Die vollständigen Seitenabmessungen in Pixeln bei der gewünschten Zoomstufe. Sie bestimmen den Maßstab, in dem die Seite gerendert wird
RotationTRotation. Auf die Seite angewendete Anzeigedrehung: ro0 (Standard), ro90, ro180 oder ro270
OptionsTRenderOptions. Eine Menge von TRenderOption-Flags, die Rendering-Qualität und -Verhalten steuern
ColorTColor. Hintergrundfüllfarbe für die Bitmap vor dem Rendern. Standard ist clWhite

 

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

BitmapTBitmap. Eine vorhandene TBitmap, in die die Kachel gerendert werden soll. Der Aufrufer ist für das Erstellen und Freigeben dieser Bitmap verantwortlich
Left, TopInteger. Obere linke Ecke des zu rendernden Kachelbereichs in Pixeln, relativ zur vollständigen Seite bei der gegebenen Zoomstufe
Width, HeightInteger. Größe der Kachel in Pixeln
PageWidth, PageHeightInteger. Die vollständigen Seitenabmessungen in Pixeln bei der gewünschten Zoomstufe
RotationTRotation. Auf die Seite angewendete Anzeigedrehung: ro0 (Standard), ro90, ro180 oder ro270
OptionsTRenderOptions. Eine Menge von TRenderOption-Flags, die Rendering-Qualität und -Verhalten steuern
ColorTColor. Auf die Bitmap vor dem Rendern angewendete Hintergrundfüllfarbe. Standard ist clWhite

Beschreibung

Color = clNone oder Color = clDefault wählen transparenten Hintergrund und alphafähiges PDFium-Bitmap; unbedeckte Kachelpixel behalten Alpha null unabhängig von nativer Transparenzabfrage; Standard clWhite ist opak

Rendert eine rechteckige Kachel der aktuellen Seite. Anders als RenderPage, das die vollständige 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, bei denen das Rendern der vollständigen Seite auf einmal zu viel Speicher verbrauchen würde

PageWidth / PageHeight definieren die insgesamt gerenderte Größe der Seite (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