Método THotPDF.AddImage

Adiciona uma imagem ao documento PDF e retorna um índice de imagem que CurrentPage.ShowImage pode desenhar

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;

Chame AddImage para registrar uma imagem e obter um handle de imagem que pode ser desenhado depois com CurrentPage.ShowImage. A sobrecarga de arquivo aceita arquivos BMP, JPEG e JPEG 2000, enquanto a sobrecarga gráfica aceita uma instância carregada de TGraphic. Compression seleciona o método de compressão de imagem do PDF. IsMask indica se a imagem é usada como máscara, e MaskIndex identifica a imagem de máscara associada. Com icJpeg um arquivo JPEG ou um TJPEGImage é embutido sem recompressão e mantém o próprio modelo de cor: JPEGs em tons de cinza viram imagens DeviceGray, JPEGs coloridos DeviceRGB e JPEGs CMYK DeviceCMYK. Arquivos JPEG são reconhecidos pelo conteúdo, então nomes em maiúsculas e a extensão .jpeg também funcionam. Com icFlate, bitmaps de paleta de 1, 4 e 8 bits mantêm a própria profundidade de bits e a própria paleta. Os filtros bilevel (icCCITT31, icCCITT32, icCCITT42, icJBIG2) tratam a cor mais escura da paleta como preto, qualquer que seja a ordem em que a paleta lista as cores

Use AddImageAsMask e AddImageWithMask quando precisar de fiação explícita de /ImageMask ou /Mask binária sem passar manualmente o argumento de baixo nível IsMask. Use AddImageWithJpegQuality para sobrescrever JpegQuality para uma imagem mantendo o padrão do documento para imagens posteriores. Use AddMonochromeImageAuto ou icAutoMono para deixar o HotPDF escolher Flate, CCITT Group 4 ou JBIG2 para conteúdo de bitmap de 1 bit com base no tamanho da imagem e nas restrições de conformidade. Quando duas chamadas AddImage produzem dados de imagem codificados idênticos com a mesma relação de máscara, o HotPDF reutiliza o Image XObject existente e retorna o índice de imagem existente em vez de embutir um stream duplicado

Exemplo 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;