THotPDF.AddImage

THotPDF

Fügt dem PDF-Dokument ein Bild hinzu und liefert einen Bildindex, den CurrentPage.ShowImage zeichnen kann

Delphi syntax:

function AddImage(Image: TGraphic; Compression: THPDFImageCompressionType;

                            IsMask: boolean = False; MaskIndex: Integer = -1): Integer; overload;

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

function AddImageWithMask(FileName: TFileName; MaskIndex: Integer; Compression: THPDFImageCompressionType = icJpeg): Integer; overload;

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

function AddMonochromeImageAuto(FileName: TFileName): Integer; overload;

function AddImage(FileName: TFileName; Compression: THPDFImageCompressionType;

                            IsMask: boolean = False; MaskIndex: Integer = -1): Integer; overload;

Description

Mit AddImage registrieren Sie ein Bild und erhalten ein Bild-Handle, das später mit CurrentPage.ShowImage gezeichnet werden kann. Der Datei-Overload akzeptiert BMP-, JPEG- und JPEG-2000-Dateien, der Graphic-Overload eine geladene TGraphic-Instanz. Compression wählt die PDF-Bildkompressionsmethode. IsMask gibt an, ob das Bild als Maske verwendet wird, und MaskIndex bezeichnet das zugehörige Maskenbild. Mit icJpeg wird eine JPEG-Datei oder ein TJPEGImage ohne Rekompromierung eingebettet und behält ihr Farbmodell: Graustufen-JPEGs werden DeviceGray-Bilder, Farb-JPEGs DeviceRGB und CMYK-JPEGs DeviceCMYK. JPEG-Dateien werden an ihrem Inhalt erkannt, daher funktionieren auch großgeschriebene Namen und die Endung .jpeg. Mit icFlate behalten 1-Bit-, 4-Bit- und 8-Bit-Paletten-Bitmaps ihre Bittiefe und ihre eigene Palette. Die Bilevel-Filter (icCCITT31, icCCITT32, icCCITT42, icJBIG2) behandeln die dunklere Palettenfarbe als Schwarz, gleich in welcher Reihenfolge die Palette listet

Verwenden Sie AddImageAsMask und AddImageWithMask, wenn Sie die binäre Verdrahtung von /ImageMask oder /Mask explizit setzen wollen, ohne das Low-Level-Argument IsMask manuell zu übergeben. Verwenden Sie AddImageWithJpegQuality, um JpegQuality für ein einzelnes Bild zu überschreiben, während spätere Bilder beim Dokument-Default bleiben. Verwenden Sie AddMonochromeImageAuto oder icAutoMono, um HotPDF je nach Bildgröße und Konformitäts-Constraints Flate, CCITT Group 4 oder JBIG2 für 1-Bit-Bitmap-Inhalt wählen zu lassen. Erzeugen zwei AddImage-Aufrufe identische kodierte Bilddaten mit derselben Maskenbeziehung, verwendet HotPDF das vorhandene Image-XObject wieder und liefert den vorhandenen Bildindex, statt einen doppelten Stream einzubetten

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;

See also: CurrentPage.ShowImage