layer_text_exists 함수 설명
layer_text_exists 함수는 주어진 레이어에 특정 텍스트 요소가 존재하는지 확인하고, 존재 여부에 따라 true 또는 false를 반환합니다.
문법
layer_text_exists(layer_name_or_id, text_element_id);
매개변수 설명
| 매개변수 | 타입 | 설명 |
|---|---|---|
| layer_name_or_id | String 또는 Layer | 확인할 레이어의 이름 또는 ID입니다. |
| text_element_id | Text Element ID | layer_text_create 또는 layer_text_get_id에서 가져온 텍스트 요소의 ID입니다. |
반환값
- Boolean: 텍스트 요소가 존재하면
true, 존재하지 않으면false를 반환합니다.
예제
var _text1_id = layer_text_get_id("Assets", "text1");
if (layer_text_exists("Assets", _text1_id)){
layer_text_destroy(_text1_id);
}
위의 예제에서는 "Assets" 레이어에서 "text1"이라는 텍스트 요소의 ID를 가져옵니다. 그런 다음 해당 요소가 존재하는지 확인하고, 존재할 경우 해당 요소를 삭제합니다.
활용 예제
- 텍스트 요소 존재 확인 후 수정하기
var _text_id = layer_text_get_id("UI", "score_text");
if (layer_text_exists("UI", _text_id)){
layer_text_set_text(_text_id, "Score: " + string(score));
}
- 게임 오버 시 텍스트 요소 삭제하기
var _game_over_id = layer_text_get_id("UI", "game_over_text");
if (layer_text_exists("UI", _game_over_id)){
layer_text_destroy(_game_over_id);
}
- 다양한 레이어에서 텍스트 요소 확인하기
var _level_text_id = layer_text_get_id("Level", "level_text");
if (layer_text_exists("Level", _level_text_id)){
// 레벨 텍스트가 존재할 경우 추가 작업 수행
}
- 조건에 따라 텍스트 요소 생성하기
var _info_text_id = layer_text_get_id("Info", "info_text");
if (!layer_text_exists("Info", _info_text_id)){
layer_text_create("Info", "info_text", "게임 정보를 여기에 표시합니다.");
}
이와 같이 layer_text_exists 함수를 활용하여 텍스트 요소의 존재 여부를 확인하고, 그에 따라 다양한 작업을 수행할 수 있습니다.