THotPDF.AddImage

THotPDF

指定された画像を PDF ドキュメントに追加します。

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 で描画できる画像ハンドルを取得します。ファイル overload は BMP および JPEG ファイルを受け取り、graphic overload は読み込み済みの TGraphic インスタンスを受け取ります。Compression は PDF 画像圧縮方式を選択します。IsMask は画像をマスクとして使用するかどうかを示し、MaskIndex は関連付けられたマスク画像を識別します

AddImageAsMask や AddImageWithMask は、低レベルな IsMask 引数を手で渡さずに、明示的なバイナリ /ImageMask や /Mask の配線が必要なときに使います。1 枚の画像だけ JpegQuality を上書きし、その後の画像はドキュメント既定を保つには AddImageWithJpegQuality を使います。AddMonochromeImageAuto または icAutoMono なら、画像サイズと規格制約に応じて、1 ビットビットマップの圧縮として Flate / CCITT Group 4 / JBIG2 を HotPDF に選ばせられます。同じマスク関係で同じエンコード結果になる 2 つの AddImage 呼び出しは、ストリームを重複して埋め込まず、既存の画像 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;

See also: CurrentPage.ShowImage