love.mouse.isDown

Checks whether a certain mouse button is down.

Function

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

This variant is not supported in earlier 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

if love.mouse.isDown("r") then
   -- do something awesome
end

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("r") then
		val = val + dt   -- we will increase the variable by 1 for every second the button is held down
	end	
end

See Also

• Mouse Constant / buttons
• love.mouse
• love.mousepressed
• love.mousereleased
• love.keyboard.isDown

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