AddImageFromFileOffset
画像処理
説明
ファイルの一部から選択したドキュメントに画像を追加します
例として、多数の画像が 1 つのファイルに連結されている場合、この関数により個々の画像を抽出し文書へ追加できます
画像をドキュメントに追加すると、PDF ファイルサイズをさらに増やさずに任意のページへ複数回描画できます
対応する画像ファイル形式: BMP、TIFF、JPEG、PNG、GIF、WMF、EMF
PDF バージョンの動作: コンポーネントあたり 16 ビットの画像データをインポートするには PDF 1.5 が必要です。文書が PDF 1.4 以下に設定され、保存バージョンがロックされていない場合、AddImageFromFileOffset は文書を自動的に PDF 1.5 へ引き上げ、16-bit image samples を AutoBumpedFeatures に記録します。呼び出し元が低い保存バージョンをロックしている場合、互換性ゲートは LastErrorCode 602 で保存を拒否します
BMP および TIFF 画像では、この関数を呼び出す前に CompressImages 関数を呼び出して画像データを圧縮できる 他の画像形式は自動的に圧縮される
構文
Delphi
Function TPDFlib.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;ActiveX
Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As LongDLL
int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);パラメータ
| FileName | 画像を含むファイルの名前 |
|---|---|
| Offset | 必要な画像が始まるファイル内オフセットです。ファイルの最初のバイトのオフセットは 0 です |
| DataLength | 画像データのバイト単位の長さ |
| Options | 複数ページ TIFF 画像では、このパラメーターで読み込むページ番号を指定する。PNG 画像の場合、0 = 通常どおり画像を読み込む、1 = アルファチャネルをグレースケール画像として読み込む、2 = 画像とアルファチャネルを読み込む（アルファは 8 ビットに制限）、3 = 画像を読み込む（画像を 8 ビット/チャネルに制限）、4 = アルファチャネルを読み込む（8 ビット/チャネルに制限）、5 = アルファチャネル付き画像を読み込む（両方を 8 ビット/チャネルに制限）、6 = 画像とアルファチャネルを読み込む、7 = 画像と ICC カラープロファイルを読み込む。他の画像タイプではこのパラメーターを 0 に設定する。Options を -1 に設定すると、TIFF、EMF、WMF 画像を GDI+ グラフィックスライブラリで強制的に読み込む。Options パラメーターを -PageNumber に設定すると（例: ページ 3 では -3）、複数ページ TIFF 画像も GDI+ を使用して読み込める |
戻り値
| 0 | 画像をファイルから読み取れませんでした。画像データが無効であるか、ファイルが見つからなかった可能性があります |
|---|---|
| Non-zero | 画像がファイルから読み取られ、ドキュメントに正常に追加されました。返される値は画像の ID で、DrawImage などの画像描画関数で使用できます |