path_start 함수 설명
path_start 함수는 호출하는 인스턴스에게 주어진 경로를 시작하라고 지시합니다. 인스턴스가 시작한 경로는 path_index 변수에 저장됩니다. 경로는 여러 정의된 점들이 연결되어 만들어지며, 인스턴스의 움직임을 계획하는 데 사용됩니다. 경로는 코드로 생성할 수 있으며, Path Editor를 통해서도 만들 수 있습니다. 이 경로는 게임에서 인스턴스에 할당되어 사용됩니다.
이 함수를 사용하여 인스턴스에게 어떤 경로를 따라야 하는지, 경로를 따라가는 속도(픽셀/스텝 단위), 경로 끝에 도달했을 때의 행동, 그리고 절대 경로 또는 상대 경로 위치를 따를 것인지 설정할 수 있습니다. 절대 경로는 Path Editor에서 디자인한 대로 정확히 시작하고 따르는 것을 의미하며, 상대 경로는 인스턴스가 생성된 위치에서 시작하여 경로를 따르는 것을 의미합니다.
아래 이미지를 보면 두 인스턴스가 path_start로 시작된 동일한 경로를 따르고 있지만, 하나는 절대 경로를 따르고 다른 하나는 상대 경로를 따릅니다. 절대 경로가 false로 설정되면(즉, 상대 경로) 인스턴스는 방 안의 위치에 관계없이 경로의 시작점으로 "점프"합니다.
인스턴스가 경로의 끝에 도달했을 때의 행동을 정의하는 상수는 이 페이지에 나와 있습니다. 경로를 따를 때 인스턴스의 위치는 Step 이벤트 후에 업데이트되므로, Step 이벤트 중에는 x와 y 위치가 이전의 x와 y와 동일합니다(시작 단계 또는 Step 이벤트에서 수동으로 수정하지 않는 한).
문법
path_start(path, speed, endaction, absolute);
인수 설명
| 인수 | 유형 | 설명 |
|---|---|---|
| path | Path Asset | 시작할 경로의 인덱스 |
| speed | Real | 경로를 따라가는 속도(픽셀/스텝 단위), 음수는 뒤로 가는 것을 의미 |
| endaction | Path End Action Constant | 경로의 끝에 도달했을 때의 행동 |
| absolute | Boolean | 호출하는 인스턴스가 Path Editor에서 정의된 절대 경로(true)를 따를지, 현재 위치에 대한 상대 경로(false)를 따를지 여부 |
반환값
N/A
활용 예제
다음은 path_start 함수를 활용한 몇 가지 예제입니다.
// 예제 1: 경로를 따라 이동
path_start(myPath, 5, path_action_stop, true);
// 예제 2: 상대 경로로 이동
path_start(myPath, 3, path_action_reverse, false);
// 예제 3: 경로 끝에 도달했을 때 반대 방향으로 이동
path_start(myPath, 4, path_action_reverse, false);
이 예제들은 각각 다른 속도와 행동을 설정하여 인스턴스가 경로를 따라 이동하는 방법을 보여줍니다.