The callback functions in LÖVE are used by the engine to perform various tasks and are all optional. However, a fully-featured game experience would probably utilize nearly all of them, so it's wise to know what they are.
function love.load() image = love.graphics.newImage("cake.jpg") local f = love.graphics.newFont(12) love.graphics.setFont(f) love.graphics.setColor(0,0,0,255) love.graphics.setBackgroundColor(255,255,255) end
This function gets called only once, when the game is started, and is usually where you would load resources, initialize variables and set specific settings. All those things can be done anywhere else as well, but doing them here means that they are done once only, saving a lot of system resources.
function love.update(dt) if love.keyboard.isDown("up") then num = num + 100 * dt -- this would increment num by 100 per second end end
This function is called continuously and will probably be where most of your math is done. 'dt' stands for "delta time" and is the amount of seconds since the last time this function was called (which is usually a small value like 0.025714).
function love.draw() love.graphics.draw(image, imgx, imgy) love.graphics.print("Click and drag the cake around or use the arrow keys", 10, 10) end
love.draw is where all the drawing happens (if that wasn't obvious enough already) and if you call any of the
love.graphics.draw outside of this function then it's not going to have any effect. This function is also called continuously so keep in mind that if you change the font/color/mode/etc at the end of the function then it will have a effect on things at the beginning of the function. For example:
function love.load() love.graphics.setColor(0,0,0) end function love.draw() love.graphics.print("This text is not black because of the line below", 100, 100) love.graphics.setColor(255,0,0) love.graphics.print("This text is red", 100, 200) end
function love.mousepressed(x, y, button) if button == 'l' then imgx = x -- move image to where mouse clicked imgy = y end end
This function is called whenever a mouse button is pressed and it receives the button and the coordinates of where it was pressed. The button can be any of the constants. This function goes very well along with
function love.mousereleased(x, y, button) if button == 'l' then fireSlingshot(x,y) -- this totally awesome custom function is defined elsewhere end end
This function is called whenever a mouse button is released and it receives the button and the coordinates of where it was released. You can have this function together with
love.mousepressed or separate, they aren't connected in any way.
function love.keypressed(key, unicode) if key == 'b' then text = "The B key was pressed." elseif key == 'a' then a_down = true end end
function love.keyreleased(key, unicode) if key == 'b' then text = "The B key was released." elseif key == 'a' then a_down = false end end
This function is called whenever a keyboard key is released and receives the key that was released. You can have this function together with
love.keypressed or separate, they aren't connected in any way.
function love.focus(f) if not f then print("LOST FOCUS") else print("GAINED FOCUS") end end
This function is called whenever the user clicks off and on the LOVE window. For instance, if he is playing a windowed game and a user clicks on his internet browser, the game could be notified and automatically pause the game.
function love.quit() print("Thanks for playing! Come back soon!") end
This function is called whenever the user clicks the windows close button (often an X). For instance, if the user decides he is done playing, he could click the close button. Then, before it closes, the game can save its state.
Those are the callback functions and their basic usage.