javax.microedition.lcdui.game
Class TiledLayer

java.lang.Object
  |
  +--javax.microedition.lcdui.game.Layer
        |
        +--javax.microedition.lcdui.game.TiledLayer

public class TiledLayer

extends Layer

TiledLayer는 타일 이미지 집합으로 채울 수 있는 셀의 격자로 구성된 시각적 요소입니다. 이 클래스를 사용하면 아주 큰 이미지가 없어도 큰 가상 계층을 만들 수 있습니다. 이 기술은 주로 2D 게임 플랫폼에서 아주 큰 스크롤 배경을 만드는데 사용됩니다.

타일

TiledLayer 셀을 채우기 위해 사용된 타일은 변경 가능하거나 불가능한 단일 Image 객체로 제공됩니다. Image는 같은 크기를 갖는 일련의 타일로 쪼개집니다. 타일 크기는 Image에 따라 지정됩니다. 아래의 그림에 표시된 대로 게임 개발자의 편의상 같은 타일 집합을 여러 가지 다양한 배열로 저장할 수 있습니다.

각 타일에는 고유 색인 번호가 할당됩니다. Image의 왼쪽 위 모서리에 있는 타일에는 색인 1이 할당됩니다. 그런 다음 나머지 타일의 번호는 행 순서 위주로(첫 번째 행에 색인을 할당한 다음 두 번째 행에 할당하는 식으로) 연속하여 매겨집니다. 타일 및 타일과 연관된 이미지 데이터 사이에는 고정된 연결이 있으므로 이러한 타일은 정적 타일로 간주됩니다.

TiledLayer를 인스턴스화할 때 정적 타일 집합이 만들어지며 이는 setStaticTileSet(javax.microedition.lcdui.Image, int, int) 메소드를 사용하여 언제든지 업데이트할 수 있습니다.

정적 타일 집합 외에도 개발자는 여러 애니메이션 타일을 정의할 수 있습니다. 애니메이션 타일은 정적 타일과 동적으로 연결되는 가상 타일입니다. 애니메이션 타일의 모양은 현재 연결된 정적 타일의 모양이 됩니다.

애니메이션 타일을 사용하면 개발자는 셀 그룹의 모양을 매우 쉽게 변경할 수 있습니다. 애니메이션 타일로 모두 채워진 셀 그룹을 사용하는 경우 애니메이션 타일과 연결된 정적 타일만 변경하면 전체 그룹의 모양을 변경할 수 있습니다. 이 기술은 여러 셀의 내용을 명시적으로 변경하지 않고도 반복되는 큰 영역에 애니메이션 효과를 줄 때 매우 유용합니다.

애니메이션 타일은 새 애니메이션 타일에 사용될 색인을 반환하는 createAnimatedTile(int) 메소드를 사용하여 만들어집니다. 애니메이션 타일 색인은 -1에서 시작하며 항상 음수이고 연속적입니다. 애니메이션 타일이 일단 만들어지면 애니메이션 타일과 연결된 정적 타일은 setAnimatedTile(int, int) 메소드를 사용하여 변경할 수 있습니다.

셀

TiledLayer 격자는 같은 크기의 셀로 구성됩니다. 격자에 있는 열과 행의 수는 구성자에서 지정되며 셀의 물리적 크기는 타일의 크기에 의해 정의됩니다.

각 셀의 내용은 타일 색인을 사용하여 지정됩니다. 양수 타일 색인은 정적 타일을 참조하며 음수 타일 색인은 애니메이션 타일을 참조합니다. 타일 색인 0은 셀이 비어 있음을 나타냅니다. 빈 셀은 완전히 투명하며 해당 영역에는 TiledLayer로 그려진 내용이 없습니다. 기본적으로 모든 셀은 타일 색인 0을 포함합니다.

setCell(int, int, int)과 fillCells(int, int, int, int, int)를 사용하면 셀의 내용을 변경할 수 있습니다. 여러 셀에 같은 타일이 포함될 수 있지만 단일 셀에 두 개 이상의 타일이 포함될 수는 없습니다. 다음 예에서는 TiledLayer를 사용하여 단순한 배경을 만들 수 있는 방법을 설명합니다.

이 예에서 물의 영역은 색인 -1인 애니메이션 타일로 채워지는데 처음에 이 타일은 정적 타일 5와 연결됩니다. setAnimatedTile(-1, 7)을 사용하여 연결된 정적 타일만 변경하면 전체 물의 영역에 애니메이션 효과를 줄 수 있습니다.

TiledLayer 렌더링

TiledLayer는 해당 paint 메소드를 수동으로 호출하여 렌더링할 수 있으며 LayerManager 객체를 사용하여 자동으로 렌더링할 수도 있습니다.

paint 메소드는 Graphics 객체의 클립 영역에 따라 전체 TiledLayer를 렌더링하려고 시도합니다. TiledLayer의 왼쪽 위 모서리는 Graphics 객체의 원점에 대해 현재 (x,y) 위치에서 렌더링됩니다. 이에 따라 Graphics 객체의 클립 영역을 설정하여 렌더링된 영역을 제어할 수 있습니다.

Since:

MIDP 2.0

Constructor Summary

TiledLayer(int columns, int rows, Image image, int tileWidth, int tileHeight)
새 TiledLayer를 만듭니다.

Method Summary

int	createAnimatedTile(int staticTileIndex) 새 애니메이션 타일을 만들고 새 애니메이션 타일을 참조하는 색인을 반환합니다.
void	fillCells(int col, int row, int numCols, int numRows, int tileIndex) 특정 타일을 사용하여 영역 셀을 채웁니다.
int	getAnimatedTile(int animatedTileIndex) 애니메이션 타일이 참조하는 타일을 가져옵니다.
int	getCell(int col, int row) 셀의 내용을 가져옵니다.
int	getCellHeight() 단일 셀의 높이(픽셀 단위)를 가져옵니다.
int	getCellWidth() 단일 셀의 너비(픽셀 단위)를 가져옵니다.
int	getColumns() TiledLayer 격자 열의 수를 가져옵니다.
int	getRows() TiledLayer 격자의 행 수를 가져옵니다.
void	paint(Graphics g) TiledLayer를 그립니다.
void	setAnimatedTile(int animatedTileIndex, int staticTileIndex) 애니메이션 타일을 지정한 정적 타일과 연결합니다.
void	setCell(int col, int row, int tileIndex) 셀의 내용을 설정합니다.
void	setStaticTileSet(Image image, int tileWidth, int tileHeight) 정적 타일 집합을 변경합니다.

Methods inherited from class javax.microedition.lcdui.game.Layer

getHeight, getWidth, getX, getY, isVisible, move, setPosition, setVisible

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TiledLayer

public TiledLayer(int columns,
                  int rows,
                  Image image,
                  int tileWidth,
                  int tileHeight)

새 TiledLayer를 만듭니다.

TiledLayer의 격자는 rows 셀의 높이와 columns 셀의 너비를 가집니다. 격자의 모든 셀은 처음에는 비어 있습니다(즉, 타일 색인 0 포함). setCell(int, int, int)과 fillCells(int, int, int, int, int)를 사용하여 격자의 내용을 수정할 수 있습니다.

TiledLayer의 정적 타일 집합은 지정한 Image로부터 만들어지며 각 타일의 치수는 tileWidth x tileHeight가 됩니다. 소스 이미지의 너비는 타일 너비 정수의 배수가 되어야 하며 소스 이미지의 높이는 타일 높이 정수의 배수가 되어야 합니다. 그렇지 않은 경우 IllegalArgumentException이 발생합니다.

setStaticTileSet(Image, int, int)를 사용하여 전체 정적 타일 집합을 변경할 수 있습니다. 이러한 메소드는 메모리와 시간을 많이 소모하므로 자주 사용하지 않습니다. 가능하면 타일 모양에 애니메이션 효과를 주기 보다 애니메이션 타일을 사용해야 합니다.

Parameters:

columns - TiledLayer의 너비(셀 개수로 표현)

rows - TiledLayer의 높이(셀 개수로 표현)

image - 정적 타일 집합 만들기에 사용할 Image

tileWidth - 단일 타일의 너비(픽셀 단위)

tileHeight - 단일 타일의 높이(픽셀 단위)

Throws:

NullPointerException - image가 null인 경우

IllegalArgumentException - rows나 columns의 개수가 1보다 적은 경우

IllegalArgumentException - tileHeight나 tileWidth가 1보다 적은 경우

IllegalArgumentException - image 너비가 tileWidth 정수의 배수가 아닌 경우

IllegalArgumentException - image 높이가 tileHeight 정수의 배수가 아닌 경우

Method Detail

createAnimatedTile

public int createAnimatedTile(int staticTileIndex)

새 애니메이션 타일을 만들고 새 애니메이션 타일을 참조하는 색인을 반환합니다. 처음에는 지정한 타일 색인(정적 타일 또는 0)과 연결됩니다.

애니메이션 타일의 색인은 항상 음수입니다. 첫 번째 애니메이션 타일에는 색인 -1, 두 번째는 -2와 같은 식으로 지정됩니다.

Parameters:

staticTileIndex - 연결된 타일의 색인(0 또는 유효한 정적 타일 색인)

Returns:

새로 만든 애니메이션 타일의 색인

Throws:

IndexOutOfBoundsException - staticTileIndex가 유효하지 않은 경우

setAnimatedTile

public void setAnimatedTile(int animatedTileIndex,
                            int staticTileIndex)

애니메이션 타일을 지정한 정적 타일과 연결합니다.

Parameters:

animatedTileIndex - 애니메이션 타일의 색인

staticTileIndex - 연결된 타일의 색인(0이거나 유효한 정적 타일 색인)

Throws:

IndexOutOfBoundsException - staticTileIndex가 유효하지 않은 경우

IndexOutOfBoundsException - 애니메이션 타일 색인이 유효하지 않은 경우

See Also:

getAnimatedTile(int)

getAnimatedTile

public int getAnimatedTile(int animatedTileIndex)

애니메이션 타일이 참조하는 타일을 가져옵니다.

애니메이션 타일과 현재 연결된 타일 색인을 반환합니다.

Parameters:

animatedTileIndex - 애니메이션 타일의 색인

Returns:

애니메이션 타일에서 참조하는 타일의 색인

Throws:

IndexOutOfBoundsException - 애니메이션 타일 색인이 유효하지 않은 경우

See Also:

setAnimatedTile(int, int)

setCell

public void setCell(int col,
                    int row,
                    int tileIndex)

셀의 내용을 설정합니다.

내용은 정적 타일 색인, 애니메이션 타일 색인으로 설정되거나 비어 있을 수 있습니다(색인 0).

Parameters:

col - 설정할 셀의 열

row - 설정할 셀의 행

tileIndex - 셀에 놓을 타일의 색인

Throws:

IndexOutOfBoundsException - tileIndex 색인이 있는 타일이 없는 경우

IndexOutOfBoundsException - row나 col이 TiledLayer 격자의 범위를 벗어나는 경우

See Also:

getCell(int, int), fillCells(int, int, int, int, int)

getCell

public int getCell(int col,
                   int row)

셀의 내용을 가져옵니다.

셀에 현재 표시된 정적 타일이나 애니메이션 타일의 색인을 가져옵니다. 셀이 비어 있으면 반환되는 색인은 0이 됩니다.

Parameters:

col - 검사할 셀의 열

row - 검사할 셀의 행

Returns:

셀에 있는 타일의 색인

Throws:

IndexOutOfBoundsException - row나 col이 TiledLayer 격자의 범위를 벗어나는 경우

See Also:

setCell(int, int, int), fillCells(int, int, int, int, int)

fillCells

public void fillCells(int col,
                      int row,
                      int numCols,
                      int numRows,
                      int tileIndex)

특정 타일을 사용하여 영역 셀을 채웁니다. 셀은 정적 타일 색인, 애니메이션 타일 색인으로 채워지거나 비어 있을 수 있습니다(색인 0).

Parameters:

col - 영역에 있는 왼쪽 위 셀의 열

row - 영역에 있는 왼쪽 위 셀의 행

numCols - 영역에 있는 열의 수

numRows - 영역에 있는 행의 수

tileIndex - 지정한 영역의 모든 셀에 놓을 타일의 색인

Throws:

IndexOutOfBoundsException - 매개 변수가 정의하는 직사각형 영역이 TiledLayer 격자의 범위를 벗어나는 경우

IllegalArgumentException - numCols가 0보다 적은 경우

IllegalArgumentException - numRows가 0보다 적은 경우

IndexOutOfBoundsException - tileIndex 색인이 있는 타일이 없는 경우

See Also:

setCell(int, int, int), getCell(int, int)

getCellWidth

public final int getCellWidth()

단일 셀의 너비(픽셀 단위)를 가져옵니다.

Returns:

TiledLayer 격자에 있는 단일 셀의 너비(픽셀 단위)

getCellHeight

public final int getCellHeight()

단일 셀의 높이(픽셀 단위)를 가져옵니다.

Returns:

TiledLayer 격자에 있는 단일 셀의 높이(픽셀 단위)

getColumns

public final int getColumns()

TiledLayer 격자 열의 수를 가져옵니다. Layer.getWidth()를 호출하면 TiledLayer의 전체 너비(픽셀 단위)를 얻을 수 있습니다.

Returns:

TiledLayer 격자의 열 너비

getRows

public final int getRows()

TiledLayer 격자의 행 수를 가져옵니다. Layer.getHeight()를 호출하면 TiledLayer의 전체 높이(픽셀 단위)를 얻을 수 있습니다.

Returns:

TiledLayer 격자의 행 높이

setStaticTileSet

public void setStaticTileSet(Image image,
                             int tileWidth,
                             int tileHeight)

정적 타일 집합을 변경합니다.

현재 정적 타일 집합을 정적 타일 집합으로 바꿉니다. 이미지에서 타일을 만드는 방법에 대한 자세한 내용은 구성자 TiledLayer(int, int, Image, int, int)를 참조하십시오.

새 정적 타일 집합이 이전 정적 타일 집합 이상의 타일을 가지면 애니메이션 타일과 셀 내용은 보존됩니다. 그렇지 않은 경우 격자의 내용은 지워지며(모든 셀이 색인 0을 포함) 애니메이션 타일은 모두 삭제됩니다.

Parameters:

image - 정적 타일 집합을 만드는 데 사용할 Image

tileWidth - 단일 타일의 너비(픽셀 단위)

tileHeight - 단일 타일의 높이(픽셀 단위)

Throws:

NullPointerException - image가 null인 경우

IllegalArgumentException - tileHeight나 tileWidth가 1보다 적은 경우

IllegalArgumentException - image 너비가 tileWidth 정수의 배수가 아닌 경우

IllegalArgumentException - image 높이가 tileHeight 정수의 배수가 아닌 경우

paint

public final void paint(Graphics g)

TiledLayer를 그립니다. 전체 TiledLayer는 Graphics 객체의 클립 영역에 따라 렌더링됩니다. TiledLayer의 왼쪽 위 모서리는 Graphics 객체의 원점에 상대적인 TiledLayer의 현재 위치에서 렌더링됩니다. Layer.getX()와 Layer.getY()를 호출하면 TiledLayer 왼쪽 위 모서리의 현재 위치를 검색할 수 있습니다. 클립 영역 및/또는 변환을 적절하게 사용하면 TiledLayer의 임의의 영역을 렌더링할 수 있습니다.

TiledLayer의 Image가 변경 가능한 경우 TiledLayer는 Image의 현재 내용을 사용하여 렌더링됩니다.

Specified by:

paint in class Layer

Parameters:

g - TiledLayer를 그릴 graphics 객체

Throws:

NullPointerException - g가 null인 경우