##### Views

- Page
- Discussion
- View source
- History

# 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

Retrieved from "https://www.love2d.org/wiki/love.mouse.getSystemCursor"
Categories: Templates | Functions

##### Personal tools

- Log in

##### Search

##### Toolbox

- What links here
- Related changes
- Special pages
- Printable version
- Permanent link
- Browse properties