layer_background_get_index 함수 설명

layer_background_get_index 함수는 배경 요소의 현재 이미지 인덱스 값을 가져오는 데 사용됩니다. 이 함수는 배경 요소의 ID를 인자로 받아, 해당 배경 요소에 할당된 스프라이트의 이미지 인덱스를 반환합니다. 만약 배경 요소가 존재하지 않거나 유효한 스프라이트가 할당되어 있지 않으면 -1을 반환합니다.

문법

layer_background_get_index(background_element_id);

인자 설명

반환값

• 실수형: 현재 스프라이트 이미지 인덱스 또는 -1

예제 코드

var lay_id = layer_get_id("Background_sky");
var back_id = layer_background_get_id(lay_id);
if (layer_background_get_index(back_id) < 4) {
    layer_background_index(back_id, 4);
}

위 코드는 "Background_sky"라는 이름의 레이어 핸들을 가져온 후, 해당 레이어의 배경 요소 ID를 얻습니다. 그 ID를 사용하여 요소의 이미지 인덱스가 4보다 작은지 확인하고, 만약 그렇다면 인덱스를 4로 설정합니다.

활용 예제

예제 1: 배경 이미지 변경

var lay_id = layer_get_id("Background_sky");
var back_id = layer_background_get_id(lay_id);
if (layer_background_get_index(back_id) != 2) {
    layer_background_index(back_id, 2);
}

예제 2: 배경 요소가 존재하는지 확인

var lay_id = layer_get_id("Background_sky");
var back_id = layer_background_get_id(lay_id);
if (back_id != -1) {
    var current_index = layer_background_get_index(back_id);
    // 현재 인덱스에 따라 다른 작업 수행
}

예제 3: 배경 요소의 인덱스에 따라 애니메이션 제어

var lay_id = layer_get_id("Background_sky");
var back_id = layer_background_get_id(lay_id);
if (layer_background_get_index(back_id) == 3) {
    // 특정 애니메이션 시작
}

이와 같이 layer_background_get_index 함수를 활용하여 배경 요소의 이미지 인덱스를 확인하고, 다양한 상황에 맞게 배경을 제어할 수 있습니다.