aa_puts(3)

💖 aa_puts(3) 💖

Library Functions Manual energy, bestie — welcome to the page that teaches you how to slap a whole string onto your AA-lib screen. ✨

🌸 NAME 🌸

aa_puts — output string to AA-lib output buffers.

🎀 SYNOPSIS 🎀

#include <aalib.h>

void aa_puts
(
     aa_context *c,
     int x,
     int y,
     enum aa_attribute attr,
     const char *s
);

🦋 PARAMETERS 🦋

• aa_context *c — the AA-lib context you're operating on. Your lil' world. Pass the one you wanna draw into, bestie.
• int x — X coordinate of the first character. Yes, the first one — the rest follow along after it.
• int y — Y coordinate of the first character. Same deal, but vertical. 📐
• enum aa_attribute attr — the attribute to use. This is the vibe check for your text, and here's the whole menu of possible values for an enum aa_attribute:
  • AA_NORMAL — normal characters. The default-ish look, nothing extra.
  • AA_DIM — dark characters. Lowkey moody. 🌚
  • AA_BOLD — bright characters. Highkey glowing, main character energy. ✨
  • AA_BOLDFONT — characters rendered in bold font. That's the font being bold, not the brightness, okay? Different thing, don't @ me.
  • AA_REVERSE — reversed (black on white) characters. Flip it, reverse it. 🔄
  • AA_SPECIAL — render characters in a way easilly visible on the screen. The exact rendering is driver dependent, but you ought to use this mode to output texts you want to make easilly visible in the image. It's giving "please notice me" and honestly? Same.
• const char *s — the string to output. The actual words, the whole point of the function, the moment. 💅

👑 DESCRIPTION 👑

Output given string to AA-lib output buffers. That's it, that's the function — it writes s starting at (x, y) in the context c using attribute attr.

⚠️ But bestie, listen: to see the effect you need to call aa_flush too. No aa_flush, no visual. It's writing to the buffers, not the screen, so the screen is gonna stay unbothered until you flush. Don't forget, fr fr. 😭

🌈 SEE ALSO 🌈

The whole friend group, in order, no one left out: 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_render(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).

okay and one last thing, the receipts 🧾 — this page was generated by c2man from aalib.h, dated 8 September 1999. iconic vintage behavior, no cap. stan a 1999 manpage. 💜