|
Attache ou retire une vignette de page (entrée /Thumb de la page PDF, ISO 32000-1 §12.3.4). Les visionneuses PDF (Adobe Acrobat, Foxit, navigateurs) affichent l'image référencée dans leur panneau de navigation sans rasteriser elles-mêmes le contenu de la page, ce qui accélère sensiblement l'ouverture des archives riches en images
Syntaxe Delphi :
procedure SetPageThumbnail(ImageIndex: Integer);
procedure ClearPageThumbnail;
Paramètres
ImageIndex est la valeur renvoyée par un appel préalable à THotPDF.AddImage ou THotPDF.AddImageFromFile. L'Image XObject sous-jacent est référencé indirectement selon la spécification, de sorte que la même image peut aussi être dessinée sur une page normale sans conflit. Passez un indice négatif pour supprimer une entrée /Thumb existante
Description
Chaque page PDF peut porter une référence indirecte vers un Image XObject dans sa clé /Thumb. L'image est généralement un bitmap 8 bits DeviceGray, DeviceRGB ou Indexed sous-échantillonné (Acrobat utilise à peu près un point de miniature par point de page), mais HotPDF ne valide pas l'espace colorimétrique – c'est l'appelant qui choisit quoi attacher. ClearPageThumbnail supprime toute vignette précédemment attachée. SetPageThumbnail(-1) est équivalent à ClearPageThumbnail. Passer un ImageIndex hors de la plage de la liste d'images du document déclenche une exception explicite
Exemple
PDF := THotPDF.Create(nil);
PDF.FileName := 'archive.pdf';
PDF.BeginDoc;
Idx := PDF.AddImageFromFile('preview.jpg', icJpeg);
PDF.CurrentPage.SetPageThumbnail(Idx);
PDF.EndDoc;
Disponibilité
HotPDF v2.119.13. L'entrée PDF /Thumb est une fonctionnalité PDF 1.0 et n'est pas soumise aux modes de conformité PDF/A, PDF/X ou PDF/UA. Pour que la visionneuse s'ouvre avec le panneau des vignettes visible, définissez aussi THotPDF.PageMode := pmUseThumbs
Formats d'image pris en charge, THPDFPage
|