sequence_get 함수 설명

sequence_get 함수는 시퀀스 자산 인덱스에서 시퀀스 객체 구조체를 가져오는 기능을 제공합니다. 자산 브라우저에서 정의된 시퀀스의 자산 인덱스를 제공하면, 이 함수는 해당 시퀀스 객체 구조체를 반환합니다. 만약 시퀀스가 존재하지 않거나 제공된 자산 인덱스가 시퀀스가 아닐 경우 -1을 반환합니다.

문법

sequence_get(sequence_index);

인수

반환값

• Sequence Object Struct 또는 -1

예제

var _seq = sequence_get(seq_Logo);
seq.loopmode = seqplay_pingpong;

위 코드는 "seq_Logo"라는 시퀀스 객체에서 시퀀스 객체 구조체를 가져오고, 그 시퀀스의 루프 모드를 설정합니다. 이후 생성되는 모든 시퀀스 인스턴스는 이제 이 루프 모드를 사용하게 됩니다.

활용 예제

예제 1: 시퀀스 객체의 속성 변경

var _seq = sequence_get(seq_Explosion);
if (_seq != -1) {
    _seq.loopmode = seqplay_once;
}

이 코드는 "seq_Explosion" 시퀀스의 루프 모드를 한 번만 재생하도록 설정합니다.

예제 2: 시퀀스 존재 여부 확인

var _seq = sequence_get(seq_Background);
if (_seq == -1) {
    show_error("시퀀스가 존재하지 않습니다.", true);
}

이 코드는 "seq_Background" 시퀀스가 존재하는지 확인하고, 존재하지 않을 경우 오류 메시지를 표시합니다.

예제 3: 여러 시퀀스의 루프 모드 설정

var sequences = [seq_Logo, seq_Explosion, seq_Background];
for (var i = 0; i < array_length(sequences); i++) {
    var _seq = sequence_get(sequences[i]);
    if (_seq != -1) {
        _seq.loopmode = seqplay_pingpong;
    }
}

이 코드는 여러 시퀀스의 루프 모드를 핑퐁으로 설정합니다.

예제 4: 시퀀스 인스턴스 생성

var _seq = sequence_get(seq_Character);
if (_seq != -1) {
    instance_create_layer(x, y, "Instances", _seq);
}

이 코드는 "seq_Character" 시퀀스를 사용하여 새로운 인스턴스를 생성합니다.

예제 5: 시퀀스의 프레임 수 가져오기

var _seq = sequence_get(seq_Logo);
if (_seq != -1) {
    var frame_count = _seq.frames;
}

이 코드는 "seq_Logo" 시퀀스의 프레임 수를 가져옵니다.