---
name: "enable_hardware_cursor"
section: "3alleg4"
platform: "linux"
package: "allegro4-doc"
version: "2:4.4.3.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/enable_hardware_cursor/3alleg4"
---

# enable\_hardware\_cursor(3alleg4)

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**(3alleg4), **show\_mouse**(3alleg4), **set\_mouse\_sprite**(3alleg4), **get\_mouse\_mickeys**(3alleg4), **gfx\_capabilities**(3alleg4), **disable\_hardware\_cursor**(3alleg4), **show\_os\_cursor**(3alleg4), **exsyscur**(3alleg4)