THotPDF.AddImage

THotPDF

Adds a specified image to PDF document.

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;

說明

呼叫 AddImage 註冊 image，並取得稍後可透過 CurrentPage.ShowImage 繪製的 image handle。file overload 接受 BMP 與 JPEG files，graphic overload 接受已載入的 TGraphic instance。Compression 會選擇 PDF image compression method。IsMask 表示 image 是否作為 mask 使用，MaskIndex 則識別關聯的 mask image

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

說明

呼叫 AddImage 註冊影像並取得影像控制代碼，之後可用 CurrentPage.ShowImage 繪製。檔案 overload 接受 BMP、JPEG 與 JPEG 2000 檔案，graphic overload 則接受已載入的 TGraphic 實例。Compression 選擇 PDF 影像壓縮方法。IsMask 表示影像是否作為遮罩使用，MaskIndex 則識別關聯的遮罩影像

需要明確的二進位 /ImageMask 或 /Mask 接線時，請使用 AddImageAsMask 與 AddImageWithMask，不必手動傳入低階的 IsMask 參數。想為單一影像覆寫 JpegQuality、又保留後續影像的文件預設值時，請使用 AddImageWithJpegQuality。使用 AddMonochromeImageAuto 或 icAutoMono,HotPDF 會依影像尺寸與合規約束，為 1-bit 點陣內容選擇 Flate、CCITT Group 4 或 JBIG2。當兩次 AddImage 呼叫在相同遮罩關係下產生完全相同的編碼影像資料時，HotPDF 會重用既有的影像 XObject 並回傳既有影像索引，而不是內嵌重複的 stream

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