com.docomostar.device.gesturereader
クラス RollReader

Object
  com.docomostar.device.gesturereader.GestureReader
      com.docomostar.device.gesturereader.RollReader

public final class RollReader
extends GestureReader

[iアプリオプションAPI]

Roll 動作についての認識を行います。 getRollData() で動作認識エンジンから認識処理結果を RollData オブジェクトとして取得します。その後、 RollData.getQuality(), RollData.getImmediateMotion(), RollData.getAccumulatedMotion() を実行することで、 認識処理結果の品質、画像の移動量を取得します。

導入されたバージョン:

Star-1.0

メソッドの概要

RollData	getRollData() 動作認識エンジンが算出した Roll 動作の認識処理結果を保持する RollData オブジェクトを取得します。
static RollReader	getRollReader(int id) RollReader オブジェクトを取得します。
void	recenter() 基準画像をリセットします。

クラス com.docomostar.device.gesturereader.GestureReader から継承されたメソッド

start, stop

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

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

メソッドの詳細

getRollReader

public static RollReader getRollReader(int id)

RollReader オブジェクトを取得します。

カメラ ID に対してこのメソッドが初めて呼ばれた場合はオブジェクトを生成して返します。 以後、同じカメラ ID に対しては、常に同じオブジェクトへの参照を返します。

同じカメラ ID を指定した ShakeReader オブジェクトが既に生成されている場合でも、 RollReader オブジェクトを生成することができます。 また、RollReader オブジェクトが既に生成されている場合でも、 異なるカメラ ID を指定した RollReader オブジェクトを生成することができます。

パラメータ:

id - カメラ ID を指定します。 カメラ ID については Camera.getCamera(int) メソッドを参照してください。

戻り値:

RollReader オブジェクトを返します。

例外:

UnsupportedOperationException -
引数 id に、 カメラ機能はサポートしているが、 動作認識機能はサポートしていないようなカメラ ID が指定された場合に発生します。

IllegalArgumentException -
引数 id に負の値が指定された場合、 または Star アプリから制御可能なカメラデバイスの台数以上の値が指定された場合に発生します。

DeviceException -
(NO_RESOURCES)
カメラデバイスを確保できない場合に発生します。

recenter

public void recenter()

基準画像をリセットします。 メソッド実行時に動作認識エンジンが取得した画像を基準画像として設定しなおします。

このメソッドで設定する基準画像は、RollData.getAccumulatedMotion() で移動量を取得する場合に利用されます。

例外:

DeviceException -
(ILLEGAL_STATE)
動作認識エンジンが STOP 状態で呼び出された場合に発生します。

GestureException -
(UNDEFINED)
その他の理由により、 基準画面をリセットできない場合に発生します。

getRollData

public RollData getRollData()

動作認識エンジンが算出した Roll 動作の認識処理結果を保持する RollData オブジェクトを取得します。

このメソッドが初めて呼ばれた場合はオブジェクトを生成して返します。 以後、このメソッドを呼び出すたびに、 最新の認識結果で更新してから同じオブジェクトへの参照を返します。

このメソッドを実行することで、 認識処理結果の品質および移動量を動作認識エンジンから取得します。 各値は、RollData.getQuality(), RollData.getImmediateMotion(), RollData.getAccumulatedMotion() により取得することができます。 各値を更新するためには、必ずこのメソッドを実行する必要があります。

このメソッドを実行すると、動作認識エンジンは移動量の算出を行い、 その後基準画像をリセットします。

戻り値:

動作認識エンジンが出力した認識結果を保持する RollData オブジェクトを返します。

例外:

DeviceException -
(ILLEGAL_STATE)
動作認識エンジンが STOP 状態で呼び出された場合に発生します。

GestureException -
(UNDEFINED)
その他の理由により、 認識結果を取得できない場合に発生します。