Difference between revisions of "love.keypressed"
m (Removed duplicated example) |
|||
| Line 13: | Line 13: | ||
=== Returns === | === Returns === | ||
Nothing. | Nothing. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== Notes === | === Notes === | ||
[[Scancode]]s are keyboard layout-independent, so the scancode "w" will be generated if the key in the same place as the "w" key on an [https://en.wikipedia.org/wiki/British_and_American_keyboards#/media/File:KB_United_States-NoAltGr.svg American keyboard] is pressed, no matter what the key is labelled or what the user's operating system settings are. | [[Scancode]]s are keyboard layout-independent, so the scancode "w" will be generated if the key in the same place as the "w" key on an [https://en.wikipedia.org/wiki/British_and_American_keyboards#/media/File:KB_United_States-NoAltGr.svg American keyboard] is pressed, no matter what the key is labelled or what the user's operating system settings are. | ||
| Line 55: | Line 46: | ||
Exit the game when the player presses the Escape key, using [[love.event.quit]]. | Exit the game when the player presses the Escape key, using [[love.event.quit]]. | ||
<source lang="lua"> | <source lang="lua"> | ||
| − | function love.keypressed(key) | + | function love.keypressed(key, scancode, isrepeat) |
if key == "escape" then | if key == "escape" then | ||
love.event.quit() | love.event.quit() | ||
| Line 61: | Line 52: | ||
end | end | ||
</source> | </source> | ||
| − | |||
{{oldin|[[0.9.0]]|090|type=example|text=Text input is now handled separately via [[love.textinput]]}} | {{oldin|[[0.9.0]]|090|type=example|text=Text input is now handled separately via [[love.textinput]]}} | ||
Revision as of 08:51, 15 February 2019
Callback function triggered when a key is pressed.
Contents
Function
| Available since LÖVE 0.10.0 |
| This variant is not supported in earlier versions. |
Synopsis
love.keypressed( key, scancode, isrepeat )
Arguments
KeyConstant key- Character of the pressed key.
Scancode scancode- The scancode representing the pressed key.
boolean isrepeat- Whether this keypress event is a repeat. The delay between key repeats depends on the user's system settings.
Returns
Nothing.
Notes
Scancodes are keyboard layout-independent, so the scancode "w" will be generated if the key in the same place as the "w" key on an American keyboard is pressed, no matter what the key is labelled or what the user's operating system settings are.
Key repeat needs to be enabled with love.keyboard.setKeyRepeat for repeat keypress events to be received. This does not affect love.textinput.
Function
| Available since LÖVE 0.9.0 and removed in LÖVE 0.10.0 |
| This variant is not supported in earlier or later versions. |
Synopsis
love.keypressed( key, isrepeat )
Arguments
KeyConstant key- Character of the key pressed.
boolean isrepeat- Whether this keypress event is a repeat. The delay between key repeats depends on the user's system settings.
Returns
Nothing.
Notes
Key repeat needs to be enabled with love.keyboard.setKeyRepeat for repeat keypress events to be received.
Function
| Removed in LÖVE 0.9.0 |
| Unicode text input is now handled separately via love.textinput. |
Synopsis
love.keypressed( key, unicode )
Arguments
KeyConstant key- Character of the key pressed.
number unicode- The unicode number of the key pressed.
Returns
Nothing.
Examples
Exit the game when the player presses the Escape key, using love.event.quit.
function love.keypressed(key, scancode, isrepeat)
if key == "escape" then
love.event.quit()
end
end
| Removed in LÖVE 0.9.0 |
| Text input is now handled separately via love.textinput. |
Record and print text the user writes (0.8.0 and below.)
function love.load()
text = "Type away! -- "
end
function love.keypressed(key, unicode)
-- ignore non-printable characters (see http://www.ascii-code.com/)
if unicode > 31 and unicode < 127 then
text = text .. string.char(unicode)
end
end
function love.draw()
love.graphics.printf(text, 0, 0, 800)
end
See Also
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
