THotPDF.AddImage

THotPDF

Aggiunge un'immagine al documento PDF e restituisce un indice immagine che CurrentPage.ShowImage può disegnare

Sintassi Delphi:

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;

Descrizione

Chiama AddImage per registrare un'immagine e ottenere un handle immagine che potrà essere disegnato in seguito con CurrentPage.ShowImage. L'overload su file accetta file BMP, JPEG e JPEG 2000, mentre l'overload su grafica accetta un'istanza TGraphic caricata. Compression seleziona il metodo di compressione immagini PDF. IsMask indica se l'immagine è usata come maschera, e MaskIndex identifica l'immagine maschera associata

Usa AddImageAsMask e AddImageWithMask quando ti serve un collegamento esplicito binario /ImageMask o /Mask senza passare manualmente l'argomento di basso livello IsMask. Usa AddImageWithJpegQuality per ignorare JpegQuality per una sola immagine conservando il valore predefinito del documento per le immagini successive. Usa AddMonochromeImageAuto o icAutoMono per lasciare che HotPDF scelga Flate, CCITT Group 4 o JBIG2 per contenuto bitmap a 1 bit in base alla dimensione dell'immagine e ai vincoli di conformità. Quando due chiamate AddImage producono dati immagine codificati identici con la stessa relazione di maschera, HotPDF riusa l'image XObject esistente e restituisce l'indice immagine esistente invece di incorporare uno stream duplicato

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;

Vedi anche: CurrentPage.ShowImage