THotPDF.AddImage Método

Añade una imagen al documento PDF y devuelve un índice de imagen que CurrentPage.ShowImage puede dibujar

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;

Llame a AddImage para registrar una imagen y obtener un manejador de imagen que luego puede dibujarse con CurrentPage.ShowImage. La sobrecarga con archivo acepta archivos BMP, JPEG y JPEG 2000, mientras que la sobrecarga gráfica acepta una instancia TGraphic cargada. Compression selecciona el método de compresión de imagen PDF. IsMask indica si la imagen se usa como máscara, y MaskIndex identifica la imagen de máscara asociada. Con icJpeg un archivo JPEG o un TJPEGImage se incrusta sin recompresión y conserva su modelo de color: los JPEG en escala de grises se convierten en imágenes DeviceGray, los JPEG con color en DeviceRGB y los JPEG CMYK en DeviceCMYK. Los archivos JPEG se reconocen por su contenido, de modo que también funcionan los nombres en mayúsculas y la extensión .jpeg. Con icFlate, los bitmaps de paleta de 1, 4 y 8 bits conservan su profundidad de bits y su propia paleta. Los filtros bilevel (icCCITT31, icCCITT32, icCCITT42, icJBIG2) tratan el color de paleta más oscuro como negro, sea cual sea el orden en que la paleta lo liste

Use AddImageAsMask y AddImageWithMask cuando necesite cableado explícito binario /ImageMask o /Mask sin pasar manualmente el argumento de bajo nivel IsMask. Use AddImageWithJpegQuality para anular JpegQuality en una imagen conservando el valor por defecto del documento para las siguientes. Use AddMonochromeImageAuto o icAutoMono para dejar que HotPDF elija Flate, CCITT Group 4 o JBIG2 para contenido bitmap de 1 bit según el tamaño de la imagen y las restricciones de conformidad. Cuando dos llamadas AddImage producen datos de imagen codificados idénticos con la misma relación de máscara, HotPDF reutiliza el XObject de imagen existente y devuelve el índice de imagen existente en lugar de incrustar un stream duplicado

Code Example


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;