구문
FUNCTION에 예약된 이름을 주어 엔진이 스스로 호출하게 합니다. 시작할 때 한 번, 매 프레임, 고정된 주기로, 또는 충돌, 트리거, 메시지, 애니메이션 이벤트가 일어날 때 호출됩니다.
FUNCTION start()
FUNCTION update(<dt>)
FUNCTION fixedUpdate(<step>)
FUNCTION onCollisionEnter(<other>)
FUNCTION onCollisionStay(<other>)
FUNCTION onCollisionExit(<other>)
FUNCTION onTriggerEnter(<other>)
FUNCTION onTriggerExit(<other>)
FUNCTION onMessage(<message>, <data>, <sender>)
FUNCTION onAnimationEvent(<event>, <data>)
FUNCTION main()
ENDFUNCTION다른 표기 : start, update, fixedUpdate, lateUpdate, onCollision, onTrigger, onMessage, onDestroy
구성 요소
| <dt> | 마지막 프레임 이후의 초이며 최대 0.1. |
|---|---|
| <step> | 고정 물리 스텝이며 1/60초. |
| <other> | 접촉이나 트리거의 상대 엔티티. |
| <message> | 다른 스크립트가 보낸 메시지 텍스트. 예: EntitySend("door", "open"). |
| <data> | 메시지나 애니메이션 이벤트와 함께 보낸 데이터. |
| <sender> | 메시지를 보낸 엔티티. |
| <event> | 애니메이션 이벤트의 이름. |
알아두기
- 함수 밖에 있는 줄은 스크립트가 로드될 때
start()보다 먼저 한 번 실행됩니다.GLOBAL선언과 준비 코드를 두기에 알맞은 곳입니다. - 받아들이는 다른 이름: 앞의 셋에는
onStart,onUpdate,onFixedUpdate.onCollision과onTrigger는onCollisionEnter와onTriggerEnter를 뜻하고,onAnimEvent는onAnimationEvent를 뜻합니다. BASIC은 대소문자를 구분하지 않으며 엔진은 여전히 기대하는 철자를 받습니다. - 생명주기 함수는 오버로드할 수 없습니다. 두 번째
update는 컴파일 오류입니다: "BASIC lifecycle function cannot be overloaded". update에서는 Sync()를 쓰지 마세요. 함수가 반환되면 프레임이 끝납니다. 시간을 재려면dt를 더하거나, 태스크에서YieldTask()로 프레임을 세세요.update의 오류는update를 멈추지 않습니다. 오류는 보고되고update는 다음 프레임에 다시 실행됩니다. 5프레임 연속으로 200ms를 넘기는update는 꺼집니다.DO … LOOP가 있는 프로그램, 그리고 함수 밖(태스크 레이블 포함) 어디엔가 Wait(), Sleep(),AWAITTASK,AWAITALL,AWAITANY가 있는 프로그램은main()으로 실행됩니다. 그러면 엔진은start()나update()를 호출하지 않으며 아무 알림도 없습니다. 이런 프로그램에FUNCTION main()을 직접 선언하지 마세요. 경고 없이 대체됩니다.lateUpdate와onDestroy는 예약된 이름으로 남아 있지만, 이 글을 쓰는 시점에 에디터는 엔티티 스크립트에서 이를 호출하지 않습니다. 의존하지 마세요.- 이 함수들도 다른 함수처럼 직접 호출할 수 있습니다.
예제
BASIC
GLOBAL elapsed# = 0GLOBAL frames AS integer = 0FUNCTION start() Console("ready") ' ready, printed secondENDFUNCTIONFUNCTION update(dt#) elapsed# = elapsed# + dt# frames = frames + 1ENDFUNCTIONFUNCTION onMessage(message$, data, sender) IF message$ = "reset" THEN frames = 0ENDFUNCTIONConsole("loaded") ' loaded, printed first매뉴얼에서 : 함수