Intel Image Processing Library

Intel社のImage Processing Libraryのメモ。
IntelのCPUの速さを世に知らしめるため、Intel社の小父さん達が気合を入れて作った無料の画像処理ライブラリです。MMX機能付きパソコンでその威力を発揮します。いっちょまえに32bitDIBにも対応してて便利。インテル・イメージ処理ライブラリのページから入手できますが、メールアドレスその他の入力が必要です。弱点はマニュアルが英語である事ですかね。
最近、日本語のIPL, OpenCVを使った画像処理プログラミングを見つけました。PDF版まであります。
それとは別にIPLについてもあります。
以下の記述は、VC++ Ver5を前提にしています。バージョンは2.1までしか使っていません。最新は2.5だったかな？(2002/5/15) 今はIntelのページには置いてなくてhttp://www.cvmt.dk/~hn/Images/install/IPL/にあるみたい。

使用するための設定
良く使うＡＰＩ
ユーザーＤＬＬの作成
私がはまったこと

使うための設定

ライブラリをそのままインストールすると"C:\Plsuite\lib\msvc\"に.libが、"C:\Plsuite\include\"にヘッダーが出来る。
ライブラリの追加は"プロジェクト"→"設定"でダイアログが開く。"リンク"のタブを開き、一番上のコンボボックスで"インプット"を選択。
"ｵﾌﾞｼﾞｪｸﾄ/ﾗｲﾌﾞﾗﾘﾓｼﾞｭｰﾙ(M)"の欄にipl.libを入力
"追加ライブラリのパス"に上記のパスを入力。パスの区切りは\ではなくて/なので注意。
ヘッダの追加は上記の設定ダイアログで"C/C++"タブを選択。"プロジェクトオプション"欄に/I "c:\Plsuite\include\\"を追加。
IPL関数を使うソースに"ipl.h"をインクルードする。

私がはまったこと

αチャンネル付のイメージをアロケートして使うとき、ROI=NULLだと、αチャンネルが処理されません。色とは別途αチャンネルを指定して処理する必要があります。

私が良く使うAPI

他にも沢山ありますが、私がよく使う分だけ。Version 1と２では結構変更が多いので注意。2→2.5では余り変わらないようです。

DIBからIPLの内部形式に変換
1. img = iplCreateImageHeader()でヘッダーを作成。ヘッダーには大きさ、ピクセル深度、カラーモデルその他が書かれる。この関数でヘッダーが出来る。失敗したら、戻り値はNULL
2. iplAllocateImage(img1, 0x0)でこのヘッダーに基づくイメージを作成する。第2パラメータはピクセルを埋める初期値。0xffffffffを指定すると、ピクセルを初期化しない。0xffffffffで初期化したい時困る事に気付いたのか,Ver2ではパラメータが３つになっている(笑)。
3. iplConvertFromDIB(bif1, img1);でLPBITMAPINFOHEADER bif1のBMPを内部形式に変換する。
  ドキュメントには、イメージデータを事前にアロケートしなくても動作するようなことが書いてあるけど、アロケートしないとエラーをくらった。
  ヘッダーとデータが連続していないDIBだと落ちるので注意。連続していないDIBを扱うには、Ver2のiplConvertFromDIBSep(ヘッダポインタ、データポインタ、IPLヘッダー)を使う。色数その他はDIBがどうなっていても、IPLヘッダーに指定したものに変換される。 IPLイメージが32ビットの場合は、DIBが32ビットの場合はそのαチャンネルがセットされるが、その他の場合、αチャンネルは０のまま(255で埋められたりしない)ので注意。
  Ver2.5にはiplConvertFromDIBSep()という、データ部を分離して指定できるAPIが出来ました。
```
 // 以下はCreateImageHeaderのパラメータ αチャンネル付き24bit画像
 int   nChannels = 4; //イメージ内のチャンネル数.ここでは４
 int   alphaChannel = 4; //αチャンネルは何番目のチャンネルか。ここでは４番目
 int     depth = IPL_DEPTH_8U; //各チャンネルは何ビットか。ここでは８ビット
 char* colorModel="RGBA"; // カラーモデル"RGB","GRAY","MSI"
 char*   channelSeq="BGRA"; // チャンネルの並びの順
 int     dataOrder=IPL_DATA_ORDER_PIXEL;
//int     dataOrder=IPL_DATA_ORDER_PLANE;
 int   origin=IPL_ORIGIN_TL; //データの並び方 TLは左上から始まる.BLなら左下から始まる
 int     align=IPL_ALIGN_DWORD;
// int     align=IPL_ALIGN_QWORD; // Ver1ではサポートされていないので要注意
 int     width;
 int   height;
 IplROI* roi=NULL; // ROIは使わない
 IplImage* maskROI; // Ver2.0用のマスク
 void* imageId=NULL; // 使わない
 IplTileInfo* tileInfo=NULL; //使わない

 img1 = iplCreateImageHeader(
	nChannels,  alphaChannel, depth,
	colorModel, channelSeq,   dataOrder,
	origin,     align,
	bif1->biWidth, bif1->biHeight,　roi, // Ver2.0ではここにmaskROIが入る
	imageId,    tileInfo);
        
 iplAllocateImage(img1, 埋める数字(0xffffffffなら埋めない));
// iplAllocateImage(img1, 埋める/埋めない(0), 埋める数字); // Ver2では、0xffffffffで埋めることが出来る。
 
```
IPLの内部形式からDIBに変換
1. 画像の大きさと同じDIBヘッダー、イメージ領域を確保。色数その他はDIBヘッダーに指定したものが作成される。
2. iplConvertToDIB(img1, bif1, 1, 1);第3パラメータはディザ処理するか、第4パラメータは使用するパレットの形態。iplConvertoToDIBsep()が無いのが非常に不便。
後始末
1. iplDeallocate(img1, IPL_IMAGE_ALL);で確保したイメージを開放する。
  第2パラメータはIPL_IMAGE_HEADERならヘッダーのみ、IPL_IMAGE_IMAGEならイメージデータのみ、IPL_IMAGE_ROIならROIのみ、IPL_IMAGE_ALLなら全て開放
α合成
1. iplAlphaComposite(iplImage *imgA, iplImgage *imgB, iplImage *imgC, int type, iplImage *imgAa, iplImage *imgBa, ipcImage *imgCa, BOOL pre, BOOL divide)
  imgAの上にimgBを重ねた画像をimgCに出力する。
  typeは合成方法を指定する。
乗算合成
1. void iplMultiplyScale(IplImage* imgA, IplImage*　imgB, IplImage* imgC)
  imgAの上にimgBを、フォトレタッチソフトなどでいう所の「乗算合成」した画像をimgCに出力する。正確にはimgC = imgA * imgB / ピクセルの取りうる最大の値(24BitBMPなら255)である。
2. 似た関数に
  void iplMultiply(IplImage* imgA, IplImage*　imgB, IplImage* imgC)
  があるが、こちらは本当に imgC = imgA * imgBなので、桁あふれに注意が必要。ていうか使えない(笑)

ユーザーDLLの作成

IPLライブラリは、各CPU毎に最適化されたDLL５個から構成されます。
IplP6.dll, IplP5.dll, IplM6.dll, IplM5.dll, IplPX.dll
それぞれが約２MBの大きさ(Ver2.0)有りますから、そのまま配布するには余りに巨大です。
そこで、必要な関数のみを抜き出したユーザーDLLを作成するためのパッケージも、Ver2.0には含まれています。
c:\Plsuite\examples\userdll.ipl\配下のファイルがそれです。丸ごとコピーして使うといいでしょう。

コンパイラをコマンドプロンプトから使用できるようにする。
ユーザーDLL作成は、コマンドプロンプトからmakeall.batを実行することで行います。このため、コマンドプロンプトからnmakeを始めとするVC++のツールが使える様設定することが必要です。
サンプルのコピーをそのままメイクしてみる。
ちなみにサンプルのメイクファイルはc:\Plsuite\examples\foo\配下で実行されることを前提にしていますので注意して下さい。
>makeall.bat
すると、何やら大量のエラーが…
makeall.batを編集
makeall.batの中身を見てみます。何だか分かりませんが、'2'を全て削除します(おいおい…)。
>makeall.bat
すると、カレントディレクトリに"your*.dll"が出来ました。…ん～む……。ま、できたからいいか(笑)。
で、いよいよ本題に入ります
ユーザーDLLの名前を決定
とりあえず私は"tga32"にします。
userdll.hにその名前を書きます。"your"を"tga32"に置換しましょう。
そして、makefileの"CustName="の右辺を"tga32"にします。
使用関数の定義
使う関数をリストアップして、userdll.hとExpList.defに書き加えます。本物のヘッダー(ipl.h)からコピーするのが間違い無くていいでしょう。
DLL, LIB作成
>makeall.batを実行します。
カレントディレクトリに
tga32.lib, tga32.dll, tga32M5.dll, tga32M6.dll, tga32P5.dll, tga32P6.dll, tga32PX.dll
が作成されました。これらのＤＬＬにリストアップした関数が入っている筈です。
ユーザーDLLの使用法
作成されたtga32.libをDLLを使うプロジェクトのフォルダーにコピーします。
Developer studioのプロジェクト→設定ダイアログの"ｵﾌﾞｼﾞｪｸﾄ/ﾗｲﾌﾞﾗﾘﾓｼﾞｭｰﾙ"に、tga32.libを追加します。テスト段階で"ipl.lib"をリンクしていた場合は、削除します。

リビルドします。
こうして作られたのが不透明ドリちゃんです。

フリーソフトウェアへ戻る
ホームページへ戻る
お手紙はnekora@mapletown.netまで☆