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

Object
  com.docomostar.opt.ui.eruption.Object3D
      com.docomostar.opt.ui.eruption.Animatable

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

Appearance, Camera, Light, MorphDeformer, NodeDeformer, TransformTree

public abstract class Animatable
extends Object3D

関連付けられた Action により、アニメーションを行う抽象クラスです。

このクラスを継承するものと、EffectSource がアニメーションを実行できます。Animatable を継承するクラスに関しては Object3D / Animatable を継承しているクラスを参照してください。
なお、Action のもつアニメーションデータがどのクラスのオブジェクトに対するものであるかを示すアクションタイプにより、関連付けを行える Action は限定されます。
Animatable のオブジェクト単独で Action の制御を行うことも可能ですが、セグメント単位での制御やリピートモードの指定など、より細かい制御を行うには ActionController を用いる必要があります。
ただし、ActionController を用いるには、あらかじめ setUseActionControllerNum(int) により有効化する ActionController の最大インデックスを設定しておく必要があります。
1 つ以上の Action 間でモーションブレンドを行う際にも ActionController を使用します。詳しくはActionの概念を参照してください。

各要素の初期値は以下の通りです。

• Action : null(全インデックスに対して)
• グローバルID : -1
• フレーム値 : 0
• ActionController : null(全インデックスに対して)
• 使用する ActionController 数： 0

グローバルID は グローバルIDについて を参照してください。

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

フィールドの概要

static int

MCE_MAX_ACTION_NUM 使用可能なアニメーション数を表します(=4)。

クラス 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

メソッドの概要

Action	getAction() 関連付けられた Action を取得します。
Action	getAction(int index) インデックスを指定して、関連付けられた Action を取得します。
ActionController	getActionController(int index) ActionController を取得します。
float	getFrame() 設定されているフレーム値を取得します。
int	getRefGid() グローバルID を取得します。
int	getRefGid(int index) インデックスを指定して、グローバルID を取得します。
void	setAction(Action action) Action を直接関連付けます。
void	setAction(Action action, int index) インデックスを指定して、Action を直接関連付けます。
void	setActionController(ActionController actCtr, int index) ActionController を設定します。
void	setFrame(float frame) 再生するフレーム値を設定します。
void	setRefGid(int rgid) 関連付ける Action のグローバルID を設定します。
void	setRefGid(int rgid, int index) インデックスを指定して、関連付ける Action のグローバルID を設定します。
void	setUseActionControllerNum(int useActCtrNum) 使用する ActionController の最大有効インデックスを設定します。
void	updatePosture() 設定されているフレーム値をもとにアニメーションを再生します。

クラス 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

フィールドの詳細

MCE_MAX_ACTION_NUM

public static final int MCE_MAX_ACTION_NUM

使用可能なアニメーション数を表します(=4)。

関連項目:

定数フィールド値

メソッドの詳細

setRefGid

public final void setRefGid(int rgid)

関連付ける Action のグローバルID を設定します。
setRefGid(int rgid, int index) に対して index = 0 とした場合と同じ処理です。

パラメータ:

rgid - 関連付ける Action のグローバルIDを指定します。-1 を設定することにより、グローバルIDを解除できます。

getRefGid

public final int getRefGid()

グローバルID を取得します。 getRefGid(int index) に対して index = 0 とした場合と同じ処理です。

戻り値:

グローバルID を返します。未設定時は -1 を返します。

setRefGid

public final void setRefGid(int rgid,
                            int index)

インデックスを指定して、関連付ける Action のグローバルID を設定します。

パラメータ:

rgid - 関連付ける Action のグローバルID を指定します。-1 を指定することにより、グローバルID を解除できます。

index - インデックスを指定します。

例外:

IllegalArgumentException -
index が [0, 3] 以外の場合に発生します。

getRefGid

public final int getRefGid(int index)

インデックスを指定して、グローバルID を取得します。

パラメータ:

index - インデックスを指定します。

戻り値:

グローバルID を返します。未設定時は -1 を返します。

例外:

IllegalArgumentException -
index が [0, 3] 以外の場合に発生します。

setAction

public final void setAction(Action action)

Action を直接関連付けます。 setAction(Action, int) に対して index = 0 とした場合と同じ処理です。

パラメータ:

action - 関連付ける Action を指定します。nullの場合、解除されます。

例外:

IllegalArgumentException -
関連付けを行う Animatable-Action 間でアクションタイプ不整合である場合に発生します。

IllegalArgumentException -
This が MorphDeformer の場合、モーフターゲット数と action の保持するセグメント数が異なる場合に発生します。

getAction

public final Action getAction()

関連付けられた Action を取得します。 getAction(int) に対して index = 0 とした場合と同じ処理です。

戻り値:

関連付けられた Action を返します。

setAction

public final void setAction(Action action,
                            int index)

インデックスを指定して、Action を直接関連付けます。

パラメータ:

action - 関連付ける Action を指定します。nullの場合、解除されます。

index - インデックスを指定します。

例外:

IllegalArgumentException -
index が [0, 3] 以外の場合に発生します。

IllegalArgumentException -
関連付けを行う Animatable-Action 間でアクションタイプ不整合である場合に発生します。

IllegalArgumentException -
This が MorphDeformer の場合、モーフターゲット数と action の保持するセグメント数が異なる場合に発生します。

getAction

public final Action getAction(int index)

インデックスを指定して、関連付けられた Action を取得します。

パラメータ:

index - インデックスを指定します。

戻り値:

関連付けられた Action を返します。

例外:

IllegalArgumentException -
index が [0, 3] 以外の場合に発生します。

setFrame

public final void setFrame(float frame)

再生するフレーム値を設定します。

フレーム値の設定のみです。実際の再生処理は updatePosture() が呼び出されたときに行われます。

パラメータ:

frame - フレーム値 を指定します。

getFrame

public final float getFrame()

設定されているフレーム値を取得します。

戻り値:

設定されているフレーム値 を返します。

updatePosture

public final void updatePosture()

設定されているフレーム値をもとにアニメーションを再生します。

setUseActionControllerNum

public final void setUseActionControllerNum(int useActCtrNum)

使用する ActionController の最大有効インデックスを設定します。

useActCtrNum を 0 にした場合、ActionController が無効になります。
ActionController を有効にする場合、useActCtrNum には最大有効インデックスに 1 を加えたものを渡すことに注意してください。

パラメータ:

useActCtrNum - 最大有効インデックス + 1 を指定します。

例外:

IllegalArgumentException -
useActCtrNum が [0, 4] 以外の場合に発生します。

setActionController

public final void setActionController(ActionController actCtr,
                                      int index)

ActionController を設定します。

パラメータ:

actCtr - ActionController を指定します。

index - インデックスを指定します。

例外:

IllegalArgumentException -
index が [0, 3] 以外の場合に発生します。

IllegalArgumentException -
This が MorphDeformer の場合、モーフターゲット数と actCtr の保持するセグメント数が異なる場合に発生します。

getActionController

public final ActionController getActionController(int index)

ActionController を取得します。

パラメータ:

index - インデックスを指定します。

戻り値:

ActionController を返します。

例外:

IllegalArgumentException -
index が [0, 3] 以外の場合に発生します。