public class IplImageConverter : ICloneable, 
	IFviCopyable, IDisposable

Public Class IplImageConverter
	Implements ICloneable, IFviCopyable, IDisposable

本ライブラリの画像オブジェクト と IplImage の間で画像データの相互変換を行うクラスです。

本クラスは Pointer フィールドに設定された IplImage 構造体へのポインタを介して操作を行います。
IplImage の確保と解放を行いませんので、外部で管理してください。

本ライブラリでは IplImage 構造体のパッキングサイズを 8 bytes に設定しています。
パッキングサイズが一致していない場合は、誤った値を参照するかアクセス違反を起こす場合がありますのでご注意ください。

---

基本仕様:

本クラスでは IplImage 構造体の下記のフィールドを参照して相互変換を行います。
下表の値の覧に記載されていない値には対応していません。
その他のフィールドの情報は無視します。

表) IplImage 構造体のフィールド:

---

ピクセルの型について:

IplImage の depth と WIL の画像オブジェクトの画像種別との関係について下表に示します。
下表で (非対応) と書かれたものはデータ変換が行えないことを示します。
(対応なし) と書かれたものは一致する型が無い事を示します。
異なる型の間ではキャストによるデータ変換を行います。
各画素を単純にキャストしてコピーしており、飽和処理は行っていません。
ピクセルのサイズが大きい方から小さい方へコピーする際や符号付きと符号なしの組み合わせでは桁落ちや溢れが発生する可能性があります。

表) 型の互換性:

---

チャネル指標について:

IplImage と WIL の画像オブジェクトのチャネル指標(または RGB フィールド)の関係について下表に示します。

表) チャネル指標の対応:

---

画像データの複製 (1) (IPL ← WIL):

WIL の画像オブジェクトから IplImage へ変換する場合は下記メソッドを使用してください。
複製先の画像データ領域の再確保を行いませんので、予め 画像サイズを調整してください。

• CopyFrom(Object)

具体的な使用方法については各メソッドの説明をご参照ください。

---

画像データの複製 (2) (IPL → WIL):

IplImage から WIL の画像オブジェクトへ変換する場合は下記メソッドを使用してください。
複製先の画像データ領域の再確保を行いませんので、予め 画像サイズを調整してください。

• CopyTo(Object)

具体的な使用方法については各メソッドの説明をご参照ください。

---

画像データの複製 (3) (IPL → WIL):

IplImage から WIL の画像オブジェクトへ変換する際に画像データ領域の確保も同時に行う場合は下記メソッドを使用してください。

• ToCFviImage()()()()
• ToCFviGdiImage()()()()
• ToFIE()()()()

具体的な使用方法については各メソッドの説明をご参照ください。

---

サイズ情報の取得 (IPL 用):

IplImage を確保する際に使用するサイズ情報を取得する場合は下記メソッドを使用してください。

• ToIplImageSize()()()()

具体的な使用方法については各メソッドの説明をご参照ください。

---

サイズ情報の取得 (WIL 用):

IplImage と互換性があるサイズ情報を取得する場合は下記メソッドを使用してください。

• ToImageSize()()()()

具体的な使用方法については各メソッドの説明をご参照ください。

System..::..Object
FVIL.Ipl..::..IplImageConverter