|
Hängt ein Miniaturbild für die Seite an oder entfernt dieses (PDF-Seiteneintrag /Thumb, ISO 32000-1 §12.3.4) — PDF-Viewer (Adobe Acrobat, Foxit, Browser-Viewer) zeigen das referenzierte Bild in ihrem Navigationsbereich an, ohne den Seiteninhalt selbst zu rastern, was das Öffnen bildintensiver Archive spürbar beschleunigt
Delphi-Syntax:
procedure SetPageThumbnail(ImageIndex: Integer);
procedure ClearPageThumbnail;
Parameter
ImageIndex ist der Wert, der von einem vorherigen Aufruf von THotPDF.AddImage oder THotPDF.AddImageFromFile zurückgegeben wurde — Das zugrunde liegende Image-XObject wird gemäß der Spezifikation indirekt referenziert, sodass dasselbe Bild ohne Konflikt auch auf einer normalen Seite gezeichnet werden kann; übergeben Sie einen negativen Index, um einen vorhandenen /Thumb-Eintrag zu entfernen
Beschreibung
Jede PDF-Seite kann eine indirekte Referenz auf ein Image-XObject in ihrem /Thumb-Schlüssel enthalten — Das Bild ist normalerweise eine heruntergerechnete 8-Bit-DeviceGray-, DeviceRGB- oder Indexed-Bitmap (Acrobat verwendet ungefähr einen Thumbnail-Punkt pro Seitenpunkt), aber HotPDF validiert den Farbraum nicht; der Aufrufer wählt aus, was angehängt werden soll; ClearPageThumbnail entfernt jedes zuvor angehängte Miniaturbild; SetPageThumbnail(-1) entspricht ClearPageThumbnail; die Übergabe eines ImageIndex, der außerhalb des Bereichs der Bildliste des Dokuments liegt, löst eine entsprechende Exception aus
Beispiel
PDF := THotPDF.Create(nil);
PDF.FileName := 'archive.pdf';
PDF.BeginDoc;
Idx := PDF.AddImageFromFile('preview.jpg', icJpeg);
PDF.CurrentPage.SetPageThumbnail(Idx);
PDF.EndDoc;
Verfügbarkeit
HotPDF v2.119.13 — Der PDF-Eintrag /Thumb ist eine PDF 1.0-Funktion und wird nicht durch PDF/A-, PDF/X- oder PDF/UA-Konformitätsmodi eingeschränkt; um den Viewer so zu öffnen, dass der Thumbnail-Bereich sichtbar ist, setzen Sie auch THotPDF.PageMode := pmUseThumbs
Siehe auch: Unterstützte Bildformate, THPDFPage
|