sprite_get_info 함수 설명

sprite_get_info 함수는 주어진 스프라이트에 대한 정보를 가져오는 데 사용됩니다. 스프라이트 인덱스를 제공하면, 이 함수는 여러 변수로 구성된 구조체를 반환합니다. 이 문서에서는 반환되는 구조체의 변수와 그 설명을 다룹니다.

스프라이트 정보 구조체

비트맵 스프라이트 데이터

비트맵 스프라이트에 대한 추가 변수:

Spine 스프라이트 데이터

Spine 스프라이트에 대한 추가 변수:

함수 사용법

구문

sprite_get_info(index);

인수

반환값

스프라이트 정보 구조체 (또는 undefined)

예제

var _info = sprite_get_info(sprite_index);
if (_info != undefined && _info.type == 0) {
    var _messages = _info.messages;
    var _messageCount = array_length(_messages);
    for (var i = 0; i < _messageCount; i++) {
        var _message = _messages[i];
        show_debug_message("Message at frame " + string(_message.frame) + ": " + _message.message);
    }
}

위 코드는 인스턴스의 스프라이트에 대한 정보 구조체를 가져오고, 그것이 undefined가 아니며 유형이 0(비트맵 스프라이트)인지 확인합니다. 그런 다음 해당 스프라이트의 방송 메시지 배열을 가져와서 각 방송 메시지와 그 프레임을 출력 로그에 인쇄합니다.

활용 예제

1. 스프라이트의 크기와 오프셋을 가져와서 게임 오브젝트의 위치를 조정하는 코드:

var _info = sprite_get_info(sprite_index);
if (_info != undefined) {
    x += _info.xoffset;
    y += _info.yoffset;
}

1. 스프라이트의 프레임 속도를 변경하는 코드:

var _info = sprite_get_info(sprite_index);
if (_info != undefined) {
    frame_speed = _info.frame_speed * 2; // 속도를 두 배로 증가
}

1. 스프라이트의 메시지를 기반으로 특정 행동을 수행하는 코드:

var _info = sprite_get_info(sprite_index);
if (_info != undefined) {
    var _messages = _info.messages;
    if (array_length(_messages) > 0) {
        // 첫 번째 메시지에 따라 행동
        if (_messages[0].message == "jump") {
            jump();
        }
    }
}

1. 스프라이트의 서브 이미지 수를 확인하여 애니메이션을 조정하는 코드:

var _info = sprite_get_info(sprite_index);
if (_info != undefined) {
    if (_info.num_subimages > 1) {
        // 애니메이션이 여러 프레임이므로 애니메이션 시작
        start_animation();
    }
}