게임 루프와 태스크
프로그램의 형태를 고르고, Sync()로 각 프레임을 끝내고, 게임 시간을 기다리고, 협력형 태스크로 여러 작업을 나란히 실행하는 법을 다룹니다.
한 줄 요약#
프레임을 그리는 것은 프로그램이 아니라 엔진입니다. BASIC 프로그램은 일을 조금 한 다음 제어를 돌려주어 프레임이 그려지게 합니다. Sync()가 그 넘겨주기입니다. 태스크를 쓰면 여러 작업이 그 넘겨주는 지점마다 차례를 번갈아 가질 수 있습니다.
세 가지 프로그램 형태#
| 형태 | 모양 | 실행 시점 | 용도 |
|---|---|---|---|
| 순차형 | 위에서 아래로 문장 | 프로그램이 시작될 때 한 번 | 설정, 도구, 테스트 |
| 메인 루프 | Sync()가 있는 DO … LOOP 하나 | 루프 본문이 프레임마다 한 번 | 클래식 AGK 또는 DarkBASIC 게임 |
| 수명 주기 함수 | FUNCTION start(), FUNCTION update(dt)… | 엔진이 호출 | JavaScript 스크립트와 같은 모델 |
순차형#
lives = 3
Console("Lives: " + Str(lives)) ' Lives: 3
프로그램은 위에서 아래로 한 번 실행되고 끝납니다.
메인 루프#
[statements] ' 첫 프레임 전에 한 번 실행
DO
[statements] ' 매 프레임 실행
Sync()
LOOP
[statements] ' EXIT로 루프를 빠져나온 뒤 한 번 실행
frames = 0
Console("start") ' start
DO
frames = frames + 1
IF frames = 3 THEN EXIT
Sync()
LOOP
Console("left after " + Str(frames)) ' left after 3
- 프로그램당
DO … LOOP는 최상위에 하나만.IF,WHILE,FUNCTION안에서는 안 됩니다. - 루프에는
Sync()(또는Swap(),YieldTask())가 있어야 합니다. 없으면 컴파일러가 "DO/LOOP requires SYNC() so the loop can yield a frame"으로 멈춥니다. EXIT는 루프를 빠져나옵니다.END는 프로그램 전체를 즉시 멈춥니다.
DO
Sync()
LOOP
DO ' 거부됨: 두 번째 메인 루프
Sync()
LOOP
AGK와 DarkBASIC에서
DO … LOOP는 어디에나 둘 수 있는 그냥 무한 루프입니다. aukimi에서는 그 프레임 루프이며, 프로그램당 하나입니다. 다른 루프에는WHILE … ENDWHILE이나REPEAT … UNTIL을 쓰세요.
⚠️ DO 루프가 있는 프로그램에서는 FUNCTION main()을 쓰지 마세요. 루프는 그 이름의 함수로 컴파일되어 둘이 충돌합니다. 컴파일러는 경고하지 않고, 루프가 실행되지 않습니다.
수명 주기 함수#
GLOBAL elapsed# = 0
FUNCTION start()
Console("ready") ' ready
ENDFUNCTION
FUNCTION update(dt#)
elapsed# = elapsed# + dt#
Print("Time: " + Str(elapsed#, 1))
ENDFUNCTION
엔진은 start를 한 번 호출한 다음, 프레임 길이(초)와 함께 매 프레임 update를 호출합니다. 쓸 루프도, 호출할 Sync()도 없습니다. update가 반환되면 엔진이 프레임을 그립니다. 훅의 전체 목록(fixedUpdate, onCollisionEnter, onMessage…)은 함수에 있습니다.
⚠️ 수명 주기 프로그램은 기다릴 수 없습니다. Wait(), Sleep(), AWAITTASK, AWAITALL, AWAITANY는 FUNCTION 안에서 거부됩니다. 더 나쁜 점은, DO가 없는 프로그램에서 이 중 하나가 태스크 레이블 안이라도 어디에든 있으면 프로그램 전체가 하나의 main()이 되어 엔진이 더 이상 start나 update를 찾지 못한다는 것입니다. 아무 알림도 없습니다. 수명 주기 프로그램에서 시간을 재려면 태스크에서 YieldTask()로 프레임을 세거나(아래 태스크 참고) dt를 누적하세요.
프레임 끝내기: Sync(), Swap(), YieldTask()#
| 호출 | 하는 일 |
|---|---|
Sync() | 프레임을 끝냅니다. 엔진이 그리고, 프로그램은 다음 프레임에 재개됩니다. 아직 로딩 중인 3D 모델도 기다리므로, LoadObject(...)와 Sync() 다음 프레임에는 모델이 있습니다. |
Swap() | 같은 일을 합니다. 클래식 Render2DBack(), Render3D(), Render2DFront(), Swap() 순서를 위해 남겨 둔 것입니다. 세 개의 Render 호출은 아무것도 하지 않고, Swap()이 프레임 전체를 그려서 올바른 그림이 나옵니다. |
YieldTask() | 역시 같은 일을 하며, 태스크 안에서 잘 읽히는 이름입니다 |
셋 모두 괄호가 필요합니다. SYNC만 쓰면 거부됩니다.
정말로 양보하는 경우#
Sync()는 프로그램이 기다릴 수 있는 곳에서만 프레임을 양보합니다. 최상위DO … LOOP가 있거나,END문이 있거나, 호출이 레이블(GOSUB서브루틴이나 태스크) 안에 있는 경우입니다.
그 밖의 곳에서 Sync()는 한 번 그리고 즉시 반환합니다. 프로그램은 멈추지 않습니다.
⚠️ 순차형 WHILE의 함정. "클릭을 기다리는" 고전적인 루프입니다. DO도 END도 없는 프로그램에서는 이 루프의 Sync()가 양보하지 않아서, 루프가 쉬지 않고 돌며 브라우저 탭을 멈춥니다. 오류는 없습니다.
' 이 프로그램에는 DO도 END도 없습니다. 실행하지 마세요.
ready = 0
WHILE ready = 0
IF PointerPressed() THEN ready = 1
Sync() ' 그리지만 다음 프레임을 기다리지 않음
ENDWHILE
해결책은 한 줄입니다. END가 있으면 같은 루프가 매 프레임 양보합니다.
ready = 0
WHILE ready = 0
IF PointerPressed() THEN ready = 1
Sync() ' 양보함: 프로그램에 END가 있음
ENDWHILE
Console("clicked") ' clicked
END
- 프로그램의 다른 곳에 있는
Wait()나Sleep()은 이것을 해결하지 못합니다.DO … LOOP,END, 레이블만 해결합니다. - AGK에서
Sync()는 어디에 쓰든 프레임을 끝냅니다. 기억해야 할 가장 큰 차이입니다.
⚠️ FUNCTION 안에서 Sync()를 절대 호출하지 마세요. DO 루프가 없으면 양보하지 않습니다. 있으면 프로그램이 시작되지 못합니다. 수명 주기 함수는 필요하지 않습니다. 함수가 반환되면 엔진이 그립니다.
DO 앞과 LOOP 뒤#
| 위치 | 실행 | 허용되는 것 |
|---|---|---|
DO 앞 | 첫 프레임 전에 한 번 | 무엇이든: 로딩, Wait(), WHILE … Sync() 로딩 화면 |
DO와 LOOP 사이 | 프레임마다 한 번 | 무엇이든 |
LOOP 뒤 | EXIT로 루프를 빠져나올 때 한 번 | Wait()와 Sleep()을 제외한 무엇이든 |
Console("loading") ' loading
Wait(0.5) ' 게임 시간으로 0.5초
frames = 0
DO
frames = frames + 1
IF frames = 120 THEN EXIT
Sync()
LOOP
Console("played " + Str(frames) + " frames") ' played 120 frames
- 루프 안의
END는LOOP뒤의 코드를 건너뜁니다. FUNCTION블록과 레이블은 루프 앞이나 뒤 어디에나 둘 수 있습니다. 이들은 "LOOP뒤의 코드"가 아닙니다. 호출될 때만 실행됩니다.LOOP뒤의Wait()나Sleep()은 거부됩니다.must appear before or inside the top-level DO/LOOP.
기다리기: Wait()와 Sleep()#
Wait(<seconds>)
Sleep(<milliseconds>)
Console("3") ' 3
Wait(1) ' 1초
Console("2") ' 2
Sleep(500) ' 0.5초
Console("go") ' go
- 둘 다 게임 시간을 기준으로 기다립니다. 게임이 일시정지되면 멈추고 시간 배율을 따릅니다. 기다리는 동안에도 엔진은 계속 프레임을 그립니다.
Wait는 초 단위,Sleep은 밀리초 단위입니다.Wait는 aukimi가 더한 것이고,Sleep은 AGK의 명령어입니다.- ⚠️ DarkBASIC에서
WAIT는 밀리초 단위입니다. 여기서Wait(1000)은 16분을 기다립니다.
| 위치 | Wait() / Sleep() | Sync() / Swap() / YieldTask() |
|---|---|---|
| 순차형 프로그램 | 가능 | 프로그램에 END가 있을 때만 양보 |
DO 앞 또는 루프 안 | 가능 | 가능 |
LOOP 뒤 | 거부됨 | 가능 |
레이블(GOSUB 서브루틴 또는 태스크) | 가능 | 가능 |
수명 주기 훅을 포함한 FUNCTION 안 | 거부됨 | 양보하지 않음. 쓰지 마세요 |
FUNCTION Pause()
Wait(1) ' 거부됨: FUNCTION은 기다릴 수 없음
ENDFUNCTION
오류 메시지는 Wait(...) is supported in the main BASIC program, not inside FUNCTION입니다. 재사용할 코드 조각에서 기다리려면 레이블을 쓰고 GOSUB로 도달하거나, 태스크로 시작하세요. 기다리는 레이블로의 GOSUB에는 프로그램에 DO 루프나 END가 필요하며, 그렇지 않으면 컴파일러가 거부합니다.
Print는 그리고, Console은 기록합니다#
| 호출 | 가는 곳 | 호출 빈도 |
|---|---|---|
Print(...) | 화면 왼쪽 위에 그려짐 | 매 프레임, 루프 안에서 |
PrintC(...) | 같지만 줄바꿈 없음 | 매 프레임 |
Console(...) | 에디터의 콘솔 | 무슨 일이 생겼을 때 |
Debug(...) | Console과 같으며 PureBasic의 이름 | 무슨 일이 생겼을 때 |
ConsoleWarning, ConsoleError, ClearConsole | 콘솔 | 무슨 일이 생겼을 때 |
Print는 만들고 있는 프레임에 씁니다. 무언가를 그리는 새 프레임은 각각 빈 텍스트 레이어에서 시작하므로, 한 번 출력한 텍스트는 사라집니다. 매 프레임 출력하세요.
Console은 한 줄을 한 번 씁니다. 매 프레임 호출하지 마세요. 진짜 오류가 묻힙니다. 한꺼번에 나온 똑같은 줄은 묶어서 횟수를 셉니다.
score = 0
DO
score = score + 1
Print("Score: " + Str(score)) ' 매 프레임 다시 그려짐
IF score = 100 THEN Console("100 reached") ' 한 번만 기록됨
IF score = 200 THEN EXIT
Sync()
LOOP태스크#
태스크는 메인 프로그램과 나란히 레이블을 실행합니다. 태스크는 협력형입니다. 한 번에 하나의 코드만 실행되고, 실행 중인 쪽이 양보할 때만 차례를 바꿉니다.
<handle> AS TASKHANDLE ' 또는 AS JOB. 선택 사항
STARTTASK <handle>, <Label>
AWAITTASK <handle>
AWAITALL <handle>, <handle> [, <handle>…]
AWAITANY <handle>, <handle> [, <handle>…]
CANCELTASK <handle>
YieldTask()
<Label>:
[statements]
RETURN <value>
태스크를 시작하고 결과 기다리기#
job AS TASKHANDLE
STARTTASK job, CountDown
Console("started") ' started
AWAITTASK job
Console("result " + Str(TaskResult(job))) ' result 42
END
CountDown:
FOR i = 3 TO 1 STEP -1
Console("tick " + Str(i)) ' tick 3, tick 2, tick 1
Wait(0.5)
NEXT
RETURN 42
STARTTASK는 태스크를 그 자리에서 실행하지 않습니다. 메인 프로그램이 다음에 양보할 때(Sync(),Wait(),AWAITTASK…) 태스크가 시작됩니다. 그래서started가 먼저 나옵니다.- 태스크는
RETURN value로 끝나는 레이블입니다. 그 값을TaskResult가 돌려줍니다. 값 없는RETURN은 쓸 수 있는 결과를 남기지 않습니다. - 태스크는 프로그램의 변수를 공유합니다. 태스크가 점수를 갱신하면 메인 루프가 다음 줄에서 새 값을 봅니다.
- 태스크는 다른 태스크를 시작하고 기다릴 수 있습니다.
AWAITTASK,AWAITALL,AWAITANY는FUNCTION안에서 거부됩니다.Wait()와 같습니다.STARTTASK와CANCELTASK는 거기서 허용됩니다.
⚠️ 레이블 안에서는 양보마다 자기 줄을 주세요. 컴파일러는 레이블의 줄을 읽어서 기다리는지 판단합니다. 한 줄짜리 IF … THEN Sync()나 IF … THEN Wait(1)을 놓치고, Sync(), Swap(), YieldTask() 뒤에 주석이 붙은 것도 놓칩니다. 그러면 컴파일 때는 오류 없이 프로그램이 시작되지 못합니다. 블록 IF를 쓰고, 아래 예제처럼 주석은 위 줄에 두세요.
핸들#
STARTTASK는 변수가 없으면 OPTION EXPLICIT 아래에서도 변수를 만듭니다. AS TASKHANDLE(또는 같은 타입인 AS JOB)로 선언하면 타입을 줍니다.
NULL로 시작합니다;- 태스크가 아닌 것은 거부합니다.
job = 5는 프로그램을BASIC value is not a task handle로 멈춥니다.
⚠️ 핸들은 일반 변수입니다. STARTTASK jobs[1], Worker는 지원되지 않습니다. 태스크를 변수에 시작한 다음 배열에 복사하세요.
태스크의 상태 읽기#
| 호출 | 결과 |
|---|---|
TaskDone(h) | 태스크가 반환했으면 참 |
TaskFailed(h) | 태스크가 오류로 멈췄으면 참 |
TaskCancelled(h) | 그 태스크에 CANCELTASK가 호출되면 즉시 참 |
TaskResult(h) | RETURN 값. 태스크가 끝나지 않았거나 실패했으면 오류 |
⚠️ 이 넷은 1이나 0이 아니라 참 또는 거짓으로 답합니다. 그대로 또는 NOT과 함께 검사하세요. IF TaskDone(h) THEN …. IF TaskDone(h) = 1로 쓰면 검사는 항상 거짓이고, Str(TaskDone(h))는 true를 출력합니다.
메인 루프에서 폴링하면 작업이 진행되는 동안에도 게임이 계속 그려집니다.
loader AS TASKHANDLE
STARTTASK loader, LoadLevel
DO
IF TaskDone(loader)
Console("rooms: " + Str(TaskResult(loader))) ' rooms: 3
EXIT
ENDIF
Print("Loading...")
Sync()
LOOP
Console("play") ' play
LoadLevel:
FOR room = 1 TO 3
' 프레임당 방 하나
Sync()
NEXT
RETURN 3
태스크 안의 오류#
태스크 안의 오류는 프로그램을 멈추지 않습니다. 태스크는 실패로 표시되고, 오류는 기다리는 곳으로 돌아옵니다.
t AS TASKHANDLE
STARTTASK t, Reload
TRY
AWAITTASK t
CATCH e$
Console("caught: " + e$) ' caught: out of ammo
ENDTRY
IF TaskFailed(t) THEN Console("failed") ' failed
END
Reload:
Wait(0.2)
THROW "out of ammo"
RETURN 0
| 기다리기 | 태스크가 실패했을 때 |
|---|---|
AWAITTASK h | 태스크의 오류를 일으킴 |
AWAITALL a, b | 처음 만난 오류를 일으킴 |
AWAITANY a, b | 아무것도 일으키지 않음. 나중에 TaskFailed를 검사하세요 |
TaskResult(h) | 태스크의 오류를 일으킴 |
오류는 오류에서 다룹니다.
태스크 취소#
CANCELTASK h는 태스크에 멈추라고 요청합니다. 태스크는 다음 양보 지점에서 멈춥니다. Wait(), Sleep(), Sync(), Swap(), YieldTask()입니다. 보통 그 양보 뒤의 코드는 실행되지 않습니다. 예외는 TRY 안의 양보입니다. 아래를 보세요.
slow AS TASKHANDLE
fast AS TASKHANDLE
STARTTASK slow, Slow
STARTTASK fast, Fast
AWAITANY slow, fast
IF TaskDone(fast) THEN Console("fast finished first") ' fast finished first
CANCELTASK slow
AWAITALL slow, fast
IF TaskCancelled(slow) THEN Console("slow cancelled") ' slow cancelled
END
Slow:
Wait(10)
Console("never printed")
RETURN 1
Fast:
Sync()
RETURN 2
TaskCancelled는 즉시 참이 되고, 취소된 태스크에 대한AWAITTASK는 오류 없이 즉시 반환합니다.- 취소된 태스크의
TaskResult는 오류입니다. 결과가 없습니다. - 이미 끝난 태스크에 대한
CANCELTASK는 아무것도 하지 않습니다. - ⚠️
STARTTASK직후에 취소한 태스크는 아직 시작되지 않았기 때문에 첫 번째 양보 지점까지는 그래도 실행됩니다. - ⚠️ 양보하지 않는 태스크는 멈출 수 없습니다.
RETURN까지 한 번에 실행됩니다. 태스크 안의AWAITTASK도 취소 지점이 아닙니다. - ⚠️ 양보를 감싼
TRY는 취소를 잡습니다. 그CATCH는BASIC task cancelled메시지를 받고,ENDTRY뒤의 코드는 다음 양보까지 계속 실행됩니다. 취소를 통과시키려면 다시 던지세요.CATCH e$, 그다음IF e$ = "BASIC task cancelled", 그다음RETHROW입니다.
스레드가 없는 이유#
메모리를 공유하는 스레드는 의도적으로 뺐습니다. "아직"이 아니라 뺀 것입니다.
태스크에서는 한 번에 하나의 코드만 실행되고, 전환은 양보 지점에서만 일어납니다. 두 양보 지점 사이에는 아무것도 변수를 건드릴 수 없습니다. 락이 필요 없고, 찾아다녀야 할 데이터 레이스도 없습니다.
PureBasic은 뮤텍스가 있는 CreateThread를 제공하고, AGK와 DarkBASIC에는 태스크가 아예 없습니다. aukimi에서 진짜 병렬 작업은 다른 곳으로 갑니다.
- 무거운 수치 계산은 GPU로 갑니다. GPU 컴퓨트를 참고하세요;
CreateWorker는 JavaScript로 작성한 Web Worker를 시작합니다. JSON 메시지를 주고받으며 메모리는 공유하지 않습니다.
제한과 흔한 걸림돌#
Sync()는 순차형WHILE루프를 멈춥니다.END를 추가하거나DO … LOOP를 쓰세요.DO … LOOP는 최상위에 하나. 다른 루프는WHILE이나REPEAT입니다.FUNCTION안에서는 기다릴 수 없습니다.GOSUB가 있는 레이블이나 태스크를 쓰세요.Wait는 초,Sleep은 밀리초. 둘 다 게임 시간 기준입니다.Print는 매 프레임,Console은 한 번.- 태스크 상태는 그대로 검사하세요.
IF TaskDone(h)이며= 1은 안 됩니다. - 레이블 안에서는 양보마다 자기 줄에.
IF … THEN Sync()도,Sync()뒤의 주석도 안 됩니다.