시퀀스 오브젝트 구조체

시퀀스 오브젝트 구조체는 시퀀스 자산에서 가져온 구조체의 이름입니다. 런타임 동안 모든 시퀀스 데이터는 이 구조체에 저장되며, 방에서 생성된 시퀀스의 모든 요소가 참조합니다. 즉, 이 구조체의 변수(또는 그 내부의 중첩 구조체)가 수정되면 원래의 시퀀스가 변경되고, 기존의 시퀀스 요소에도 영향을 미칩니다.

이 구조체는 다음과 같은 변경 가능한 속성을 가집니다:

속성 이름 타입 설명
name String 시퀀스의 이름을 나타내는 문자열입니다. 이 값을 필요에 따라 가져오거나 설정할 수 있습니다. sequence_create 함수를 사용하여 생성된 시퀀스는 이름이 없으며, 이 값은 빈 문자열("")입니다.
loopmode Sequence Play Mode Constant 시퀀스 오브젝트의 재생 모드로, 가져오거나 설정할 수 있습니다. 아래 표의 상수 중 하나일 수 있습니다.
playbackSpeed Real 시퀀스의 재생 속도를 지정합니다. 이는 초당 프레임 또는 게임 프레임당 프레임으로 해석됩니다. 이 값을 가져오거나 설정할 수 있습니다.
playbackSpeedType Sprite Speed Constant playbackSpeed가 어떻게 해석되어야 하는지를 지정합니다. 이 값을 가져오거나 설정할 수 있습니다.
length Real 시퀀스의 길이를 프레임 단위로 나타냅니다. 이 값을 가져오거나 설정할 수 있지만, 시퀀스 인스턴스가 새로운 길이를 초과하는 재생 헤드를 설정하면 문제가 발생할 수 있습니다.
volume Real 0에서 1까지의 스칼라 값으로, 시퀀스의 모든 오디오 트랙의 볼륨을 조절하는 데 사용됩니다. 이 값을 가져오거나 설정할 수 있으며, 모든 트랙의 전역 오디오 출력을 수정합니다.
xorigin Real X축을 따라 시퀀스의 원점을 나타냅니다.
yorigin Real Y축을 따라 시퀀스의 원점을 나타냅니다.
messageEventKeyframes Array of Sequence Keyframe Structs 시퀀스의 메시지 이벤트 키프레임에 접근할 수 있게 해줍니다. 이 속성을 가져오면 키프레임 구조체의 배열이 반환되며, 설정할 때는 키프레임 구조체의 배열을 제공해야 합니다.
momentKeyframes Array of Sequence Keyframe Structs 시퀀스의 순간 이벤트 키프레임에 접근할 수 있게 해줍니다. 이 속성을 가져오면 키프레임 구조체의 배열이 반환되며, 설정할 때는 키프레임 구조체의 배열을 제공해야 합니다.
tracks Array of Sequence Track Structs 시퀀스의 최상위 자산 트랙 목록에 접근할 수 있게 해줍니다. 이 속성을 가져오면 트랙 구조체의 배열이 반환되며, 설정할 때는 트랙 구조체의 배열을 제공해야 합니다.

loopmode 상수

상수 이름 설명
seqplay_oneshot 시퀀스가 한 번 재생되고 완료되면 정지합니다. 0
seqplay_loop 시퀀스가 반복되며, 재생 영역의 끝에 도달하면 시작으로 돌아갑니다. 1
seqplay_pingpong 시퀀스가 반복되며, 재생 영역의 끝에 도달하면 방향을 반대로 바꿉니다. 2

참고 사항

  • 시퀀스 에디터에서 생성된 시퀀스의 속성에 접근하려면 먼저 자산 인덱스에서 sequence_get 함수를 호출하여 시퀀스 오브젝트 구조체를 가져와야 합니다.
  • 이 시퀀스 구조체에 대한 변경 사항은 모든 후속 인스턴스에도 적용되며, 게임이 실행되는 동안 유지됩니다. game_restart 함수를 호출하더라도 유지됩니다.

활용 예제

// 시퀀스 생성
var mySequence = sequence_create();

// 시퀀스 이름 설정
mySequence.name = "My First Sequence";

// 재생 모드 설정
mySequence.loopmode = seqplay_loop;

// 재생 속도 설정
mySequence.playbackSpeed = 30;

// 볼륨 설정
mySequence.volume = 0.8;

// 시퀀스 길이 설정
mySequence.length = 120;

// X, Y 원점 설정
mySequence.xorigin = 100;
mySequence.yorigin = 200;

// 메시지 이벤트 키프레임 추가
var messageKeyframes = [];
array_push(messageKeyframes, new SequenceKeyframeStruct());
mySequence.messageEventKeyframes = messageKeyframes;

// 순간 이벤트 키프레임 추가
var momentKeyframes = [];
array_push(momentKeyframes, new SequenceKeyframeStruct());
mySequence.momentKeyframes = momentKeyframes;

// 트랙 추가
var tracks = [];
array_push(tracks, new SequenceTrackStruct());
mySequence.tracks = tracks;
// 시퀀스 속성 가져오기
var sequenceName = mySequence.name;
var sequenceLength = mySequence.length;
var sequenceVolume = mySequence.volume;

// 시퀀스 재생
sequence_play(mySequence);
// 시퀀스 수정
mySequence.playbackSpeed = 60; // 재생 속도 변경
mySequence.volume = 0.5; // 볼륨 변경
// 시퀀스 종료
sequence_stop(mySequence);

Read more

기술 문서 해설 및 활용 예제

이 문서는 특정 기술에 대한 설명과 활용 방법을 다룹니다. 아래에서 내용을 쉽게 이해할 수 있도록 해설하고, 다양한 활용 및 응용 예제를 추가로 제공합니다. 기술 개요 이 기술은 게임 개발에서 자주 사용되는 기능으로, 특정 작업을 자동화하거나 효율적으로 처리하는 데 도움을 줍니다. 주로 게임의 로직을 구성하거나 사용자 인터페이스를 제어하는 데 사용됩니다. 주요

By 이재협/실장/시스템개발실/PHYSIA

키워드 설명서

이 문서는 특정 키워드에 대한 설명과 사용법을 제공합니다. 문법 (arguments); 인수 인수 이름 유형 설명 argument_name 인수에 대한 설명을 여기에 작성합니다. 반환값 (선택적 설명) 예제 code_example() { // 여기에 코드 예제를 설명합니다. } 코드 예제 설명 위의 코드 예제는 특정 기능을 수행하는 함수의 기본 구조를 보여줍니다. 이 함수는 인수를 받아들이고, 특정

By 이재협/실장/시스템개발실/PHYSIA

GameMaker 환경 설정 및 기능

이 문서에서는 GameMaker의 환경 설정 및 다양한 IDE 기능에 대한 정보를 제공합니다. 다음은 주요 항목들입니다: IDE 환경 설정 IDE(통합 개발 환경) 설정은 GameMaker의 전반적인 사용 경험을 조정하는 데 도움을 줍니다. 여기서 사용자는 개인의 필요에 맞게 다양한 옵션을 설정할 수 있습니다. 주요 설정 항목 설정 항목 설명 테마 IDE의 색상

By 이재협/실장/시스템개발실/PHYSIA

GameMaker IDE 설명서

GameMaker IDE는 게임을 만들고 소프트웨어에서 제공하는 모든 기능을 활용하는 주요 인터페이스입니다. 이 프로그램은 시작 화면부터 게임을 만들기 위해 사용하는 모든 편집기 창까지 포함되며, 매뉴얼과 다양한 튜토리얼에서 IDE라고 언급됩니다. IDE의 구성 요소 다음 섹션에서는 IDE에 대한 정보를 다룹니다: 1. 설정 및 기능 IDE의 설정 및 기능은 사용자가 게임 개발을 보다 효율적으로

By 이재협/실장/시스템개발실/PHYSIA