jp.nyatla.nyartoolkit.old.processor

クラス SingleARMarkerProcesser

java.lang.Object

jp.nyatla.nyartoolkit.old.processor.SingleARMarkerProcesser

public abstract class SingleARMarkerProcesser
extends java.lang.Object

このクラスは、登録した複数のARマーカのうち、同時に1個のARマーカの検出処理を管理します。 このクラスを継承してアプリケーションを作成することで、ARマーカの状態変化に対応するイベントドリブンなアプリケーションを構築できます。 クラスは、マーカの出現・移動・消滅を、自己コールバック関数（イベントハンドラ）により通知します。イベントハンドラは、 引数に状態変化の詳細を与えるので、アプリケーションではそれに応じた処理を実装します。

イベントの説明- このクラスには、３個の自己コールバック関数があります。SingleARMarkerProcesserは、以下のタイミングでこれらを呼び出します。 ユーザは継承クラスでこれらの関数に実装を行い、イベント駆動のアプリケーションを作成できます。

• 　onEnterHandler(int) - 登録したマーカが初めて見つかった時に呼び出されます。ここに、発見したマーカに対応した初期処理を書きます。
• 　onLeaveHandler() - 検出中のマーカが消失した時に呼び出されます。ここに、マーカの終期処理を書きます。
• 　onUpdateHandler(jp.nyatla.nyartoolkit.core.rasterdriver.squaredetect.NyARSquare, jp.nyatla.nyartoolkit.core.types.matrix.NyARDoubleMatrix44)- 検出中のマーカの位置姿勢が更新されたときに呼び出されます。ここに、マーカ位置の更新処理を書きます。

特性-

• 自動敷居値調整を行うため、環境光の変化に耐性があります。
• 複数のマーカが画像にある場合は、一番初めに認識したマーカを優先して認識します。
• 複数の同一パターンマーカが画像にある場合は、区別できません。

このクラスの定義は古いため、特別な事情が無い限り、NyARMarkerSystemを使うべきです。

フィールドの概要

フィールド

修飾子とタイプ	フィールドと説明
java.lang.Object	tag ユーザーが自由に使えるタグ変数です。

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
void	detectMarker(INyARRgbRaster i_raster) この関数は、画像を処理して、適切なマーカ検出イベントハンドラを呼び出します。
void	reset(boolean i_is_force) この関数は、インスタンスの状態をリセットします。
void	setARCodeTable(NyARCode[] i_ref_code_table, int i_code_resolution, double i_marker_width) この関数は、検出するマーカパターンテーブルの配列を指定します。
void	setConfidenceThreshold(double i_new_cf, double i_exist_cf) この関数は、マーカパターンの一致率の敷居値を設定します。

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

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

フィールドの詳細

tag

public java.lang.Object tag

ユーザーが自由に使えるタグ変数です。

メソッドの詳細

setARCodeTable

public void setARCodeTable(NyARCode[] i_ref_code_table,
                  int i_code_resolution,
                  double i_marker_width)

この関数は、検出するマーカパターンテーブルの配列を指定します。 マーカパターンには、配列の先頭から、0から始まるID番号を割り当てられます。 このIDは、onEnterHandler(int)イベントハンドラに通知されるID番号に対応し、マーカパターンの識別に使います。

パラメータ:

i_ref_code_table - マーカパターンテーブルにセットする配列です。配列にあるマーカパターンの解像度は、i_code_resolutionに一致している必要があります。

i_code_resolution - マーカパターン縦横解像度です。

i_marker_width -

メモ: マーカを検出している状態で関数を実行すると、イベント通知なしに、認識中のマーカを見失います。

例外:

NyARRuntimeException

reset

public void reset(boolean i_is_force)

この関数は、インスタンスの状態をリセットします。 状態をリセットすると、もしマーカを認識している場合には、onLeaveHandler()イベントハンドラがコールされ、未認識状態になります。

パラメータ:

i_is_force - 強制フラグ。trueにすると、イベント通知なしにマーカ認識状態をリセットします。

detectMarker

public void detectMarker(INyARRgbRaster i_raster)

この関数は、画像を処理して、適切なマーカ検出イベントハンドラを呼び出します。 イベントハンドラの呼び出しは、この関数を呼び出したスレッドが、この関数が終了するまでに行います。

パラメータ:

i_raster - 検出処理をする画像を指定します。

例外:

NyARRuntimeException

setConfidenceThreshold

public void setConfidenceThreshold(double i_new_cf,
                          double i_exist_cf)

この関数は、マーカパターンの一致率の敷居値を設定します。 敷居値は、0.0<n<1.0の範囲で指定します。

パラメータ:

i_new_cf - 新しくマーカを発見するときの閾値です。

i_exist_cf - 継続してマーカを追跡するときの閾値です。 i_new_cfの6割程度の値を指定すると良いでしょう。