al_set_mouse_wheel_precision(3alleg5)

✨ al_set_mouse_wheel_precision — Allegro 5 API ✨

okay bestie, so this one is from the Allegro 5 API and it's genuinely so fun, like scroll wheel girlies rise up 🖱️💖

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

void al_set_mouse_wheel_precision(int precision)

---

💅 DESCRIPTION 💅

So this function sets the precision of the mouse wheel — and by "mouse wheel" we mean the z and w coordinates, yes both of them, the whole squad. 🎀

This precision shows up as a multiplier on the dz and dw fields in mouse events. It also does stuff to the z and w fields of events and of ALLEGRO_MOUSE_STATE(3alleg5) — but not in a simple way if you go changing the precision all the time 🙈, so the suggestion is to reset those axes to 0 whenever you change precision. Noted, queen, we love a clean slate.

Setting it to a high value lets you detect tiny little changes in those two axes for some high precision mice. ✨ And the flexible way to use it? Set it to a high value — 120 is likely sufficient for most, if not all, mice — and then 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 no, bestie, it is impossible to set it to a lower precision than that. One is the floor. Periodt. 💀

---

🦋 SINCE 🦋

5.1.10

---

👑 SEE ALSO 👑

• al_get_mouse_wheel_precision(3alleg5)

---

mwah 💜 that's the whole thing — this page came straight out of the Allegro reference manual, for al_set_mouse_wheel_precision(3alleg5), and honestly? iconic. go forth and scroll with precision, iykyk 🎀✨