com.docomostar.opt.ui.eruption
クラス Particle

Object
  上位を拡張 com.docomostar.opt.ui.eruption.Object3D
      上位を拡張 com.docomostar.opt.ui.eruption.Particle
直系の既知のサブクラス:
EffectSource

public class Particle
extends Object3D

パーティクルを表すクラスです。

MCE ファイルからロードした EffectSource にセットされているシードがこのクラスだった場合に、設定値を変更するために使用します。EffectSource にセットされているシードは、EffectSource.getSeed(int) で取得することができます。
シードとして設定された場合、1 つの Particle オブジェクトから複数のエフェクトが生成されます。そのため、寿命、移動速度、回転、スケール、色、テクスチャ座標関連を設定する際には単一の値ではなく区間を用い、 発生する個々のエフェクトはその区間内からランダムで選ばれた値が用いられます。

端末によって、本クラスはサポートされていない場合があります。未サポートの場合、メソッドが呼び出された時点で UnsupportedOperationException が発生します。


フィールドの概要
 
クラス com.docomostar.opt.ui.eruption.Object3D から継承されたフィールド
MCE_CLASS_TYPE_ACTION, MCE_CLASS_TYPE_ACTIONCONTROLLER, MCE_CLASS_TYPE_ACTIONTABLE, MCE_CLASS_TYPE_APPEARANCE, MCE_CLASS_TYPE_BONE, MCE_CLASS_TYPE_BONEDEFORMER, MCE_CLASS_TYPE_CAMERA, MCE_CLASS_TYPE_EFFECTSOURCE, MCE_CLASS_TYPE_FIGURE, MCE_CLASS_TYPE_GEOMETRICSHAPE, MCE_CLASS_TYPE_GRAPHICS3D, MCE_CLASS_TYPE_INDEXBUFFER, MCE_CLASS_TYPE_INTERSECTIONATTRIBUTES, MCE_CLASS_TYPE_LIGHT, MCE_CLASS_TYPE_MORPHDEFORMER, MCE_CLASS_TYPE_NODEDEFORMER, MCE_CLASS_TYPE_OBJECT3D, MCE_CLASS_TYPE_PARTICLE, MCE_CLASS_TYPE_TEXTURE, MCE_CLASS_TYPE_TEXTURETABLE, MCE_CLASS_TYPE_TRACKBALL, MCE_CLASS_TYPE_TRANSFORMTREE, MCE_CLASS_TYPE_VERTEXBUFFER
 
メソッドの概要
 void setColorIniVal(int upperVal, int lowerVal)
          Particle の色の初期値を設定します。
 void setColorRange(int upperVal, int lowerVal)
          Particle の色の範囲を設定します。
 void setColorVelocity(float[] upperIni, float[] lowerIni, float[] upperAcc, float[] lowerAcc)
          Particle の色変化の速度を設定します。
 void setLifeDuration(float upperVal, float lowerVal)
          Particle の寿命を設定します。
 void setMoveSpeed(float upperIni, float lowerIni, float upperAcc, float lowerAcc)
          Particle の移動速度を設定します。
 void setMoveSpeedRange(float upperVal, float lowerVal)
          移動速度の範囲を設定します。
 void setRotationIniVal(Vector3D upperVal, Vector3D lowerVal)
          Particle の回転初期角を設定します。
 void setRotationRange(Vector3D upperVal, Vector3D lowerVal)
          Particle の回転角の範囲を設定します。
 void setRotationVelocity(Vector3D upperIni, Vector3D lowerIni, Vector3D upperAcc, Vector3D lowerAcc)
          Particle の回転速度を設定します。
 void setScaleIniVal(Vector3D upperVal, Vector3D lowerVal)
          Particle のスケーリングの初期値を設定します。
 void setScaleRange(Vector3D upperVal, Vector3D lowerVal)
          Particle のスケーリング範囲を設定します。
 void setScaleVelocity(Vector3D upperIni, Vector3D lowerIni, Vector3D upperAcc, Vector3D lowerAcc)
          Particle のスケーリング速度を設定します。
 void setTextureSTRange(float[] upperVal, float[] lowerVal)
          Particle が用いるテクスチャ座標の範囲を設定します。
 void setTextureSTVelocity(float[] velocity, float[] frameStep)
          Particle が用いるテクスチャ座標の速度を設定します。
 
クラス com.docomostar.opt.ui.eruption.Object3D から継承されたメソッド
dispose, equals, findObject3D, findObject3D, getClassType, getUserId, hashCode, isDisposed, isRenderEnable, setRenderEnable, setUserId
 
クラス Object から継承されたメソッド
getClass, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

setLifeDuration

public final void setLifeDuration(float upperVal,
                                  float lowerVal)
Particle の寿命を設定します。

Particle の寿命を [lowerVal, upperVal] の範囲に設定します。

パラメータ:
upperVal - 寿命の上限値を指定します。
lowerVal - 寿命の下限値を指定します。
例外:
IllegalArgumentException -
upperVal < lowerVal の場合に発生します。

setMoveSpeed

public final void setMoveSpeed(float upperIni,
                               float lowerIni,
                               float upperAcc,
                               float lowerAcc)
Particle の移動速度を設定します。

Particle の初期速度と加速度をそれぞれ [lowerIni, upperIni]、[lowerAcc, upperAcc] の範囲に設定します。 EffectSource.setLaunchVector(Vector3D, Vector3D, boolean) で normalize を true にしていない場合、実際の初期速度と加速度は射出方向ベクトルの長さをかけたものになります。 引数のチェックは初速度、加速度の順で行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperIni - 初速度の上限を指定します。
lowerIni - 初速度の下限を指定します。
upperAcc - 加速度の上限を指定します。
lowerAcc - 加速度の下限を指定します。
例外:
IllegalArgumentException -
upperIni < lowerIni の場合に発生します。
IllegalArgumentException -
upperAcc < lowerAcc の場合に発生します。

setMoveSpeedRange

public final void setMoveSpeedRange(float upperVal,
                                    float lowerVal)
移動速度の範囲を設定します。

Particle の移動速度の範囲を [lowerVal, upperVal] に設定します。 EffectSource.setLaunchVector(Vector3D, Vector3D, boolean) で normalize を true にしていない場合、実際の上下限は射出方向ベクトルの長さをかけたものになります。

パラメータ:
upperVal - 移動速度の上限を指定します。
lowerVal - 移動速度の下限を指定します。
例外:
IllegalArgumentException -
upperVal < lowerVal の場合に発生します。

setRotationIniVal

public final void setRotationIniVal(Vector3D upperVal,
                                    Vector3D lowerVal)
Particle の回転初期角を設定します。

回転順序は x->y->z の順です。引数のチェックは x, y, z の順で行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperVal - 初期角の上限値を指定します。
lowerVal - 初期角の下限値を指定します。
例外:
NullPointerException -
upperVal、lowerVal のいずれかが null の場合に発生します。
IllegalArgumentException -
upperVal.c < lowerVal.c となる成分 c が存在する場合に発生します。

setRotationVelocity

public final void setRotationVelocity(Vector3D upperIni,
                                      Vector3D lowerIni,
                                      Vector3D upperAcc,
                                      Vector3D lowerAcc)
Particle の回転速度を設定します。

回転順序は x->y->z の順です。引数のチェックは回転初速度の x, y, z、回転加速度の x, y, z の順で行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperIni - 回転初速度の上限を指定します。
lowerIni - 回転初速度の下限を指定します。
upperAcc - 回転加速度の上限を指定します。
lowerAcc - 回転加速度の下限を指定します。
例外:
NullPointerException -
upperIni, lowerIni, upperAcc, lowerAcc のいずれかが null の場合に発生します。
IllegalArgumentException -
upperIni.c < lowerIni.c となる成分 c が存在する場合に発生します。
IllegalArgumentException -
upperAcc.c < lowerAcc.c となる成分 c が存在する場合に発生します。

setRotationRange

public final void setRotationRange(Vector3D upperVal,
                                   Vector3D lowerVal)
Particle の回転角の範囲を設定します。

引数のチェックは x, y, z の順で行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperVal - 回転角の上限を指定します。
lowerVal - 回転角の下限を指定します。
例外:
NullPointerException -
upperVal, lowerVal のいずれかが null の場合に発生します。
IllegalArgumentException -
upperVal.c < lowerVal.c となる成分 c が存在する場合に発生します。

setScaleIniVal

public final void setScaleIniVal(Vector3D upperVal,
                                 Vector3D lowerVal)
Particle のスケーリングの初期値を設定します。

実際のスケール値は EffectSource においてパーティクルを発生させる際に、当 API で指定した範囲内からランダムに決められます。 引数のチェックは x, y, z の順で行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperVal - スケーリング初期値の上限を指定します。
lowerVal - スケーリング初期値の下限を指定します。
例外:
NullPointerException -
upperVal, lowerVal のいずれかが null の場合に発生します。
IllegalArgumentException -
upperVal.c < lowerVal.c となる成分 c が存在する場合に発生します。

setScaleVelocity

public final void setScaleVelocity(Vector3D upperIni,
                                   Vector3D lowerIni,
                                   Vector3D upperAcc,
                                   Vector3D lowerAcc)
Particle のスケーリング速度を設定します。

引数のチェックは初速度の x, y, z、加速度の x, y, z の順で行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperIni - 初速度の上限を指定します。
lowerIni - 初速度の下限を指定します。
upperAcc - 加速度の上限を指定します。
lowerAcc - 加速度の下限を指定します。
例外:
NullPointerException -
upperIni, lowerIni, upperAcc, lowerAcc のいずれかが null の場合に発生します。
IllegalArgumentException -
upperIni.c < lowerIni.c となる成分 c が存在する場合に発生します。
IllegalArgumentException -
upperAcc.c < lowerAcc.c となる成分 c が存在する場合に発生します。

setScaleRange

public final void setScaleRange(Vector3D upperVal,
                                Vector3D lowerVal)
Particle のスケーリング範囲を設定します。

引数のチェックは x, y, z の順で行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperVal - スケーリングの上限を指定します。
lowerVal - スケーリングの下限を指定します。
例外:
NullPointerException -
upperVal, lowerVal のいずれかが null の場合に発生します。
IllegalArgumentException -
upperVal.c < lowerVal.c となる成分 c が存在する場合に発生します。

setColorIniVal

public final void setColorIniVal(int upperVal,
                                 int lowerVal)
Particle の色の初期値を設定します。

Particle の色の初期値を [upperVal, lowerVal] に設定します。

パラメータ:
upperVal - 色の上限値 (0xAABBGGRR)を指定します。
lowerVal - 色の下限値 (0xAABBGGRR)を指定します。
例外:
IllegalArgumentException -
upperVal < lowerVal の場合に発生します。

setColorVelocity

public final void setColorVelocity(float[] upperIni,
                                   float[] lowerIni,
                                   float[] upperAcc,
                                   float[] lowerAcc)
Particle の色変化の速度を設定します。

A, B, G, R のそれぞれに対して交互に初速度、加速度という順で引数のチェックが行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperIni - 初速度の上限 (A, B, G, R の順) を指定します。
lowerIni - 初速度の下限 (A, B, G, R の順) を指定します。
upperAcc - 加速度の上限 (A, B, G, R の順) を指定します。
lowerAcc - 加速度の下限 (A, B, G, R の順) を指定します。
例外:
NullPointerException -
upperIni , lowerIni , upperAcc , lowerAcc のいずれかが null の場合に発生します。
IllegalArgumentException -
upperIni.c < lowerIni.c となる成分 c が存在する場合に発生します。
IllegalArgumentException -
upperAcc.c < lowerAcc.c となる成分 c が存在する場合に発生します。
IndexOutOfBoundsException -
各配列要素数が一致しない場合に発生します。

setColorRange

public final void setColorRange(int upperVal,
                                int lowerVal)
Particle の色の範囲を設定します。 Particle の色の範囲を [upperVal, lowerVal] に設定します。

パラメータ:
upperVal - 色の上限値 (0xAABBGGRR)を指定します。
lowerVal - 色の下限値 (0xAABBGGRR)を指定します。
例外:
IllegalArgumentException -
upperVal < lowerVal の場合に発生します。

setTextureSTVelocity

public final void setTextureSTVelocity(float[] velocity,
                                       float[] frameStep)
Particle が用いるテクスチャ座標の速度を設定します。

Particle の描画用モデルがスプライトの場合のみ有効です。

パラメータ:
velocity - テクスチャ座標の増減値の配列 (順に s, t に対応) を指定します。
frameStep - 何フレーム毎に増減させるかの値の配列 (順に s, t に対応) を指定します。
例外:
NullPointerException -
velocity , frameStep のいずれかが null の場合に発生します。
IndexOutOfBoundsException -
各配列要素数が一致しない場合に発生します。

setTextureSTRange

public final void setTextureSTRange(float[] upperVal,
                                    float[] lowerVal)
Particle が用いるテクスチャ座標の範囲を設定します。

Particle の描画用モデルがスプライトの場合のみ有効です。 引数のチェックは配列の先頭から行われ、途中でエラーになった場合、それよりも前の値は引数のものに変更されます。

パラメータ:
upperVal - 上限値の配列 (それぞれ s, t に対応) を指定します。
lowerVal - 下限値の配列 (それぞれ s, t に対応) を指定します。
例外:
NullPointerException -
upperVal, lowerVal のいずれかが null の場合に発生します。
IllegalArgumentException -
upperVal[i] < lowerVal[i] となる i(i < 2) が存在する場合に発生します。
IndexOutOfBoundsException -
各配列要素数が一致しない場合に発生します。


NTT DOCOMO,INC.

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

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

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

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

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