layer_sequence_get_instance 함수 설명
layer_sequence_get_instance 함수는 시퀀스 요소 ID를 입력받아 해당 시퀀스 인스턴스 구조체를 반환합니다. 이 ID는 layer_sequence_create() 함수나 다른 레이어 요소 함수들에 의해 반환됩니다. 시퀀스 인스턴스 구조체의 형식에 대한 자세한 내용은 "Sequence Instance Struct" 페이지를 참조하세요.
문법
layer_sequence_get_instance(sequence_element_id)
인수
| 인수 이름 | 타입 | 설명 |
|---|---|---|
| sequence_element_id | Sequence Element ID | 타겟으로 할 시퀀스 요소의 고유 ID 값 |
반환값
- Sequence Instance Struct
예제
var _seq = layer_sequence_create("Background", 0, 0, seq_AnimatedBackground);
var _struct = layer_sequence_get_instance(_seq);
_struct.speedScale = 0.5;
위의 코드는 새로운 시퀀스 요소를 생성한 후, 해당 시퀀스 인스턴스 ID를 가져옵니다. 이후 이 ID를 사용하여 시퀀스 인스턴스의 재생 속도 비율 속성을 변경합니다.
활용 예제
예제 1: 시퀀스 인스턴스의 속성 변경
var _seq = layer_sequence_create("Foreground", 0, 0, seq_StaticForeground);
var _struct = layer_sequence_get_instance(_seq);
_struct.alpha = 0.8; // 투명도 변경
예제 2: 시퀀스 인스턴스의 위치 조정
var _seq = layer_sequence_create("MovingObject", 100, 100, seq_Moving);
var _struct = layer_sequence_get_instance(_seq);
_struct.x = 150; // X 위치 변경
_struct.y = 200; // Y 위치 변경
예제 3: 시퀀스 인스턴스의 반복 설정
var _seq = layer_sequence_create("LoopingAnimation", 0, 0, seq_Loop);
var _struct = layer_sequence_get_instance(_seq);
_struct.loop = true; // 반복 설정
예제 4: 시퀀스 인스턴스의 속도 조절
var _seq = layer_sequence_create("FastAnimation", 0, 0, seq_Fast);
var _struct = layer_sequence_get_instance(_seq);
_struct.speedScale = 2.0; // 속도를 두 배로 증가
이와 같이 layer_sequence_get_instance 함수를 활용하여 다양한 시퀀스 인스턴스의 속성을 조정할 수 있습니다.