THPDFPage.SetPageThumbnail / ClearPageThumbnail

THPDFPage

Anexa ou remove uma imagem miniatura de página (entrada /Thumb da página PDF, ISO 32000-1 §12.3.4). Visualizadores PDF (Adobe Acrobat, Foxit, visualizadores de navegador) exibem a imagem referenciada no painel de navegação sem rasterizar eles mesmos o conteúdo da página, tornando a abertura de arquivos com muitas imagens perceptivelmente mais rápida

Sintaxe Delphi:

procedure SetPageThumbnail(ImageIndex: Integer);

procedure ClearPageThumbnail;

Parâmetros

ImageIndex é o valor retornado por uma chamada anterior THotPDF.AddImage ou THotPDF.AddImageFromFile. O Image XObject subjacente é referenciado indiretamente conforme a especificação, portanto a mesma imagem também pode ser desenhada em uma página normal sem conflito. Passe um índice negativo para remover uma entrada /Thumb existente

Descrição

Cada página PDF pode carregar uma referência indireta para um Image XObject em sua chave /Thumb. A imagem normalmente é um bitmap reduzido de 8 bits DeviceGray, DeviceRGB ou Indexed (o Acrobat usa aproximadamente um ponto de miniatura por ponto de página), mas o HotPDF não valida o espaço de cores; o chamador escolhe o que anexar. ClearPageThumbnail remove qualquer miniatura anexada anteriormente. SetPageThumbnail(-1) equivale a ClearPageThumbnail. Passar um ImageIndex fora do intervalo da lista de imagens do documento levanta uma exceção descritiva

Exemplo

PDF := THotPDF.Create(nil);
PDF.FileName := 'archive.pdf';
PDF.BeginDoc;
Idx := PDF.AddImageFromFile('preview.jpg', icJpeg);
PDF.CurrentPage.SetPageThumbnail(Idx);
PDF.EndDoc;

Disponibilidade

HotPDF v2.119.13. The PDF /Thumb entry is a PDF 1.0 feature and is not gated under PDF/A, PDF/X, or PDF/UA compliance modes. To make the viewer open with the thumbnail panel visible, also set THotPDF.PageMode := pmUseThumbs.

Consulte também: Supported Image Formats, THPDFPage