com.j_phone.system
クラス PostureInfo

java.lang.Object
  |
  +--com.j_phone.system.PostureInfo

public class PostureInfo
extends java.lang.Object

モーションコントロールの姿勢情報を保持するクラスです。

PostureInfo は複数データを配列管理しています。 各要素の取得メソッドに配列のインデックスを指定することにより、それぞれの要素を取得することができます。

導入されたバージョン:
JSCL 1.3.2

メソッドの概要
 int getCount()
          PostureInfo に含まれる姿勢情報数を取得します。
 int[] getDynamicAccelerationX(int offset, int length)
          動加速度 X軸を取得します。
 int[] getDynamicAccelerationY(int offset, int length)
          動加速度 Y軸を取得します。
 int[] getDynamicAccelerationZ(int offset, int length)
          推奨されていません。 将来の拡張用。戻り値は常に null になり例外も発生しません。
 int[] getField(int offset, int length)
          磁場環境を取得します。
 int[] getPitch(int offset, int length)
          ピッチ角を取得します。
 int[] getRoll(int offset, int length)
          ロール角を取得します。
 int[] getStaticAccelerationX(int offset, int length)
          静加速度 X軸を取得します。
 int[] getStaticAccelerationY(int offset, int length)
          静加速度 Y軸を取得します。
 int[] getStaticAccelerationZ(int offset, int length)
          推奨されていません。 将来の拡張用。戻り値は常に null になり例外も発生しません。
 int[] getYaw(int offset, int length)
          ヨー角を取得します。
 
クラス java.lang.Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

getCount

public int getCount()
PostureInfo に含まれる姿勢情報数を取得します。

MotionDetectiveSensorgetPostureInfoLatest()メソッドにより取得した場合は 1、 MotionDetectiveSensorgetPostureInfoStack(int)メソッドにより取得した場合は、 getPostureInfoStack(int)メソッドの引数numの値が返ります。

戻り値:
姿勢情報数

getYaw

public int[] getYaw(int offset,
                    int length)
ヨー角を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
角度。範囲は 0 〜 360度。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getRoll

public int[] getRoll(int offset,
                     int length)
ロール角を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
角度。範囲は -90 〜 90度。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getPitch

public int[] getPitch(int offset,
                      int length)
ピッチ角を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
角度。範囲は -90 〜 90度。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getDynamicAccelerationX

public int[] getDynamicAccelerationX(int offset,
                                     int length)
動加速度 X軸を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
加速度。単位はmg(ミリジー)。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getDynamicAccelerationY

public int[] getDynamicAccelerationY(int offset,
                                     int length)
動加速度 Y軸を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
加速度。単位はmg(ミリジー)。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getDynamicAccelerationZ

public int[] getDynamicAccelerationZ(int offset,
                                     int length)
推奨されていません。 将来の拡張用。戻り値は常に null になり例外も発生しません。

動加速度 Z軸を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
加速度。単位はmg(ミリジー)。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getStaticAccelerationX

public int[] getStaticAccelerationX(int offset,
                                    int length)
静加速度 X軸を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
加速度。単位はmg(ミリジー)。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getStaticAccelerationY

public int[] getStaticAccelerationY(int offset,
                                    int length)
静加速度 Y軸を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
加速度。単位はmg(ミリジー)。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getStaticAccelerationZ

public int[] getStaticAccelerationZ(int offset,
                                    int length)
推奨されていません。 将来の拡張用。戻り値は常に null になり例外も発生しません。

静加速度 Z軸を取得します。

PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
加速度。単位はmg(ミリジー)。
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する

getField

public int[] getField(int offset,
                      int length)
磁場環境を取得します。

モーションコントロールを使用する環境に適しているかどうかを示す値を返します。 値が大きいほど最適な環境になります(MAX 1024)。 値が -1 の場合は、異常状態を示します。 PostureInfo に含まれる姿勢情報の、引数offset(先頭は0)から引数length分の情報を取得します。

パラメータ:
offset - 取得を開始する姿勢情報の配列のオフセット
length - 取得する情報数
戻り値:
磁場環境
例外:
java.lang.IllegalArgumentException - 引数が不正な場合に発生する
ArrayIndexOutOfBoundsException - 引数offsetが配列の有効範囲外を指定した場合に発生する