com.docomostar.opt.ui.eruption
クラス Transform

Object
  com.docomostar.opt.ui.eruption.Transform

public final class Transform
extends Object

4 x 4 の変換行列を表すクラスです。

配列 a と行列 T の対応関係は以下の通りです。


端末によって、本クラスはサポートされていない場合があります。未サポートの場合、メソッドが呼び出された時点で UnsupportedOperationException が発生します。

フィールドの概要

static int	MCE_ROTATE_EULER_XYZ XYZ順に回転を表します(=0)。
static int	MCE_ROTATE_EULER_XZY XZY順に回転を表します(=1)。
static int	MCE_ROTATE_EULER_YXZ YXZ順に回転を表します(=2)。
static int	MCE_ROTATE_EULER_YZX YZX順に回転を表します(=3)。
static int	MCE_ROTATE_EULER_ZXY ZXY順に回転を表します(=4)。
static int	MCE_ROTATE_EULER_ZYX ZYX順に回転を表します(=5)。

コンストラクタの概要

Transform()
Transform を生成します。

Transform(float[] a)
変換行列成分を設定して Transform を生成します。

メソッドの概要

void	copy(Transform src) 変換行列をコピーします。
void	dispose() Native資源を破棄します。
void	get(float[] r) 変換行列を取得します。
void	multiply(Transform t) 変換行列を乗算します。
void	multiply(Transform t1, Transform t2) 変換行列を乗算します。
void	set(float[] a) 指定された変換行列を設定します。
void	setIdentity() 恒等変換を設定します。
void	setInvert(Transform src) 逆行列を設定します。
void	setRotate(Vector3D v, float angle) 回転成分を設定します。
void	setRotateEuler(int type, Vector3D angles) 回転成分を設定(オイラー指定)します。
void	setScale(float x, float y, float z) スケール成分を設定します。
void	setScale(Vector3D v) スケール成分を設定(ベクタ指定)します。
void	setTranslate(float x, float y, float z) 平行移動成分を設定します。
void	setTranslate(Vector3D v) 平行移動成分を設定(ベクタ指定)します。
void	setTranspose(Transform src) 転置行列を設定します。
void	transPosition(Vector3D v) 頂点を移動します。
void	transPosition(Vector3D v, Vector3D r) 頂点を移動します。

クラス Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

MCE_ROTATE_EULER_XYZ

public static final int MCE_ROTATE_EULER_XYZ

XYZ順に回転を表します(=0)。

関連項目:

定数フィールド値

MCE_ROTATE_EULER_XZY

public static final int MCE_ROTATE_EULER_XZY

XZY順に回転を表します(=1)。

関連項目:

定数フィールド値

MCE_ROTATE_EULER_YXZ

public static final int MCE_ROTATE_EULER_YXZ

YXZ順に回転を表します(=2)。

関連項目:

定数フィールド値

MCE_ROTATE_EULER_YZX

public static final int MCE_ROTATE_EULER_YZX

YZX順に回転を表します(=3)。

関連項目:

定数フィールド値

MCE_ROTATE_EULER_ZXY

public static final int MCE_ROTATE_EULER_ZXY

ZXY順に回転を表します(=4)。

関連項目:

定数フィールド値

MCE_ROTATE_EULER_ZYX

public static final int MCE_ROTATE_EULER_ZYX

ZYX順に回転を表します(=5)。

関連項目:

定数フィールド値

コンストラクタの詳細

Transform

public Transform()

Transform を生成します。

Transform

public Transform(float[] a)

変換行列成分を設定して Transform を生成します。

パラメータ:

a - 4 x 4 の変換行列成分の配列を指定します。

例外:

NullPointerException -
a が null の場合に発生します。

IllegalArgumentException -
a.length < 16 の場合に発生します。

メソッドの詳細

set

public final void set(float[] a)

指定された変換行列を設定します。

パラメータ:

a - 4 x 4 の変換行列成分の配列を指定します。

例外:

NullPointerException -
a が null の場合に発生します。

IllegalArgumentException -
a.length < 16 の場合に発生します。

get

public final void get(float[] r)

変換行列を取得します。

パラメータ:

r - 変換行列を渡す float 配列を指定します。

例外:

NullPointerException -
r が null の場合に発生します。

IllegalArgumentException -
r.length < 16 の場合に発生します。

copy

public final void copy(Transform src)

変換行列をコピーします。

パラメータ:

src - コピー元の Transform を指定します。

例外:

NullPointerException -
src が null の場合に発生します。

setIdentity

public final void setIdentity()

恒等変換を設定します。

multiply

public final void multiply(Transform t)

変換行列を乗算します。自身と引数 t を乗算し、結果は自身に格納されます。

パラメータ:

t - Transform を指定します。

例外:

NullPointerException -
t が null の場合に発生します。

multiply

public final void multiply(Transform t1,
                           Transform t2)

変換行列を乗算します。t1 の右から t2 を乗算し、結果は自身に格納されます。

パラメータ:

t1 - Transform を指定します。

t2 - Transform を指定します。

例外:

NullPointerException -
t1 が null または t2 が null の場合に発生します。

setTranslate

public final void setTranslate(float x,
                               float y,
                               float z)

平行移動成分を設定します。

パラメータ:

x - X軸方向の平行移動成分を指定します。

y - Y軸方向の平行移動成分を指定します。

z - Z軸方向の平行移動成分を指定します。

setTranslate

public final void setTranslate(Vector3D v)

平行移動成分を設定(ベクタ指定)します。

パラメータ:

v - 平行移動成分を表す Vector3D を指定します。

例外:

NullPointerException -
v が null の場合に発生します。

setRotate

public final void setRotate(Vector3D v,
                            float angle)

回転成分を設定します。

パラメータ:

v - 回転する軸を表す Vector3D を指定します。

angle - 角度(1.0=360度) を指定します。

例外:

NullPointerException -
v が null の場合に発生します。

IllegalArgumentException -
v が零ベクトルで、angle が 0 以外の場合に発生します。

setRotateEuler

public final void setRotateEuler(int type,
                                 Vector3D angles)

回転成分を設定(オイラー指定)します。

パラメータ:

type - 回転順を指定します。指定できる値は、以下の通りです。

• XYZ順 - MCE_ROTATE_EULER_XYZ
• XZY順 - MCE_ROTATE_EULER_XZY
• YXZ順 - MCE_ROTATE_EULER_YXZ
• YZX順 - MCE_ROTATE_EULER_YZX
• ZXY順 - MCE_ROTATE_EULER_ZXY
• ZYX順 - MCE_ROTATE_EULER_ZYX

angles - 各軸の回転成分を表す Vector3D (1.0=360度) を指定します。

例外:

NullPointerException -
angles が null の場合に発生します。

IllegalArgumentException -
type が不正な場合に発生します。

setScale

public final void setScale(float x,
                           float y,
                           float z)

スケール成分を設定します。

パラメータ:

x - X軸方向のスケール成分を指定します。

y - Y軸方向のスケール成分を指定します。

z - Z軸方向のスケール成分を指定します。

setScale

public final void setScale(Vector3D v)

スケール成分を設定(ベクタ指定)します。

パラメータ:

v - スケール成分を表す Vector3D を指定します。

例外:

NullPointerException -
v が null の場合に発生します。

setInvert

public final void setInvert(Transform src)

逆行列を設定します。

パラメータ:

src - 逆行列を求める Transform を指定します。

例外:

NullPointerException -
src が null の場合に発生します。

ArithmeticException -
内部で計算エラーが起きた場合に発生します。

setTranspose

public final void setTranspose(Transform src)

転置行列を設定します。

パラメータ:

src - 転置行列を求める Transform を指定します。

例外:

NullPointerException -
src が null の場合に発生します。

transPosition

public final void transPosition(Vector3D v)

頂点を移動します。演算結果は引数 v に格納されます。

パラメータ:

v - 頂点を表す Vector3D を指定します。

例外:

NullPointerException -
v が null の場合に発生します。

ArithmeticException -
内部で計算エラーが起きた場合に発生します。

transPosition

public final void transPosition(Vector3D v,
                                Vector3D r)

頂点を移動します。演算結果は引数 r に格納されます。

パラメータ:

v - 頂点(移動前)を表す Vector3D を指定します。

r - 頂点(移動後)を渡す Vector3D を指定します。

例外:

NullPointerException -
v が null または r が null の場合に発生します。

ArithmeticException -
内部で計算エラーが起きた場合に発生します。

dispose

public final void dispose()

Native資源を破棄します。 Native資源は参照が無くなってもFinalizerによるガベージコレクションが起きるまで破棄されません。 確実に破棄タイミングを制御したい場合にはこのメソッドを明示的に呼び出す必要があります。