al_set_mou..._precision(3)

✨ al_set_mou..._precision ✨

okay so bestie, welcome to the Allegro reference manual entry for al_set_mou..._precision(3) — yes the name is a lil truncated, that's just how the man page shows it, and no I'm not ignoring it, it's literally the title 💅

---

🎀 NAME 🎀

al_set_mouse_wheel_precision — Allegro 5 API 🦋

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

void al_set_mouse_wheel_precision(int precision)

---

💖 DESCRIPTION 💖

okay so this one sets the precision of the mouse wheel — like the z and w coordinates ✨. And how does that precision show up? It manifests itself as a multiplier on the dz and dw fields in mouse events 🔥.

It also affects the z and w fields of events and ALLEGRO_MOUSE_STATE(3) — but ngl, not in a simple way if you alter the precision often 😭. So the move is: it's suggested to reset those axes to 0 when you change precision. Considerate, right? 🫶

Setting this to a high value lets you detect small changes in those two axes for some high precision mice 👑. And the flexible way to use this precision? Set it to a high value (and like, 120 is likely sufficient for most, if not all, mice) and use a floating point dz and dw, like so:

al_set_mouse_wheel_precision(120);

ALLEGRO_EVENT event;
al_wait_for_event(event_queue, &event);
if (event.type == ALLEGRO_EVENT_MOUSE_AXES) {
  double dz = (double)event.mouse.dz / al_get_mouse_wheel_precision();
  /* Use dz in some way... */
}

Precision is set to 1 by default 🌈. And heads up — it is impossible to set it to a lower precision than that 💀. Like, 1 is the floor, periodt.

---

⭐ SINCE ⭐

5.1.10 🎀

---

💜 SEE ALSO 💜

• al_get_mouse_wheel_precision(3) — the getter bestie, obviously 🔥

---

and that's the whole page, bestie!! 💖✨ this was al_set_mou..._precision(3) from the Allegro reference manual — mwah, go forth and scroll with precision 🦋🌸💅