시퀀스 이벤트, 순간 및 브로드캐스트 메시지

이 문서에서는 시퀀스 구조체에 추가할 수 있는 특별한 "액션" 속성에 대해 설명합니다. 이러한 액션 속성은 이벤트, 순간 및 브로드캐스트 메시지의 세 가지 유형으로 나뉘며, 각 유형에 대해 자세히 설명하겠습니다.

시퀀스 이벤트

시퀀스 객체에는 이벤트를 추가할 수 있으며, 이러한 이벤트는 객체 자산에서 사용하는 이벤트와 유사합니다. 시퀀스 객체에 할당된 이벤트는 시퀀스 생명 주기에서 정의된 순간에 한 번 발생하거나 시퀀스가 실행되는 매 프레임마다 발생합니다. 다음은 사용 가능한 이벤트 목록입니다:

이벤트를 설정하려면, 메서드 변수를 올바른 이름의 속성에 할당해야 합니다. 다음은 구문입니다:

<sequence_struct>.<event_property> = method(<sequence_struct>, <function_name>);

활용 예제

마우스 왼쪽 버튼 클릭 시 시퀀스 방향을 반전시키는 예제입니다.

/// @function seq_reverse();
function seq_reverse() {
    if (mouse_check_button_pressed(mb_left)) {
        if (self.headDirection == seqdir_right) {
            self.headDirection = seqdir_left;
        } else {
            self.headDirection = seqdir_right;
        }
    }
}

var _seq = sequence_get(Sequence1);
_seq.event_step = method(_seq, seq_reverse);

순간

시퀀스 순간은 시퀀스가 재생되는 동안 특정 프레임에서 발생하는 고유한 코드 액션입니다. 이러한 코드 순간은 미리 정의된 메서드 변수로, 주어진 프레임에서 트리거됩니다. 예를 들어, 특정 프레임에서 "총알" 인스턴스를 생성하려면 다음과 같은 함수를 만들어야 합니다.

/// @function seq_shoot();
seq_shoot = function() {
    instance_create_layer(sequence.xorigin, sequence.yorigin, "Instances", obj_Bullet);
}

이 함수를 시퀀스 구조체의 momentKeyframes 속성에 추가합니다.

활용 예제

다음 코드는 60, 120, 180 프레임에서 seq_shoot 메서드를 호출하도록 설정합니다.

var _seq = sequence_get(my_Seq);
var _k = array_create(3);
_k[0] = sequence_keyframe_new(seqtracktype_moment);
_k[0].frame = 60;
_k[1] = sequence_keyframe_new(seqtracktype_moment);
_k[1].frame = 120;
_k[2] = sequence_keyframe_new(seqtracktype_moment);
_k[2].frame = 180;

var _d = array_create(1);
_d[0] = sequence_keyframedata_new(seqtracktype_moment);
_d[0].channel = 0;
_d[0].event = method(_d[0], seq_shoot);

_k[0].channels = _d;
_k[1].channels = _d;
_k[2].channels = _d;
_seq.momentKeyframes = _k;

브로드캐스트 메시지

시퀀스는 브로드캐스트 메시지를 생성할 수 있습니다. 이는 애니메이션 타임라인의 특정 프레임에 추가된 문자열로, 해당 타임라인 지점에 도달하면 문자열이 모든 객체 인스턴스에 전송됩니다. 브로드캐스트 메시지를 생성하려면 messageEventKeyframes 속성에 추가합니다.

활용 예제

다음 코드는 60, 120 프레임에서 브로드캐스트 메시지를 설정합니다.

var _seq = sequence_get(my_Seq);
var _k = array_create(2);
_k[0] = sequence_keyframe_new(seqtracktype_message);
_k[0].frame = 60;
_k[1] = sequence_keyframe_new(seqtracktype_message);
_k[1].frame = 120;

var _m1 = array_create(2);
_m1[0] = "Hello";
_m1[1] = "World";

var _m2 = array_create(1);
_m2[0] = "This is a Broadcast Message";

var _d1 = array_create(1);
_d1[0] = sequence_keyframedata_new(seqtracktype_message);
_d1[0].channel = 0;
_d1[0].events = _m1;

var _d2 = array_create(1);
_d2[0] = sequence_keyframedata_new(seqtracktype_message);
_d2[0].channel = 0;
_d2[0].events = _m2;

_k[0].channels = _d1;
_k[1].channels = _d2;
_seq.messageEventKeyframes = _k;

이 코드는 메시지 텍스트를 키프레임 데이터 채널에 배열로 전달합니다. 이는 동일한 프레임에서 여러 메시지를 브로드캐스트할 수 있도록 합니다.