install_keyboard_hooks(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

✨ NAME ✨

install_keyboard_hooks — bestie, this is the one that installs custom keyboard hooks. It lives in the Allegro game programming library 💖

🌸 SYNOPSIS 🌸

#include <allegro.h>

void install_keyboard_hooks(int (*keypressed)(), int (*readkey)());

🎀 DESCRIPTION 🎀

okay so listen. You should only use this function if you aren't using the rest of the keyboard handler. Like, that's the vibe check, and if you fail it this is not your girl. 🙈

You call it in the place of install_keyboard(), and it lets you hand over your own callback routines for detecting and reading keypresses. Those callbacks are the ones that the main keypressed() and readkey() functions will end up using. So your custom logic is feeding the standard functions. iconic behaviour honestly 💅

And why would you even want that? Because it's useful if you want to use Allegro's GUI code with a custom keyboard handler — it gives the GUI a way to get keyboard input from your own code, completely bypassing the normal Allegro input system. no cap. 🦋

fr fr: this is a swap out the whole input pipeline situation, not a little tweak. Make sure that's actually what you want before you commit to it. 👑

🌈 SEE ALSO 🌈

that's the whole page bestie, go forth and hook those keys 💜

Allegro manual, version 4.4.3 — install_keyboard_hooks(3) — mwah, that's a wrap 🫶✨

📦 where this page comes from