aa_autoinitmouse(3)

💖 aa_autoinitmouse — the "bestie, just find me a mouse" function 💖

okay so this is a page from the Library Functions Manual (the aa_autoinitmouse(3) one, you already knew that tho). it's the easy-peasy, no-thoughts-just-vibes way to get a mouse working in AA-lib. let's get into it 🐭✨

✨ NAME ✨

aa_autoinitmouse — the easy to use AA-lib mouse initialization function. literally it just finds you a mouse driver so you don't have to. queen behavior 👑

🌸 SYNOPSIS 🌸

#include <aalib.h>

int aa_autoinitmouse
(
     struct aa_context *c,
     int mode
);

🎀 PARAMETERS 🎀

• struct aa_context *c — the AA-lib context you wanna operate on. this is your lil world, your main character arena, and the mouse is moving around inside it.
• int mode — a mask of extra features you're requesting. and bestie… no such features are available in the current AA-lib version. so it's giving "you can ask, but the answer is no." pass it anyway, it's fine, it's just decorative rn 💀

🦋 DESCRIPTION 🦋

okay so the way this works: it goes looking for an available mouse driver that supports the mode you specified. no cap, it's a whole search party.

first it tries to initialize the recommended drivers — like, the ones everybody trusts, the popular girls of the driver world 👑.

then it moves on to the drivers available in the aa_kbddrivers array, which is all the regular output drivers compiled into AA-lib. (yes, aa_kbddrivers, that's exactly what it says, don't come for me 🙈)

so: recommended first, then the compiled-in lineup. it's giving "we checked the VIP list, now we're checking the regular list." 💅

🌈 RETURNS 🌈

1 when successful, or 0 on failure. that's it. binary. iconic. either she ate or she didn't 🍓

💜 SEE ALSO 💜

bestie there are SO many siblings. here's the whole family reunion:

• 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_recommendhi(3)
• aa_recommendlow(3)
• aa_init(3)
• aa_initkbd(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)

lowkey go read aa_getmouse(3) next if you actually wanna use the mouse you just initialized. just saying 🫶

that's the whole thing bestie, you're officially mouse-pilled 🐭💅

this page was brought to you by c2man aalib.h, dated 8 September 1999 — yes it's vintage, yes it still slays, we stan a timeless queen 👑✨