layer_tilemap_get_id 함수 설명

layer_tilemap_get_id 함수는 특정 레이어의 타일 맵 요소의 고유 ID 값을 가져오는 데 사용됩니다. 이 함수는 레이어 핸들(레이어를 생성할 때 layer_create() 함수를 사용하여 얻음) 또는 레이어 이름(문자열 형식)을 인수로 받아, 해당 레이어의 타일 맵 요소와 연결된 ID 값을 반환합니다. 이 함수는 IDE에서 추가된 타일 맵과 함께 사용하도록 설계되었습니다. 만약 코드에서 layer_tilemap_create() 함수를 사용하여 타일 맵을 레이어에 추가하면, 추가된 타일 맵 요소의 고유 ID를 반환합니다. 주어진 타일 맵 ID가 잘못되었거나 타일 맵이 존재하지 않는 경우, 함수는 -1을 반환합니다.

문법

layer_tilemap_get_id(layer_id)

인수

반환값

• 타일 맵 요소 ID 또는 -1

예제

var lay_id = layer_get_id("tilemap_trees");
var tile_id = layer_tilemap_get_id(lay_id);
layer_tilemap_destroy(tile_id);

위의 코드는 "tilemap_trees"라는 이름의 레이어에 대한 레이어 핸들을 가져온 후, 이를 사용하여 해당 레이어의 타일 맵 요소 ID를 가져옵니다. 이 ID는 이후 레이어에서 타일 맵을 제거하는 데 사용됩니다.

활용 예제

1. 타일 맵 요소의 존재 확인

var lay_id = layer_get_id("tilemap_ground");
var tile_id = layer_tilemap_get_id(lay_id);
if (tile_id != -1) {
    // 타일 맵이 존재할 경우의 처리
}

1. 타일 맵 업데이트

var lay_id = layer_get_id("tilemap_background");
var tile_id = layer_tilemap_get_id(lay_id);
if (tile_id != -1) {
    // 타일 맵을 업데이트하는 코드
}

1. 타일 맵 제거 후 새 타일 맵 추가

var lay_id = layer_get_id("tilemap_obstacles");
var tile_id = layer_tilemap_get_id(lay_id);
if (tile_id != -1) {
    layer_tilemap_destroy(tile_id);
}
// 새로운 타일 맵 추가
var new_tile_id = layer_tilemap_create(lay_id, ...);

1. 여러 레이어에서 타일 맵 ID 가져오기

var layers = ["tilemap_layer1", "tilemap_layer2", "tilemap_layer3"];
for (var i = 0; i < array_length(layers); i++) {
    var lay_id = layer_get_id(layers[i]);
    var tile_id = layer_tilemap_get_id(lay_id);
    // 각 레이어의 타일 맵 ID 처리
}

이와 같은 방법으로 layer_tilemap_get_id 함수를 활용하여 다양한 타일 맵 요소를 관리하고 조작할 수 있습니다.