Vector (common 0.0.1 API)

java.lang.Object
- com.serenegiant.math.Vector

All Implemented Interfaces:: java.io.Serializable, java.lang.Cloneable

public class Vector
extends java.lang.Object
implements java.io.Serializable, java.lang.Cloneable

See Also:: Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

static Vector normVector

static float TO_DEGREE

static float TO_RADIAN

float x

float y

float z

static Vector zeroVector

Fields
Modifier and Type	Field and Description
`static Vector`	`normVector`
`static float`	`TO_DEGREE`
`static float`	`TO_RADIAN`
`float`	`x`
`float`	`y`
`float`	`z`
`static Vector`	`zeroVector`

Constructor Summary

Constructors
Constructor and Description

Vector()

Vector(float x, float y)

Vector(float x, float y, float z)

Vector(Vector v)

Constructors
Constructor and Description
`Vector()`
`Vector(float x, float y)`
`Vector(float x, float y, float z)`
`Vector(Vector v)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Vector`	`add(float x, float y)` ベクトルに加算 v = v + (x,y,0)
`Vector`	`add(float x, float y, float z)` ベクトルを加算 v = v + (x,y,z)
`Vector`	`add(float x, float y, float z, float a)` ベクトルを加算(スケール変換有り)v = v + (x,y,z)*a
`Vector`	`add(Vector v)` ベクトルを加算 v = v + v'
`Vector`	`add(Vector v, float a)` ベクトルを加算(スケール変換有り) v = v + v' * a
`float`	`angleXY()` XY平面上でベクトルとX軸の角度を取得
`float`	`angleXZ()` XZ平面上でベクトルとX軸の角度を取得
`float`	`angleYZ()` YZ平面上でベクトルとY軸の角度を取得
`Vector`	`clear(float scalar)` ベクトルの各成分に指定したスカラ値をセット
`Vector`	`clone()`
`Vector`	`cross(Vector v)`
`static Vector`	`cross(Vector v3, Vector v1, Vector v2)` ベクトルの外積を計算(3D, crossProductと同じ)
`float`	`cross2(Vector v)` ベクトルの外積を計算(2D, crossProduct2と同じ) v1×v2= x1y2-x2y1 = \|v1\|\|v2\|sin(θ)
`Vector`	`crossProduct(Vector v)`
`static Vector`	`crossProduct(Vector v3, Vector v1, Vector v2)` ベクトルの外積を計算(3D, crossと同じ)
`float`	`crossProduct2(Vector v)` ベクトルの外積を計算(2D, cross2と同じ) v1×v2= x1y2-x2y1 = \|v1\|\|v2\|sin(θ)
`float`	`distance(float x, float y)` ベクトル間の距離を取得する
`float`	`distance(float x, float y, float z)` ベクトル間の距離を取得する
`float`	`distance(Vector v)` ベクトル間の距離を取得する
`float`	`distSquared(float x, float y)` ベクトル間の距離の2乗を取得する
`float`	`distSquared(float x, float y, float z)` ベクトル間の距離の2乗を取得する
`float`	`distSquared(Vector v)` ベクトル間の距離の2乗を取得する
`Vector`	`div(float scale)` ベクトルの各成分をスカラ値で割り算
`Vector`	`div(float x_scale, float y_scale)` ベクトルの各成分をスカラ値で割り算
`Vector`	`div(float x_scale, float y_scale, float z_scale)` ベクトルの各成分をスカラ値で割り算
`Vector`	`div(Vector other)` ベクトルの各成分同士の割り算(内積・外積じゃないよ)
`float`	`dot(float x, float y, float z)` ベクトルの内積を取得(dotProductと同じ)
`float`	`dot(Vector v)` ベクトルの内積を取得(dotProductと同じ) 標準化ベクトルv2を含む直線にベクトルv1を真っ直ぐ下ろした（正射影した）時の長さ
`float`	`dotProduct(float x, float y, float z)` ベクトルの内積を取得(dotと同じ)
`float`	`dotProduct(Vector v)` ベクトルの内積を取得(dotと同じ) 標準化ベクトルv2を含む直線にベクトルv1を真っ直ぐ下ろした（正射影した）時の長さ
`float`	`getAngle(Vector v)` ベクトル間の角度を取得ベクトル１ Za=(X1,Y1,Z1)、ベクトル２ Zb=(X2,Y2,Z2)、求める角φとすると、 cos φ ＝ Za・Zb / (\|Za\| \|Zb\|) =(X1X2+Y1Y2+Z1Z2) / √{(X1^2 + Y1^2 + Z1^2)(X2^2 + Y2^2 + Z2^2)} 上式のアークコサイン(cos^-1)を取ればOK。
`float[]`	`getQuat()` クオータニオンとして取得(4番目の成分は1)
`float`	`len()` ベクトルの長さを取得
`float`	`lenSquared()` ベクトルの長さの２乗を取得
`Vector`	`limit(float scalar)` x,y,z各成分を指定した値[-scalar, +scalar]に収まるように制限する
`Vector`	`limit(float lower, float upper)` x,y,z各成分を指定した値[lower, upper]に収まるように制限する
`Vector`	`mod(float scalar)` ベクトルの各成分をスカラ値で剰余計算
`Vector`	`mult(float scale)` ベクトルの各成分にスカラ値をかけ算
`Vector`	`mult(float x_scale, float y_scale)` ベクトルの各成分にスカラ値をかけ算
`Vector`	`mult(float x_scale, float y_scale, float z_scale)` ベクトルの各成分にスカラ値をかけ算
`Vector`	`mult(Vector other)` ベクトルの各成分同士の掛け算(内積・外積じゃないよ)
`Vector`	`normalize()` ベクトルを正規化(長さを1にする)
`Vector`	`rotate_inv(float angleX, float angleY, float angleZ)` 逆回転(スレッドセーフではない)
`Vector`	`rotate_inv(Vector angle)` 逆回転(スレッドセーフではない)
`Vector`	`rotate_inv(Vector angle, float a)` 逆回転(スレッドセーフではない)
`Vector`	`rotate(float angleX, float angleY, float angleZ)` ベクトルを回転(スレッドセーフではない)
`Vector`	`rotate(float angle, float axisX, float axisY, float axisZ)` ベクトルを回転(スレッドセーフではない) x軸：(1,0,0), y軸(0,1,0), z軸(0,0,1)
`Vector`	`rotate(Vector angle)`
`static Vector[]`	`rotate(Vector[] v, float angleX, float angleY, float angleZ)` ベクトル配列内の各ベクトルを回転(スレッドセーフでは無い)
`Vector`	`rotate(Vector angle, float a)` ベクトルを回転(スレッドセーフではない) v = v#rot(angle * a)
`static Vector`	`rotate(Vector v, float angleX, float angleY, float angleZ)` ベクトルを回転(スレッドセーフではない)
`Vector`	`rotateXY(float angle)`
`Vector`	`rotateXZ(float angle)` Y軸周りに(XZ平面上で)ベクトルを指定した角度[度]回転させる
`Vector`	`rotateYZ(float angle)` X軸周りに(YZ平面上で)ベクトルを指定した角度[度]回転させる
`Vector`	`set(float x, float y)` ベクトルの各成分に指定したスカラ値をセット, zは0
`Vector`	`set(float x, float y, float z)` ベクトルの各成分に指定したスカラ値をセット v = (x,y,z)
`Vector`	`set(float x, float y, float z, float a)` ベクトルの各成分に指定したスカラ値をセット(スケール変換有り) v = (x,y,z) * a
`Vector`	`set(Vector v)` ベクトルに指定したベクトルをセット v = v'
`Vector`	`set(Vector v, float a)` ベクトルに指定したベクトルをセット(スケール変換あり) v' = v * a
`Vector`	`setQuat(float[] q)` クオータニオンをセット(4番目の成分は無視される)
`Vector`	`sign()` 各成分を負なら-1.0f, ゼロなら0.0f, 正なら1.0fにする
`float`	`slope()` 原点とこのベクトルが示す点を通る直線の傾きを取得(2D)
`float`	`slope(Vector v)` 2つのベクトルで示す点を通る直線の傾きを取得(2D)
`Vector`	`sub(float x, float y)` ベクトルを減算 v = v - (x,y,0)
`Vector`	`sub(float x, float y, float z)` ベクトルを減算 v = v - (x,y,z)
`Vector`	`sub(float x, float y, float z, float a)` ベクトルを減算(スケール変換有り)v = v - (x,y,z)*a
`Vector`	`sub(Vector v)` ベクトルを減算 v = v - v'
`Vector`	`sub(Vector v, float a)`
`Vector`	`swap(Vector v)` ベクトルの各成分を交換
`Vector`	`swapXY()` x成分とy成分を交換
`Vector`	`toDegree()` x,y,zがそれぞれラジアンであるとみなして角度に変換する
`Vector`	`toRadian()` x,y,zがそれぞれ角度(degree)であるとみなしてラジアンに変換する
`java.lang.String`	`toString()`
`java.lang.String`	`toString(java.lang.String fmt)`
`static Vector`	`vector(float x, float y, float z)`
`static Vector`	`vector(Vector v)`
`float`	`x()` x成分値を取得
`void`	`x(float x)` x成分値をセット
`float`	`y()` y成分値を取得
`void`	`y(float y)` y成分値をセット
`float`	`z()` z成分値を取得
`void`	`z(float z)` z成分値をセット

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - TO_RADIAN
```
public static final float TO_RADIAN
```
    See Also:
    
    Constant Field Values
  - TO_DEGREE
```
public static final float TO_DEGREE
```
    See Also:
    
    Constant Field Values
  - zeroVector
```
public static final Vector zeroVector
```
  - normVector
```
public static final Vector normVector
```
  - x
```
public float x
```
  - y
```
public float y
```
  - z
```
public float z
```
- Constructor Detail
  - Vector
```
public Vector()
```
  - Vector
```
public Vector(float x,
              float y)
```
  - Vector
```
public Vector(Vector v)
```
  - Vector
```
public Vector(float x,
              float y,
              float z)
```
- Method Detail
  - vector
```
public static Vector vector(float x,
                            float y,
                            float z)
```
  - vector
```
public static Vector vector(Vector v)
```
  - clone
```
public Vector clone()
             throws java.lang.CloneNotSupportedException
```
    Overrides:
    
    clone in class java.lang.Object
    
    Throws:
    
    java.lang.CloneNotSupportedException
  - clear
```
public Vector clear(float scalar)
```
    ベクトルの各成分に指定したスカラ値をセット
    
    Parameters:
    
    scalar -
    
    Returns:
  - set
```
public Vector set(float x,
                  float y)
```
    ベクトルの各成分に指定したスカラ値をセット, zは0
    
    Parameters:
    
    x -
    
    y -
    
    Returns:
  - set
```
public Vector set(Vector v)
```
    ベクトルに指定したベクトルをセット v = v'
    
    Parameters:
    
    v -
    
    Returns:
  - set
```
public Vector set(Vector v,
                  float a)
```
    ベクトルに指定したベクトルをセット(スケール変換あり) v' = v * a
    
    Parameters:
    
    v -
    
    a -
    
    Returns:
  - set
```
public Vector set(float x,
                  float y,
                  float z)
```
    ベクトルの各成分に指定したスカラ値をセット v = (x,y,z)
    
    Parameters:
    
    x -
    
    y -
    
    z -
    
    Returns:
  - set
```
public Vector set(float x,
                  float y,
                  float z,
                  float a)
```
    ベクトルの各成分に指定したスカラ値をセット(スケール変換有り) v = (x,y,z) * a
    
    Parameters:
    
    x -
    
    y -
    
    z -
    
    a -
    
    Returns:
  - x
```
public float x()
```
    x成分値を取得
    
    Returns:
  - x
```
public void x(float x)
```
    x成分値をセット
    
    Parameters:
    
    x -
  - y
```
public float y()
```
    y成分値を取得
    
    Returns:
  - y
```
public void y(float y)
```
    y成分値をセット
    
    Parameters:
    
    y -
  - z
```
public float z()
```
    z成分値を取得
    
    Returns:
  - z
```
public void z(float z)
```
    z成分値をセット
    
    Parameters:
    
    z -
  - add
```
public Vector add(float x,
                  float y)
```
    ベクトルに加算 v = v + (x,y,0)
    
    Parameters:
    
    x -
    
    y -
    
    Returns:
  - add
```
public Vector add(float x,
                  float y,
                  float z)
```
    ベクトルを加算 v = v + (x,y,z)
    
    Parameters:
    
    x -
    
    y -
    
    z -
    
    Returns:
  - add
```
public Vector add(float x,
                  float y,
                  float z,
                  float a)
```
    ベクトルを加算(スケール変換有り)v = v + (x,y,z)*a
    
    Parameters:
    
    x -
    
    y -
    
    z -
    
    a -
    
    Returns:
  - add
```
public Vector add(Vector v)
```
    ベクトルを加算 v = v + v'
    
    Parameters:
    
    v -
    
    Returns:
  - add
```
public Vector add(Vector v,
                  float a)
```
    ベクトルを加算(スケール変換有り) v = v + v' * a
    
    Parameters:
    
    v -
    
    a -
    
    Returns:
  - sub
```
public Vector sub(float x,
                  float y)
```
    ベクトルを減算 v = v - (x,y,0)
    
    Parameters:
    
    x -
    
    y -
    
    Returns:
  - sub
```
public Vector sub(Vector v)
```
    ベクトルを減算 v = v - v'
    
    Parameters:
    
    v -
    
    Returns:
  - sub
```
public Vector sub(Vector v,
                  float a)
```
  - sub
```
public Vector sub(float x,
                  float y,
                  float z)
```
    ベクトルを減算 v = v - (x,y,z)
    
    Parameters:
    
    x -
    
    y -
    
    z -
    
    Returns:
  - sub
```
public Vector sub(float x,
                  float y,
                  float z,
                  float a)
```
    ベクトルを減算(スケール変換有り)v = v - (x,y,z)*a
    
    Parameters:
    
    x -
    
    y -
    
    z -
    
    a -
    
    Returns:
  - mult
```
public Vector mult(Vector other)
```
    ベクトルの各成分同士の掛け算(内積・外積じゃないよ)
    
    Parameters:
    
    other -
    
    Returns:
  - mult
```
public Vector mult(float scale)
```
    ベクトルの各成分にスカラ値をかけ算
  - mult
```
public Vector mult(float x_scale,
                   float y_scale)
```
    ベクトルの各成分にスカラ値をかけ算
  - mult
```
public Vector mult(float x_scale,
                   float y_scale,
                   float z_scale)
```
    ベクトルの各成分にスカラ値をかけ算
  - div
```
public Vector div(Vector other)
```
    ベクトルの各成分同士の割り算(内積・外積じゃないよ)
    
    Parameters:
    
    other -
    
    Returns:
  - div
```
public Vector div(float scale)
```
    ベクトルの各成分をスカラ値で割り算
  - div
```
public Vector div(float x_scale,
                  float y_scale)
```
    ベクトルの各成分をスカラ値で割り算
  - div
```
public Vector div(float x_scale,
                  float y_scale,
                  float z_scale)
```
    ベクトルの各成分をスカラ値で割り算
  - mod
```
public Vector mod(float scalar)
```
    ベクトルの各成分をスカラ値で剰余計算
  - toRadian
```
public Vector toRadian()
```
    x,y,zがそれぞれ角度(degree)であるとみなしてラジアンに変換する
    
    Returns:
  - toDegree
```
public Vector toDegree()
```
    x,y,zがそれぞれラジアンであるとみなして角度に変換する
    
    Returns:
  - limit
```
public Vector limit(float scalar)
```
    x,y,z各成分を指定した値[-scalar, +scalar]に収まるように制限する
    
    Parameters:
    
    scalar -
    
    Returns:
  - limit
```
public Vector limit(float lower,
                    float upper)
```
    x,y,z各成分を指定した値[lower, upper]に収まるように制限する
    
    Parameters:
    
    lower -
    
    upper -
    
    Returns:
  - len
```
public float len()
```
    ベクトルの長さを取得
  - lenSquared
```
public float lenSquared()
```
    ベクトルの長さの２乗を取得
  - normalize
```
public Vector normalize()
```
    ベクトルを正規化(長さを1にする)
  - dot
```
public float dot(Vector v)
```
    ベクトルの内積を取得(dotProductと同じ) 標準化ベクトルv2を含む直線にベクトルv1を真っ直ぐ下ろした（正射影した）時の長さ
  - dotProduct
```
public float dotProduct(Vector v)
```
    ベクトルの内積を取得(dotと同じ) 標準化ベクトルv2を含む直線にベクトルv1を真っ直ぐ下ろした（正射影した）時の長さ
  - dot
```
public float dot(float x,
                 float y,
                 float z)
```
    ベクトルの内積を取得(dotProductと同じ)
  - dotProduct
```
public float dotProduct(float x,
                        float y,
                        float z)
```
    ベクトルの内積を取得(dotと同じ)
  - cross2
```
public float cross2(Vector v)
```
    ベクトルの外積を計算(2D, crossProduct2と同じ) v1×v2= x1*y2-x2*y1 = |v1||v2|sin(θ)
  - crossProduct2
```
public float crossProduct2(Vector v)
```
    ベクトルの外積を計算(2D, cross2と同じ) v1×v2= x1*y2-x2*y1 = |v1||v2|sin(θ)
  - cross
```
public Vector cross(Vector v)
```
  - crossProduct
```
public Vector crossProduct(Vector v)
```
  - cross
```
public static Vector cross(Vector v3,
                           Vector v1,
                           Vector v2)
```
    ベクトルの外積を計算(3D, crossProductと同じ)
  - crossProduct
```
public static Vector crossProduct(Vector v3,
                                  Vector v1,
                                  Vector v2)
```
    ベクトルの外積を計算(3D, crossと同じ)
  - angleXY
```
public float angleXY()
```
    XY平面上でベクトルとX軸の角度を取得
  - angleXZ
```
public float angleXZ()
```
    XZ平面上でベクトルとX軸の角度を取得
  - angleYZ
```
public float angleYZ()
```
    YZ平面上でベクトルとY軸の角度を取得
  - getAngle
```
public float getAngle(Vector v)
```
    ベクトル間の角度を取得ベクトル１ Za=(X1,Y1,Z1)、ベクトル２ Zb=(X2,Y2,Z2)、求める角φとすると、 cos φ ＝ Za・Zb / (|Za| |Zb|) =(X1X2+Y1Y2+Z1Z2) / √{(X1^2 + Y1^2 + Z1^2)(X2^2 + Y2^2 + Z2^2)} 上式のアークコサイン(cos^-1)を取ればOK。
    
    Parameters:
    
    v -
    
    Returns:
  - rotateXY
```
public Vector rotateXY(float angle)
```
  - rotateXZ
```
public Vector rotateXZ(float angle)
```
    Y軸周りに(XZ平面上で)ベクトルを指定した角度[度]回転させる
  - rotateYZ
```
public Vector rotateYZ(float angle)
```
    X軸周りに(YZ平面上で)ベクトルを指定した角度[度]回転させる
  - rotate
```
public Vector rotate(float angle,
                     float axisX,
                     float axisY,
                     float axisZ)
```
    ベクトルを回転(スレッドセーフではない) x軸：(1,0,0), y軸(0,1,0), z軸(0,0,1)
    
    Parameters:
    
    angle - [度]
    
    axisX -
    
    axisY -
    
    axisZ -
    
    Returns:
  - rotate
```
public Vector rotate(float angleX,
                     float angleY,
                     float angleZ)
```
    ベクトルを回転(スレッドセーフではない)
    
    Parameters:
    
    angleX - [度]
    
    angleY - [度]
    
    angleZ - [度]
    
    Returns:
  - rotate
```
public static Vector rotate(Vector v,
                            float angleX,
                            float angleY,
                            float angleZ)
```
    ベクトルを回転(スレッドセーフではない)
    
    Parameters:
    
    v - 回転させるベクトル
    
    angleX - [度]
    
    angleY - [度]
    
    angleZ - [度]
    
    Returns:
  - rotate
```
public static Vector[] rotate(Vector[] v,
                              float angleX,
                              float angleY,
                              float angleZ)
```
    ベクトル配列内の各ベクトルを回転(スレッドセーフでは無い)
    
    Parameters:
    
    v - ベクトル配列
    
    angleX - [度]
    
    angleY - [度]
    
    angleZ - [度]
    
    Returns:
  - rotate
```
public Vector rotate(Vector angle,
                     float a)
```
    ベクトルを回転(スレッドセーフではない) v = v#rot(angle * a)
    
    Parameters:
    
    angle - 回転角, 各成分は [度]
    
    a - スケール変換
    
    Returns:
  - rotate
```
public Vector rotate(Vector angle)
```
  - rotate_inv
```
public Vector rotate_inv(float angleX,
                         float angleY,
                         float angleZ)
```
    逆回転(スレッドセーフではない)
    
    Parameters:
    
    angleX -
    
    angleY -
    
    angleZ -
    
    Returns:
  - rotate_inv
```
public Vector rotate_inv(Vector angle,
                         float a)
```
    逆回転(スレッドセーフではない)
    
    Parameters:
    
    angle -
    
    a -
    
    Returns:
  - rotate_inv
```
public Vector rotate_inv(Vector angle)
```
    逆回転(スレッドセーフではない)
    
    Parameters:
    
    angle -
    
    Returns:
  - getQuat
```
public float[] getQuat()
```
    クオータニオンとして取得(4番目の成分は1)
    
    Returns:
  - setQuat
```
public Vector setQuat(float[] q)
```
    クオータニオンをセット(4番目の成分は無視される)
    
    Parameters:
    
    q -
    
    Returns:
  - distance
```
public float distance(Vector v)
```
    ベクトル間の距離を取得する
  - distance
```
public float distance(float x,
                      float y)
```
    ベクトル間の距離を取得する
    
    Parameters:
    
    x -
    
    y -
    
    Returns:
  - distance
```
public float distance(float x,
                      float y,
                      float z)
```
    ベクトル間の距離を取得する
    
    Parameters:
    
    x -
    
    y -
    
    z -
    
    Returns:
  - distSquared
```
public float distSquared(Vector v)
```
    ベクトル間の距離の2乗を取得する
    
    Parameters:
    
    v -
    
    Returns:
  - distSquared
```
public float distSquared(float x,
                         float y)
```
    ベクトル間の距離の2乗を取得する
    
    Parameters:
    
    x -
    
    y -
    
    Returns:
  - distSquared
```
public float distSquared(float x,
                         float y,
                         float z)
```
    ベクトル間の距離の2乗を取得する
    
    Parameters:
    
    x -
    
    y -
    
    z -
    
    Returns:
  - swap
```
public Vector swap(Vector v)
```
    ベクトルの各成分を交換
  - swapXY
```
public Vector swapXY()
```
    x成分とy成分を交換
  - slope
```
public float slope(Vector v)
```
    2つのベクトルで示す点を通る直線の傾きを取得(2D)
  - slope
```
public float slope()
```
    原点とこのベクトルが示す点を通る直線の傾きを取得(2D)
    
    Returns:
  - sign
```
public Vector sign()
```
    各成分を負なら-1.0f, ゼロなら0.0f, 正なら1.0fにする
    
    Returns:
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - toString
```
public java.lang.String toString(java.lang.String fmt)
```

Class Vector

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TO_RADIAN

TO_DEGREE

zeroVector

normVector

x

y

z

Constructor Detail

Vector

Vector

Vector

Vector

Method Detail

vector

vector

clone

clear

set

set

set

set

set

x

x

y

y

z

z

add

add

add

add

add

sub

sub

sub

sub

sub

mult

mult

mult

mult

div

div

div

div

mod

toRadian

toDegree

limit

limit

len

lenSquared

normalize

dot

dotProduct

dot

dotProduct

cross2

crossProduct2

cross

crossProduct

cross

crossProduct

angleXY

angleXZ

angleYZ

getAngle

rotateXY

rotateXZ

rotateYZ

rotate

rotate

rotate