THPDFPage.SetPageThumbnail / ClearPageThumbnail

THPDFPage

 

Supported Image Formats

מצמיד או מסיר תמונת thumbnail של עמוד, ערך PDF page ‏/Thumb לפי ISO 32000-1 §12.3.4. PDF viewers כגון Adobe Acrobat, Foxit ו-browser viewers מציגים את התמונה המופנית בלוח הניווט שלהם בלי לבצע rasterising לתוכן העמוד בעצמם, מה שמאיץ באופן מורגש פתיחת ארכיונים עתירי תמונות

 

Delphi syntax:

procedure SetPageThumbnail(ImageIndex: Integer);

procedure ClearPageThumbnail;

 

Parameters

ImageIndex הוא הערך שהוחזר מקריאה קודמת ל-THotPDF.AddImage או THotPDF.AddImageFromFile. ה-Image XObject הבסיסי מופנה indirect לפי המפרט, כך שאותה תמונה יכולה גם להיצבע בעמוד רגיל ללא התנגשות. העבר index שלילי כדי להסיר ערך /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 color 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.

 

Example

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.

 

See also: Supported Image Formats, THPDFPage