ImageCompareライブラリ (Ver1.0.0.0) 使用方法

• <使用方法>


1. VisualStudioにてプロジェクトを作成します。


2. フレームワークを[.NetFramework4.5]にします。


3. 任意の場所に[ImageCompareLibrary.dll]と[ImageCompareLibrary.xml]を設置します。


4. [ImageCompareLibrary.dll]を参照設定します。




• <画像比較について>


• 一致度は、0が最も低く、1が完全一致となります。
  画像の種類・サイズにもよりますが、0.98以上が類似画像の目安です。


• コンストラクタのResizeSizeプロパティの値を大きくすることで、より厳密に画像比較を行えますが、処理速度は大きく低下します。




• <メソッド>
1. コンストラクタ
• 説明

ImageCompareライブラリを初期化します。


• メソッド

new ImageCompareLibrary(int ResizeSize = 16, System.Drawing.Drawing2D.InterpolationMode ResizeMode = InterpolationMode.Default)


• 引数



引数名	型	説明
ResizeSize	int	ハッシュ作成時の画像サイズ （省略時:16）
ResizeMode	System.Drawing.Drawing2D.InterpolationMode	ハッシュ作成時の画像リサイズ補間方法 （省略時:InterpolationMode.Default） InterpolationModeについてはこちらをご覧ください。



• 使用例



ImageCompareLibrary.ImageCompareLibrary objLibrary = new ImageCompareLibrary.ImageCompareLibrary(16, System.Drawing.Drawing2D.InterpolationMode.Bilinear);





2. 画像の比較
1. ファイルパス指定


• 説明

画像のファイルパス指定し、ImageCompareライブラリにて比較後、結果を返します。


• メソッド

double ImageCompare(string ImageFilePath1, string ImageFilePath2)


• 引数



引数名	型	説明
ImageFilePath1	string	比較する画像ファイルのフルパス
ImageFilePath2	string	比較する画像ファイルのフルパス



• 戻り値



型	説明
double	一致度 0(完全不一致)〜1(完全一致)



• 使用例



using (ImageCompareLibrary.ImageCompareLibrary objImageCompareLibrary = new ImageCompareLibrary.ImageCompareLibrary()) {   double dblCompare = objImageCompareLibrary.ImageCompare(txtFilePath1.Text, txtFilePath2.Text); }




2. Bitmapデータ指定


• 説明

画像のBitmapデータ指定し、ImageCompareライブラリにて比較後、結果を返します。


• メソッド

double ImageCompare(System.Drawing.Bitmap ImageFileData1, System.Drawing.Bitmap ImageFileData2)


• 引数



引数名	型	説明
ImageFileData1	System.Drawing.Bitmap	比較対象の画像データ
ImageFileData2	System.Drawing.Bitmap	比較対象の画像データ



• 戻り値



型	説明
double	一致度 0(完全不一致)〜1(完全一致)



• 使用例



using (ImageCompareLibrary.ImageCompareLibrary objImageCompareLibrary = new ImageCompareLibrary.ImageCompareLibrary()) {   Bitmap bmpData1 = new Bitmap(txtFilePath1.Text);   Bitmap bmpData2 = new Bitmap(txtFilePath2.Text);   double dblCompare = objImageCompareLibrary.ImageCompare(bmpData1, bmpData2); }




3. ハッシュデータ指定


• 説明

画像のハッシュデータ指定し、ImageCompareライブラリにて比較後、結果を返します。
ハッシュデータの取得方法は「画像ハッシュ値の算出」をご参照ください。


• メソッド

double ImageCompare(System.Collections.BitArray ImageHash1, System.Collections.BitArray ImageHash2)


• 引数



引数名	型	説明
ImageHash1	System.Collections.BitArray	比較対象の画像ハッシュ値
ImageHash2	System.Collections.BitArray	比較対象の画像ハッシュ値



• 戻り値



型	説明
double	一致度 0(完全不一致)〜1(完全一致)



• 使用例



using (ImageCompareLibrary.ImageCompareLibrary objImageCompareLibrary = new ImageCompareLibrary.ImageCompareLibrary()) {   System.Collections.BitArray bitHash1 = objImageCompareLibrary.ImageHash(txtFilePath1.Text);   System.Collections.BitArray bitHash2 = objImageCompareLibrary.ImageHash(txtFilePath2.Text);   double dblCompare = objImageCompareLibrary.ImageCompare(bitHash1, bitHash2); }







3. 画像ハッシュ値の算出
1. ファイルパス指定


• 説明

画像のファイルパス指定し、ImageCompareライブラリにて画像ハッシュ値を算出後、結果を返します。


• メソッド

System.Collections.BitArray ImageHash(string ImageFilePath)


• 引数



引数名	型	説明
ImageFilePath	string	画像ハッシュ値を計算する画像ファイルのフルパス



• 戻り値



型	説明
System.Collections.BitArray	画像ハッシュ値



• 使用例



using (ImageCompareLibrary.ImageCompareLibrary objImageCompareLibrary = new ImageCompareLibrary.ImageCompareLibrary()) {   System.Collections.BitArray bitHash1 = objImageCompareLibrary.ImageHash(txtFilePath1.Text); }




2. Bitmapデータ指定


• 説明

画像のBitmapデータ指定し、ImageCompareライブラリにて画像ハッシュ値を算出後、結果を返します。


• メソッド

System.Collections.BitArray ImageHash(System.Drawing.Bitmap ImageBitmapData)


• 引数



引数名	型	説明
ImageBitmapData	System.Drawing.Bitmap	画像ハッシュ値を計算する画像ファイルのフルパス



• 戻り値



型	説明
System.Collections.BitArray	画像ハッシュ値



• 使用例



using (ImageCompareLibrary.ImageCompareLibrary objImageCompareLibrary = new ImageCompareLibrary.ImageCompareLibrary()) {   System.Drawing.Bitmap bmpData1 = new Bitmap(txtFilePath1.Text);   System.Collections.BitArray bitHash1 = objImageCompareLibrary.ImageHash(bmpData1); }