THPDFPage.SetPageThumbnail / ClearPageThumbnail

THPDFPage

 

Supported Image Formats

یک تصویر thumbnail صفحه را وصل یا حذف می‌کند (entry /Thumb در صفحه PDF، ISO 32000-1 §12.3.4). نمایش‌دهنده‌های PDF (Adobe Acrobat، Foxit، نمایش‌دهنده‌های مرورگر) تصویر ارجاع‌شده را در پنل navigation خودشان بدون rasterise کردن محتوای صفحه نمایش می‌دهند و همین باعث می‌شود باز کردن archiveهای سنگین از نظر تصویر به‌طور محسوسی سریع‌تر شود

 

نحو Delphi:

procedure SetPageThumbnail(ImageIndex: Integer);

procedure ClearPageThumbnail;

 

پارامترها

ImageIndex مقداری است که از یک فراخوانی قبلی THotPDF.AddImage یا THotPDF.AddImageFromFile برمی‌گردد. Image XObject زیرین طبق spec به‌صورت غیرمستقیم ارجاع می‌شود، بنابراین همان تصویر می‌تواند بدون conflict روی یک صفحه عادی هم رسم شود. برای حذف entry موجود /Thumb یک index منفی بدهید

 

توضیح

هر صفحه PDF می‌تواند یک reference غیرمستقیم به یک Image XObject در کلید /Thumb داشته باشد. تصویر معمولاً یک bitmap 8-bit از نوع DeviceGray، DeviceRGB یا Indexed با downsample است (Acrobat تقریباً از هر point صفحه یک point thumbnail استفاده می‌کند)، اما HotPDF فضای رنگ را validate نمی‌کند - فراخواننده انتخاب می‌کند چه چیزی وصل شود. ClearPageThumbnail هر thumbnail قبلاً وصل‌شده‌ای را حذف می‌کند. SetPageThumbnail(-1) معادل ClearPageThumbnail است. دادن ImageIndex خارج از بازه فهرست تصویرهای سند یک exception توصیفی ایجاد می‌کند

 

مثال

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. entry /Thumb در PDF یک ویژگی PDF 1.0 است و زیر حالت‌های سازگاری PDF/A، PDF/X یا PDF/UA gate نمی‌شود. برای اینکه نمایش‌دهنده با پنل thumbnail باز شود، THotPDF.PageMode := pmUseThumbs را هم تنظیم کنید

 

همچنین ببینید: Supported Image Formats, THPDFPage