[💬] Love2D 모듈 알아보기: love 이름 공간과 콜백 함수

[토끼주문(icyselec)]

Love2D 모듈 알아보기: love 이름 공간과 콜백 함수

[love 이름 공간]
Love2D 프레임워크는 모든 내장 모듈과 콜백 함수들을 'love'라고 부르는 이름 공간 아래에 배치한다. 이름 공간은 테이블로 구현되어 있으며 실행 시간 중에도 유연하게 변경할 수 있다.

conf.lua를 변경하지 않았다면, 다음과 같은 모듈들이 기본적으로 로드되어 있다.
audio
data
event
filesystem
font
graphics
image
joystick
keyboard
math
mouse
physics
sound
system
thread
timer
touch
video
window

이 외에 다른 모듈들은 직접 명시적으로 require 함수를 호출해서 모듈을 불러와야 한다.

또, thread 모듈을 통해 생성된 새로운 스레드는 data, filesystem, thread 모듈을 제외한 다른 모듈을 로드하지 않는다. 이 경우에도 직접 require 함수를 호출해야 한다.

[콜백 함수]
모든 콜백 함수는 반환값이 없다. (예외적으로, love.run과 love.quit는 반환값이 존재한다.) 대신, 이벤트가 발생한 이유나 관련 데이터를 인자로 전달하기 때문에 매개변수에 대한 설명을 달아두었다. 매개변수는 '(이름: 타입, ...)'의 형식으로 표기한다.

Love2D 11.5를 기준으로 다음과 같은 콜백 함수들이 사용되고 있다.
love.conf (t: table)
love.directorydropped (path: string)
love.displayrotated (index: number, orientation: DisplayOrientation)
love.draw ()
love.errorhandler (msg: string)
love.filedropped (file: DroppedFile)
love.focus (focus: boolean)
love.gamepadaxis (joystick: Joystick, axis: GamepadAxis, value: number)
love.gamepadpressed (joystick: Joystick, button: GamepadButton)
love.gamepadreleased (joystick: Joystick, button: GamepadButton)
love.joystickadded (joystick: Joystick)
love.joystickaxis (joystick: Joystick, axis: number, value: number)
love.joystickhat (joystick: Joystick, hat: number, direction: JoystickHat)
love.joystickpressed (joystick: Joystick, button: number)
love.joystickreleased (joystick: Joystick, button: number)
love.joystickremoved (joystick: Joystick)
love.keypressed (key: KeyConstant, scancode: Scancode, isrepeat: boolean)
love.keyreleased (key: KeyConstant, scancode: Scancode)
love.load (arg: table, unfilteredArg: table)
love.lowmemory ()
love.mousefocus (focus: boolean)
love.mousemoved (x: number, y: number, dx: number, dy: number, istouch: boolean)
love.mousepressed (x: number, y: number, button: number, istouch: boolean, presses: number)
love.mousereleased (x: number, y: number, button: number, istouch: boolean, presses: number)
love.quit ()
love.resize (w: number, h: number)
love.run ()
love.textedited (text: string, start: number, length: number)
love.textinput (text: string)
love.threaderror (thread: Thread, errorstr: string)
love.touchmoved (id: light userdata, x: number, y: number, dx: number, dy: number, presses: number)
love.touchpressed (id: light userdata, x: number, y: number, dx: number, dy: number, presses: number)
love.touchreleased (id: light userdata, x: number, y: number, dx: number, dy: number, presses: number)
love.update (dt: number)
love.visible (visible: boolean)
love.wheelmoved (x: number, y: number)

[커스텀 콜백 함수]
콜백 함수는 'love.handlers'에 이름을 등록하면 새로 추가할 수 있다. 만약, 'onGameCrashed'라는 이벤트를 등록하고자 한다면 다음과 같이 하면 된다.
love.handlers['onGameCrashed'] = function () end

love.event.quit는 love.quit와 같지 않다. 특정 이벤트를 발생시킬려면 직접 love.event.push 함수를 사용해서 이벤트의 이름과 인자를 전달하여야 한다.

[자주 쓰이는 콜백 함수]
love.conf (t: table)
t는 설정값을 저장할 테이블이다.

사실 위키 분류에 따르자면 love.conf 함수도 콜백 함수로 취급된다. 왜냐하면, 다른 함수에 의해 불려지기 때문이다.

love.draw ()
화면을 갱신하는데 사용되는 함수이다. 단독으로 호출하지 않고, love.run의 제어를 받는다.

love.errorhandler (msg: string)
msg는 오류가 발생한 원인이다.

error 함수를 호출하거나, 오류가 발생하면 이 콜백 함수가 호출된다.

love.keypressed (key: KeyConstant, scancode: Scancode, isrepeat: boolean)
key는 입력된 키를 나타낸다. scancode는 좀 더 저수준의 제어를 위해 직접 스캔 코드를 나타낸다. isrepeat는 키가 반복되고 있는지를 알린다. 이는 시스템의 설정에 따라 동작이 다를 수도 있다.

키가 입력될 때, 이 콜백 함수가 호출된다.

love.load (arg: table, unfilteredArg: table)
arg는 프로그램 실행 시 같이 전달된 명령 줄 매개변수를 담고 있다, untilteredArg는 arg와 비슷하지만 필터링되지 않은(게임 실행 시 옵션 지정 등) 매개변수를 담고 있다.

love.run 콜백 함수에 의해서 게임 실행 시 최초로 단 한번만 실행된다. 대부분의 코드는 여기서 초기화하는 것이 좋다.

love.mousemoved (x: number, y: number, dx: number, dy: number, istouch: boolean)
x와 y는 현재 마우스의 좌표를 0부터 love.graphics.getWidth()-1, love.graphics.getHeight()-1 사이의 값으로 나타낸다. dx와 dy는 이전 입력과 비교하여 상대적인 좌표를 나타낸다. istouch는 터치스크린의 터치인지 아닌지를 나타낸다.

마우스 입력을 사용할 때, 아래의 mousepressed 콜백 함수와 함께 사용하기 좋은 함수이다.

love.mousepressed (x: number, y: number, button: number, istouch: boolean, presses: number)
button은 입력된 마우스의 버튼을 1=왼쪽, 2=오른쪽, 3=휠 클릭 으로 나타낸다. presses는 몇번을 연속해서 누르는지를 알려주고 이는 짧은 시간 이후 초기화되며 시간 내로 계속 연속 입력하면 값이 증가한다.

love.quit ()
반환값이 true일 경우, 게임 종료를 중단하고 그 이외에 값은 게임을 그대로 종료시킨다.

이 콜백 함수는 게임 종료 직전에 실행되어야 하는 루틴을 작성할 때 유용하다.

love.update (dt: number)
dt는 마지막으로 update가 호출된 이후 지난 시간을 나타낸다.

게임의 업데이트 주기를 알리는 콜백 함수이다. 게임이 작동하려면 없어서는 안될 중요한 콜백 함수이지만, 반드시 게임의 데이터 갱신이 update 함수 내에서만 일어나야 할 필요는 없다.

[이벤트 사용 시 주의점]
1. 이벤트는 반드시 제어가 love.run으로 돌아와야만 실행된다. 다음과 같은 코드는 그 자리에서 즉시 종료하지 않으며, 오류를 일으킨다. 게임을 종료시키는 것은 love.run 함수가 끝날 때이다.
function love.load () local f = nil; if not f then love.event.quit() end f(); end
2. 콜백 함수와 이벤트는 다르다. 정확히는 이벤트가 발생하면 콜백 함수가 호출되는데 콜백 함수가 호출된다고 반드시 이벤트가 발생한 것은 아니다. 아래는 가능한 이벤트들의 목록이다.
directorydropped
displayrotated
errorhandler
filedropped
focus
gamepadaxis
gamepadpressed
gamepadreleased
joystickadded
joystickaxis
joystickhat
joystickpressed
joystickreleased
joystickremoved
keypressed
keyreleased
lowmemory
mousefocus
mousemoved
mousepressed
mousereleased
quit
resize
textedited
textinput
threaderror
touchmoved
touchpressed
touchreleased
visible
wheelmoved
3. 이벤트는 스레드 간에 공유되지 않는다.

[익명(58.29)]