Light (Star-1.2 (APIリファレンス))

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

com.docomostar.ui.graphics3d
クラス Light

Object
  com.docomostar.ui.graphics3d.Object3D
      com.docomostar.ui.graphics3d.Light

public class Light
extends Object3D

光源データを保持する、光源クラスを定義します。

光源の最大数は機種依存です。最大値は getMaxLights() メソッドにより取得できます。この値は、レンダリング機能である Graphics3D.renderObject3D(DrawableObject3D, Transform) メソッド呼び出し時に、同時にサポートされる光源の最大数です。

光源オブジェクトは、光源のモード情報、および、 三次元ベクトル オブジェクトを二つ保持します。ベクトルの一つは光源の位置を、もう一つは光源の向きを意味します。ベクトル情報は、いずれもワールド座標による指定です。

光源のモードと二つのベクトルの関係は、以下のようになっています。

光源のモード位置ベクトル方向ベクトル

AMBIENT 無効無効

DIRECTIONAL 無効有効

OMNI 有効無効

SPOT 有効有効

レンダリング時に、方向ベクトルがゼロベクトルであり、モードが DIRECTIONAL または SPOT の場合には、自動でベクトル (0, 0, -1) に補正されて扱われます。

光源のモード	位置ベクトル	方向ベクトル
AMBIENT	無効	無効
DIRECTIONAL	無効	有効
OMNI	有効	無効
SPOT	有効	有効

setTime(int) メソッド呼び出しによって現在時刻が変更されても、保持しているデータ内容は変化しません。

導入されたバージョン:: Star-1.0
関連項目:: 数値演算に関する共通の定義

フィールドの概要

static int AMBIENT
           環境光源を表す光源のモードの名前です(=128)。

static int DIRECTIONAL
           平行光源を表す光源のモードの名前です(=129)。

static int OMNI
           点光源を表す光源のモードの名前です(=130)。

static int SPOT
           スポット光源を表す光源のモードの名前です(=131)。

クラス com.docomostar.ui.graphics3d.Object3D から継承したフィールド

TYPE_ACTION_TABLE, TYPE_FIGURE, TYPE_FOG, TYPE_GROUP, TYPE_GROUP_MESH, TYPE_LIGHT, TYPE_NONE, TYPE_PRIMITIVE, TYPE_TEXTURE

コンストラクタの概要

Light()
           光源オブジェクトを生成します。

メソッドの概要

static int getMaxLights()
           レンダリング時に適用可能な光源の最大数を取得します。

Vector3D getPosition()
           光源の位置を取得します。

Vector3D getVector()
           光源の向きを取得します。

void setAttenuation(float constant, float linear, float quadratic)
           光源の減衰に関するパラメータを設定します。

void setColor(int RGB)
           光源の色を設定します。

void setIntensity(float intensity)
           光源の強度を設定します。

void setMode(int mode)
           光源のモードを設定します。

void setPosition(Vector3D v)
           光源の位置を設定します。

void setSpotAngle(float angle)
           スポット光源モード用の角度を設定します。

void setSpotExponent(float exponent)
           スポット光源モード用の輝度分布を設定します。

void setVector(Vector3D v)
           光源の向きを設定します。

クラス com.docomostar.ui.graphics3d.Object3D から継承したメソッド

createInstance, createInstance, dispose, getTime, getType, setTime

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

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

フィールドの詳細

AMBIENT

public static final int AMBIENT

環境光源を表す光源のモードの名前です(=128)。

関連項目:: 定数フィールド値

DIRECTIONAL

public static final int DIRECTIONAL

平行光源を表す光源のモードの名前です(=129)。

関連項目:: 定数フィールド値

OMNI

public static final int OMNI

点光源を表す光源のモードの名前です(=130)。

関連項目:: 定数フィールド値

SPOT

public static final int SPOT

スポット光源を表す光源のモードの名前です(=131)。

関連項目:: 定数フィールド値

コンストラクタの詳細

Light

public Light()

光源オブジェクトを生成します。

初期状態は以下のようになります。

モード: DIRECTIONAL
色 : 0x00FFFFFF (完全な白)
強度 : 1.0
減衰 : (1, 0, 0)
スポット光源の角度 : 45(degree)
スポット光源の輝度分布 : 0.0
位置 : (0, 0, 0)
向き : (0, 0, 1)

メソッドの詳細

setPosition

public void setPosition(Vector3D v)

光源の位置を設定します。

三次元ベクトル オブジェクトへの参照を保持します。このメソッドが呼び出されたあとに、該当するベクトルの内容が変化したときには、光源の設定内容が変化します。このメソッドによる設定内容は、光源のタイプが DIRECTIONAL または AMBIENT のときは利用されません。

パラメータ:: v - ベクトルオブジェクトを指定します。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。; NullPointerException -
引数 v が null の場合に発生します。

getPosition

public Vector3D getPosition()

光源の位置を取得します。

この光源オブジェクトが保持している、三次元ベクトル オブジェクトへの参照を返します。該当するベクトルの内容が変化したときには、光源の設定内容は変化します。

戻り値:: 光源の向きを表すベクトルオブジェクトを返します。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。

setVector

public void setVector(Vector3D v)

光源の向きを設定します。

三次元ベクトル オブジェクトへの参照を保持します。このメソッドが呼び出されたあとに、該当するベクトルの内容が変化したときには、光源の設定内容が変化します。このメソッドによる設定内容は、光源のタイプが OMNI または AMBIENT のときは利用されません。

パラメータ:: v - ベクトルオブジェクトを指定します。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。; NullPointerException -
引数 v が null の場合に発生します。

getVector

public Vector3D getVector()

光源の向きを取得します。

戻り値:: 光源の向きを表すベクトルオブジェクトを返します。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。

setMode

public void setMode(int mode)

光源のモードを設定します。

パラメータ:: mode - 光源のモード値を指定します。 AMBIENT, DIRECTIONAL, OMNI, SPOT のいずれかの値なことが必要です。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。; IllegalArgumentException -
引数 mode が AMBIENT, DIRECTIONAL, OMNI, SPOT のいずれかではない場合に発生します。

setIntensity

public void setIntensity(float intensity)

光源の強度を設定します。

パラメータ:: intensity - 光源の強度を指定します。通常の光源設定では、値は 0 から 1 の範囲になりますが、光の高度なブレンド機能などを有する環境では、その範囲外の値も意味を持ちます。そのような機能が無い環境下では、レンダリング時に、この値は区間 [0,1] に丸められて利用されます。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。; IllegalArgumentException -
引数 intensity が Float.NaN の場合に発生します。

setColor

public void setColor(int RGB)

光源の色を設定します。

パラメータ:: RGB - 0x00RRGGBB の形式で、光源の色を指定します。上位 8 ビットは無視されます。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。

setSpotAngle

public void setSpotAngle(float angle)

スポット光源モード用の角度を設定します。

このメソッドによる設定内容は、光源のタイプが SPOT のときに限り反映されます。

パラメータ:: angle - スポット光源の円錐の角度 (degree) を指定します。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。; IllegalArgumentException -
引数 angle が区間 [0, 90] の範囲外の場合に発生します。

setSpotExponent

public void setSpotExponent(float exponent)

スポット光源モード用の輝度分布を設定します。

このメソッドによる設定内容は、光源のタイプが SPOT のときに限り反映されます。

パラメータ:: exponent - スポット光源の輝度分布を指定します。 0 のときは均一な明るさに、 128 のときは濃淡がはっきりした明るさの分布になります。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。; IllegalArgumentException -
引数 exponent が区間 [0, 128] の範囲外の場合に発生します。

setAttenuation

public void setAttenuation(float constant,
                           float linear,
                           float quadratic)

光源の減衰に関するパラメータを設定します。

このメソッドによる設定内容は、光源のタイプが OMNI または SPOT のときに限り反映されます。

以下の数式により、減衰する量が定義されます。 (d は頂点から光源までの距離)

1 / (constant + linear * d + quadratic * d * d)

初期状態つまり、 (constant,linear,quadratic) = (1,0,0) のときには、減衰はありません。

パラメータ:: constant - 定数 constant 値を指定します。; linear - 定数 linear 値を指定します。; quadratic - 定数 quadratic 値を指定します。
例外:: UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。; IllegalArgumentException -
引数 constant, linear, quadratic のいずれかに負数 (マイナス∞も含む) がある場合に発生します。; IllegalArgumentException -
引数 constant, linear, quadratic のいずれかが Float.NaN, Float.POSITIVE_INFINITY である場合に発生します。; IllegalArgumentException -
引数 constant, linear, quadratic がすべて 0 の場合に発生します。

getMaxLights

public static int getMaxLights()

レンダリング時に適用可能な光源の最大数を取得します。

レンダリング機能である Graphics3D.renderObject3D(DrawableObject3D, Transform) メソッド呼び出し時に、同時に扱うことができる光源オブジェクトの最大数です。

このメソッドが返す値は、機種依存になります。

戻り値:: レンダリング時に適用可能な光源の最大数を返します。

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

NTT DOCOMO,INC.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。

「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。

フィールドの概要
`static int`	`AMBIENT` 環境光源を表す光源のモードの名前です(=128)。
`static int`	`DIRECTIONAL` 平行光源を表す光源のモードの名前です(=129)。
`static int`	`OMNI` 点光源を表す光源のモードの名前です(=130)。
`static int`	`SPOT` スポット光源を表す光源のモードの名前です(=131)。

コンストラクタの概要
`Light()` 光源オブジェクトを生成します。

メソッドの概要
`static int`	`getMaxLights()` レンダリング時に適用可能な光源の最大数を取得します。
`Vector3D`	`getPosition()` 光源の位置を取得します。
`Vector3D`	`getVector()` 光源の向きを取得します。
`void`	`setAttenuation(float constant, float linear, float quadratic)` 光源の減衰に関するパラメータを設定します。
`void`	`setColor(int RGB)` 光源の色を設定します。
`void`	`setIntensity(float intensity)` 光源の強度を設定します。
`void`	`setMode(int mode)` 光源のモードを設定します。
`void`	`setPosition(Vector3D v)` 光源の位置を設定します。
`void`	`setSpotAngle(float angle)` スポット光源モード用の角度を設定します。
`void`	`setSpotExponent(float exponent)` スポット光源モード用の輝度分布を設定します。
`void`	`setVector(Vector3D v)` 光源の向きを設定します。

com.docomostar.ui.graphics3d クラス Light

AMBIENT

DIRECTIONAL

OMNI

SPOT

Light

setPosition

getPosition

setVector

getVector

setMode

setIntensity

setColor

setSpotAngle

setSpotExponent

setAttenuation

getMaxLights

com.docomostar.ui.graphics3d
クラス Light