このエンティティの内部キャッシュ。
子にtouchableなものが含まれているかどうかを表す。
変換行列のキャッシュ。 Object2D
は状態に変更があった時、本値の_modifiedをtrueにする必要がある。
初期値は undefined
であり、 getMatrix()
によって必要な時に生成されるため、
if (this._matrix) this._matrix._modified = true
という式で記述する必要がある。
エンジンに組み込まれているSprite等のエンティティ群は、
すでに本処理を組み込んでいるため通常ゲーム開発者はこの値を意識する必要はない。
Object2D
を継承したクラスを新たに作る場合には、本フィールドを適切に操作しなければならない。
このエンティティを最後に描画した時のCamrera
。
エンジンが子孫を描画すべきであればtrue
、でなければfalse
を本クラスを継承したクラスがセットする。
デフォルト値はtrue
となる。
このEが「映り込む」カメラの集合。 空でない配列が指定されている場合、配列内に存在しないCameraでの描画時にはこのEがスキップされる。 初期値はundefinedである。targetCamerasがこの値を暗黙に生成するので、ゲーム開発者はそちらを使うべきである。
オブジェクトの回転。度数で指定する。
初期値は 0
である。
E
や Camera2D
においてこの値を変更した場合、 modified()
を呼び出す必要がある。
背景画像の拡大・縮小に用いられる SurfaceEffector
。
(ex. 背景に「枠」の部分を持つ画像を使い、枠部分の拡大率を固定したいような場合は、 NinePatchSurfaceEffector
を指定すればよい)
この値を変更した場合、 this.invalidate()
を呼び出す必要がある。
背景画像の Surface
。
この値を変更した場合、 this.invalidate()
を呼び出す必要がある。
このエンティティの全子エンティティ。
子エンティティが存在しない場合、本フィールドの値は 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()
を呼び出す必要がある。
このPaneの包含矩形を計算する。 Eを継承する他のクラスと異なり、Paneは子要素の位置を包括矩形に含まない。
公開のプロパティから内部の変換行列キャッシュを更新する。
子を追加する。
子エンティティとして追加するエンティティ
この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)
と同じ動作となる。
子エンティティとして追加するエンティティ
挿入位置にある子エンティティ
このエンティティの描画キャッシュ無効化をエンジンに通知する。
このメソッドを呼び出し後、描画キャッシュの再構築が行われ、各 Renderer
に描画内容の変更が反映される。
このエンティティに対する変更をエンジンに通知する。
このメソッドの呼び出し後、 this
に対する変更が各 Renderer
の描画に反映される。
このメソッドは描画キャッシュの無効化を保証しない。描画キャッシュの無効化も必要な場合、 invalidate()
を呼び出さなければならない。
詳細は E#modified()
のドキュメントを参照。
オブジェクトを相対的に移動する。
このメソッドは 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
このエンティティ自身の描画を行う。 このメソッドはエンジンから暗黙に呼び出され、ゲーム開発者が呼び出す必要はない。
オブジェクトのサイズを相対的に変更する。
このメソッドは width
と height
を同時に加算するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
加算する幅
加算する高さ
オブジェクトのサイズを設定する。
このメソッドは width
と height
を同時に設定するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
幅
高さ
オブジェクトのサイズを設定する。
このメソッドは width
と height
を同時に設定するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
幅と高さ
オブジェクトの拡大率を設定する。
このメソッドは scaleX
と scaleY
に同じ値を同時に設定するためのユーティリティメソッドである。
E
や Camera2D
においてこのメソッドを呼び出した場合、 modified()
を呼び出す必要がある。
拡大率
このEを表示状態にする。
this.hide()
によって非表示状態にされたエンティティを表示状態に戻す。
生成直後のエンティティは表示状態であり、 hide()
を呼び出さない限りこのメソッドを呼び出す必要はない。
このEが表示状態であるかどうかを返す。
The ninepatch image scrollbar entity. Takes two images as ninepatch images for the background and the bar itself.
9パッチ画像の横スクロールバー。 二つの画像(背景用・バー用)をとり、9パッチで拡大して利用する。