javax.microedition.lcdui.game
クラス Layer

java.lang.Object
  javax.microedition.lcdui.game.Layer

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

Sprite, TiledLayer

public abstract class Layer
extends Object

Layer はゲームの視覚要素を表現する抽象クラスです。 各 Layer は、位置（視覚境界の左上角に属する）、幅、高さおよび可視または不可視の属性を持っています。 Layer のサブクラスは、それらをレンダリングできるように paint(Graphics) メソッドを実装しなければなりません。

Layer の位置 (x, y) は常に Layer の paint() メソッドに渡される Graphics オブジェクトの座標系に相対して解釈します。 この座標系を描画座標系と呼びます。 Layer の初期位置は (0, 0) です。

導入されたバージョン:

MIDP 2.0

setPosition

public void setPosition(int x,
                        int y)

この Layer の左上角の位置を描画座標系における (x, y) に設定します。 Layer の位置はデフォルトで (0, 0) です。

パラメータ:

x - 水平の位置を渡します。

y - 垂直の位置を渡します。

関連項目:

move(int, int), getX(), getY()

move

public void move(int dx,
                 int dy)

指定された水平方向と垂直方向の距離に従って、この Layer を移動させます。

渡されたパラメータによって Integer.MAX_VALUE または Integer.MIN_VALUE を超えてしまうのであれば、Layer の座標系はオーバーフローあるいはアンダーフローの影響を受けることがあります。

パラメータ:

dx - 水平軸に沿って移動させる距離を渡します（正数なら右方向へ、負数なら左方向へ）。

dy - 垂直軸に沿って移動させる距離を渡します（正数なら下方向へ、負数なら上方向へ）。

関連項目:

setPosition(int, int), getX(), getY()

getX

public final int getX()

描画座標系によるこの Layer の左上角の水平位置を取得します。

戻り値:

Layer の水平位置を返します。

関連項目:

getY(), setPosition(int, int), move(int, int)

getY

public final int getY()

描画座標系によるこの Layer の左上角の垂直位置を取得します。

戻り値:

Layer の垂直位置を返します。

関連項目:

getX(), setPosition(int, int), move(int, int)

getWidth

public final int getWidth()

この Layer の現在の幅をピクセル単位で取得します。

戻り値:

幅をピクセル数で返します。

関連項目:

getHeight()

getHeight

public final int getHeight()

この Layer の現在の高さをピクセル単位で取得します。

戻り値:

高さをピクセル数で返します。

関連項目:

getWidth()

setVisible

public void setVisible(boolean visible)

この Layer の可視属性を設定します。 paint(Graphics) メソッドが呼ばれたときに可視状態の Layer はレンダリングされます； 不可視状態の Layer はレンダリングされません。

パラメータ:

visible - Layer を可視状態にするなら true を、不可視状態にするなら false を渡します。

関連項目:

isVisible()

isVisible

public final boolean isVisible()

この Layer の可視属性を取得します。

戻り値:

Layer が可視状態なら true を、不可視状態なら false を返します。

paint

public abstract void paint(Graphics g)

この Layer が可視状態にあるなら描画を行います。 Graphics オブジェクトに提供された原点から相対する現在の (x, y) 座標を左上角として Layer をレンダリングします。 アプリケーションは、Layer がどこでレンダリングされるかを制御し、レンダリングされる領域を制限するために Graphics のクリッピングと原点移動を用いることができます。

この Layer が可視状態か否かをチェックするのはこのメソッドの実装の責任です； Layer が可視状態にないのなら、このメソッドは何もしません。

このメソッドを呼び出した結果、Graphics オブジェクトの属性（クリップ領域、原点移動、描画色など）は変更しません。

パラメータ:

g - Layer をレンダリングするための Graphics オブジェクトを渡します。

例外:

NullPointerException - g パラメータが null の場合に throw します。