Difference between revisions of "love.keyboard.isDown"

(Back to a more consistent overview)
Line 3: Line 3:
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
down = love.keyboard.isDown( key[, key2, key3, ...] )
+
down = love.keyboard.isDown( key )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
 
{{param|KeyConstant|key|The key to check.}}
 
{{param|KeyConstant|key|The key to check.}}
{{New feature|0.7.2|
 
{{param|KeyConstant|keyN|A key to check}}
 
|072}}
 
 
=== Returns ===
 
=== Returns ===
{{param|boolean|down|True if the any supplied key is down, false if not.}}
+
{{param|boolean|down|True if the key is down, false if not.}}
 +
== Function ==
 +
{{newin|[[0.7.2]]|072|type=variant}}
 +
=== Synopsis ===
 +
<source lang="lua">
 +
anyDown = love.keyboard.isDown( key1, key2, key3, ... )
 +
</source>
 +
=== Arguments ===
 +
{{param|KeyConstant|keyN|A key to check.}}
 +
=== Returns ===
 +
{{param|boolean|anyDown|True if any supplied key is down, false if not.}}
 
== Examples ==
 
== Examples ==
 
=== Increase a value while a key is held down ===
 
=== Increase a value while a key is held down ===

Revision as of 16:22, 20 November 2012

Checks whether a certain key is down. Not to be confused with love.keypressed or love.keyreleased.

Function

Synopsis

down = love.keyboard.isDown( key )

Arguments

KeyConstant key
The key to check.

Returns

boolean down
True if the key is down, false if not.

Function

Available since LÖVE 0.7.2
This variant is not supported in earlier versions.

Synopsis

anyDown = love.keyboard.isDown( key1, key2, key3, ... )

Arguments

KeyConstant keyN
A key to check.

Returns

boolean anyDown
True if any supplied key is down, false if not.

Examples

Increase a value while a key is held down

val = 0   -- establish a variable for later use
function love.update(dt)
	if love.keyboard.isDown("up") then
		val = val + dt   -- we will increase the variable by 1 for every second the key is held down
	end	
end

See Also


Other Languages