THPDFViewerModel Snapshot Methods

Cria imagens de página sem construir um controle Viewer e reutiliza o cache de renderização de páginas carregadas

Declarações

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;

Notas de uso

• O chamador é dono de cada TBitmap retornado e deve liberá-lo
• Valores de DPI são limitados à faixa suportada de 12 a 2400
• Estado inválido de documento ou de página retorna nil nos métodos de criação
• CreatePageThumbnail e CreateCurrentPageThumbnail escolhem um DPI de renderização ajustado aos limites de pixels solicitados, preservam a proporção da página, aplicam a rotação de visão e nunca retornam um bitmap mais largo ou mais alto que os limites fornecidos
• PrefetchPageSnapshots e PrefetchCurrentPageSnapshots aquecem assincronamente uma janela centralizada de páginas e limitam a contagem de páginas agendadas a RenderCacheCapacity
• Os métodos de prefetch retornam o número de páginas agendadas, usam índices de página de base zero e substituem qualquer requisição anterior de prefetch de páginas carregadas
• A criação de snapshots preempta o trabalho de prefetch ativo antes da renderização em primeiro plano, enquanto a telemetria de prefetch no nível do documento distingue preempção em primeiro plano de cancelamento explícito
• SaveCurrentPageSnapshotToBMP grava saída Windows BMP e retorna se o arquivo foi criado
• THPDFViewerSnapshotFormat seleciona vsfBMP, vsfJPEG ou vsfPNG
• A saída em stream começa na posição atual do stream e nunca assume a posse dele
• A qualidade JPEG é limitada de 1 a 100
• A saída em arquivo remove um arquivo vazio ou parcialmente codificado quando o salvamento falha