com.docomostar.ui.graphics3d
クラス Object3D

Object
  com.docomostar.ui.graphics3d.Object3D

直系の既知のサブクラス:

ActionTable, DrawableObject3D, Fog, Light, Texture

public abstract class Object3D
extends Object

[iアプリオプションAPI]

すべての3Dオブジェクトの基底クラスとなる、 抽象的な3Dオブジェクトクラスを定義します。

3Dオブジェクトは、現在時刻を表す値 (int) を一つ保持します。 初期状態では、この現在時刻の値は 0 になっています。 設定されている現在時刻は、レンダリング時に利用されます。

導入されたバージョン:

Star-1.0

フィールドの概要

static int	TYPE_ACTION_TABLE アクションテーブル を表す、3Dオブジェクト のタイプの名前です(=1)。
static int	TYPE_FIGURE フィギュア を表す、3Dオブジェクト のタイプの名前です(=2)。
static int	TYPE_FOG フォグ を表す、3Dオブジェクト のタイプの名前です(=4)。
static int	TYPE_GROUP グループ を表す、3Dオブジェクト のタイプの名前です(=7)。
static int	TYPE_GROUP_MESH メッシュタイプの グループ を表す、3Dオブジェクト のタイプの名前です(=8)。
static int	TYPE_LIGHT 光源 を表す、3Dオブジェクト のタイプの名前です(=5)。
static int	TYPE_NONE 破棄されたオブジェクトを表す、 3Dオブジェクト のタイプの名前です(=0)。
static int	TYPE_PRIMITIVE プリミティブ を表す、3Dオブジェクト のタイプの名前です(=6)。
static int	TYPE_TEXTURE テクスチャ を表す、3Dオブジェクト のタイプの名前です (=3)。

メソッドの概要

static Object3D	createInstance(byte[] data) バイトデータから、3Dオブジェクトを一つ生成します。
static Object3D	createInstance(java.io.InputStream is) データを入力して、3Dオブジェクトを一つ生成します。
void	dispose() 3Dオブジェクトが保持しているデータをメモリから解放します。
int	getTime() 3Dオブジェクトに設定されている現在時刻を取得します。
int	getType() 3Dオブジェクトのタイプを番号で取得します。
void	setTime(int time) 3Dオブジェクトに現在時刻を設定します。

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

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

フィールドの詳細

TYPE_NONE

public static final int TYPE_NONE

破棄されたオブジェクトを表す、 3Dオブジェクト のタイプの名前です(=0)。

既に dispose() メソッドが呼ばれているオブジェクトであることを示します。 このタイプが設定されているオブジェクトは、再利用できません。

関連項目:

定数フィールド値

TYPE_ACTION_TABLE

public static final int TYPE_ACTION_TABLE

アクションテーブル を表す、3Dオブジェクト のタイプの名前です(=1)。

関連項目:

定数フィールド値

TYPE_FIGURE

public static final int TYPE_FIGURE

フィギュア を表す、3Dオブジェクト のタイプの名前です(=2)。

関連項目:

定数フィールド値

TYPE_TEXTURE

public static final int TYPE_TEXTURE

テクスチャ を表す、3Dオブジェクト のタイプの名前です (=3)。

関連項目:

定数フィールド値

TYPE_FOG

public static final int TYPE_FOG

フォグ を表す、3Dオブジェクト のタイプの名前です(=4)。

関連項目:

定数フィールド値

TYPE_LIGHT

public static final int TYPE_LIGHT

光源 を表す、3Dオブジェクト のタイプの名前です(=5)。

関連項目:

定数フィールド値

TYPE_GROUP

public static final int TYPE_GROUP

グループ を表す、3Dオブジェクト のタイプの名前です(=7)。

関連項目:

定数フィールド値

TYPE_GROUP_MESH

public static final int TYPE_GROUP_MESH

メッシュタイプの グループ を表す、3Dオブジェクト のタイプの名前です(=8)。

関連項目:

定数フィールド値

TYPE_PRIMITIVE

public static final int TYPE_PRIMITIVE

プリミティブ を表す、3Dオブジェクト のタイプの名前です(=6)。

関連項目:

定数フィールド値

メソッドの詳細

createInstance

public static Object3D createInstance(java.io.InputStream is)
                               throws java.io.IOException

データを入力して、3Dオブジェクトを一つ生成します。

データ内容が グループ オブジェクトであるとき、 生成される グループ オブジェクトが参照する 3Dオブジェクト 群において、 フィギュア オブジェクトまたは プリミティブ オブジェクトと テクスチャ オブジェクトとの関連付け、および、 フィギュア オブジェクトと アクションテーブル オブジェクトとの、 関連付けが自動で設定されることがあります。

パラメータ:

is - データを取得する為の入力ストリームオブジェクトを指定します。

戻り値:

生成された3Dオブジェクトを返します。

例外:

NullPointerException -
引数 is が null の場合に発生します。

java.io.IOException -
データを読み出す際に I/O エラーが起こった場合に発生します。

RuntimeException -
データが不正な場合に発生します。

createInstance

public static Object3D createInstance(byte[] data)

バイトデータから、3Dオブジェクトを一つ生成します。

データ内容が グループ オブジェクトであるとき、 生成される グループ オブジェクトが参照する 3Dオブジェクト 群において、 フィギュア オブジェクトまたは プリミティブ オブジェクトと テクスチャ オブジェクトとの関連付け、および、 フィギュア オブジェクトと アクションテーブル オブジェクトとの、 関連付けが自動で設定されることがあります。

パラメータ:

data - バイトデータを指定します。

戻り値:

生成された3Dオブジェクトを返します。

例外:

NullPointerException -
引数 data が null の場合に発生します。

RuntimeException -
データが不正な場合に発生します。

dispose

public void dispose()

3Dオブジェクトが保持しているデータをメモリから解放します。

このメソッドを呼び出した後は、このオブジェクトを再利用できなくなります。

このメソッドを呼び出した後に、 getType() メソッドを呼び出したときの戻り値は、 常に TYPE_NONE になります。

既に dispose() メソッドが呼ばれているときには、何もしません。 このとき、例外は発生しません。

getType

public int getType()

3Dオブジェクトのタイプを番号で取得します。

本クラスに定義されているタイプ値 TYPE_NONE, TYPE_ACTION_TABLE, TYPE_FIGURE, TYPE_TEXTURE, TYPE_FOG, TYPE_LIGHT, TYPE_GROUP, TYPE_GROUP_MESH, TYPE_PRIMITIVE のいずれかが返されます。

戻り値:

オブジェクトのタイプ値を返します。

setTime

public void setTime(int time)

3Dオブジェクトに現在時刻を設定します。

パラメータ:

time - 現在時刻を指定します。

例外:

UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。

getTime

public int getTime()

3Dオブジェクトに設定されている現在時刻を取得します。

戻り値:

設定されている現在時刻を返します。

例外:

UIException -
(ILLEGAL_STATE)
既に dispose() されたオブジェクトに対して呼ばれた場合に発生します。