jp.nyatla.nyartoolkit.rpf.reality.nyartk

クラス NyARRealityTarget

java.lang.Object

jp.nyatla.nyartoolkit.core.utils.NyARManagedObject

jp.nyatla.nyartoolkit.rpf.reality.nyartk.NyARRealityTarget

public class NyARRealityTarget
extends NyARManagedObject

このクラスは、Realityターゲット(RTターゲット)のプロパティを格納します。 プロパティには、ターゲットのメタデータ、二次元座標系データ、三次元座標系データの３個があります。 ターゲットのメタデータは常に利用が可能です。二次元座標系データは、RT_DEAD以外のステータスを持つ RTターゲットだけが利用できます。三次元座標データは、RT_KNOWNステータスを持つRTターゲットだけが利用できます。 ユーザーが直接書き込みできるのはtagメンバのみです。他のメンバには、書き込みをしないでください。

ネストされたクラスの概要

クラスから継承されたネストされたクラス/インタフェース jp.nyatla.nyartoolkit.core.utils.NyARManagedObject

NyARManagedObject.INyARManagedObjectPoolOperater

フィールドの概要

フィールド

修飾子とタイプ	フィールドと説明
int	_grab_rate 内部向けのメンバ変数です。
NyARRectOffset	_offset 内部向けのメンバ変数です。
NyARTarget	_ref_tracktarget 内部向けのメンバ変数です。
NyARTransMatResultParam	_result_param
NyARSquare	_screen_square 内部向けのメンバ変数です。
long	_serial 内部向けのメンバ変数です。
int	_target_type 内部向けのメンバ変数です。
NyARDoubleMatrix44	_transform_matrix 内部向けのメンバ変数です。
static int	INVALID_REALITY_TARGET_ID 定数値。
static int	RT_DEAD ターゲットの種類。
static int	RT_KNOWN ターゲットの種類。
static int	RT_UNKNOWN ターゲットの種類。
java.lang.Object	tag ユーザオブジェクトを配置するポインタータグです。

コンストラクタの概要

コンストラクタ

コンストラクタと説明
NyARRealityTarget(NyARRealityTargetPool i_pool) コンストラクタです。

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
static long	createSerialId() ID生成器。
int	getGrabbRate() この関数は、RTターゲットの補足率を返します。
boolean	getRgbPatt3d(NyARRealitySource i_src, NyARDoublePoint3d[] i_vertex, NyARDoubleMatrix44 i_matrix, int i_resolution, INyARRgbRaster o_raster) この関数は、RTターゲット座標系の4頂点で囲まれる領域を射影した平面から、RGB画像をo_rasterに取得します。
boolean	getRgbRectPatt3d(NyARRealitySource i_src, double i_x, double i_y, double i_w, double i_h, int i_resolution, INyARRgbRaster o_raster) RTターゲット座標系の4頂点で定義する矩形から、RGB画像をo_rasterに取得します。
long	getSerialId() この関数は、RTターゲットのシリアルIDを返します。
void	getTargetCenter(NyARDoublePoint2d o_center) この関数は、RTターゲットの四角系の中央点を返します。
void	getTargetCenter(NyARIntPoint2d o_center) getTargetCenter(NyARDoublePoint2d)の出力型違いの関数です。
int	getTargetType() この関数は、RTターゲットのステータスタイプを返します。
void	getTargetVertex(NyARDoublePoint2d[] o_vertex) この関数は、RTターゲットの四角系頂点配列をコピーして返します。
boolean	isInnerRectPoint2d(int i_x, int i_y) この関数は、点がRTターゲットの二次元座標系の四角形を包括する矩形の内側にあるか判定します。
boolean	isInnerVertexPoint2d(int i_x, int i_y) この関数は、点がRTターゲットの二次元座標系の四角形の内側にあるか判定します。
NyARDoublePoint2d[]	refTargetVertex() この関数は、RTターゲットの四角系頂点配列への参照値を返します。
NyARDoubleMatrix44	refTransformMatrix() この関数は、RTターゲットの姿勢変換行列の参照値を返します。
int	releaseObject() ファイナライザです。

クラスから継承されたメソッド jp.nyatla.nyartoolkit.core.utils.NyARManagedObject

getCount, initObject, referenceObject

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

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

フィールドの詳細

tag

public java.lang.Object tag

ユーザオブジェクトを配置するポインタータグです。ユーザが自由にオブジェクトを配置できます。 INyARDisposableインタフェイスを持つオブジェクトを指定すると、このターゲットを開放するときにINyARDisposable.dispose()が自動的にコールされます。

INyARDisposableインタフェイスは、RTターゲットの消失時に特別な処理を実行したいときに追加してください。

INVALID_REALITY_TARGET_ID

public static final int INVALID_REALITY_TARGET_ID

定数値。無効なシリアルID値を定義します。

関連項目:

定数フィールド値

_serial

public long _serial

内部向けのメンバ変数です。getSerialId()を使ってください。

_transform_matrix

public NyARDoubleMatrix44 _transform_matrix

内部向けのメンバ変数です。refTransformMatrix()を使ってください。

_result_param

public NyARTransMatResultParam _result_param

RT_UNKNOWN

public static final int RT_UNKNOWN

ターゲットの種類。Unknownステータスであることを示します。

関連項目:

定数フィールド値

RT_KNOWN

public static final int RT_KNOWN

ターゲットの種類。Knownステータスである事を示します。

関連項目:

定数フィールド値

RT_DEAD

public static final int RT_DEAD

ターゲットの種類。Deadステータスである事を示します。

関連項目:

定数フィールド値

_target_type

public int _target_type

内部向けのメンバ変数です。getTargetType()を使ってください。

_offset

public NyARRectOffset _offset

内部向けのメンバ変数です。ターゲットのオフセット位置。

_ref_tracktarget

public NyARTarget _ref_tracktarget

内部向けのメンバ変数です。このターゲットが参照しているトラックターゲット

_screen_square

public NyARSquare _screen_square

内部向けのメンバ変数です。スクリーン上の歪み解除済み矩形。

_grab_rate

public int _grab_rate

内部向けのメンバ変数です。getGrabbRate()を使ってください。

コンストラクタの詳細

NyARRealityTarget

public NyARRealityTarget(NyARRealityTargetPool i_pool)

コンストラクタです。 この関数は、ユーザが使うことはありません。

パラメータ:

i_pool - 親となるマネージドオブジェクトプール

メソッドの詳細

releaseObject

public int releaseObject()

ファイナライザです。 この関数は、ユーザが使うことはありません。 INyARDisposableに関する処理を追加しています。

オーバーライド:

releaseObject クラス内 NyARManagedObject

戻り値:

減算後の参照カウンタ

createSerialId

public static long createSerialId()

ID生成器。システムの稼働期間中、一意なRealityTargetSerialIDを返します。 この関数は、ユーザが使うことはありません。

戻り値:

一意なID

refTransformMatrix

public final NyARDoubleMatrix44 refTransformMatrix()

この関数は、RTターゲットの姿勢変換行列の参照値を返します。 姿勢変換行列は、カメラ座標系をRTターゲット座標系に変換する行列です。 この値は変更しないでください。（編集するときは、コピーを作ってください。） 値は、次のサイクルを実行するまで有効です。

戻り値:

[READ ONLY]姿勢変換行列の参照値。

getTargetType

public int getTargetType()

この関数は、RTターゲットのステータスタイプを返します。

値のサマリ- 詳しくは、NyARRealityを参考にして下さい。

• RT_UNKNOWN=未確定ターゲット。2次元座標利用可能
• RT_KNOWN =確定した既知のターゲット。3次元座標利用可能
• RT_DEAD =次のprogressで削除するターゲット

戻り値:

RTターゲットのステータス値

getSerialId

public long getSerialId()

この関数は、RTターゲットのシリアルIDを返します。 詳しくは、NyARRealityを参考にして下さい。

戻り値:

シリアルID。

getGrabbRate

public int getGrabbRate()

この関数は、RTターゲットの補足率を返します。 値は、一定期間における、ターゲットの認識率を元に計算します。 20を切ると消失の可能性が高い？様な気がします。

戻り値:

補足率の値。0-100の数値です。

refTargetVertex

public final NyARDoublePoint2d[] refTargetVertex()

この関数は、RTターゲットの四角系頂点配列への参照値を返します。 二次元系の座標値です。RT_KNOWNとRT_UNKNOWNステータスのRTターゲットで使用できます。 樽型歪みの逆矯正は行いません。 値は、次のサイクルを実行するまで有効です。

戻り値:

[READ ONLY]ターゲットの四角系の頂点配列(4要素)。

getTargetVertex

public final void getTargetVertex(NyARDoublePoint2d[] o_vertex)

この関数は、RTターゲットの四角系頂点配列をコピーして返します。 二次元系の座標値です。RT_KNOWNとRT_UNKNOWNステータスのRTターゲットで使用できます。 樽型歪みの逆矯正は行いません。

パラメータ:

o_vertex - 値を格納する配列。4要素である事。

getTargetCenter

public final void getTargetCenter(NyARDoublePoint2d o_center)

この関数は、RTターゲットの四角系の中央点を返します。 二次元系の座標値です。RT_KNOWNとRT_UNKNOWNステータスのRTターゲットで使用できます。 樽型歪み逆矯正は行いません。

パラメータ:

o_center - 値を格納するオブジェクト。

getTargetCenter

public final void getTargetCenter(NyARIntPoint2d o_center)

getTargetCenter(NyARDoublePoint2d)の出力型違いの関数です。

パラメータ:

o_center - 値を格納するオブジェクト。

isInnerVertexPoint2d

public final boolean isInnerVertexPoint2d(int i_x,
                           int i_y)

この関数は、点がRTターゲットの二次元座標系の四角形の内側にあるか判定します。 (範囲ではなく、頂点の内側であることに注意してください。) 二次元系の座標値です。RT_KNOWNとRT_UNKNOWNステータスのRTターゲットで使用できます。 入力値の樽型歪み矯正は行いません。

パラメータ:

i_x - 検査する座標x

i_y - 検査する座標y

戻り値:

点が内側にあるときはtrue,無い時はfalse

isInnerRectPoint2d

public final boolean isInnerRectPoint2d(int i_x,
                         int i_y)

この関数は、点がRTターゲットの二次元座標系の四角形を包括する矩形の内側にあるか判定します。 二次元系の座標値です。RT_KNOWNとRT_UNKNOWNステータスのRTターゲットで使用できます。 入力値の樽型歪み矯正は行いません。

メモ-この関数にはnewが残っています。大量に呼び出すときにはnewの削除を検討しましょう。

パラメータ:

i_x - 検査する座標x

i_y - 検査する座標y

戻り値:

点が内側にあるときはtrue,無い時はfalse

getRgbPatt3d

public final boolean getRgbPatt3d(NyARRealitySource i_src,
                   NyARDoublePoint3d[] i_vertex,
                   NyARDoubleMatrix44 i_matrix,
                   int i_resolution,
                   INyARRgbRaster o_raster)
                           throws NyARException

この関数は、RTターゲット座標系の4頂点で囲まれる領域を射影した平面から、RGB画像をo_rasterに取得します。 三次元系の座標値です。RT_KNOWNステータスのRTターゲットで使用できます。

メモ:この関数にはnewが残ってるので注意

パラメータ:

i_src - 画像ソース。このRTターゲットの親のNyARRealityに入力したNyARRealitySourceオブジェクト。

i_vertex - ターゲットのオフセットを基準値とした、頂点座標。要素数は4であること。(mm単位)

i_matrix - RTターゲット座標系の姿勢変換行列。値を指定すると、RTターゲット座標系と平行な面から、任意の姿勢に変換した後にパターンを取得します。 nullを指定すると、RTターゲット座標系と同じ平面の座標系で取得します。 この変数は、例えばマーカの40mm上のパターンを取得したりするときに役立ちます。(誤差の影響を強く受けるため、精密な測定には向いていません。)

i_resolution - 1ピクセルあたりのサンプル数です。二乗した値が実際のサンプル数になります。 2なら4ピクセル、4なら16ピクセルの入力から、出力1ピクセルを生成します。

o_raster - 出力先のラスタオブジェクト。

戻り値:

画像取得に成功するとtrue

例外:

NyARException

getRgbRectPatt3d

public final boolean getRgbRectPatt3d(NyARRealitySource i_src,
                       double i_x,
                       double i_y,
                       double i_w,
                       double i_h,
                       int i_resolution,
                       INyARRgbRaster o_raster)
                               throws NyARException

RTターゲット座標系の4頂点で定義する矩形から、RGB画像をo_rasterに取得します。 三次元系の座標値です。RT_KNOWNステータスのRTターゲットで使用できます。

パラメータ:

i_src - 画像ソース。このRTターゲットの親のNyARRealityに入力したNyARRealitySourceオブジェクト。

i_x - RTターゲット座標系の矩形の左上座標X(mm単位)

i_y - RTターゲット座標系の矩形の左上座標Y(mm単位)

i_w - RTターゲット座標系の矩形の幅(mm単位)

i_h - RTターゲット座標系の矩形の高さ(mm単位)

i_resolution - 1ピクセルあたりのサンプル数です。二乗した値が実際のサンプル数になります。 2なら4ピクセル、4なら16ピクセルの入力から、出力1ピクセルを生成します。

o_raster - 出力先のラスタオブジェクト。

戻り値:

画像取得に成功するとtrue

例外:

NyARException