Difference between revisions of "love.keyboard.setKeyRepeat"

(Replaced example (much simpler, doesn't involve AnAL))
m (→‎Examples: Fixed arguments of love.keypressed (scancode parameter added))
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
Enables or disables key repeat for [[love.keypressed]]. It is disabled by default.
 +
== Function ==
 +
{{newin|[[0.9.0]]|090|type=variant}}
 +
=== Synopsis ===
 +
<source lang="lua">
 +
love.keyboard.setKeyRepeat( enable )
 +
</source>
 +
=== Arguments ===
 +
{{param|boolean|enable|Whether repeat keypress events should be enabled when a key is held down.}}
 +
=== Returns ===
 +
Nothing.
 +
=== Notes ===
 +
The interval between repeats depends on the user's system settings. This function doesn't affect whether [[love.textinput]] is called multiple times while a key is held down.
 +
 +
== Function ==
 +
{{oldin|[[0.9.0]]|090|type=variant}}
 
Enables key repeating and sets the delay and interval.
 
Enables key repeating and sets the delay and interval.
−
== Function ==
 
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
−
love.keyboard.setKeyRepeat( delay, Interval )
+
love.keyboard.setKeyRepeat( delay, interval )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
−
{{param|number|delay|The amount of time before repeating the key (in milliseconds). 0 disables key repeat.}}
+
{{param|number|delay|The amount of time before repeating the key (in seconds). 0 disables key repeat.}}
−
{{param|number|Interval|The amount of time between repeats (in milliseconds)}}
+
{{param|number|interval|The amount of time between repeats (in seconds)}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
 
== Examples ==
 
== Examples ==
−
=== Hold key to continue moving left or right ===
+
Hold left or right to change the position.
−
Please note that a generally better way to move an object would be to put code in [[love.update]]() which uses [[love.keyboard.isDown]]. This is just an example.
 
 
<source lang="lua">
 
<source lang="lua">
 
function love.load()
 
function love.load()
−
x = 400
+
love.keyboard.setKeyRepeat(true)
−
love.keyboard.setKeyRepeat(10, 200)
+
x = 50
 
end
 
end
  
−
function love.keypressed(key)
+
function love.keypressed(key, scancode, isrepeat)
−
if key == "left" then x = x - 20
+
if key == "right" then
−
elseif key == "right" then x = x + 20
+
x = (x + 80) % love.graphics.getWidth()
 +
elseif key == "left" then
 +
x = (x - 80) % love.graphics.getWidth()
 
end
 
end
 
end
 
end
  
 
function love.draw()
 
function love.draw()
−
love.graphics.circle("fill", x,300, 30,30)
+
love.graphics.circle("fill", x, 100, 50, 50)
 
end
 
end
 
</source>
 
</source>
Line 32: Line 49:
 
== See Also ==
 
== See Also ==
 
* [[parent::love.keyboard]]
 
* [[parent::love.keyboard]]
 +
* [[love.keyboard.hasKeyRepeat]]
 +
* [[love.keypressed]]
 
[[Category:Functions]]
 
[[Category:Functions]]
−
{{#set:Description=Enables key repeating and sets the delay and interval.}}
+
{{#set:Description=Enables or disables key repeat for [[love.keypressed]].}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.keyboard.setKeyRepeat}}
 
{{i18n|love.keyboard.setKeyRepeat}}

Latest revision as of 09:46, 16 April 2020

Enables or disables key repeat for love.keypressed. It is disabled by default.

Function

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

Synopsis

love.keyboard.setKeyRepeat( enable )

Arguments

boolean enable
Whether repeat keypress events should be enabled when a key is held down.

Returns

Nothing.

Notes

The interval between repeats depends on the user's system settings. This function doesn't affect whether love.textinput is called multiple times while a key is held down.

Function

Removed in LÖVE 0.9.0
This variant is not supported in that and later versions.

Enables key repeating and sets the delay and interval.

Synopsis

love.keyboard.setKeyRepeat( delay, interval )

Arguments

number delay
The amount of time before repeating the key (in seconds). 0 disables key repeat.
number interval
The amount of time between repeats (in seconds)

Returns

Nothing.

Examples

Hold left or right to change the position. 

function love.load()
	love.keyboard.setKeyRepeat(true)
	x = 50
end

function love.keypressed(key, scancode, isrepeat)
	if key == "right" then
		x = (x + 80) % love.graphics.getWidth()
	elseif key == "left" then
		x = (x - 80) % love.graphics.getWidth()
	end
end

function love.draw()
	love.graphics.circle("fill", x, 100, 50, 50)
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

Retrieved from "https://love2d.org./w/index.php?title=love.keyboard.setKeyRepeat&oldid=25244"