com.nttdocomo.ui.graphics3d
クラス Group

Object
  拡張com.nttdocomo.ui.graphics3d.Object3D
      拡張com.nttdocomo.ui.graphics3d.DrawableObject3D
          拡張com.nttdocomo.ui.graphics3d.Group

public class Group
extends DrawableObject3D

3Dオブジェクト 群のひとかたまりのグループを表す、 グループクラスを定義します。

グループは、 3Dオブジェクト 群への参照を保持します。 その 3Dオブジェクト は、 グループオブジェクトであっても構いません。 ただし、参照に自分自身を持つことはできません。 また、グループ A がグループ B の参照を持っているときに、 グループB にグループ A の参照を加えるなど、 参照の関係をループさせることはできません。 以上の条件を満たすならば、異なるグループオブジェクトが、 同一の 3Dオブジェクト を参照していても構いません。

グループオブジェクトには、大きく分けて2種類があり、 getType() メソッドにより取得できる値によって区別できます。 通常のグループ Object3D.TYPE_GROUP と、 メッシュグループ Object3D.TYPE_GROUP_MESH の2種類です。メッシュグループは、バイナリデータを入力する メソッド Object3D.createInstance(InputStream) Object3D.createInstance(byte[]) を利用することで生成できます。 このメッシュグループは、以下の特徴を持ちます。

グループは、 変換行列 オブジェクトを一つ保持します。 初期状態では、この行列の内容は恒等変換を意味する状態になっています。 ただし、メソッド Object3D.createInstance(InputStream) Object3D.createInstance(byte[]) によって生成された場合は、行列の内容はバイナリデータによって 設定されることがあります。

メッシュグループに関する、追記事項を以下に示します。

導入されたバージョン:
DoJa-4.0 (901i)

フィールドの概要
 
クラス com.nttdocomo.ui.graphics3d.DrawableObject3D から継承したフィールド
BLEND_ADD, BLEND_ALPHA, BLEND_NORMAL
 
クラス com.nttdocomo.ui.graphics3d.Object3D から継承したフィールド
TYPE_ACTION_TABLE, TYPE_FIGURE, TYPE_FOG, TYPE_GROUP, TYPE_GROUP_MESH, TYPE_LIGHT, TYPE_NONE, TYPE_PRIMITIVE, TYPE_TEXTURE
 
コンストラクタの概要
Group()
           3Dオブジェクト への参照を持たない グループオブジェクトを生成します。
 
メソッドの概要
 void addElement(Object3D obj)
           新規に 3Dオブジェクト への参照を追加します。
 void dispose()
           このオブジェクト、および、参照を保持している 3Dオブジェクト が持っている関連データを解放します。
 Object3D getElement(int index)
           番号を指定して、参照を保持している 3Dオブジェクト のうちの一つを取得します。
 int getNumElements()
           参照を保持している 3Dオブジェクト の数を取得します。
 void getTransform(Transform transform)
           設定されている 変換行列 を取得します。
 void removeElement(int index)
           番号を指定して、参照を保持している 3Dオブジェクト のうちの一つについて、参照を解除します。
 void setBlendMode(int mode)
           参照を保持している 描画可能な3Dオブジェクト すべてに、図形用ブレンドモードを設定します。
 void setPerspectiveCorrectionEnabled(boolean isOn)
           参照を保持している 描画可能な3Dオブジェクト すべてに、パースペクティブコレクションの設定をします。
 void setTime(int time)
           このオブジェクトに現在時刻を設定すると同時に、 参照を保持している 3Dオブジェクト すべてに現在時刻を設定します。
 void setTransform(Transform transform)
           変換行列 を設定します。
 void setTransparency(float v)
           参照を保持している 描画可能な3Dオブジェクト すべてに、透明度を設定します。
 
クラス com.nttdocomo.ui.graphics3d.DrawableObject3D から継承したメソッド
isCross
 
クラス com.nttdocomo.ui.graphics3d.Object3D から継承したメソッド
createInstance, createInstance, getTime, getType