Class Quaternion

クォータニオンです。

値を操作するメソッドは基本的に破壊的操作であるため、影響を与えたくない場合は明示的にclone()を呼び出してインスタンスを複製してください。

Index

Constructors

Properties

w x y z

Methods

clone createEulerAngles dot equals identity invert length lengthSq multiply normalize set setFromAxisAngle setFromEulerAngles slerp toAxisAngle

Static Methods

axisAngle euler fromToRotation lookRotation

Constructors

constructor

new Quaternion(): Quaternion
Returns Quaternion
new Quaternion(x: number, y: number, z: number, w: number): Quaternion
Parameters
- x: number
- y: number
- z: number
- w: number
Returns Quaternion

Properties

w

w: number

x

x: number

y

y: number

z

z: number

Methods

clone

clone(): Quaternion
インスタンスを複製します。

Returns Quaternion

createEulerAngles

createEulerAngles(): Vector3
オイラー角表現での回転の値を返します。

Returns Vector3

dot

dot(v: Quaternion): number
自身とvの回転の内積を計算します。
Parameters
- v: Quaternion
Returns number

equals

equals(v: Quaternion): boolean
自身の値とvを比較し、ほとんど等しいときにtrueを返します。
Parameters
- v: Quaternion
Returns boolean

identity

identity(): this
自身の値を単位回転で更新します。これは回転のない状態を指します。

Returns this

invert

invert(): this
自身の値を反転します。

Returns this

length

length(): number
自身（クォータニオン）を4次元のベクトルとみたときの長さを返します。

Returns number

lengthSq

lengthSq(): number
自身（クォータニオン）を4次元のベクトルとみたときの2乗の長さを返します。

Returns number

multiply

multiply(v: Quaternion): this
vの値を自身に乗算します。
Parameters
- v: Quaternion
Returns this

normalize

normalize(): this
自身の値を正規化します。

Returns this

set

set(x: number, y: number, z: number, w: number): this
自身のx, y, z, w成分の値を設定します。
Parameters
- x: number
- y: number
- z: number
- w: number
Returns this

setFromAxisAngle

setFromAxisAngle(axis: Vector3, degree: number): this
axisの周りをdegree度回転する値で自身を更新します。
Parameters
- axis: Vector3
- degree: number
Returns this
Example
```
new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), 90);
```

setFromEulerAngles

setFromEulerAngles(v: Vector3): this
オイラー角表現での回転で自身を更新します。軸の適用順序はZXYの順となります。
Parameters
- v: Vector3
Returns this
Example
```
new Quaternion().setFromEulerAngles(new Vector3(90, 0, 0));
```
setFromEulerAngles(x: number, y: number, z: number): this
オイラー角表現での回転で自身を更新します。軸の適用順序はZXYの順となります。
Parameters
- x: number
- y: number
- z: number
Returns this
Example
```
new Quaternion().setFromEulerAngles(90, 0, 0);
```

slerp

slerp(v: Quaternion, a: number): this
自身と v の間を a で球状に補間した値を計算し、計算結果で自身の値を更新します。
Parameters
- v: Quaternion
- a: number
  補間の範囲を [0, 1] で指定します。
Returns this
Example
```
let min = new Quaternion().identity();
let max = new Quaternion().setFromEulerAngles(0, 45, 0);
min.clone().slerp(max, 0.5);
```

toAxisAngle

toAxisAngle(): AxisAngle
回転を軸と角度に分離した値を取得します。

Returns AxisAngle

Static Methods

`Static`axisAngle

axisAngle(axis: Vector3, angle: number): Quaternion
axisの周りをdegree度回転するようなQuaternionを生成します。
Parameters
- axis: Vector3
- angle: number
Returns Quaternion
Example
```
let q = Quaternion.axisAngle(new Vector3(0, 1, 0), 90);
```

`Static`euler

euler(angles: Vector3): Quaternion
オイラー角で回転を指定してQuaternionを生成します。軸の適用順序はZXYの順となります。
Parameters
- angles: Vector3
Returns Quaternion
euler(x: number, y: number, z: number): Quaternion
オイラー角を回転を指定してQuaternionを生成します。軸の適用順序はZXYの順となります。
Parameters
- x: number
- y: number
- z: number
Returns Quaternion

`Static`fromToRotation

fromToRotation(from: Vector3, to: Vector3): Quaternion
ある方向から別の方向へ向きを変更するような回転を表すQuaternionを生成します。
Parameters
- from: Vector3
- to: Vector3
Returns Quaternion

`Static`lookRotation

lookRotation(forward: Vector3, up: Vector3): Quaternion
forward の方向へ向き、かつ上方向が up の向きとなるような回転を表すQuaternionを生成します。

upは省略可能であり、省略した場合は new Vector3(0, 1, 0) を指定したのと同様に扱われます。
Parameters
- forward: Vector3
- up: Vector3
Returns Quaternion