THPDFPage.SetPageThumbnail / ClearPageThumbnail

THPDFPage

 

支持的图像格式

附加或移除页面缩略图图像(PDF 页面 /Thumb 条目,ISO 32000-1 §12.3.4)。PDF 阅读器(Adobe Acrobat、Foxit、浏览器阅读器)可在导航面板中直接显示引用的图像,无需自行光栅化页面内容,因此打开图像密集型归档文件会明显更快。

 

Delphi 语法:

procedure SetPageThumbnail(ImageIndex: Integer);

procedure ClearPageThumbnail;

 

参数

ImageIndex 是之前调用 THotPDF.AddImageTHotPDF.AddImageFromFile 返回的值。底层 Image XObject 会按规范以间接方式引用,因此同一图像也可以绘制到普通页面上而不会冲突。传入负索引可移除现有 /Thumb 条目。

 

说明

每个 PDF 页面都可以在 /Thumb 键中保存一个指向 Image XObject 的间接引用。该图像通常是降采样的 8 位 DeviceGray、DeviceRGB 或 Indexed 位图(Acrobat 大致按每个页面点对应一个缩略图点处理),但 HotPDF 不验证色彩空间,调用方决定附加什么图像。ClearPageThumbnail 会移除之前附加的缩略图。SetPageThumbnail(-1) 等同于 ClearPageThumbnail。如果传入的 ImageIndex 不在文档图像列表范围内,会抛出带说明的异常。

 

示例

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

 

可用性

HotPDF v2.119.13。PDF /Thumb 条目是 PDF 1.0 功能,不受 PDF/A、PDF/X 或 PDF/UA 合规模式限制。若要让阅读器打开时显示缩略图面板,还需要设置 THotPDF.PageMode := pmUseThumbs

 

另请参阅: 支持的图像格式, THPDFPage