AddImageFromFile

画像処理

説明

ファイルから選択した文書へ画像を追加します

画像をドキュメントに追加すると、PDF ファイルサイズをさらに増やさずに任意のページへ複数回描画できます

対応する画像ファイル形式は BMP、TIFF、JPEG、PNG、GIF、WMF、EMF、WebP で、最新の画像デコーダーを利用できる場合は AVIF、HEIF、HEIC、JPEG XL にも対応します

PDF バージョンの動作: 1 成分あたり 16 ビットの画像データをインポートするには PDF 1.5 が必要です。ドキュメントが PDF 1.4 以下に設定され、保存バージョンがロックされていない場合、AddImageFromFile はドキュメントを自動的に PDF 1.5 へ引き上げ、16-bit image samples を AutoBumpedFeatures に記録します。呼び出し側がより低い保存バージョンをロックすると、互換性ゲートは LastErrorCode 602 で保存を拒否します

BMP および TIFF 画像では、この関数を呼び出す前に CompressImages 関数を呼び出して画像データを圧縮できる他の画像形式は自動的に圧縮される

構文

Delphi

Function TPDFlib.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

パラメータ

FileName	追加する画像のファイル名
Options	マルチページ TIFF 画像では読み込むページ番号を指定します。PNG 画像: 0 = 通常どおり読み込む 1 = アルファチャネルをグレースケール画像として読み込む 2 = 画像とアルファチャネルを読み込む（アルファは 8 ビットに制限） 3 = 画像を読み込む（画像は 1 チャネルあたり 8 ビットに制限） 4 = アルファチャネルを読み込む（1 チャネルあたり 8 ビットに制限） 5 = アルファチャネル付き画像を読み込む（両方を 1 チャネルあたり 8 ビットに制限） 6 = 画像とアルファチャネルを読み込む 7 = 画像と ICC カラープロファイルを読み込む 8 = 高ビット深度を保持して画像、アルファチャネル、ICC カラープロファイルを読み込む。その他の画像型では 0 に設定します。Options を -1 にすると TIFF、EMF、WMF 画像を GDI+ で強制的に読み込みます。マルチページ TIFF は Options を -PageNumber（例: 3 ページ目は -3）にして GDI+ でも読み込めます

FileName

追加する画像のファイル名

Options

マルチページ TIFF 画像では読み込むページ番号を指定します。PNG 画像: 0 = 通常どおり読み込む 1 = アルファチャネルをグレースケール画像として読み込む 2 = 画像とアルファチャネルを読み込む（アルファは 8 ビットに制限） 3 = 画像を読み込む（画像は 1 チャネルあたり 8 ビットに制限） 4 = アルファチャネルを読み込む（1 チャネルあたり 8 ビットに制限） 5 = アルファチャネル付き画像を読み込む（両方を 1 チャネルあたり 8 ビットに制限） 6 = 画像とアルファチャネルを読み込む 7 = 画像と ICC カラープロファイルを読み込む 8 = 高ビット深度を保持して画像、アルファチャネル、ICC カラープロファイルを読み込む。その他の画像型では 0 に設定します。Options を -1 にすると TIFF、EMF、WMF 画像を GDI+ で強制的に読み込みます。マルチページ TIFF は Options を -PageNumber（例: 3 ページ目は -3）にして GDI+ でも読み込めます

戻り値

0	画像を追加できませんでした。画像が見つからないか、対応していない形式です
Non-zero	画像が正常に追加されました。ImageID が返され、SelectImage や DrawImage などの関数に渡せます