Lifecycle functions

문

구문

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
매뉴얼에서 : 함수