THotPDF.AddImage Méthode

Appelez AddImage pour enregistrer une image et obtenir un handle d’image que CurrentPage.ShowImage pourra dessiner plus tard. La surcharge fichier accepte les fichiers BMP, JPEG et JPEG 2000, tandis que la surcharge graphique accepte une instance TGraphic chargée. Compression sélectionne la méthode de compression d’image PDF. IsMask indique si l’image sert de masque et MaskIndex identifie l’image de masque associée. Avec icJpeg, un fichier JPEG ou un TJPEGImage est embarqué sans recompression et conserve son espace colorimétrique : les JPEG en niveaux de gris deviennent des images DeviceGray, les JPEG couleur DeviceRGB et les JPEG CMYK DeviceCMYK. Les fichiers JPEG sont reconnus à leur contenu, si bien que les noms en majuscules et l’extension .jpeg fonctionnent aussi. Avec icFlate, les bitmaps à palette 1 bit, 4 bits et 8 bits conservent leur profondeur de bits et leur propre palette. Les filtres bilevel (icCCITT31, icCCITT32, icCCITT42, icJBIG2) traitent la couleur de palette la plus foncée comme noir, quel que soit l’ordre de la palette

function AddImageAsMask(FileName: TFileName; Compression: THPDFImageCompressionType = icFlate): Integer; overload;

function AddImageWithJpegQuality(FileName: TFileName; Quality: TJPEGQualityRange): Integer; overload;

Utilisez AddImageAsMask et AddImageWithMask lorsque vous avez besoin d’un câblage explicite en /ImageMask ou /Mask binaire sans passer manuellement l’argument de bas niveau IsMask. Utilisez AddImageWithJpegQuality pour déroger JpegQuality pour une image tout en préservant le défaut du document pour les images suivantes. Utilisez AddMonochromeImageAuto ou icAutoMono pour laisser HotPDF choisir Flate, CCITT Group 4 ou JBIG2 pour un contenu bitmap 1 bit selon la taille de l’image et les contraintes de conformité. Lorsque deux appels AddImage produisent des données d’image encodées identiques avec la même relation de masque, HotPDF réutilise l’XObject image existant et renvoie l’index d’image existant au lieu d’embarquer un flux dupliqué

Exemple de code



var

  ImageHandle: Integer;

begin

  ImageHandle := HPDF.AddImage( '.\Sample.jpg', icJpeg );

  HPDF.CurrentPage.ShowImage( ImageHandle, 100, 200, 150, 100 );  // Draw the image at position 100,200 with size 150x100

end;