概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

com.nttdocomo.device.gesturereader
クラス RollReader

Object
  拡張com.nttdocomo.device.gesturereader.GestureReader
      拡張com.nttdocomo.device.gesturereader.RollReader
public final class RollReader
extends GestureReader
 [iアプリオプションAPI]

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

導入されたバージョン:
DoJa-5.0 (904i)

メソッドの概要
 RollData getRollData()
           動作認識エンジンが算出した Roll 動作の認識処理結果を保持する RollData オブジェクトを取得します。
static RollReader getRollReader(int id)
          RollReader オブジェクトを取得します。
 void recenter()
           基準画像をリセットします。
 
クラス com.nttdocomo.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 に負の値が指定された場合、 または Java から制御可能なカメラデバイスの台数以上の値が指定された場合に発生します。
DeviceException - カメラデバイスを確保できない場合に発生します(NO_RESOURCES)。

recenter

public void recenter()

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

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

例外:
DeviceException - 動作認識エンジンが STOP 状態で呼び出された場合に発生します (ILLEGAL_STATE)。
GestureException - その他の理由により、 基準画面をリセットできない場合に発生します(UNDEFINED)。

getRollData

public RollData getRollData()

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

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

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

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

戻り値:
動作認識エンジンが出力した認識結果を保持する RollData オブジェクトを返します。
例外:
DeviceException - 動作認識エンジンが STOP 状態で呼び出された場合に発生します (ILLEGAL_STATE)。
GestureException - その他の理由により、 認識結果を取得できない場合に発生します(UNDEFINED)。
概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

NTT DOCOMO,INC.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。

「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。