THPDFViewerModel Snapshot Methods

Creates page images without constructing a Viewer control and reuses the loaded page render cache

Declarations

function CreatePageSnapshot(PageIndex: Integer; DPI: Integer= 150): TBitmap;
function CreateCurrentPageSnapshot(DPI: Integer= 150): TBitmap;
function SaveCurrentPageSnapshotToBMP(const FileName: string; DPI: Integer= 150): boolean;

Verwendungshinweise

• Der Aufrufer besitzt jede zurückgegebene TBitmap und muss sie freigeben
• DPI-Werte werden auf den unterstützten Bereich 12 bis 2400 begrenzt
• Ungültiger Dokument- oder Seitenzustand lässt die Erzeugungsmethoden nil liefern
• CreatePageThumbnail und CreateCurrentPageThumbnail wählen eine zur gewünschten Pixelbegrenzung passende Render-DPI, wahren das Seitenverhältnis, wenden die Ansichtsrotation an und liefern nie eine Bitmap, die breiter oder höher als die gelieferten Grenzen ist
• PrefetchPageSnapshots und PrefetchCurrentPageSnapshots wärmen asynchron ein zentriertes Seitenfenster und begrenzen die eingeplante Seitenanzahl auf RenderCacheCapacity
• Die Prefetch-Methoden liefern die Anzahl der eingeplanten Seiten, nutzen nullbasierte Seitenindizes und ersetzen jede frühere Prefetch-Anfrage für geladene Seiten
• Die Snapshot-Erzeugung verdrängt aktive Prefetch-Arbeit vor dem Vordergrund-Render, während die Telemetrie auf Dokumentebene Vordergrund-Verdrängung von explizitem Abbruch unterscheidet
• SaveCurrentPageSnapshotToBMP schreibt eine Windows-BMP-Ausgabe und meldet, ob die Datei entstanden ist
• THPDFViewerSnapshotFormat wählt vsfBMP, vsfJPEG oder vsfPNG
• Die Stream-Ausgabe beginnt an der aktuellen Stream-Position und übernimmt nie das Eigentum am Stream
• Die JPEG-Qualität wird auf 1 bis 100 begrenzt
• Die Dateiausgabe entfernt eine leere oder teilweise kodierte Datei, wenn das Speichern fehlschlägt