layer_get_name 함수 설명
layer_get_name 함수는 주어진 레이어의 이름을 가져오는 기능을 제공합니다. 이 함수는 고유한 레이어 핸들 값을 입력받으며, 만약 해당 레이어가 Room Editor에서 생성된 이름이 있는 레이어라면, 레이어 이름을 포함한 문자열을 반환합니다. 반면, Room Editor에서 생성되지 않은 레이어(즉, layer_create를 사용하여 생성된 경우)라면 빈 문자열 ""을 반환합니다.
문법
layer_get_name(layer_id)
인수 설명
| 인수 이름 | 타입 | 설명 |
|---|---|---|
| layer_id | Layer | 이름을 가져올 레이어의 핸들 |
반환 값
- String: 레이어의 이름
예제 코드
다음 코드는 방 안의 모든 레이어 ID를 가져오고, 이름이 있는 레이어인지 확인한 후, 이름이 있는 레이어의 ID를 리스트에 추가하는 예제입니다.
var _arr_layers = layer_get_all();
var _arr_layers_named = [];
for (var i = 0; i < array_length(_arr_layers); i++) {
if (layer_get_name(_arr_layers[i]) != "") {
array_push(_arr_layers_named, _arr_layers[i]);
}
}
활용 예제
- 레이어 이름 목록 생성
- 방 안의 모든 레이어 이름을 배열에 저장하는 코드:
gml var _layer_names = []; var _layers = layer_get_all(); for (var i = 0; i < array_length(_layers); i++) { var name = layer_get_name(_layers[i]); if (name != "") { array_push(_layer_names, name); } } - 특정 레이어 이름 확인
- 특정 레이어의 이름을 확인하고 조건에 따라 작업 수행:
gml var my_layer_id = layer_create(); if (layer_get_name(my_layer_id) == "Background") { // 배경 레이어에 대한 작업 수행 } - 레이어 이름 변경
- 레이어의 이름을 변경하는 방법:
gml var my_layer_id = layer_create(); layer_set_name(my_layer_id, "New Layer Name"); - 이름이 없는 레이어 필터링
- 이름이 없는 레이어를 필터링하여 처리하는 코드:
gml var _layers = layer_get_all(); for (var i = 0; i < array_length(_layers); i++) { if (layer_get_name(_layers[i]) == "") { // 이름이 없는 레이어에 대한 처리 } }
이와 같은 방법으로 layer_get_name 함수를 활용하여 레이어의 이름을 관리하고, 다양한 작업을 수행할 수 있습니다.