com.docomostar.opt.device
クラス GyroData

Object
  上位を拡張 com.docomostar.opt.device.GyroData

public class GyroData
extends Object

ジャイロセンサ機能の角速度取得機能により取得したデータを定義します。

X/Y/Z 軸回りの角速度値を提供します。角速度の単位は、 deg/s(角度毎秒) です。 角速度は各軸に対する回転方向に応じて正負が解釈され、 軸の正方向に対し右ねじが進む向きに回転した場合を正とします。
X/Y/Z 軸は、ストレートタイプの端末においては Y 軸を基準に以下のように定義されます。

なお、この X/Y/Z 軸の定義はストレートタイプの端末に対するものであり、 その他端末における X/Y/Z 軸の定義は、ジャイロセンサの搭載位置によって異なるため機種依存です。

取得可能な軸回りの角速度は実装によって異なります。例えば 2 軸センサが搭載されている場合であれば、 X, Y 軸回りの角速度が取得可能になる等です。

このオブジェクトの内部には、計測データを配列として保持しています。このクラスのメソッドにおいて、 戻り値として配列を返す場合、オブジェクト内部で保持する配列への参照を返します。

計測データを更新するためには、GyroSensor.getData() を呼び出す必要があります。

このオブジェクトの内部で保持している配列の長さは、size() で取得できる計測データ数より長い場合があります。 その場合、配列の ( size() - 1 ) 番目までの要素には有効な計測値が格納されていますが、 size() 番目以降の要素には不定値が格納されています。 なお、 size() で取得できる計測データ数が 0 の場合は、配列の全要素に不定値が格納されています。

なお、このクラスの説明における下記用語の具体的な位置は機種依存ですが、 「メインスクリーンの上部」の定義は、 加速度センサや電子コンパスにおける定義と同一であることが保障されています。 また、利用者が端末を自然に持った時の上下関係と、下記定義が一致していなければなりません。

導入されたバージョン:
Star-1.2
関連項目:
GyroSensor

メソッドの概要
 int[] getAngularVelocityX()
           X 軸回りの角速度値を取得します。
 int[] getAngularVelocityY()
           Y 軸回りの角速度値を取得します。
 int[] getAngularVelocityZ()
           Z 軸回りの角速度値を取得します。
 int size()
           このオブジェクトに含まれている計測データ数を取得します。
 
クラス Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

size

public int size()

このオブジェクトに含まれている計測データ数を取得します。
このオブジェクトに計測データが含まれていない場合は 0 を返します。

戻り値:
計測データ数を返します。

getAngularVelocityX

public int[] getAngularVelocityX()

X 軸回りの角速度値を取得します。

戻り値:
X 軸回りの角速度値を返します。単位は deg/s(角度毎秒) です。 古い測定データから順に配列の先頭から格納されます。 返される配列は、このオブジェクトが内部で保持している配列への参照です。
例外:
com.docomostar.lang.UnsupportedOperationException -
実装がこの軸回りの角速度値をサポートしていない場合に発生します。

getAngularVelocityY

public int[] getAngularVelocityY()

Y 軸回りの角速度値を取得します。

戻り値:
Y 軸回りの角速度値を返します。単位は deg/s(角度毎秒) です。 古い測定データから順に配列の先頭から格納されます。 返される配列は、このオブジェクトが内部で保持している配列への参照です。
例外:
com.docomostar.lang.UnsupportedOperationException -
実装がこの軸回りの角速度値をサポートしていない場合に発生します。

getAngularVelocityZ

public int[] getAngularVelocityZ()

Z 軸回りの角速度値を取得します。

戻り値:
Z 軸回りの角速度値を返します。単位は deg/s(角度毎秒) です。 古い測定データから順に配列の先頭から格納されます。 返される配列は、このオブジェクトが内部で保持している配列への参照です。
例外:
com.docomostar.lang.UnsupportedOperationException -
実装がこの軸回りの角速度値をサポートしていない場合に発生します。


NTT DOCOMO,INC.

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

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

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

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

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