com.nttdocomo.ui.util3d
クラス FastMath

Object
  com.nttdocomo.ui.util3d.FastMath

public class FastMath

extends Object

float 型の高速な数値 演算 機能を提供する、ユーティリティクラスを定義します。

導入されたバージョン:

DoJa-4.0 (901i)

関連項目:

数値演算に関する共通の定義

メソッドの概要

static float	abs(float a) 絶対値の近似値を計算します。
static float	acos(float a) 逆余弦の近似値を計算します。
static float	add(float x, float y) 加算の近似値 (x + y) を計算します。
static float	asin(float a) 逆正弦の近似値を計算します。
static float	atan(float a) 逆正接の近似値を計算します。
static float	atan2(float a, float b) 二次元座標から逆正接の近似値を計算します。
static float	cos(float a) 余弦の近似値を計算します。
static float	div(float x, float y) 除算の近似値 (x / y) を計算します。
static int	floatToInnerInt(float v) float 値を、各種の数値演算時にエンジン内部で表現される int 値に変換します。
static float	innerIntToFloat(int v) 各種の数値演算時にエンジン内部で表現される int 値を、 float 値に変換します。
static float	mul(float x, float y) 乗算の近似値 (x * y) を計算します。
static float	sin(float a) 正弦の近似値を計算します。
static float	sqrt(float x) 平方根の近似値を計算します。
static float	sub(float x, float y) 減算の近似値 (x - y) を計算します。
static float	tan(float a) 正接の近似値を計算します。

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

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

メソッドの詳細

floatToInnerInt

public static int floatToInnerInt(float v)

float 値を、各種の数値演算時にエンジン内部で表現される int 値に変換します。

innerIntToFloat(int) メソッドと組み合わせて用いることで、 各種の数値演算時の誤差を事前に想定すること、または、 オーバーフローのチェックをすることなどが可能になります。

パラメータ:

v - float 値を指定します。

戻り値:

int 値を返します。

例外:

IllegalArgumentException - 引数 v に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

関連項目:

数値演算に関する共通の定義

innerIntToFloat

public static float innerIntToFloat(int v)

各種の数値演算時にエンジン内部で表現される int 値を、 float 値に変換します。

floatToInnerInt(float) メソッドと組み合わせて用いることで、 各種の数値演算時の誤差を事前に想定すること、または、 オーバーフローのチェックをすることなどが可能になります。

パラメータ:

v - int 値を指定します。

戻り値:

float 値を返します。

関連項目:

数値演算に関する共通の定義

add

public static float add(float x,
                        float y)

加算の近似値 (x + y) を計算します。

パラメータ:

x - 値を指定します。

y - 値を指定します。

戻り値:

加算の近似値を返します。

例外:

IllegalArgumentException - 引数 x,y のいずれかに、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

sub

public static float sub(float x,
                        float y)

減算の近似値 (x - y) を計算します。

add(x, -y) を呼び出したのと同じ結果になります。

パラメータ:

x - 値を指定します。

y - 値を指定します。

戻り値:

減算の近似値を返します。

例外:

IllegalArgumentException - 引数 x,y のいずれかに、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

mul

public static float mul(float x,
                        float y)

乗算の近似値 (x * y) を計算します。

パラメータ:

x - 値を指定します。

y - 値を指定します。

戻り値:

乗算の近似値を返します。

例外:

IllegalArgumentException - 引数 x,y のいずれかに、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

div

public static float div(float x,
                        float y)

除算の近似値 (x / y) を計算します。

パラメータ:

x - 値を指定します。

y - 値を指定します。

戻り値:

x/y を計算した結果の近似値を返します。

例外:

IllegalArgumentException - 引数 x,y のいずれかに、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

ArithmeticException - 引数 y が 0 の場合に発生します。 また、引数 y を int 幅の値に変換したときに 0 になる場合にも発生します。

sqrt

public static float sqrt(float x)

平方根の近似値を計算します。

パラメータ:

x - 値を指定します。

戻り値:

指定された値の平方根の近似値を返します。

例外:

IllegalArgumentException - 引数 x に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

ArithmeticException - 引数 x が負数の場合に発生します。 また、引数 x を int 幅の値に変換したときに負数になる場合にも発生します。

sin

public static float sin(float a)

正弦の近似値を計算します。

パラメータ:

a - 角度 (degree) を指定します。

戻り値:

指定された角度の正弦値の近似値を返します。

例外:

IllegalArgumentException - 引数 a に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

cos

public static float cos(float a)

余弦の近似値を計算します。

パラメータ:

a - 角度 (degree) を指定します。

戻り値:

指定された角度の余弦値の近似値を返します。

例外:

IllegalArgumentException - 引数 a に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

tan

public static float tan(float a)

正接の近似値を計算します。

パラメータ:

a - 角度 (degree) を指定します。

戻り値:

指定された角度の正接値の近似値を返します。 引数 a を 180 で割ったときの余りが 90 になる場合には、 Float.POSITIVE_INFINITY または Float.NEGATIVE_INFINITY を返します。

例外:

IllegalArgumentException - 引数 a に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

asin

public static float asin(float a)

逆正弦の近似値を計算します。

パラメータ:

a - 値を指定します。

戻り値:

指定された値の逆正弦値 (degree) を 区間 [-90, 90] の範囲で計算した結果の近似値を返します。

例外:

IllegalArgumentException - 引数 a に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

ArithmeticException - 引数 a が 区間 [-1, 1] の範囲ではない場合に発生します。

acos

public static float acos(float a)

逆余弦の近似値を計算します。

パラメータ:

a - 値を指定します。

戻り値:

指定された値の逆余弦値 (degree) を 区間 [0, 180] の範囲で計算した結果の近似値を返します。

例外:

IllegalArgumentException - 引数 a に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

ArithmeticException - 引数 a が 区間 [-1, 1] の範囲ではない場合に発生します。

atan

public static float atan(float a)

逆正接の近似値を計算します。

パラメータ:

a - 値を指定します。

戻り値:

指定された値の逆正接値 (degree) を 区間 (-90, 90) の範囲で計算した結果の近似値を返します。

例外:

IllegalArgumentException - 引数 a に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

atan2

public static float atan2(float a,
                          float b)

二次元座標から逆正接の近似値を計算します。

パラメータ:

a - x 座標の値を指定します。

b - y 座標の値を指定します。

戻り値:

b/a の逆正接値 (degree) を 区間 [0, 180) の範囲で計算した結果の近似値を返します。
引数 a および b が 0 の場合には、Float.NaN を返します。
引数 b が 0 ではなく、引数 a が 0 の場合には、常に 90 を返します。
引数 a が 0 ではなく、引数 b が 0 の場合には、常に 0 を返します。

例外:

IllegalArgumentException - 引数 a,b のいずれかに、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。

abs

public static float abs(float a)

絶対値の近似値を計算します。

パラメータ:

a - 値を指定します。

戻り値:

指定された値の絶対値の近似値を返します。

例外:

IllegalArgumentException - 引数 a に、 Float.NaN, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY のいずれかが指定された場合に発生します。