layer_background_destroy 함수 설명

layer_background_destroy 함수는 주어진 배경 요소를 삭제하는 기능을 제공합니다. 이 함수는 배경 ID를 인자로 받아 해당 배경을 제거합니다. 배경 ID는 layer_background_create() 함수를 사용하여 배경을 생성할 때 얻거나, layer_get_background_id()와 함께 레이어 핸들을 사용하여 얻을 수 있습니다. 이 함수는 레이어 자체를 삭제하지 않고, 레이어에서 배경만 제거합니다. 만약 배경이 방 편집기에서 추가된 것이라면, 방을 나갔다가 다시 들어오면 배경이 다시 생성됩니다. 그러나 방이 지속적(persistent)이라면, 방 지속성이 꺼지지 않는 한 배경은 제거됩니다.

문법

layer_background_destroy(background_element_id)

인자

반환값

• 해당 없음

예제

var lay_id = layer_get_id("Background_trees");
var bck_id = layer_background_get_id("Forrest");
if (layer_background_exists(lay_id, bck_id)){
    layer_background_destroy(bck_id);
}

위 코드는 "Background_trees" 레이어에서 주어진 배경 요소가 존재하는지 확인하고, 존재한다면 해당 배경을 삭제합니다(레이어는 삭제하지 않음).

활용 예제

예제 1: 배경 삭제 후 새로운 배경 추가

var lay_id = layer_get_id("Background_trees");
var bck_id = layer_background_get_id("Forrest");

if (layer_background_exists(lay_id, bck_id)){
    layer_background_destroy(bck_id);
}

var new_bck_id = layer_background_create("New_Background");
layer_background_add(lay_id, new_bck_id);

예제 2: 특정 조건에서 배경 제거

if (player_health < 50) {
    var lay_id = layer_get_id("Background_trees");
    var bck_id = layer_background_get_id("Forrest");

    if (layer_background_exists(lay_id, bck_id)){
        layer_background_destroy(bck_id);
    }
}

예제 3: 방이 지속적일 때 배경 제거

if (room_persistent) {
    var lay_id = layer_get_id("Background_trees");
    var bck_id = layer_background_get_id("Forrest");

    if (layer_background_exists(lay_id, bck_id)){
        layer_background_destroy(bck_id);
    }
}

예제 4: 배경 존재 여부 확인 후 처리

var lay_id = layer_get_id("Background_trees");
var bck_id = layer_background_get_id("Forrest");

if (!layer_background_exists(lay_id, bck_id)) {
    // 배경이 존재하지 않으면 새로운 배경 생성
    var new_bck_id = layer_background_create("New_Background");
    layer_background_add(lay_id, new_bck_id);
}