roar_get_vol(3)

💖 roar_get_vol — get/set mixer levels, bestie edition 💖

okay so this is a page from the System Manager's Manual: RoarAudio (that's the manual name, she's fancy like that 🎀), and today we're learning about roar_get_vol, roar_set_vol, and roar_set_vol2 — aka the trio that sets mixer levels and RoarAudio stream levels. no cap, they're literally the volume girlies 💅

---

✨ NAME ✨

roar_get_vol, roar_set_vol, roar_set_vol2 — set mixer levels or RoarAudio streams 🎚️

---

🌸 SYNOPSIS 🌸

#include <roaraudio.h>

int roar_set_vol(struct roar_connection * con, int id, struct
roar_mixer_settings * mixer, int   channels);

int roar_set_vol2     (struct roar_connection * con, int id, struct
roar_mixer_settings * mixer, int   channels, int mode);

int roar_get_vol(struct roar_connection * con, int id, struct
roar_mixer_settings * mixer, int * channels);

---

🦋 DESCRIPTION 🦋

so basically this call gets or sets the mixing levels for a stream. like, it's the volume knob of the whole situation 🔥

important bestie alert 🚨 roar_set_vol() is marked obsolete and will be removed soon — use roar_set_vol2() instead, fr fr. don't get attached to the old one, she's leaving 💀

---

💜 PARAMETERS 💜

• con — the connection to the roar audio server. your little phone line to the server, essentially 📞
• id — the ID of the stream you wanna change. gotta know which stream you're messing with 👑
• mixer — the mixer state for the stream. this is the actual data packet of volume vibes ✨
• channels — the number of channels to set mixer data for, or the number of channels mixer data is returned for (depends on which direction you're going, iykyk) 🎧
• mode — the mode of operating. currently the following modes are supported: ROAR_SET_VOL_ALL, ROAR_SET_VOL_MS, ROAR_SET_VOL_UNMAPPED 🌈

---

💅 RETURN VALUE 💅

• on success, these calls return 0 — slay, we ate ✅
• on error, -1 is returned — not the vibe, something went wrong 😭

---

🍓 EXAMPLES 🍓

FIXME

(yeah, the examples section literally just says FIXME. iconic of the devs, honestly 🙈 no example yet, bestie, the docs are still cooking 🧚)

---

🫶 SEE ALSO 🫶

• libroar(7)
• RoarAudio(7)

---

and that's the whole page, bestie 💖 this one came from RoarAudio, dated May 2011 — a true vintage queen 👑 go forth and adjust those mixer levels responsibly 🌸💜✨