layer_sequence_speedscale 함수 설명
layer_sequence_speedscale 함수는 주어진 시퀀스의 재생 속도를 변경하는 기능을 제공합니다. 이 함수는 layer_sequence_create() 또는 다른 레이어 요소 함수에서 반환된 시퀀스 요소 ID와 속도 배율 값을 인자로 받습니다. 속도 배율 값은 배수 형태로, 기본 재생 속도는 1이며, 1보다 작은 값은 재생 속도를 느리게 하고, 1보다 큰 값은 재생 속도를 빠르게 합니다. 예를 들어, 0.5는 재생 속도를 절반으로 줄이고, 2는 재생 속도를 두 배로 증가시킵니다.
문법
layer_sequence_speedscale(sequence_element_id, speedscale)
인자 설명
| 인자 이름 | 타입 | 설명 |
|---|---|---|
| sequence_element_id | Sequence Element ID | 타겟 시퀀스 요소의 고유 ID 값 |
| speedscale | Real | 사용할 속도 배율 (배수), 기본값은 1 |
반환값
- N/A
예제
var _seq = layer_sequence_create("Background", 0, 0, seq_AnimatedBackground);
layer_sequence_speedscale(_seq, 0.75);
위 코드는 호출 인스턴스의 레이어에 새로운 시퀀스를 생성하고, 그 속도 배율 값을 0.75로 설정합니다 (기본 재생 속도의 3/4).
활용 예제
예제 1: 시퀀스 느리게 재생하기
var _slow_seq = layer_sequence_create("SlowAnimation", 0, 0, seq_SlowAnimation);
layer_sequence_speedscale(_slow_seq, 0.5);
예제 2: 시퀀스 빠르게 재생하기
var _fast_seq = layer_sequence_create("FastAnimation", 0, 0, seq_FastAnimation);
layer_sequence_speedscale(_fast_seq, 2);
예제 3: 기본 속도로 재생하기
var _normal_seq = layer_sequence_create("NormalAnimation", 0, 0, seq_NormalAnimation);
layer_sequence_speedscale(_normal_seq, 1);
예제 4: 사용자 입력에 따라 속도 조절하기
var _user_seq = layer_sequence_create("UserAnimation", 0, 0, seq_UserAnimation);
var user_speed = get_user_input_speed(); // 사용자로부터 속도 입력 받기
layer_sequence_speedscale(_user_seq, user_speed);
예제 5: 게임 이벤트에 따라 속도 변경하기
if (game_event_occurred) {
var _event_seq = layer_sequence_create("EventAnimation", 0, 0, seq_EventAnimation);
layer_sequence_speedscale(_event_seq, 1.5); // 이벤트 발생 시 속도 증가
}