com.nttdocomo.ui.graphics3d.collision
インタフェース Shape
- 既知のサブインタフェースの一覧:
- AxisAlignedBV, BoundingVolume
- 既知の実装クラスの一覧:
- AABBox, AABCapsule, AABCylinder, AbstractBV, AbstractShape
- public interface Shape
形状を表わすインターフェースです。
すべての形状の基底となるインターフェースです。
1. 形状関連のインターフェース構成について
形状関連のインターフェース関係は次のようになっています。(左側のインターフェースを継承)
Shape−BoundingVolume−AxisAlignedBV
2. 形状関連のクラス構成について
Shapeインターフェース、BoundingVolumeインターフェースには、次のようにそれぞれを実現した抽象クラスがあり、これらの継承クラスは
次のようになっています。
AxisAlignedBVインターフェースには抽象クラスとして実現しているものはなく、次のクラスが直接実現
しています。
3. 座標系について
すべての座標系を並べると、次のようになります。(左側が親座標系)
ワールド座標系−(BVFigure座標系)−(ボーン座標系)−Shape座標系−BV座標系
このうち、( )内の座標系は、BVFigureに形状を設定する場合に関係する座標系です。
BV座標系は、BoundingVolume(Box、Capsule、Cylinder、Sphere、
AABBox、AABCapsule、AABCylinder)の場合に関係する座標系です。
したがって、形状の使い方により、関係する座標系は次のようになります。
- ワールド座標系にセットする
- ワールド座標系−Shape座標系(BoundingVolume以外のShapeの場合)
- ワールド座標系−Shape座標系−BV座標系(BoundingVolumeの場合)
- Figure全体の
BoundingVolumeとしてBVFigureにセットする
- ワールド座標系−BVFigure座標系−Shape座標系−BV座標系
BVFigureのボーンに対するBoundingVolumeとしてBVFigureにセットする
- ワールド座標系−BVFigure座標系−ボーン座標系−Shape座標系−BV座標系
(ボーン座標系からBVFigure座標系への一次変換は、ActionTableオブジェクトのデータにより行われます)
4. 一次変換行列について
3.における座標系間の変換に関する一次変換行列は、次のメソッドを使って設定します。
- ワールド座標系−Shape座標系(下図参照)
- Shape座標系−BV座標系(下図参照)
- ワールド座標系−BVFigure座標系
- BVFigure座標系−Shape座標系
- 2つの座標系は一致します(恒等変換)。一次変換行列を設定するメソッドはありません。
- ボーン座標系−Shape座標系
- 2つの座標系は一致します(恒等変換)。一次変換行列を設定するメソッドはありません。
- 導入されたバージョン:
- DoJa-5.0 (903i)
TYPE_POINT
public static final int TYPE_POINT
- Pointを表わすタイプです(=1)。
- 関連項目:
- 定数フィールド値
TYPE_LINE
public static final int TYPE_LINE
- Lineを表わすタイプです(=2)。
- 関連項目:
- 定数フィールド値
TYPE_RAY
public static final int TYPE_RAY
- Rayを表わすタイプです(=3)。
- 関連項目:
- 定数フィールド値
TYPE_TRIANGLE
public static final int TYPE_TRIANGLE
- Triangleを表わすタイプです(=4)。
- 関連項目:
- 定数フィールド値
TYPE_PLANE
public static final int TYPE_PLANE
- Planeを表わすタイプです(=5)。
- 関連項目:
- 定数フィールド値
TYPE_SPHERE
public static final int TYPE_SPHERE
- Sphereを表わすタイプです(=6)。
- 関連項目:
- 定数フィールド値
TYPE_BOX
public static final int TYPE_BOX
- Boxを表わすタイプです(=7)。
- 関連項目:
- 定数フィールド値
TYPE_CYLINDER
public static final int TYPE_CYLINDER
- Cylinderを表わすタイプです(=8)。
- 関連項目:
- 定数フィールド値
TYPE_CAPSULE
public static final int TYPE_CAPSULE
- Capsuleを表わすタイプです(=9)。
- 関連項目:
- 定数フィールド値
TYPE_AAB_BOX
public static final int TYPE_AAB_BOX
- AABBoxを表わすタイプです(=10)。
- 関連項目:
- 定数フィールド値
TYPE_AAB_CYLINDER
public static final int TYPE_AAB_CYLINDER
- AABCylinderを表わすタイプです(=11)。
- 関連項目:
- 定数フィールド値
TYPE_AAB_CAPSULE
public static final int TYPE_AAB_CAPSULE
- AABCapsuleを表わすタイプです(=12)。
- 関連項目:
- 定数フィールド値
TRANS_SHAPE_WORLD
public static final int TRANS_SHAPE_WORLD
- Shape座標系からワールド座標系への一次変換行列(スケールあり)を表わします(=1)。
- 関連項目:
- 定数フィールド値
TRANS_SHAPE_WORLD_NOSCALE
public static final int TRANS_SHAPE_WORLD_NOSCALE
- Shape座標系からワールド座標系への一次変換行列(スケールなし)を表わします(=2)。
- 関連項目:
- 定数フィールド値
TRANS_BV_SHAPE
public static final int TRANS_BV_SHAPE
- BV座標系からShape座標系への一次変換行列(BoundingVolume.getRotateメソッド、
BoundingVolume.getCenterメソッドの結果を行列として１つにしたもの)を表わします(=4)。
- 関連項目:
- 定数フィールド値
TRANS_BV_WORLD
public static final int TRANS_BV_WORLD
- BV座標系からワールド座標系への一次変換行列(スケールあり)を表わします(=5)。
- 関連項目:
- 定数フィールド値
TRANS_BV_WORLD_NOSCALE
public static final int TRANS_BV_WORLD_NOSCALE
- BV座標系からワールド座標系への一次変換行列(スケールなし)を表わします(=6)。
- 関連項目:
- 定数フィールド値
getShapeType
public int getShapeType()
-
- 戻り値:
- 形状タイプを返します。
- 関連項目:
TYPE_POINT,
TYPE_LINE,
TYPE_RAY,
TYPE_TRIANGLE,
TYPE_PLANE,
TYPE_SPHERE,
TYPE_BOX,
TYPE_CYLINDER,
TYPE_CAPSULE,
TYPE_AAB_BOX,
TYPE_AAB_CYLINDER,
TYPE_AAB_CAPSULE
createMesh
public void createMesh(int rgb,
int mode,
float v)
-
- パラメータ:
rgb - 0x00rrggbbの形式で、Primitiveオブジェクトの色を指定します。上位8ビットは無視されます。mode - ブレンドモードを指定します。DrawableObject3D.BLEND_NORMAL、DrawableObject3D.BLEND_ALPHA、DrawableObject3D.BLEND_ADDのいずれかを指定します。v - 透明度をパーセントで指定します。100の時が不透明です。
- 例外:
IllegalArgumentException - 引数modeがDrawableObject3D.BLEND_NORMAL、DrawableObject3D.BLEND_ALPHA、DrawableObject3D.BLEND_ADDのいずれかでもない場合に発生します。
IllegalArgumentException - 引数vがFloatNaNの場合、0未満の場合、あるいは100より大きい場合に発生します。
getMesh
public Primitive getMesh()
-
- 戻り値:
- テスト描画用のPrimitiveオブジェクトを返します。
createMeshメソッドでPrimitiveオブジェクトが生成されていない場合はnullを返します。
- 例外:
UIException - 保持しているPrimitiveオブジェクトが既に dispose() されている場合に発生します
(ILLEGAL_STATE)。
getMeshTransform
public Transform getMeshTransform(Transform meshTrans)
テスト描画用の一次変換行列を取得します。
開発時の図形位置の確認用としての利用を前提としたメソッドです。
- パラメータ:
meshTrans - 一次変換行列の値を受け取るTransformオブジェクトを指定します。
指定されたTransformオブジェクトに値をコピーして、戻り値で返します。nullが指定された
場合は、Transformオブジェクトを生成して値をコピーし、戻り値で返します。
- 戻り値:
- 一次変換行列を返します。
createMeshメソッドでPrimitiveオブジェクトが生成されていない場合、保持しているPrimitiveオブジェクトが既に dispose() されている場合はnullを返します。
deleteMesh
public void deleteMesh()
-
setTransform
public void setTransform(Transform trans)
ワールド座標系に対してShape座標系をセットする際の一次変換行列を設定します。
初期値は単位行列で、Shape座標系
がワールド座標系と一致します。
次のBoundingVolumeオブジェクトに対してこのメソッドを実行しても無視されます。
設定する行列の3×3部分が直交行列となり、全方向同一スケールとなるように指定してください。そうでない場合の
衝突判定、可視判定は保証されません。
- パラメータ:
trans - ワールド座標系に対してShape座標系をセットする際の一次変換行列を
設定します。nullを設定すると単位行列として扱われ、Shape座標系がワールド座標系と一致
します。
- 例外:
IllegalArgumentException - 引数transの1〜3列の列ベクトルに零ベクトルがある場合に発生します。
- 関連項目:
- 図形サイズ・位置、ベクトル、行列設定値に関する注意事項
getTransform
public Transform getTransform(int transType,
Transform trans)
指定した座標系間の一次変換行列を取得します。
次の一次変換行列を取得することができます。
- TRANS_SHAPE_WORLD
Shape座標系からワールド座標系への一次変換行列(スケールあり)。
setTransformで設定した一次変換行列を取得します。
- TRANS_SHAPE_WORLD_NOSCALE
Shape座標系からワールド座標系への一次変換行列(スケールなし)。
- TRANS_BV_SHAPE
BV座標系からShape座標系への一次変換行列。
(getRotate、getCenter(false)の結果を行列として１つにしたもの)
- TRANS_BV_WORLD
BV座標系からワールド座標系への一次変換行列(スケールあり)。
(TRANS_SHAPE_WORLDとTRANS_BV_SHAPEの組合せ)
- TRANS_BV_WORLD_NOSCALE
BV座標系からワールド座標系への一次変換行列(スケールなし)。
TRANS_BV_WORLDにおいてBoundingVolumeのサイズにスケールがかかっていない行列。
BoundingVolumeの中心(BV座標系の原点)がShape座標系の原点と異なる位置の場合、中心位置に関しては
スケールがかかります。
次のBoundingVolumeオブジェクトに対してこのメソッドを実行した場合にも、ワールド座標系−Shape座標系間の一次変換行列を取得することができます。
(取得する一次変換行列は、ワールド座標系とShape座標系の間に入る座標系に関する変換行列を
すべて含めて計算されたものです。)
- パラメータ:
transType - 取得する一次変換行列のタイプを指定します。
TRANS_SHAPE_WORLD、TRANS_SHAPE_WORLD_NOSCALE、TRANS_BV_SHAPE、
TRANS_BV_WORLD、TRANS_BV_WORLD_NOSCALEのいずれかを指定します。
trans - 一次変換行列の値を受け取るTransformオブジェクトを指定します。
指定されたTransformオブジェクトに値をコピーして、戻り値で返します。nullが指定された
場合は、Transformオブジェクトを生成して値をコピーし、戻り値で返します。
- 戻り値:
-
- 例外:
IllegalArgumentException - transTypeにTRANS_SHAPE_WORLD、TRANS_SHAPE_WORLD_NOSCALE、
TRANS_BV_SHAPE、TRANS_BV_WORLD、TRANS_BV_WORLD_NOSCALE
以外が指定された場合に発生します
getScale
public float getScale()
Shape座標系からワールド座標系への一次変換行列におけるスケール成分を取得します。
- 戻り値:
- Shape座標系からワールド座標系への一次変換行列におけるスケール成分を返します。
全方向同一スケールが設定されることを前提としていますが、同一スケールでない場合は、
最大値を返します。
setAttribute
public void setAttribute(Object attribute)
形状に属性オブジェクトを付加します。
Objectクラスを継承した任意のクラスのオブジェクトを付加することができます。これにより、
図形ごとにユーザー独自の属性を設定することができます。
引数attributeにnullを指定することにより、既に設定されている属性オブジェクトを除去
することができます。
- パラメータ:
attribute - 形状に付加する属性オブジェクトを指定します。
getAttribute
public Object getAttribute()
-
- 戻り値:
- 形状に付加している属性オブジェクトを返します。設定されていない場合はnullを返します。
NTT DoCoMo,Inc.
本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。
Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。
FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。
「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。
その他記載された会社名、製品名などは該当する各社の商標または登録商標です。