AddImageFromStream

画像処理

説明

TStream から選択文書へ画像を追加する

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

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

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

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

構文

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

パラメータ

InStream	イメージデータを含む TStream オブジェクト。ストリーム内の現在位置は無視され、イメージデータはストリームの位置 0 から読み取られる
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+ でも読み込めます

InStream

イメージデータを含む TStream オブジェクト。ストリーム内の現在位置は無視され、イメージデータはストリームの位置 0 から読み取られる

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	ストリームから有効な画像データを読み取るときにエラーが発生しました画像は文書に正常に追加されました。戻り値は DrawImage などの画像描画関数で使用できる画像 ID です
Non-zero