aa_render(3)

💖 aa_render — the moment your framebuffer becomes art, bestie

okay so real quick, this is a page from the Library Functions Manual, and it's all about aa_render(3), the glow-up function. iykyk ✨

🌸 NAME 🌸

aa_render — convert image buffer to ASCII-art. that's it. that's the whole job. and it ate. 👑

✨ SYNOPSIS ✨

#include <aalib.h>

void aa_render
(
     aa_context *c,
     const aa_renderparams *p,
     int x1,
     int y1,
     int x2,
     int y2
);

🎀 PARAMETERS 🎀

• aa_context *c — the AA-lib context you're operating on, bestie. it's giving "which canvas are we painting on" energy. 🎨
• const aa_renderparams *p — the rendering parametters 💅 that say your brightness, your gamma correction, and other useful stuff. wanna know the defaults? hit up aa_defrenderparams, she'll tell you. ✨
• int x1 — column of the top left coner of the rendered area. and yes, it's measured in characters, not pixels. characters!! 🫶
• int y1 — row of the top left coner of the rendered area. 🌸
• int x2 — column of the bottom right coner of the rendered area. 🦋
• int y2 — row of the bottom right coner of the rendered area. and that's the whole rectangle, periodt. ⭐

💜 DESCRIPTION 💜

this function does the trick, no cap — it takes your emulated framebuffer and turns it into high quality ASCII-art. literally the main character moment of the whole library. 🌈

if you want to be really fast though, you might use aa_fastrender instead (speed over beauty, we respect it 🏃♀️). and if you want to emulate palette, use aa_renderpalette. different vibes, different functions.

⚠️ note that to actually see the effect, you need to call aa_flush too. don't do all this gorgeous rendering and then forget to flush, that's tragic. 😭

also heads up: the first call to this function may take a while, because the rendering tables are produced. she's building her setup, let her cook. 🔥

👑 SEE ALSO 👑

• 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_initkbd(3), aa_initmouse(3), aa_close(3), aa_uninitkbd(3), aa_uninitmouse(3), aa_fastrender(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)

like, that's a whole friend group right there. go say hi. 🫶

and that's the tea 🍓 — this page was brought to you by c2man aalib.h, dated 8 September 1999, and yeah, aa_render(3) is still serving looks after all these years. stan a legend. 💅✨