love

The root module which contains all the other modules. Clearly the loveliest module of all.

When beginning to write games using LÖVE, the most important parts of the API are the callbacks: love.load to do one-time setup of your game, love.update which is used to manage your game's state frame-to-frame, and love.draw which is used to render the game state onto the screen.

More interactive games will override additional callbacks in order to handle input from the user, and other aspects of a full-featured game.

LÖVE provides default placeholders for these callbacks, which you can override inside your own code, simply by specifying their fully qualified name:

function love.load()
   hamster = love.graphics.newImage("hamster.png")
   x = 50
   y = 50
end
function love.draw()
   love.graphics.draw(hamster, x, y)
end

Modules

love.audio	Provides of audio interface for playback/recording sound.
love.data	Provides functionality for creating and transforming data.
love.event	Manages events, like keypresses.
love.filesystem	Provides an interface to the user's filesystem.
love.font	Allows you to work with fonts.
love.graphics	Drawing of shapes and images, management of screen geometry.
love.image	Provides an interface to decode encoded image data.
love.joystick	Provides an interface to connected joysticks.
love.keyboard	Provides an interface to the user's keyboard.
love.math	Provides system-independent mathematical functions.
love.mouse	Provides an interface to the user's mouse.
love.physics	Can simulate 2D rigid body physics in a realistic manner.
love.sound	This module is responsible for decoding sound files.
love.system	Provides access to information about the user's system.
love.thread	Allows you to work with threads.
love.timer	Provides high-resolution timing functionality.
love.touch	Provides an interface to touch-screen presses.
love.video	This module is responsible for decoding and streaming video files.
love.window	Provides an interface for the program's window.

Types

Data	The superclass of all data.
Object	The superclass of all LÖVE types.
Variant	The types supported by love.thread and love.event.

Callbacks

Config Files	Game configuration settings.
love.directorydropped	Callback function triggered when a directory is dragged and dropped onto the window.
love.displayrotated	Called when the device display orientation changed.
love.draw	Callback function used to draw on the screen every frame.
love.errhand	The error handler, used to display error messages.
love.errorhandler	The error handler, used to display error messages.
love.filedropped	Callback function triggered when a file is dragged and dropped onto the window.
love.focus	Callback function triggered when window receives or loses focus.
love.gamepadaxis	Called when a Joystick's virtual gamepad axis is moved.
love.gamepadpressed	Called when a Joystick's virtual gamepad button is pressed.
love.gamepadreleased	Called when a Joystick's virtual gamepad button is released.
love.joystickadded	Called when a Joystick is connected.
love.joystickaxis	Called when a joystick axis moves.
love.joystickhat	Called when a joystick hat direction changes.
love.joystickpressed	Called when a joystick button is pressed.
love.joystickreleased	Called when a joystick button is released.
love.joystickremoved	Called when a Joystick is disconnected.
love.keypressed	Callback function triggered when a key is pressed.
love.keyreleased	Callback function triggered when a keyboard key is released.
love.load	This function is called exactly once at the beginning of the game.
love.lowmemory	Callback function triggered when the system is running out of memory on mobile devices.
love.mousefocus	Callback function triggered when window receives or loses mouse focus.
love.mousemoved	Callback function triggered when the mouse is moved.
love.mousepressed	Callback function triggered when a mouse button is pressed.
love.mousereleased	Callback function triggered when a mouse button is released.
love.quit	Callback function triggered when the game is closed.
love.resize	Called when the window is resized.
love.run	The main function, containing the main loop. A sensible default is used when left out.
love.textedited	Called when the candidate text for an IME has changed.
love.textinput	Called when text has been entered by the user.
love.threaderror	Callback function triggered when a Thread encounters an error.
love.touchmoved	Callback function triggered when a touch press moves inside the touch screen.
love.touchpressed	Callback function triggered when the touch screen is touched.
love.touchreleased	Callback function triggered when the touch screen stops being touched.
love.update	Callback function used to update the state of the game every frame.
love.visible	Callback function triggered when window is shown or hidden.
love.wheelmoved	Callback function triggered when the mouse wheel is moved.

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info