jp.nyatla.nyartoolkit.core.transmat

クラス NyARTransMat_ARToolKit

java.lang.Object

jp.nyatla.nyartoolkit.core.transmat.NyARTransMat_ARToolKit

すべての実装されたインタフェース:

INyARTransMat

public class NyARTransMat_ARToolKit
extends java.lang.Object
implements INyARTransMat

このクラスは、ARToolKitと同じ方法で、二次元矩形から３次元位置姿勢を推定します。

コンストラクタの概要

コンストラクタ

コンストラクタと説明
NyARTransMat_ARToolKit(INyARCameraDistortionFactor i_ref_distfactor, NyARPerspectiveProjectionMatrix i_ref_projmat) コンストラクタです。
NyARTransMat_ARToolKit(NyARParam i_param) コンストラクタです。

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
boolean	transMat(NyARSquare i_square, NyARRectOffset i_offset, NyARDoubleMatrix44 o_result, NyARTransMatResultParam o_param) この関数は、理想座標系の四角系を元に、位置姿勢変換行列を求めます。
boolean	transMatContinue(NyARSquare i_square, NyARRectOffset i_offset, NyARDoubleMatrix44 i_prev_result, double i_prev_err, NyARDoubleMatrix44 o_result, NyARTransMatResultParam o_param) ARToolkitと同じ結果を返します。

クラスから継承されたメソッド java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

NyARTransMat_ARToolKit

public NyARTransMat_ARToolKit(INyARCameraDistortionFactor i_ref_distfactor,
                      NyARPerspectiveProjectionMatrix i_ref_projmat)

コンストラクタです。 座標計算に必要なオブジェクトの参照値を元に、インスタンスを生成します。

パラメータ:

i_ref_distfactor - 樽型歪み矯正オブジェクトの参照値です。歪み矯正が不要な時は、nullを指定します。

i_ref_projmat - 射影変換オブジェクトの参照値です。

例外:

NyARException

NyARTransMat_ARToolKit

public NyARTransMat_ARToolKit(NyARParam i_param)

コンストラクタです。 座標計算に必要なカメラパラメータの参照値を元に、インスタンスを生成します。

パラメータ:

i_param - ARToolKit形式のカメラパラメータです。 インスタンスは、この中から樽型歪み矯正オブジェクト、射影変換オブジェクトを参照します。

例外:

NyARException

メソッドの詳細

transMat

public boolean transMat(NyARSquare i_square,
               NyARRectOffset i_offset,
               NyARDoubleMatrix44 o_result,
               NyARTransMatResultParam o_param)
                 throws NyARException

この関数は、理想座標系の四角系を元に、位置姿勢変換行列を求めます。 ARToolKitのarGetTransMatに該当します。

定義:

transMat インタフェース内 INyARTransMat

パラメータ:

i_square - 矩形情報を格納したオブジェクトです。

i_offset - カメラ座標系での、矩形のオフセット位置です。通常、原点中心のマーカ座標になります。

o_result - 結果を格納するオブジェクトです。

o_param - 結果パラメータを格納するオブジェクトです。nullの場合無視します。

例外:

NyARException

関連項目:

INyARTransMat.transMatContinue(jp.nyatla.nyartoolkit.core.squaredetect.NyARSquare, jp.nyatla.nyartoolkit.core.transmat.NyARRectOffset, jp.nyatla.nyartoolkit.core.types.matrix.NyARDoubleMatrix44, double, jp.nyatla.nyartoolkit.core.types.matrix.NyARDoubleMatrix44, jp.nyatla.nyartoolkit.core.transmat.NyARTransMatResultParam)

transMatContinue

public boolean transMatContinue(NyARSquare i_square,
                       NyARRectOffset i_offset,
                       NyARDoubleMatrix44 i_prev_result,
                       double i_prev_err,
                       NyARDoubleMatrix44 o_result,
                       NyARTransMatResultParam o_param)
                         throws NyARException

ARToolkitと同じ結果を返します。i_prev_err引数は無視されますので、0を指定してください。

定義:

transMatContinue インタフェース内 INyARTransMat

パラメータ:

i_square - 矩形情報を格納したオブジェクトです。

i_offset - カメラ座標系での、矩形のオフセット位置です。通常、原点中心のマーカ座標になります。

i_prev_result - 参照する過去のオブジェクトです。このオブジェクトとo_resultには同じものを指定できます。

o_result - 結果を格納するオブジェクトです。

o_param - 結果パラメータを格納するオブジェクトです。nullの場合無視します。

戻り値:

トラッキングに失敗した場合はfalseを返します。その場合はINyARTransMat.transMat(jp.nyatla.nyartoolkit.core.squaredetect.NyARSquare, jp.nyatla.nyartoolkit.core.transmat.NyARRectOffset, jp.nyatla.nyartoolkit.core.types.matrix.NyARDoubleMatrix44, jp.nyatla.nyartoolkit.core.transmat.NyARTransMatResultParam)からやり直してください。

例外:

NyARException

関連項目:

INyARTransMat.transMatContinue(jp.nyatla.nyartoolkit.core.squaredetect.NyARSquare, jp.nyatla.nyartoolkit.core.transmat.NyARRectOffset, jp.nyatla.nyartoolkit.core.types.matrix.NyARDoubleMatrix44, double, jp.nyatla.nyartoolkit.core.types.matrix.NyARDoubleMatrix44, jp.nyatla.nyartoolkit.core.transmat.NyARTransMatResultParam)