パターン操作
[グレイサーチ (正規化相関サーチ)]

FGA グレイサーチパターンオブジェクトの生成.

画像 (FGA 画像オブジェクト) から FGA グレイサーチパターンオブジェクトを生成します。
不要になったパターンは必ず FIE ライブラリの関数 fnFIE_free_object() で解放してください。

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_alloc() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in]	himage	サーチパターンにする FGA 画像オブジェクト ( type: uc8 / ch: 1)
[in]	hmask	マスクにする FGA 画像オブジェクト ( type: bin, uc8 / ch: 1 ) NULL を投入するとマスクなしのパターンになります。
[in]	mark_offsetx	回答Ｘ座標オフセット(100倍値)
[in]	mark_offsety	回答Ｙ座標オフセット(100倍値)
[in]	filter	内部で画像ピラミッドの生成に使うフィルタの種別 F_COMP_MODE_SMOOTH 通常（平均）フィルタ 特に問題なければこれを指定 F_COMP_MODE_MIN 最小値フィルタ パターンが黒い細線で構成されているような場合に指定 F_COMP_MODE_MAX 最大値フィルタ パターンが白い細線で構成されているような場合に指定 F_COMP_MODE_AVERAGE2 再平均フィルタ パターンにカメラノイズが多い場合に指定
[out]	errorcode	エラーコード。エラーコードを受け取る必要の無い場合は、NULL を指定します。 F_ERR_NONE 正常終了 F_ERR_NOMEMORY メモリ不足 F_ERR_INVALID_OBJECT 渡されたオブジェクトの種別が異常 F_ERR_GS_NO_CONTRAST パターン画像に情報が足りないため、パターンにならない。 （==マスク部をのぞいた画像の濃度分散が0.0になる） F_ERR_INVALID_IMAGE 対応していない画像が渡された hmask と himage のサイズが違う 非対応画像type チャネル数が1でない 入力画像が大きすぎる F_ERR_INVALID_PARAM パラメータ異常 himage オブジェクトがNULL filter に異常な値が渡された

戻り値:

正常終了した場合は、生成した FGA グレイサーチパターンオブジェクトのハンドルを返します。 ライセンスエラー、未初期化エラー、パラメータエラー、またはメモリ不足により生成できなかったときは NULL を返します。

FGA グレイサーチパターンオブジェクトのマスク画像を取得する.

FGA グレイサーチパターンオブジェクトのマスク画像を複製し、FGA 画像オブジェクトとして取得します。
取得したマスク画像が不要になったら必ず FIE ライブラリの関数 fnFIE_free_object() で解放してください。

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_get_mask() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in]	hpattern	FGA グレイサーチパターンオブジェクト
[out]	himage	取得するマスク画像 (FGA 画像オブジェクト / type: bin) へのポインタ himage は NULL で初期化してから引数に渡してください。

戻り値:

	F_ERR_INVALID_PARAM	引数異常またはマスクが存在しない
	F_ERR_INVALID_OBJECT	オブジェクト異常
	F_ERR_NONE	正常終了
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

FGA グレイサーチパターンオブジェクトのマスク再設定.

FGA グレイサーチパターンオブジェクト hpattern に適用されているマスクを新たなマスクに変更します。

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_set_mask() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in,out]	hpattern	FGA グレイサーチパターンオブジェクト
[in]	hmask	新しいマスクにする FGA 画像オブジェクト( type : bin, uc8 / ch: 1 )

戻り値:

	F_ERR_NONE	正常終了
	F_ERR_NOMEMORY	メモリ不足
	F_ERR_INVALID_OBJECT	渡されたオブジェクトの種別が異常,またはオブジェクトがNULL
	F_ERR_GS_NO_CONTRAST	パターン画像に情報が足りないため、パターンにならない。 (== マスク部をのぞいた画像の濃度分散が0.0になる)
	F_ERR_INVALID_IMAGE	対応していない画像が渡された,または画像がNULL
	F_ERR_INVALID_PARAM	パラメータ異常 hmask のチャネル数が1でない hmask とパターンのサイズが違う
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

FGA グレイサーチパターンオブジェクトのマスク除去.

FGA グレイサーチパターンオブジェクト hpattern から、パターンマスクを除去します。

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_unset_mask() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in,out]

hpattern

FGA グレイサーチパターンオブジェクト

戻り値:

	F_ERR_NONE	正常終了
	F_ERR_INVALID_PARAM	引数異常
	F_ERR_INVALID_OBJECT	パターンオブジェクト以外が渡された,またはオブジェクトが NULL
	F_ERR_NOMEMORY	メモリ不足
	F_ERR_GS_NO_CONTRAST	パターン画像に情報が足りないため、パターンにならない。 (==画像の濃度分散が 0.0 になる）
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

FGA グレイサーチパターンオブジェクトのパターン画像を取得する.

FGA グレイサーチパターンオブジェクトのパターン画像を、FGA 画像オブジェクトとして取得します。
取得したパターン画像が不要になったら必ず FIE ライブラリの関数 fnFIE_free_object() で解放してください。

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_get_image() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in]	hpattern	FGA グレイサーチパターンオブジェクト
[out]	himage	取得するパターン画像 (FGA 画像オブジェクト / type: uc8) へのポインタ himage は NULL で初期化してから引数に渡してください。

戻り値:

	F_ERR_INVALID_PARAM	引数異常
	F_ERR_INVALID_OBJECT	パターンでないオブジェクトが渡された
	F_ERR_NOMEMORY	メモリ不足
	F_ERR_NONE	正常終了
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

FGA グレイサーチパターンオブジェクトの圧縮画像を取得する.

FGA グレイサーチパターンオブジェクトの指定した圧縮度のパターン画像を、FGA 画像オブジェクトとして取得します。
取得したパターン画像が不要になったら必ず FIE ライブラリの関数 fnFIE_free_object() で解放してください。

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_get_comp_image() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in]	hpattern	FGA グレイサーチパターンオブジェクト
[in]	unit	圧縮度( 0 〜 9 )
[out]	himage	取得するパターン画像 (FGA 画像オブジェクト / type: uc8) へのポインタ himage は NULL で初期化してから引数に渡してください。

戻り値:

	F_ERR_INVALID_PARAM	引数異常、または指定した圧縮度に該当するパターン画像がない
	F_ERR_INVALID_OBJECT	パターンでないオブジェクトが渡された
	F_ERR_NOMEMORY	メモリ不足
	F_ERR_NONE	正常終了
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

FGA グレイサーチパターンオブジェクトの圧縮フィルタ種別取得.

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_get_comp_filter() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in]	hpattern	FGA グレイサーチパターンオブジェクト
[out]	filter	圧縮フィルタ種別

戻り値:

	F_ERR_INVALID_PARAM	引数異常
	F_ERR_INVALID_OBJECT	パターン以外のオブジェクトが渡された
	F_ERR_NONE	正常終了
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

FGA グレイサーチパターンオブジェクトの圧縮フィルタ変更.

FGA グレイサーチパターンオブジェクトの圧縮フィルタ種別を変更し、パターンの再構築を行います。

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_set_comp_filter() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in,out]	hpattern	FGA グレイサーチパターンオブジェクト
[in]	filter	圧縮フィルタの種別 F_COMP_MODE_SMOOTH 通常 2x2（平均）フィルタ 特に問題なければこれを指定 F_COMP_MODE_MIN 最小値フィルタ パターンが黒い細線で構成されているような場合に指定 F_COMP_MODE_MAX 最大値フィルタ パターンが白い細線で構成されているような場合に指定 F_COMP_MODE_AVERAGE2 再平均フィルタ パターンにカメラノイズが多い場合に指定

戻り値:

	F_ERR_NONE	正常終了
	F_ERR_NOMEMORY	メモリ不足
	F_ERR_INVALID_PARAM	引数異常
	F_ERR_INVALID_OBJECT	オブジェクト異常
	F_ERR_GS_NO_CONTRAST	パターン画像の分散が0になるため、パターンにならない。
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

FGA グレイサーチパターンオブジェクトの通知座標オフセット取得.

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_get_offset() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in]	hpattern	FGA グレイサーチパターンオブジェクト
[out]	x	水平方向通知座標オフセット(100倍値)
[out]	y	垂直方向通知座標オフセット(100倍値)

戻り値:

	F_ERR_INVALID_PARAM	引数異常
	F_ERR_INVALID_OBJECT	パターン以外のオブジェクトが渡された
	F_ERR_NONE	正常終了
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

FGA グレイサーチパターンオブジェクトの通知座標オフセット設定.

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_set_offset() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in,out]	hpattern	FGA グレイサーチパターンオブジェクト
[in]	x	水平方向通知座標オフセット(100倍値)
[in]	y	垂直方向通知座標オフセット(100倍値)

戻り値:

	F_ERR_NONE	正常終了
	F_ERR_INVALID_OBJECT	パターン以外のオブジェクトが渡された
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

回転パターン (FGA グレイサーチパターンオブジェクト) の生成.

作成済みのパターン (FGA グレイサーチパターンオブジェクト) を参考にして回転処理を行い、 新しい回転済みのパターン (FGA グレイサーチパターンオブジェクト) を生成します。

不要になったパターンは必ず FIE ライブラリの関数 fnFIE_free_object() で解放してください。

本関数に対応する FIE ライブラリ関数は fnFIE_gs2_pattern_rotate() となります。
ここに記載されていない詳細な仕様に関しては 「FIE ライブラリ説明書」 を参照して下さい。

引数:

[in]	hpattern	参考にするパターン (FGA グレイサーチパターンオブジェクト)
[in]	rot_angle	回転角 degreeの 10 倍値
[in]	clip_width	回転パターン幅の上限
[in]	clip_height	回転パターン高さの上限
[in]	rotate_method	回転の方法 0 または 1 NN法 2 bilinear法
[out]	rotate_pattern	新たに作成する回転済みパターン (FGA グレイサーチパターンオブジェクト) へのポインタ rotate_pattern は NULL で初期化してから引数に渡してください。

戻り値:

	F_ERR_NONE	正常終了
	F_ERR_NOMEMORY	メモリ不足
	F_ERR_INVALID_PARAM	引数異常
	F_ERR_INVALID_OBJECT	入力オブジェクト異常
	F_ERR_INVALID_IMAGE	入力したパターン内の画像が大きすぎる
	F_ERR_GS_NO_CONTRAST	パターン画像に情報が足りないため、パターンにならない。 （==画像の濃度分散が0.0になる）
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー