Difference between revisions of "love.keyreleased"

m
(13 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Callback function triggered when a key is released.
+
Callback function triggered when a keyboard key is released.
 +
 
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
love.keyreleased( key )
+
love.keyreleased( key, scancode )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|KeyConstant|key|Character of the key released.}}
+
{{param|KeyConstant|key|Character of the released key.}}
 +
{{New feature|0.10.0|
 +
{{param|Scancode|scancode|The scancode representing the released key.}} }}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
=== Notes ===
 +
[[Scancode]]s are keyboard layout-independent, so the scancode "w" will be used 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.
 +
 +
== Examples ==
 +
Exit the game when the player releases the Escape key, using [[love.event.quit]].
 +
<source lang="lua">
 +
function love.keyreleased(key)
 +
  if key == "escape" then
 +
      love.event.quit()
 +
  end
 +
end
 +
</source>
 
== See Also ==
 
== See Also ==
 
* [[parent::love]]
 
* [[parent::love]]
 +
* [[love.keypressed]]
 +
* [[love.keyboard.isDown]]
 
[[Category:Callbacks]]
 
[[Category:Callbacks]]
{{#set:Description=Callback function triggered when a key is released.}}
+
{{#set:Description=Callback function triggered when a keyboard key is released.}}
 +
{{#set:Subcategory=Keyboard}}
 +
{{#set:Since=000}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.keyreleased}}
 
{{i18n|love.keyreleased}}

Revision as of 22:30, 7 March 2019

Callback function triggered when a keyboard key is released.

Function

Synopsis

love.keyreleased( key, scancode )

Arguments

KeyConstant key
Character of the released key.
Available since LÖVE 0.10.0
Scancode scancode
The scancode representing the released key.

Returns

Nothing.

Notes

Scancodes are keyboard layout-independent, so the scancode "w" will be used 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.

Examples

Exit the game when the player releases the Escape key, using love.event.quit.

function love.keyreleased(key)
   if key == "escape" then
      love.event.quit()
   end
end

See Also


Other Languages