love.mouse.setCursor

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

Sets the current mouse cursor.

Function

Synopsis

love.mouse.setCursor( cursor )

Arguments

Cursor cursor
The Cursor object to use as the current mouse cursor.

Returns

Nothing.

Function

Synopsis

love.mouse.setCursor( )

Arguments

None.

Returns

Nothing.

Notes

Resets the current mouse cursor to the default.

Examples

function love.load()
    cursor = love.mouse.getSystemCursor("hand")

--  Or:
--  cursor = love.mouse.newCursor("pig.png", 0, 0)
end

function love.mousepressed(x, y, button)
    if button == "l" then
        -- Use a custom cursor when the left mouse button is pressed.
        love.mouse.setCursor(cursor)
    end
end

function love.mousereleased(x, y, button)
    if button == "l" then
        -- Go back to the default cursor when the left mouse button is released.
        love.mouse.setCursor()
    end
end

See Also

Other Languages

Personal tools