変換行列のキャッシュ。 Object2D
は状態に変更があった時、本値の_modifiedをtrueにする必要がある。
初期値は undefined
であり、 getMatrix()
によって必要な時に生成されるため、
if (this._matrix) this._matrix._modified = true
という式で記述する必要がある。
エンジンに組み込まれているSprite等のエンティティ群は、
すでに本処理を組み込んでいるため通常ゲーム開発者はこの値を意識する必要はない。
Object2D
を継承したクラスを新たに作る場合には、本フィールドを適切に操作しなければならない。
このEが「映り込む」カメラの集合。 空でない配列が指定されている場合、配列内に存在しないCameraでの描画時にはこのEがスキップされる。 初期値はundefinedである。targetCamerasがこの値を暗黙に生成するので、ゲーム開発者はそちらを使うべきである。
オブジェクトの回転。度数で指定する。
初期値は 0
である。
E
や Camera2D
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
このエンティティの全子エンティティ。
子エンティティが存在しない場合、本フィールドの値は undefined
または空配列である。
描画時の合成方法を指定する。
初期値は undefined
となり、合成方法を指定しないことを意味する。
E
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
このオブジェクトの縦幅。
初期値は 0
である。実際の表示領域としてはscaleX, scaleY, angleの値も考慮する必要がある。
E
や Camera2D
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
このエンティティに割り振られる Game
単位で一意のID。(ただし local
が真である場合を除く)
このエンティティがローカルであるか否か。 コンストラクタで真が指定された時、または属するシーンがローカルシーンまたはローカルティック補間シーンである時、この値は真である。
この値が真である場合、このエンティティに対する point イベントはこのゲームインスタンスにのみ通知され、
他の参加者・視聴者には通知されない。また真である場合、 id
の値の一意性は保証されない。
この値は参照のためにのみ公開されている。ゲーム開発者はこの値を直接変更してはならない。
このエンティティのmessageイベント。
0~1でオブジェクトの不透明度を表す。
初期値は 1
である。本値が0の場合、Rendererは描画処理を省略する。
E
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
親。
このエンティティのpoint downイベント。
このエンティティのpoint moveイベント。
このエンティティのpoint upイベント。
オブジェクトの横方向の倍率。
初期値は 1
である。
E
や Camera2D
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
オブジェクトの縦方向の倍率。
初期値は 1
である。
E
や Camera2D
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
このエンティティが属するシーン。
様々な状態を表すビットフラグ。
ゲーム開発者向けのタグ情報管理コンテナ。 この値はゲームエンジンのロジックからは使用されず、ゲーム開発者は任意の目的に使用してよい。
このエンティティを表示できるカメラの配列。
初期値は空配列である。
この値が undefined
または空配列である場合、このエンティティとその子孫はカメラによらず描画される。
空でない配列である場合、このエンティティとその子孫は、配列内に含まれるカメラでの描画の際にのみ表示される。
この値を変更した場合、 this.modified()
を呼び出す必要がある。
プレイヤーにとって触れられるオブジェクトであるかを表す。
この値が偽である場合、ポインティングイベントの対象にならない。
初期値は false
である。
E
の他のプロパティと異なり、この値の変更後に this.modified()
を呼び出す必要はない。
時間経過イベント。本イベントの一度のfireにつき、常に1フレーム分の時間経過が起こる。
このオブジェクトの横幅。
初期値は 0
である。実際の表示領域としてはscaleX, scaleY, angleの値も考慮する必要がある。
E
や Camera2D
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
このオブジェクトの横位置。
初期値は 0
である。実際の座標位置はscaleX, scaleY, angleの値も考慮する必要がある。
E
や Camera2D
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
このオブジェクトの縦位置。
初期値は 0
である。実際の座標位置はscaleX, scaleY, angleの値も考慮する必要がある。
E
や Camera2D
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
公開のプロパティから内部の変換行列キャッシュを更新する。
子を追加する。
子エンティティとして追加するエンティティ
このEの包含矩形を計算する。
使用カメラ。
このエンティティが破棄済みであるかを返す。
自身と自身の子孫の中で、その座標に反応する PointSource
を返す。
戻り値は、対象が見つかった場合、 target
に見つかったエンティティを持つ PointSource
である。
対象が見つからなかった場合、 undefined
である。戻り値が undefined
でない場合、その target
プロパティは次を満たす:
this
) またはその子孫であるE#touchable
が真であるcamera
から可視である中で最も手前にある対象の座標
this
に適用する変換行列。省略された場合、単位行列
touchable指定を無視する場合真を指定する。省略された場合、偽
対象のカメラ。指定されなかった場合undefined
このエンティティが属する Game
を返す。
このオブジェクトの変換行列を得る。
このEを非表示状態にする。
this.show()
が呼ばれるまでの間、このエンティティは各 Renderer
によって描画されない。
また Game#findPointSource()
で返されることもなくなる。
this#pointDown
, pointMove
, pointUp
なども通常の方法ではfireされなくなる。
子を挿入する。
target
がthis
の子でない場合、append(e)
と同じ動作となる。
子エンティティとして追加するエンティティ
挿入位置にある子エンティティ
オブジェクトを相対的に移動する。
このメソッドは x
と y
を同時に加算するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
X座標に加算する値
Y座標に加算する値
オブジェクトを移動する。
このメソッドは x
と y
を同時に設定するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
X座標
Y座標
オブジェクトを移動する。
このメソッドは x
と y
を同時に設定するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
X,Y座標
子を削除する。
e
が this
の子でない場合、 AssertionError
がthrowされる。
e === undefined
であり親がない場合、 AssertionError
がthrowされる。
削除する子エンティティ。省略された場合、自身を親から削除する
自分自身と子孫の内容を描画する。
このメソッドは、 Renderer#draw()
からエンティティのツリー構造をトラバースする過程で暗黙に呼び出される。
通常、ゲーム開発者がこのメソッドを呼び出す必要はない。
描画先に対するRenderer
対象のカメラ。省略された場合、undefined
自分自身の内容を描画する。
このメソッドは、 Renderer#draw()
からエンティティのツリー構造をトラバースする過程で暗黙に呼び出される。
通常、ゲーム開発者がこのメソッドを呼び出す必要はない。
戻り値は、このエンティティの子孫の描画をスキップすべきであれば偽、でなければ真である。 (この値は、子孫の描画方法をカスタマイズする一部のサブクラスにおいて、通常の描画パスをスキップするために用いられる)
描画先に対するRenderer
対象のカメラ
オブジェクトのサイズを相対的に変更する。
このメソッドは width
と height
を同時に加算するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
加算する幅
加算する高さ
オブジェクトのサイズを設定する。
このメソッドは width
と height
を同時に設定するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
幅
高さ
オブジェクトのサイズを設定する。
このメソッドは width
と height
を同時に設定するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
幅と高さ
オブジェクトの拡大率を設定する。
このメソッドは scaleX
と scaleY
に同じ値を同時に設定するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
拡大率
このメソッドは、 E#findPointSourceByPoint()
内で子孫の探索をスキップすべきか判断するために呼ばれる。
通常、子孫の描画方法をカスタマイズする一部のサブクラスにおいて、与えられた座標に対する子孫の探索を制御する場合に利用する。
ゲーム開発者がこのメソッドを呼び出す必要はない。
戻り値は、子孫の探索をスキップすべきであれば偽、でなければ真である。
このエンティティ(this
)の位置を基準とした相対座標
このEを表示状態にする。
this.hide()
によって非表示状態にされたエンティティを表示状態に戻す。
生成直後のエンティティは表示状態であり、 hide()
を呼び出さない限りこのメソッドを呼び出す必要はない。
このEが表示状態であるかどうかを返す。
子にtouchableなものが含まれているかどうかを表す。