layer_sequence_get_headpos 함수 설명
layer_sequence_get_headpos 함수는 특정 시퀀스 요소의 현재 재생 위치(플레이헤드 위치)를 반환하는 함수입니다. 이 함수는 layer_sequence_create() 또는 다른 레이어 요소 함수에서 반환된 시퀀스 요소 ID를 사용하여 호출됩니다.
문법
layer_sequence_get_headpos(sequence_element_id)
인자 설명
| 인자 이름 | 타입 | 설명 |
|---|---|---|
| sequence_element_id | 정수 | 타겟 시퀀스 요소의 고유 ID 값입니다. |
반환값
- 현재 플레이헤드 위치(현재 프레임)를 반환합니다.
예제
if (layer_sequence_get_headpos(title_sequence) != 0) {
layer_sequence_headpos(title_sequence, 0);
}
위 코드는 변수 "title_sequence"에 저장된 시퀀스 요소 ID의 현재 플레이헤드 위치를 확인하고, 만약 0으로 설정되어 있지 않다면 0으로 설정합니다.
활용 예제
예제 1: 시퀀스 재생 위치 확인
var current_pos = layer_sequence_get_headpos(my_sequence);
if (current_pos > 10) {
// 특정 작업 수행
}
예제 2: 시퀀스 초기화
if (layer_sequence_get_headpos(my_sequence) != 0) {
layer_sequence_headpos(my_sequence, 0); // 시퀀스를 처음으로 되돌림
}
예제 3: 시퀀스 상태에 따른 이벤트 발생
if (layer_sequence_get_headpos(event_sequence) == 5) {
// 이벤트 발생
}
예제 4: 여러 시퀀스의 위치 확인
var pos1 = layer_sequence_get_headpos(sequence_one);
var pos2 = layer_sequence_get_headpos(sequence_two);
if (pos1 == pos2) {
// 두 시퀀스가 같은 위치에 있을 때의 처리
}
예제 5: 시퀀스 반복 재생
if (layer_sequence_get_headpos(loop_sequence) >= total_frames) {
layer_sequence_headpos(loop_sequence, 0); // 시퀀스를 처음으로 되돌림
}
이와 같이 layer_sequence_get_headpos 함수를 활용하여 다양한 시퀀스의 재생 위치를 확인하고, 그에 따른 로직을 구현할 수 있습니다.