仕様書

方向の記述

[32] 装置の方向は、基準となる座標枠coordinate frameから装置座標枠への変換変換 (数学)として表します >>11。

[23] 座標の変換変換 (数学)transformationは、 基準となる座標枠coordinate frame (X, Y, Z) から装置座標枠 (x, y, z) へと次の通り回転させるものです >>11。

  1. [25] 装置座標枠を、基準となる座標枠に揃えます。
  2. [26] 装置座標枠の z 軸を α ° 回転させます。
  3. [27] 装置座標枠の x 軸を β ° 回転させます。
  4. [29] 装置座標枠の y 軸を γ ° 回転させます。
  5. [30] 装置座標枠を返します。

[24] 回転は、右手系によります。すなわち、軸の正の回転とは、 軸の正方向をみたとき時計回りとなる回転をいいます。 >>11

[28] ただし、 α ∈ [ 0, 360 ), β ∈ [ -180, 180 ), γ ∈ [ -90, 90 ) の範囲内とします。 >>11

[31] すなわち、この (α, β, γ) は Z-X'-Y" 型 intrinsic自転 Tait-Bryan angles です。 >>11

[33] 絶対は、基準となる座標枠が地球座標枠かどうかとします >>11。

[34] α, β, γ の値のいずれかまたはすべてが得られない場合は、 null とすることができます >>11。

方向決定に用いる装置

[35] イベント型が deviceorientation の場合、 α、β、γ、絶対の決定 (>>32) は、加速度計とジャイロスコープだけを使った何らかの基準からの回転 (絶対 = 偽) とすることができます。 それが得られない場合や、より高い精度の値が得られる場合には、 地球座標枠からの回転 (絶対 = 真) としても構いません。 >>11

[39] イベント型が deviceorientationabsolute の場合、 磁力計も用いることができ、地球座標枠からの回転 (絶対 = 真) としなければなりません。 >>36

IDL 属性

[19] DeviceRotationRate インターフェイスの IDL属性と DeviceRotationRateInit 辞書のメンバー辞書メンバーと DeviceOrientationEvent インターフェイスの IDL属性と DeviceOrientationEventInit 辞書のメンバー辞書メンバーである alpha装置の方向, beta装置の方向, gamma装置の方向 は、 long?nullable 型です。 IDL属性は読み取り専用、 辞書メンバーの既定値は null です。 >>11

[20] DeviceOrientationEvent インターフェイスの IDL属性と DeviceOrientationEventInit 辞書のメンバー辞書メンバーである absolute装置の方向 は、 boolean 型です。 IDL属性は読み取り専用、 辞書メンバーの既定値は偽です。 >>11

[2] これらは、それぞれα、β、γ、絶対を表すために使われます。

[4] DeviceRotationRate インターフェイス >>3 と DeviceRotationRateInit 辞書 >>3 は、 方向の変化率の記述に用いられます。

[5] このインターフェイスは、文書環境に晒されますが、 NoInterfaceObject です >>3。

[6] このインターフェイスと辞書は、メンバーとして alpha装置の方向, beta装置の方向, gamma装置の方向 を持ちます >>3。

[7] このインターフェイスは、 rotationRate IDL属性で使われます。 装置の方向の変化率を °/s 単位で表します >>3。

関連

[8] GeolocationCoordinates の headingGeolocationCoordinates は進行方向を表します。

歴史

[1] DeviceOrientation Event 参照。