|
MID 프로필 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Object | +--javax.microedition.lcdui.game.LayerManager
LayerManager는 일련의 Layer를 관리합니다. LayerManager는 각 Layer의 올바른 영역을 적절한 순서로 자동 렌더링함으로써 추가된 Layer를 렌더링하는 과정을 단순화합니다.
LayerManager는 Layer를 추가, 삽입 및 제거할 수 있는 정렬된 목록을 유지 관리합니다. Layer의 색인은 해당 z-order와 상관 관계가 있습니다. 가장 높은 색인을 갖는 Layer는 사용자로부터 가장 멀리 있는 반면 색인 0의 계층은 사용자와 가장 가깝습니다. 색인은 항상 연속적이어야 합니다. 즉, Layer가 제거되면 연속성을 유지하기 위해 후속 Layer의 색인이 조정됩니다.
LayerManager 클래스는 화면에서 게임의 Layer를 렌더링하는 방법을 제어하는 몇 가지 기능을 제공합니다.
보기 창은 표시 가능 영역의 크기 및 LayerManager 좌표계에 대한 위치를 제어합니다. 보기 창의 위치를 변경하면 사용자 보기를 스크롤하거나 화면 이동하는 효과가 발생합니다. 예를 들어, 오른쪽으로 스크롤하려면 보기 창의 위치를 오른쪽으로 이동하면 됩니다. 보기 창의 크기는 사용자 보기의 크기를 제어하며 대개는 장치 화면에 적절한 크기로 고정됩니다.
이 예에서 보기 창은 85 x 85 픽셀로 설정되며
LayerManager 좌표계의 (52, 11)에 위치합니다.
각 Layer는 LayerManager 원점에 상대적인 위치에 표시됩니다.
paint(Graphics, int, int) 메소드는 화면에 대하여
보기 창을 렌더링할 위치를 제어하는 (x,y) 위치를 포함합니다.
이러한 매개 변수를 변경하더라도 보기 창의 내용은 변경되지 않고
보기 창이 그려질 위치만 변경됩니다.
이 위치는 Graphics 객체의 원점에 상대적이므로 Graphics
객체의 변환 속성에 종속됩니다.
예를 들어, 게임에서 화면 위쪽에 현재 점수를 표시하는 경우
보기 창은 점수를 표시할 충분할 공간을 제공하기 위해 (17, 17)에서
렌더링될 수 있습니다.
| Constructor Summary | |
LayerManager()
새 LayerManager를 만듭니다. |
|
| Method Summary | |
void |
append(Layer l)
Layer를 LayerManager에 추가합니다. |
Layer |
getLayerAt(int index)
지정된 색인의 Layer를 가져옵니다. |
int |
getSize()
이 LayerManager에 있는 Layer의 수를 가져옵니다. |
void |
insert(Layer l,
int index)
이 LayerManager의 지정된 색인에 새 Layer를 삽입합니다. |
void |
paint(Graphics g,
int x,
int y)
LayerManager의 현재 보기 창을 지정된 위치에서 렌더링합니다. |
void |
remove(Layer l)
이 LayerManager에서 지정된 Layer를 제거합니다. |
void |
setViewWindow(int x,
int y,
int width,
int height)
LayerManager에서 보기 창을 설정합니다. |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public LayerManager()
| Method Detail |
public void append(Layer l)
l - 추가되는 Layer
NullPointerException - Layer가
null인 경우insert(Layer, int),
remove(Layer)
public void insert(Layer l,
int index)
l - 삽입되는 Layerindex - 새 Layer가
삽입되는 색인
NullPointerException - Layer가
null인 경우
IndexOutOfBoundsException - 색인이
0보다 작거나
이 LayerManager에 이미 추가된
Layer 수보다 큰 경우append(Layer),
remove(Layer)public Layer getLayerAt(int index)
index - 원하는 Layer의 색인
IndexOutOfBoundsException - 지정된
index가 0보다 작은 경우 또는
이 LayerManager에 추가된
Layer의 수보다 큰 경우public int getSize()
public void remove(Layer l)
l - 제거되는 Layer
NullPointerException - 지정된
Layer가 null인 경우append(Layer),
insert(Layer, int)
public void paint(Graphics g,
int x,
int y)
LayerManager는 올바른 z-order를 구현하여 내림차순 색인으로 각 계층을 렌더링합니다. 보기 창을 완전히 벗어나는 Layer는 렌더링되지 않습니다.
이 메소드에 전달된 좌표는 Graphics 객체의 원점에 대하여 LayerManager의 보기 창을 렌더링할 위치를 결정합니다. 예를 들어, 게임에서 현재 점수를 화면 위쪽에 표시하는 경우 해당 영역 아래에 게임 계층을 렌더링하기 위해 보기 창은 (0, 20)에서 렌더링될 수 있습니다. 이 위치는 Graphics 객체의 원점에 상대적이며 Graphics 객체를 변환하면 화면에서 보기 창을 렌더링할 위치가 변경됩니다.
Graphics 객체의 클립 영역은 보기 창과 같은 치수를 갖는 영역과 교차하며 (x,y)에 위치합니다. 그런 다음 LayerManager는 점 (x,y)가 LayerManager 좌표계에 있는 viewWindow 위치와 일치하도록 그래픽 객체를 변환합니다. 그런 다음 Layer는 적절한 순서로 렌더링됩니다. Graphics 객체의 변환 및 클립 영역은 이 메소드가 반환되기 이전의 값으로 복원됩니다.
렌더링은 Graphics 객체의 클립 영역과 변환에 종속됩니다. 따라서 클립 영역이 충분히 크지 않으면 지정된 보기 창의 일부만 렌더링될 수 있습니다.
성능상의 이유로 이 메소드는 표시되지 않거나 Graphics 객체의 클립 영역을 완전히 벗어나서 렌더링되는 Layer는 무시할 수 있습니다. Graphics 객체의 속성은 Layer의 그리기 메소드에 대한 호출 사이에 알려진 상태로 복원되지 않습니다. 클립 영역은 Layer의 범위를 벗어날 수 있습니다. Layer는 해당 범위 내에서 렌더링 작업이 수행되도록 해야 합니다.
g - LayerManager를 그릴 때 사용할 그래픽 인스턴스x - Graphics의 변환 원점에 상대적인 보기 창을
렌더링할 수평 위치y - Graphics의 변환 원점에 상대적인 보기 창을
렌더링할 수직 위치
NullPointerException - g가 null인 경우setViewWindow(int, int, int, int)
public void setViewWindow(int x,
int y,
int width,
int height)
paint(javax.microedition.lcdui.Graphics, int, int) 메소드가 호출될 때 보기 창은
LayerManager가 그리는 영역을 지정합니다.
따라서 개발자는 LayerManager 좌표계에 상대적인 보기 창의 위치와
표시 가능 영역의 크기를 제어할 수 있습니다.
보기 창은 이 메소드에 대한 다른 호출에 의해 수정될 때까지 계속 표시됩니다. 기본적으로 보기 창은 LayerManager 좌표계의 (0,0)에 있으며 너비와 높이는 모두 Integer.MAX_VALUE로 설정됩니다.
x - LayerManager의 원점에
상대적인 보기 창의 수평 위치y - LayerManager의 원점에
상대적인 보기 창의 수직 위치width - 보기 창의 너비height - 보기 창의 높이
IllegalArgumentException - width나
height가 0보다 작은 경우
|
MID 프로필 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||