Difference between revisions of "love.mouse.isDown"
(more functional example, more see alsos) |
Radgerayden (talk | contribs) (→Arguments) |
||
| (10 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
Checks whether a certain mouse button is down. | Checks whether a certain mouse button is down. | ||
| + | |||
| + | This function does not detect mouse wheel scrolling; you must use the [[love.wheelmoved]] (or [[love.mousepressed]] in version [[0.9.2]] and older) callback for that. | ||
| + | |||
== Function == | == Function == | ||
| + | {{newin|[[0.10.0]]|100|type=variant}} | ||
| + | === Synopsis === | ||
| + | <source lang="lua"> | ||
| + | down = love.mouse.isDown( button, ... ) | ||
| + | </source> | ||
| + | === Arguments === | ||
| + | {{param|number|button|The index of a button to check. 1 is the primary mouse button, 2 is the secondary mouse button and 3 is the middle button. Further buttons are mouse dependant.}} | ||
| + | {{param|number|...|Additional button numbers to check.}} | ||
| + | |||
| + | === Returns === | ||
| + | {{param|boolean|down|True if any specified button is down.}} | ||
| + | |||
| + | == Function == | ||
| + | {{oldin|[[0.10.0]]|100|type=variant}} | ||
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
| Line 10: | Line 27: | ||
{{param|boolean|down|True if the specified button is down.}} | {{param|boolean|down|True if the specified button is down.}} | ||
== Function == | == Function == | ||
| − | {{ | + | {{newinoldin|[[0.7.2]]|072|[[0.10.0]]|100|type=variant}} |
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
| Line 19: | Line 36: | ||
=== Returns === | === Returns === | ||
{{param|boolean|anyDown|True if any specified button is down, false otherwise.}} | {{param|boolean|anyDown|True if any specified button is down, false otherwise.}} | ||
| + | |||
== Example == | == Example == | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== Increase a value while the right mouse button is held === | === Increase a value while the right mouse button is held === | ||
<source lang="lua"> | <source lang="lua"> | ||
val = 0 -- establish a variable for later use | val = 0 -- establish a variable for later use | ||
function love.update(dt) | function love.update(dt) | ||
| − | if love.mouse.isDown( | + | if love.mouse.isDown(2) then |
val = val + dt -- we will increase the variable by 1 for every second the button is held down | val = val + dt -- we will increase the variable by 1 for every second the button is held down | ||
end | end | ||
end | end | ||
</source> | </source> | ||
| + | |||
== See Also == | == See Also == | ||
* [[MouseConstant|Mouse Constant / buttons]] | * [[MouseConstant|Mouse Constant / buttons]] | ||
Revision as of 11:58, 5 January 2016
Checks whether a certain mouse button is down.
This function does not detect mouse wheel scrolling; you must use the love.wheelmoved (or love.mousepressed in version 0.9.2 and older) callback for that.
Contents
Function
| Available since LÖVE 0.10.0 |
| This variant is not supported in earlier versions. |
Synopsis
down = love.mouse.isDown( button, ... )
Arguments
number button- The index of a button to check. 1 is the primary mouse button, 2 is the secondary mouse button and 3 is the middle button. Further buttons are mouse dependant.
number ...- Additional button numbers to check.
Returns
boolean down- True if any specified button is down.
Function
| Removed in LÖVE 0.10.0 |
| This variant is not supported in that and later versions. |
Synopsis
down = love.mouse.isDown( button )
Arguments
MouseConstant button- The button to check.
Returns
boolean down- True if the specified button is down.
Function
| Available since LÖVE 0.7.2 and removed in LÖVE 0.10.0 |
| This variant is not supported in earlier or later versions. |
Synopsis
anyDown = love.mouse.isDown( button1, button2, button3, ... )
Arguments
MouseConstant buttonN- A button to check.
Returns
boolean anyDown- True if any specified button is down, false otherwise.
Example
Increase a value while the right mouse button is held
val = 0 -- establish a variable for later use
function love.update(dt)
if love.mouse.isDown(2) then
val = val + dt -- we will increase the variable by 1 for every second the button is held down
end
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
