---
name: "enable_hardware_cursor"
section: "3alleg"
platform: "linux"
package: "liballegro-doc"
version: "2:4.2.2-2.2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/enable_hardware_cursor"
---

# enable\_hardware\_cursor(3alleg)

Enables the OS hardware cursor. Allegro game programming library.

## NAME

enable\_hardware\_cursor - Enables the OS hardware cursor. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**void enable\_hardware\_cursor(void);**

## DESCRIPTION

After calling this function, Allegro will let the operating system draw the mouse cursor instead of doing it itself. This is not possible with all graphics drivers though: you'll need to check the gfx\_capabilities flags after calling show\_mouse() to see if this works. On some platforms, enabling the hardware cursor causes get\_mouse\_mickeys() to return only a limited range of values, so you should not call this function if you need mouse  mickeys.

## SEE ALSO

[**install\_mouse**(3alleg)](/install_mouse/3alleg.md), [**show\_mouse**(3alleg)](/show_mouse/3alleg.md), [**set\_mouse\_sprite**(3alleg)](/set_mouse_sprite/3alleg.md), [**get\_mouse\_mickeys**(3alleg)](/get_mouse_mickeys/3alleg.md), [**gfx\_capabilities**(3alleg)](/gfx_capabilities/3alleg.md), [**disable\_hardware\_cursor**(3alleg)](/disable_hardware_cursor/3alleg.md), [**show\_os\_cursor**(3alleg)](/show_os_cursor/3alleg.md), [**exsyscur**(3alleg)](/exsyscur/3alleg.md)