layer_sequence_get_sequence 함수 설명
layer_sequence_get_sequence 함수는 시퀀스 요소 ID를 입력받아 해당 시퀀스 객체 구조체를 반환합니다. 이 함수는 먼저 시퀀스 인스턴스 구조체를 가져올 필요 없이 시퀀스 데이터에 직접 접근할 수 있게 해줍니다. 시퀀스 객체 구조체의 형식에 대한 자세한 내용은 The Sequence Object Struct 페이지를 참조하세요.
문법
layer_sequence_get_sequence(sequence_element_id)
매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
| sequence_element_id | 시퀀스 요소 ID | 타겟 시퀀스 요소의 고유 ID 값 |
반환값
- 시퀀스 객체 구조체
예제
var _seq = layer_sequence_create("Background", 0, 0, seq_AnimatedBackground);
var _struct = layer_sequence_get_sequence(_seq);
_struct.playbackSpeedType = spritespeed_framespersecond;
_struct.playbackSpeed = 30;
위 코드는 새로운 시퀀스 요소를 생성한 후, 해당 시퀀스 데이터 구조체를 가져옵니다. 이후 이 구조체를 사용하여 시퀀스의 재생 속도와 유형을 변경합니다.
활용 예제
예제 1: 시퀀스 재생 속도 변경
var _seq = layer_sequence_create("GameAnimation", 0, 0, seq_Game);
var _struct = layer_sequence_get_sequence(_seq);
_struct.playbackSpeed = 60; // 재생 속도를 60으로 설정
예제 2: 시퀀스 반복 설정
var _seq = layer_sequence_create("LoopAnimation", 0, 0, seq_Loop);
var _struct = layer_sequence_get_sequence(_seq);
_struct.loop = true; // 시퀀스를 반복하도록 설정
예제 3: 시퀀스 정지
var _seq = layer_sequence_create("StopAnimation", 0, 0, seq_Stop);
var _struct = layer_sequence_get_sequence(_seq);
_struct.isPlaying = false; // 시퀀스를 정지
예제 4: 시퀀스 시작
var _seq = layer_sequence_create("StartAnimation", 0, 0, seq_Start);
var _struct = layer_sequence_get_sequence(_seq);
_struct.isPlaying = true; // 시퀀스를 시작
예제 5: 시퀀스 속도 조정
var _seq = layer_sequence_create("SpeedAdjustAnimation", 0, 0, seq_SpeedAdjust);
var _struct = layer_sequence_get_sequence(_seq);
_struct.playbackSpeed = 45; // 재생 속도를 45로 조정
이와 같이 layer_sequence_get_sequence 함수를 활용하여 시퀀스의 다양한 속성을 조정할 수 있습니다.