love.mouse.getSystemCursor

Available since LÖVE 0.9.0

This function is not supported in earlier versions.

Gets a Cursor object representing a system-native hardware cursor.

Hardware cursors are framerate-independent and work the same way as normal operating system cursors. Unlike drawing an image at the mouse's current coordinates, hardware cursors never have visible lag between when the mouse is moved and when the cursor position updates, even at low framerates.

Function

Synopsis

cursor = love.mouse.getSystemCursor( ctype )

Arguments

CursorType ctype

The type of system cursor to get.

Returns

Cursor cursor

The Cursor object representing the system cursor type.

Notes

The "image" CursorType is not a valid argument. Use love.mouse.newCursor to create a hardware cursor using a custom image.

Examples

function love.load()
    i_beam_cursor = love.mouse.getSystemCursor("ibeam")
    love.mouse.setCursor(i_beam_cursor)
end

See Also

• love.mouse
• love.mouse.setCursor
• Cursor

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