THPDFPage.SetPageThumbnail / ClearPageThumbnail

THPDFPage

Присоединяет или удаляет миниатюру страницы (запись /Thumb страницы PDF, ISO 32000-1 §12.3.4). PDF-просмотрщики (Adobe Acrobat, Foxit, браузерные просмотрщики) показывают указанное изображение в панели навигации без самостоятельной растеризации содержимого страницы, что заметно ускоряет открытие архивов с большим количеством изображений

Delphi syntax:

procedure SetPageThumbnail(ImageIndex: Integer);

procedure ClearPageThumbnail;

Параметры

ImageIndex - это значение, возвращенное предыдущим вызовом THotPDF.AddImage или THotPDF.AddImageFromFile. Базовый Image XObject указывается косвенной ссылкой согласно спецификации, поэтому то же изображение можно также рисовать на обычной странице без конфликта. Передайте отрицательный индекс, чтобы удалить существующую запись /Thumb

Описание

Each PDF page can carry an indirect reference to an Image XObject in its /Thumb key. The image is normally a downsampled 8-bit DeviceGray, DeviceRGB, or Indexed bitmap (Acrobat uses roughly one thumbnail point per page point), but HotPDF does not validate the colour space – the caller chooses what to attach. ClearPageThumbnail removes any previously attached thumbnail. SetPageThumbnail(-1) is equivalent to ClearPageThumbnail. Passing an ImageIndex that is not in range of the document’s image list raises a descriptive exception.

Пример

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

Availability

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.

См. также: Supported Image Formats, THPDFPage