THotPDF.AddImage

THotPDF

向 PDF 文档添加图像并返回图像索引，供 CurrentPage.ShowImage 绘制

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;

说明

调用 AddImage 注册图像并获取图像句柄，稍后可用 CurrentPage.ShowImage 绘制。file 重载接受 BMP、JPEG 和 JPEG 2000 文件，graphic 重载接受已加载的 TGraphic 实例。Compression 选择 PDF 图像压缩方法。IsMask 表示图像是否用作 mask，MaskIndex 标识关联的 mask 图像

需要显式接好二值 /ImageMask 或 /Mask、又不想手动传底层 IsMask 参数时，使用 AddImageAsMask 与 AddImageWithMask。要用单张图像覆盖 JpegQuality、同时保留后续图像的文档默认值时，使用 AddImageWithJpegQuality。对 1 位位图内容，用 AddMonochromeImageAuto 或 icAutoMono 让 HotPDF 根据图像尺寸与合规约束在 Flate、CCITT Group 4 或 JBIG2 之间选择。两次 AddImage 调用在相同掩码关系下产生完全相同的编码图像数据时，HotPDF 复用既有 image XObject 并返回既有图像索引，而不是嵌入重复流

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;

另请参阅: CurrentPage.ShowImage