THPDFViewerModel Snapshot Methods

Skapar sidobilder utan att konstruera en Viewer-kontroll och återanvänder renderingscachen för laddade sidor

Deklarationer

function CreatePageSnapshot(PageIndex: Integer; DPI: Integer= 150): TBitmap;
function CreateCurrentPageSnapshot(DPI: Integer= 150): TBitmap;
function CreatePageThumbnail(PageIndex, MaxWidth, MaxHeight: Integer): TBitmap;
function CreateCurrentPageThumbnail(MaxWidth, MaxHeight: Integer): TBitmap;
function PrefetchPageSnapshots(PageIndex, Radius: Integer;
  DPI: Integer= 150): Integer;
function PrefetchCurrentPageSnapshots(Radius: Integer= 1;
  DPI: Integer= 150): Integer;
function SaveCurrentPageSnapshotToBMP(const FileName: string; DPI: Integer= 150): boolean;
function SaveCurrentPageSnapshotToStream(Stream: TStream;
  ImageFormat: THPDFViewerSnapshotFormat; DPI: Integer= 150;
  JPEGQuality: Integer= 90): boolean;
function SaveCurrentPageSnapshot(const FileName: string;
  ImageFormat: THPDFViewerSnapshotFormat; DPI: Integer= 150;
  JPEGQuality: Integer= 90): boolean;

Användningsanteckningar

• Anroparen äger och måste frigöra varje returnerad TBitmap
• DPI-värden begränsas till intervallet som stöds, 12 till 2400
• Ogiltigt dokument- eller sidotillstånd returnerar nil från skapandemetoderna
• CreatePageThumbnail och CreateCurrentPageThumbnail väljer en renderings-DPI anpassad till de begärda pixelgränserna, bevarar sidans bildförhållande, tillämpar vyrotation och returnerar aldrig en bitmapp bredare eller högre än de angivna gränserna
• PrefetchPageSnapshots och PrefetchCurrentPageSnapshots värmer ett centrerat sidofönster asynkront och takar antalet schemalagda sidor vid RenderCacheCapacity
• Förhämtningsmetoderna returnerar antalet schemalagda sidor, använder nollbaserade sidindex och ersätter varje tidigare förhämtningsbegäran för laddade sidor
• Skapande av ögonblicksbild preemterar aktivt förhämtningsarbete före förgrundsrenderingen, medan dokumentnivåns prefetch-telemetri skiljer förgrundspreemtion från uttryckligt avbrott
• SaveCurrentPageSnapshotToBMP skriver Windows BMP-utdata och returnerar huruvida filen skapades
• THPDFViewerSnapshotFormat väljer vsfBMP, vsfJPEG, eller vsfPNG
• Strömutdata börjar vid strömmens aktuella position och tar aldrig ägandeskap av strömmen
• JPEG-kvaliteten begränsas från 1 till 100
• Filutdata tar bort en tom eller delvis kodad fil när sparningen misslyckas