install_sound_input(3alleg4)

💖 install_sound_input — Allegro manual, bestie edition 💖

okay so real talk, this one lives in the Allegro manual, section 3alleg4, and it's literally the moment your game goes from "plays sounds" to "hears sounds". main character energy fr.

✨ NAME ✨

install_sound_input — fires up the sound recorder module. it's part of the Allegro game programming library, and yes she's the icon who lets you capture audio instead of just blasting it. 🎤

🦋 SYNOPSIS 🦋

#include <allegro.h>

int install_sound_input(int digi, int midi);

🌸 DESCRIPTION 🌸

so here's the tea: install_sound_input initialises the sound recorder module. that's the whole vibe. 🎀

bestie, lowkey important: you must install the normal sound playback system before you call this routine. do not skip that step, it's giving prerequisites, it's not optional. 🙈

the two card parameters — digi and midi — use the exact same constants as install_sound(), no new lore required. that includes:

• DIGI_NONE and MIDI_NONE — use these if you want to disable parts of the module. sometimes you just don't need the whole thing, and that's valid. 💅
• DIGI_AUTODETECT and MIDI_AUTODETECT — use these to let Allegro guess at the hardware for you. it's basically the "you figure it out, i trust you" option. ✨

👑 RETURN VALUE 👑

• 0 — slay! it worked, everything's good, success. 💖
• any other value — the machine or the driver doesn't support sound recording. not a vibe, but at least you know now. 💀

🌈 SEE ALSO 🌈

• install_sound(3alleg4)
• start_sound_input(3alleg4)
• midi_recorder(3alleg4)

and that's the whole page, bestie!! this was Allegro version 4.4.3 — go forth and record some audio, you absolute legend 🫶✨🎀