THPDFViewerModel Snapshot Methods

Tworzy obrazy stron bez konstruowania kontrolki Viewer i ponownie wykorzystuje cache renderowania załadowanych stron

Declarations

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

Uwagi dotyczące użycia

• The caller owns and must free each returned TBitmap
• Wartości DPI są ograniczane do obsługiwanego zakresu od 12 do 2400
• Invalid document or page state returns nil from the creation methods
• CreatePageThumbnail i CreateCurrentPageThumbnail dobierają DPI renderu dopasowane do żądanych granic pikselowych, zachowują proporcje strony, stosują obrót widoku i nigdy nie zwracają bitmapy szerszej ani wyższej niż podane limity
• PrefetchPageSnapshots i PrefetchCurrentPageSnapshots rozgrzewają wyśrodkowane okno stron asynchronicznie i ograniczają liczbę zaplanowanych stron do RenderCacheCapacity
• Metody prefetch zwracają liczbę zaplanowanych stron, używają indeksów od zera i zastępują wcześniejsze żądanie prefetch załadowanych stron
• Tworzenie snapshotu wyprzedza aktywną pracę prefetch przed renderem pierwszoplanowym, a telemetria prefetch na poziomie dokumentu rozróżnia wyprzedzenie pierwszoplanowe od jawnego anulowania
• SaveCurrentPageSnapshotToBMP zapisuje wyjście Windows BMP i zwraca informację, czy plik został utworzony
• THPDFViewerSnapshotFormat wybiera vsfBMP, vsfJPEG albo vsfPNG
• Wyjście do strumienia zaczyna się od bieżącej pozycji strumienia i nigdy nie przejmuje własności strumienia
• Jakość JPEG jest dociskana do zakresu od 1 do 100
• Wyjście do pliku usuwa pusty albo częściowo zakodowany plik, gdy zapis się nie powiedzie