Track Struct 설명서
Track Struct는 최상위 자산 트랙 또는 하위 트랙 매개변수 트랙으로 사용할 수 있으며, 트랙의 동작은 이름과 유형에 의해 정의됩니다. Track Struct는 sequence_track_new 함수를 사용하여 생성할 수 있으며, Sequence Instance Struct의 activeTracks 속성이나 Sequence Object Struct의 tracks 속성을 통해 검색할 수 있습니다.
Track Struct의 속성
| 속성 이름 | 변수 유형 | 설명 |
|---|---|---|
| type | Sequence Track Type Constant | 트랙의 유형을 설명하는 Sequence Track Type Constant입니다. 이는 Types 섹션에 제공된 상수 중 하나일 수 있습니다. |
| name | String | "최상위" 자산 트랙을 생성할 때, 이곳에 지정하는 이름은 트랙을 식별하는 데 필요한 문자열일 수 있습니다. 매개변수 트랙의 경우, GameMaker에 어떤 종류의 매개변수 트랙을 생성하는지 알려주기 위해 특정 문자열을 지정해야 합니다. |
| tracks | Array of Sequence Track Structs | 이 트랙의 자식 트랙 목록에 접근할 수 있는 속성입니다. 이 속성을 가져오면 Sequence Track Structs의 배열이 반환되며, 설정할 때는 Sequence Track Structs의 배열을 지정해야 합니다. |
| visible | Boolean | 이 트랙이 보이는지(true) 또는 보이지 않는지(false)를 나타냅니다. 이 값을 가져오거나 설정할 수 있으며, 트랙이 보이지 않으면 자식 트랙도 그려지지 않습니다. |
| keyframes | Array of Sequence Keyframe Structs | 트랙의 keyframe structs 목록에 접근할 수 있는 속성입니다. 이 속성을 가져오면 keyframe structs의 배열이 반환되며, 설정할 때는 keyframe structs의 배열을 지정해야 합니다. |
| enabled | Boolean | 이 트랙이 활성화되어 있는지 나타냅니다. 자산 트랙인 경우 비활성화되면 그려지지 않으며, 매개변수 트랙인 경우 트랙의 값이 적용되지 않습니다. |
Track 유형
type 속성은 다음 상수 중 하나일 수 있습니다:
| 상수 | 설명 | 값 |
|---|---|---|
| seqtracktype_graphic | 그래픽(스프라이트) 자산 트랙 | 1 |
| seqtracktype_audio | 오디오 자산 트랙 | 2 |
| seqtracktype_instance | 인스턴스 자산 트랙 | 14 |
| seqtracktype_sequence | 시퀀스 자산 트랙 | 7 |
| seqtracktype_clipmask | 클립 마스크 그룹 자산 트랙 | 8 |
| seqtracktype_clipmask_mask | 클립 마스크 스프라이트 자산 트랙 | 9 |
| seqtracktype_clipmask_subject | 마스킹되는 클립 마스크 스프라이트 자산 트랙 | 10 |
| seqtracktype_group | 그룹 폴더 자산 트랙 | 11 |
| seqtracktype_colour | 색상 데이터 매개변수 트랙 | 4 |
| seqtracktype_real | 실수 매개변수 트랙 | 3 |
| seqtracktype_message | 방송 메시지 트랙 | 15 |
| seqtracktype_moment | 이벤트/모멘트 트랙 | 16 |
| seqtracktype_text | 텍스트 자산 트랙 | 17 |
| seqtracktype_particlesystem | 파티클 시스템 자산 트랙 | 18 |
| seqtracktype_audioeffect | 오디오 효과 매개변수 트랙 | 19 |
이름 속성
name 속성은 다음 문자열 중 하나일 수 있습니다:
| 문자열 | 설명 |
|---|---|
| "position" | seqtracktype_real 유형의 트랙에서 위치 데이터를 사용해야 함을 나타냅니다. |
| "scale" | seqtracktype_real 유형의 트랙에서 스케일링 데이터를 사용해야 함을 나타냅니다. |
| "rotation" | seqtracktype_real 유형의 트랙에서 회전 데이터를 사용해야 함을 나타냅니다. |
| "blend_multiply" 또는 "image_blend" | seqtracktype_colour 유형의 트랙에서 색상 곱셈 데이터를 사용해야 함을 나타냅니다. |
| "image_speed" | seqtracktype_real 유형의 트랙에서 이미지 속도 값을 사용해야 함을 나타냅니다. |
| "image_index" | seqtracktype_real 유형의 트랙에서 이미지 인덱스 값을 사용해야 함을 나타냅니다. |
| "image_angle" | seqtracktype_real 유형의 트랙에서 이미지 각도 값을 사용해야 함을 나타냅니다. |
활용 예제
다음은 Track Struct를 활용하는 몇 가지 예제입니다.
예제 1: 그래픽 자산 트랙 생성
var myTrack = sequence_track_new(seqtracktype_graphic, "My Graphic Track");
예제 2: 오디오 자산 트랙 생성
var audioTrack = sequence_track_new(seqtracktype_audio, "Background Music");
예제 3: 트랙의 가시성 설정
myTrack.visible = true; // 트랙을 보이게 설정
예제 4: 키프레임 추가
myTrack.keyframes = [keyframe_new(0, 1), keyframe_new(1, 2)];
예제 5: 트랙 활성화/비활성화
myTrack.enabled = false; // 트랙 비활성화
이 문서에서는 Track Struct의 기본 개념과 속성, 활용 예제를 설명했습니다.