love (简体中文)
当你开始用LÖVE编写游戏时, 需要了解几个最重要的API回调函数: love.load仅执行一次,用于初始化加载你的游戏, love.update用于管理你的游戏每一帧的状态, love.draw用于渲染你的游戏到屏幕.
为了处理玩家输入的信息以及呈现一个全方面体验的游戏,很多交互将会重写额外的回调函数.
LÖVE提供了默认的空回调函数,你可以通过对应的回调函数名在你自己的代码里重写这些函数:
-- 初始化矩形的一些默认值.
function love.load()
x, y, w, h = 20, 20, 60, 20
end
-- 每一帧变大矩形的尺寸.
function love.update(dt)
w = w + 1
h = h + 1
end
-- 渲染颜色矩形.
function love.draw()
love.graphics.setColor(0, 100, 100)
love.graphics.rectangle("fill", x, y, w, h)
end
Contents
Modules(模块)
love.audio | Provides of audio interface for playback/recording sound. | ||
love.data | Provides functionality for creating and transforming data. | 11.0 | |
love.event | Manages events, like keypresses. | 0.6.0 | |
love.filesystem | Provides an interface to the user's filesystem. | ||
love.font | Allows you to work with fonts. | 0.7.0 | |
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. | 0.5.0 | |
love.keyboard | Provides an interface to the user's keyboard. | ||
love.math | Provides system-independent mathematical functions. | 0.9.0 | |
love.mouse | Provides an interface to the user's mouse. | ||
love.physics | Can simulate 2D rigid body physics in a realistic manner. | 0.4.0 | |
love.sound | This module is responsible for decoding sound files. | ||
love.system | Provides access to information about the user's system. | 0.9.0 | |
love.thread | Allows you to work with threads. | 0.7.0 | |
love.timer | Provides high-resolution timing functionality. | ||
love.touch | Provides an interface to touch-screen presses. | 0.10.0 | |
love.video | This module is responsible for decoding and streaming video files. | 0.10.0 | |
love.window | Provides an interface for the program's window. | 0.9.0 |
Third-party modules(第三方模块)
lua-enet | Multiplayer networking module for games. | 0.9.0 | |
socket | Module for HTTP, TCP, and UDP networking. | 0.5.0 | |
utf8 | Provides basic support for manipulating UTF-8 strings. | 0.9.2 |
Functions(方法)
love.getVersion | Gets the current running version of LÖVE. | 0.9.1 | |
love.hasDeprecationOutput | Gets whether LÖVE displays warnings when using deprecated functionality. | 11.0 | |
love.isVersionCompatible | Gets whether the given version is compatible with the current running version of LÖVE. | 0.10.0 | |
love.setDeprecationOutput | Sets whether LÖVE displays warnings when using deprecated functionality. | 11.0 |
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(回调)
General(通用)
Config Files | Game configuration settings. | ||
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. | 11.0 | |
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. | 0.10.0 | |
love.quit | Callback function triggered when the game is closed. | 0.7.0 | |
love.run | The main function, containing the main loop. A sensible default is used when left out. | ||
love.threaderror | Callback function triggered when a Thread encounters an error. | 0.9.0 | |
love.update | Callback function used to update the state of the game every frame. |
Joystick(操作杆)
love.gamepadaxis | Called when a Joystick's virtual gamepad axis is moved. | 0.9.0 | |
love.gamepadpressed | Called when a Joystick's virtual gamepad button is pressed. | 0.9.0 | |
love.gamepadreleased | Called when a Joystick's virtual gamepad button is released. | 0.9.0 | |
love.joystickadded | Called when a Joystick is connected. | 0.9.0 | |
love.joystickaxis | Called when a joystick axis moves. | 0.9.0 | |
love.joystickhat | Called when a joystick hat direction changes. | 0.9.0 | |
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. | 0.9.0 |
其他语言
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