THPDFPage.SetPageThumbnail / ClearPageThumbnail

THPDFPage

 

Supported Image Formats

Dołącza lub usuwa obraz miniatury strony (wpis strony PDF /Thumb, ISO 32000-1 §12.3.4). Przeglądarki PDF (Adobe Acrobat, Foxit, przeglądarki w przeglądarkach internetowych) wyświetlają wskazany obraz w panelu nawigacji bez samodzielnego rasteryzowania treści strony, co zauważalnie przyspiesza otwieranie archiwów z dużą liczbą obrazów

 

Delphi syntax:

procedure SetPageThumbnail(ImageIndex: Integer);

procedure ClearPageThumbnail;

 

Parametry

ImageIndex to wartość zwrócona przez wcześniejsze wywołanie THotPDF.AddImage lub THotPDF.AddImageFromFile. Bazowy Image XObject jest odwoływany pośrednio zgodnie ze specyfikacją, więc ten sam obraz może być również rysowany na zwykłej stronie bez konfliktu. Przekaż indeks ujemny, aby usunąć istniejący wpis /Thumb

 

Opis

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.

 

Przykład

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.

 

Zobacz też: Supported Image Formats, THPDFPage