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;

Примечания по использованию

• Вызывающий владеет и обязан освободить каждый возвращённый TBitmap
• Значения DPI ограничиваются поддерживаемым диапазоном от 12 до 2400
• При некорректном состоянии документа или страницы методы создания возвращают nil
• CreatePageThumbnail и CreateCurrentPageThumbnail выбирают DPI отрисовки под запрошенные границы в пикселях, сохраняют пропорции страницы, применяют поворот view и никогда не возвращают bitmap шире или выше заданных пределов
• PrefetchPageSnapshots и PrefetchCurrentPageSnapshots асинхронно прогревают центрированное окно страниц и ограничивают число планируемых страниц значением RenderCacheCapacity
• Методы prefetch возвращают число запланированных страниц, используют индексы страниц с нулевой базой и замещают любой предыдущий запрос prefetch загруженной страницы
• Создание snapshot вытесняет активную работу prefetch перед отрисовкой на переднем плане, а телеметрия prefetch на уровне документа отличает такое вытеснение от явной отмены
• SaveCurrentPageSnapshotToBMP пишет вывод в Windows BMP и возвращает признак того, создан ли файл
• THPDFViewerSnapshotFormat выбирает vsfBMP, vsfJPEG, или vsfPNG
• Вывод в stream начинается с текущей позиции stream и никогда не передаёт владение stream
• Качество JPEG ограничивается диапазоном от 1 до 100
• При сбое сохранения файловый вывод удаляет пустой или частично закодированный файл