aa_initkbd(3)

πŸ’– aa_initkbd β€” the manual, but make it make sense πŸ’–

okay so bestie, welcome to the Library Functions Manual entry for aa_initkbd(3) πŸŽ€. it's giving "old-school C library lore" and honestly? we're obsessed. let's get into it πŸ¦‹


✨ NAME ✨

aa_initkbd β€” spin up the AA-lib keyboard driver. that's it, that's the whole job πŸ’…


🌸 SYNOPSIS 🌸

#include <aalib.h>

int aa_initkbd
(
     struct aa_context *context,
     const struct aa_kbddriver *drv,
     int mode
);

πŸ’œ PARAMETERS πŸ’œ

  • struct aa_context *context β€” the AA-lib context you want to operate on. like, which little universe are we doing this in? that one 🌈
  • const struct aa_kbddriver *drv β€” the driver you wish to use. pick your fighter πŸ‘‘
  • int mode β€” a mask of extra features you're requesting. it can contain AA_SENDRELEASE if you're also interested in release events too (as in, when a key goes up and not just when it goes down). so if you're nosy about releases, that's your flag πŸ“

🫢 DESCRIPTION 🫢

okay so here's the tea: this is the most primitive AA-lib keyboard initialization function. literally the bare-bones, low-level, no-frills entry point 😀.

but that's not a drag, bestie β€” it's a feature. it allows better control over the process than the easier-to-use aa_autoinitkbd function. aa_autoinitkbd is the friend who just orders for the table; aa_initkbd is you, reading the whole menu and choosing deliberately. main character energy, no cap πŸ’…βœ¨


πŸ”₯ RETURNS πŸ”₯

  • 1 on success πŸŽ‰
  • 0 on fail 😭

that's it. binary. iconic. periodt.


πŸ’€ SEE ALSO πŸ’€

a truly enormous friend group, fr fr. here's everyone:

save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3), aa_mmheight(3), aa_imgwidth(3), aa_imgheight(3), aa_image(3), aa_text(3), aa_attrs(3), aa_currentfont(3), aa_autoinit(3), aa_autoinitkbd(3), aa_autoinitmouse(3), aa_recommendhi(3), aa_recommendlow(3), aa_init(3), aa_initmouse(3), aa_close(3), aa_uninitkbd(3), aa_uninitmouse(3), aa_fastrender(3), aa_render(3), aa_puts(3), aa_printf(3), aa_gotoxy(3), aa_hidecursor(3), aa_showcursor(3), aa_getmouse(3), aa_hidemouse(3), aa_showmouse(3), aa_registerfont(3), aa_setsupported(3), aa_setfont(3), aa_getevent(3), aa_getkey(3), aa_resize(3), aa_resizehandler(3), aa_parseoptions(3), aa_edit(3), aa_createedit(3), aa_editkey(3), aa_putpixel(3), aa_recommendhikbd(3), aa_recommendlowkbd(3), aa_recommendhimouse(3), aa_recommendlowmouse(3), aa_recommendhidisplay(3), aa_recommendlowdisplay(3)


and that's the whole page, bestie 🫢 go forth and initialize that keyboard πŸ’–

this lil artifact was brought to you by c2man, pulled straight out of aalib.h, dated 8 September 1999 β€” so yes, it's older than us and it still ate 🌈✨ stay iconic βœ¨πŸ‘‘πŸ’