幾何変換
[リージョン処理]

リージョンの平行移動

本関数はリージョンの各ランの座標に入力移動量を加算して、リージョン全体を平行移動します。 本関数実行後 *hDstReg の計算済み特徴量はすべてクリアされます。 *hDstReg の値がNULLの場合 *hDstReg には自動的にREGIONオブジェクトが割り当てられます。 ユーザ側で fnFIE_free_object() によってオブジェクトの解放を行って下さい。 hSrcReg と *hDstReg が同一ハンドルでも問題はありません。 また、入力リージョンがランを含まないときは同じ空き出力リージョンを生成します。 エラー終了時には *hDstReg の内容は本関数実行前の状態を保持します。 ( *hDstReg がNULLだった場合はNULLのまま。)

引数:

[in]	hSrcReg	入力リージョン
[out]	hDstReg	出力リージョン
[in]	iDx	横方向の移動量
[in]	iDy	縦方向の移動量

戻り値:

	F_ERR_NONE	正常終了
	F_ERR_NOMEMORY	メモリ不足で異常終了した
	F_ERR_INVALID_PARAM	不正パラメータ 不正なハンドルが渡されたため、異常終了した 移動後の座標は32bit整数の表示範囲以外になるため、異常終了した
	F_ERR_INVALID_OBJECT	入力ハンドルはリージョンオブジェクトのハンドルではない
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

リージョンの射影変換

処理対象リージョンを、幾何変換の同次変換行列 vpMat に従って射影変換します。

vpMat は座標変換に使用する同次変換行列で、3x3の正方行列を指定します。 vpMat は逆行列を計算できる必要があります。 vpMat の意味や作成法については 同次変換行列 を併せてご参照ください。

*hDstReg の値がNULLの場合 *hDstReg には自動的にREGIONオブジェクトが割り当てられます。 ユーザ側で fnFIE_free_object() によってオブジェクトの解放を行って下さい。 hSrcReg と *hDstReg が同一ハンドルでも問題はありません。 エラー終了時には *hDstReg の内容は本関数実行前の状態を保持します。

引数:

[in]	hSrcReg	入力リージョン
[out]	hDstReg	出力リージョン
[in]	vpMat	射影変換行列

戻り値:

	F_ERR_NONE	正常終了
	F_ERR_NOMEMORY	メモリ不足で異常終了した
	F_ERR_INVALID_PARAM	不正パラメータ 不正なハンドルが渡された 変換後の座標は32bit整数の表示範囲外 入力リージョンの外接矩形の横サイズ(xdiff)または縦サイズ(ydiff)が I32_MAX - 1 以上 変換後のランの数が UI32_MAX 以上 変換行列が3x3でない
	F_ERR_INVALID_OBJECT	不正なリージョンオブジェクトが入力された
	F_ERR_CALC_IMPOSSIBLE	変換行列の逆行列が計算不可能
	F_ERR_NO_LICENCE	ライセンスエラー、または未初期化エラー

注意:

• 変換後の座標が32bit整数に収まるかどうかの判定は、リージョンの軸平行外接矩形を用いています。 また、オーバーフローの問題を避けるため、±1のマージンを設けています。 これらの都合のため、変換後の座標が辛うじて32bitに収まる場合でも、範囲外としてエラー終了する場合があります。