AddImageFromString

画像処理

説明

メモリから選択した文書に画像を追加します

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

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

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

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

構文

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

パラメータ

Source	画像データを含む文字列。ライブラリーの ActiveX 版ではこの文字列に 16 ビット文字を含める必要があり、各文字の下位 8 ビットだけが使用されます
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+ でも読み込めます

Source

画像データを含む文字列。ライブラリーの ActiveX 版ではこの文字列に 16 ビット文字を含める必要があり、各文字の下位 8 ビットだけが使用されます

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	画像データが無効か、画像形式が非対応でした。画像を正常に追加しました。返される値は ImageID で、SelectImage や DrawImage などの関数で使用できます
1