THotPDF.AddImage Método

 

THotPDF.AddImage

THotPDF

 

Arriba  Anterior  Siguiente

Agrega una imagen especificada al documento PDF

 

Sintaxis Delphi:

function AddImage(Image: TGraphic; Compression: THPDFImageCompressionType;

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

 

function AddImage(FileName: TFileName; Compression: THPDFImageCompressionType;

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

 

Descripción

Llama a AddImage para registrar una imagen y obtener un identificador de imagen que después puede dibujarse con CurrentPage.ShowImage. La sobrecarga de 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 la 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 embebe sin recompresión y conserva su modelo de color: los JPEG en escala de grises se convierten en imágenes DeviceGray, los JPEG a color en DeviceRGB y los CMYK en DeviceCMYK. Los archivos JPEG se reconocen por su contenido, así los nombres en mayúsculas y la extensión .jpeg también funcionan. 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 más oscuro de la paleta como negro, sin importar el orden en que la paleta lo liste

 

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

 

Descripción

Llama a AddImage para registrar una imagen y obtener un identificador que después puede dibujarse con CurrentPage.ShowImage. La sobrecarga de 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 la imagen PDF. IsMask indica si la imagen se usa como máscara y MaskIndex identifica la imagen de máscara asociada

Use AddImageAsMask y AddImageWithMask cuando necesite un cableado explícito de /ImageMask o /Mask sin pasar manualmente el argumento de bajo nivel IsMask. Use AddImageWithJpegQuality para sobrescribir JpegQuality en una imagen concreta conservando el valor del documento para las siguientes. Use AddMonochromeImageAuto o icAutoMono para 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 a AddImage producen datos de imagen codificados idénticos con la misma relación de máscara, HotPDF reutiliza el image XObject existente y devuelve el índice de imagen existente en lugar de embeber un stream duplicado

 

Ejemplo de código


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;

 

Ver también: CurrentPage.ShowImage