타일 맵 요소
타일 맵은 동일한 깊이에 있는 타일 세트 타일의 모음입니다. 이를 그리드로 시각화할 수 있으며, 각 셀은 해당 셀에 그려야 할 타일의 인덱스와 어떻게 그려야 하는지(회전, 뒤집기 및/또는 반전)를 저장합니다. 각 타일 맵은 고유한 요소 ID와 속성을 가집니다.
타일 작업 관련 요소
타일 작업 시 다음과 같은 요소들이 서로 관련되어 있습니다:
- 타일 세트: 타일 레이어와 타일 맵을 생성하는 데 사용하는 자산입니다.
- 타일 레이어: 타일 세트를 추가하기 위해 방 편집기에서 생성하는 것입니다. 레이어는 코드가 아닌 방 편집기에서 특정 유형만 가능합니다.
- 타일 맵: 방 편집기 또는 코드에서 레이어에 추가된 타일의 모음으로, 해당 레이어의 단일 요소로 호출됩니다.
방 편집기에서는 레이어당 하나의 타일 맵만 사용할 수 있으며, 타일 레이어를 추가할 때 생성됩니다. 그러나 코드에서 작업할 때는 레이어에 여러 타일 맵을 할당할 수 있습니다.
타일 데이터 "블롭"
타일 데이터의 "블롭"은 32비트 값으로 저장됩니다. 이 값은 타일 세트의 타일 인덱스를 저장하는 19비트(비트 0~18)와 타일 데이터의 그리기 방식을 나타내는 몇 가지 추가 비트로 구성됩니다: - 비트 28: 반전 비트 - 비트 29: 뒤집기 비트 - 비트 30: 회전 비트 - 비트 31: 사용되지 않음 - 비트 19~27: 사용되지 않음
사용되지 않는 비트를 사용하여 사용자 정의 데이터를 저장할 수도 있습니다.
타일 마스크 상수
타일 데이터 블롭의 특정 비트에 더 편리하게 접근하기 위해 다음과 같은 타일 마스크 상수를 사용할 수 있습니다:
| 상수 | 설명 |
|---|---|
| tile_rotate | 타일 데이터 블롭의 회전 비트를 설정/가져오는 데 사용됩니다. |
| tile_mirror | 타일 데이터 블롭의 반전 비트를 설정/가져오는 데 사용됩니다. |
| tile_flip | 타일 데이터 블롭의 뒤집기 비트를 설정/가져오는 데 사용됩니다. |
| tile_index_mask | 타일 데이터 블롭과 "and" 연산을 수행하여 타일 인덱스의 19비트를 추출하는 데 사용되는 특별한 상수입니다. |
특정 맵 셀에서 타일 데이터를 가져오려면 tilemap_get 또는 tilemap_get_at_pixel을 사용하고, 설정하려면 tilemap_set 또는 tilemap_set_at_pixel을 사용합니다.
타일 맵 비트 마스크
타일 맵에 사용자 정의 비트 마스크를 추가하여 타일 데이터 "블롭"의 비트를 사용자 정의 용도로 사용할 수 있습니다. 그러나 이는 고급 사용자만을 위한 기능입니다. 타일 인덱스에 예약된 비트를 마스킹해야 하기 때문입니다. 타일 인덱스에 예약된 19비트가 있지만, 8비트만 사용하면 11비트를 남겨 사용자 정의 마스크를 만들 수 있습니다. 이 마스크는 코드에서 사용되고 확인되어 사용자 정의 타일 충돌 등을 생성하는 데 사용될 수 있습니다.
비트 마스크는 타일 맵이 그려질 때 타일 데이터와 "and" 연산을 수행하여 적용됩니다. 즉, 마스크에 포함되지 않은 비트는 무시되지만, 사용자가 자신의 목적으로 읽고 쓸 수 있습니다.
일반적으로는 사용자 정의 타일 데이터 블롭을 생성할 필요가 없으며, 대신 tilemap_get 함수를 사용하여 타일 데이터를 가져오고, 개별 타일 편집 기능을 사용하여 조작한 후 tilemap_set을 사용하여 다시 설정합니다.
타일 맵당 마스크 외에도 전역 마스크도 있습니다. 두 마스크는 내부적으로 GameMaker에 의해 비트 단위로 "and" 연산을 수행하여 그리기에 사용됩니다.
마스크 비트 계산
초기 인덱스 마스크 값을 얻으려면 타일 세트의 타일 수에서 1을 빼면 됩니다. 예를 들어, 16x16 타일 세트는 256개의 타일을 가지며 마스크 값은 255(또는 16진수로 $ff)입니다. 타일 세트의 타일 수가 2의 거듭제곱이 아닌 경우, 가장 가까운 2의 거듭제곱으로 반올림하여 마스크를 얻습니다. 예를 들어, 20x20 타일 세트는 400개의 타일을 가지며, 이를 512로 반올림하여 마스크 인덱스 값은 511($1ff)입니다. 인덱스 마스크 외에도 타일에 할당된 뒤집기, 회전 및 반전 값을 보존하고 싶다면, 타일 마스크 상수 아래의 상수를 사용할 수 있습니다. 이들은 인덱스 마스크 값과 비트 단위로 "or" 연산을 수행하여 해당 데이터 비트를 보존하는 데 사용됩니다.
비트 연산자에 대한 자세한 내용은 비트 연산자 문서를 참조하십시오.
함수 참조
| 함수 이름 | 설명 |
|---|---|
| layer_tilemap_get_id | 레이어의 타일 맵 ID를 가져옵니다. |
| layer_tilemap_exists | 레이어에 타일 맵이 존재하는지 확인합니다. |
| layer_tilemap_create | 레이어에 타일 맵을 생성합니다. |
| layer_tilemap_destroy | 레이어의 타일 맵을 삭제합니다. |
| tilemap_tileset | 타일 맵의 타일 세트를 가져옵니다. |
| tilemap_clear | 타일 맵을 지웁니다. |
| tilemap_x | 타일 맵의 X 좌표를 가져옵니다. |
| tilemap_y | 타일 맵의 Y 좌표를 가져옵니다. |
| tilemap_set | 타일 맵을 설정합니다. |
| tilemap_set_at_pixel | 특정 픽셀에서 타일 맵을 설정합니다. |
| tilemap_set_mask | 타일 맵의 마스크를 설정합니다. |
| tilemap_set_global_mask | 전역 마스크를 설정합니다. |
| tilemap_set_width | 타일 맵의 너비를 설정합니다. |
| tilemap_set_height | 타일 맵의 높이를 설정합니다. |
| tilemap_get_mask | 타일 맵의 마스크를 가져옵니다. |
| tilemap_get_global_mask | 전역 마스크를 가져옵니다. |
| tilemap_get_tileset | 타일 맵의 타일 세트를 가져옵니다. |
| tilemap_get_frame | 타일 맵의 프레임을 가져옵니다. |
| tilemap_get_tile_width | 타일 맵의 타일 너비를 가져옵니다. |
| tilemap_get_tile_height | 타일 맵의 타일 높이를 가져옵니다. |
| tilemap_get_width | 타일 맵의 너비를 가져옵니다. |
| tilemap_get_height | 타일 맵의 높이를 가져옵니다. |
| tilemap_get_x | 타일 맵의 X 좌표를 가져옵니다. |
| tilemap_get_y | 타일 맵의 Y 좌표를 가져옵니다. |
| tilemap_get | 타일 맵에서 타일 데이터를 가져옵니다. |
| tilemap_get_at_pix | 특정 픽셀에서 타일 데이터를 가져옵니다. |
| tilemap_get_cell_x_at_pixel | 특정 픽셀에서 셀의 X 좌표를 가져옵니다. |
| tilemap_get_cell_y_at_pixel | 특정 픽셀에서 셀의 Y 좌표를 가져옵니다. |
개별 타일 편집 함수
| 함수 이름 | 설명 |
|---|---|
| tile_get_empty | 빈 타일을 가져옵니다. |
| tile_get_index | 타일의 인덱스를 가져옵니다. |
| tile_get_flip | 타일의 뒤집기 상태를 가져옵니다. |
| tile_get_mirror | 타일의 반전 상태를 가져옵니다. |
| tile_get_rotate | 타일의 회전 상태를 가져옵니다. |
| tile_set_empty | 타일을 빈 상태로 설정합니다. |
| tile_set_index | 타일의 인덱스를 설정합니다. |
| tile_set_flip | 타일의 뒤집기 상태를 설정합니다. |
| tile_set_mirror | 타일의 반전 상태를 설정합니다. |
| tile_set_rotate | 타일의 회전 상태를 설정합니다. |
| draw_tile | 타일을 그립니다. |
활용 예제
// 타일 맵 생성
var myTileMap = layer_tilemap_create(layer, tilemap_tileset);
// 타일 설정
tilemap_set(myTileMap, tile_index);
// 특정 픽셀에서 타일 데이터 가져오기
var tileData = tilemap_get_at_pixel(myTileMap, x, y);
// 타일 데이터 수정
||
||
tilemap_set_at_pixel(myTileMap, x, y, tileData);
// 타일 맵의 너비와 높이 설정
tilemap_set_width(myTileMap, 10);
tilemap_set_height(myTileMap, 10);
// 타일 맵에서 특정 셀의 타일 인덱스 가져오기
var tileIndex = tilemap_get(myTileMap, cellX, cellY);
// 타일 맵의 마스크 설정
tilemap_set_mask(myTileMap, customMask);
// 타일 맵 그리기
draw_tilemap(myTileMap);
// 타일 맵의 모든 타일 비우기
tilemap_clear(myTileMap);
// 특정 위치에 타일 추가
tilemap_set_at_pixel(myTileMap, x, y, tileIndex);
// 타일의 반전 상태 설정
tile_set_mirror(tileIndex, true);
// 타일의 회전 상태 설정
tile_set_rotate(tileIndex, 90);