AuEvent(3)

👑 AuEvent(3) — the event union, bestie ✨

okay so welcome to the Library Functions Manual, section 3, and today's main character is AuEvent 💖 she's a union, she's a vibe, she holds literally every kind of event the Network Audio System wants to send your way. let's get into it 🦋

🌸 Name 🌸

AuEvent — event union. yes that's it, that's the whole name, and honestly? iconic.

🎀 Structures 🎀

first things first, you gotta pull her in:

#include <audio/audiolib.h>

and then, the queen herself:

typedef union _AuEvent
{
    int type;
    AuAnyEvent auany;
    AuElementNotifyEvent auelementnotify;
    AuMonitorNotifyEvent aumonitornotify;
    AuGrabNotifyEvent augrabnotify;
    AuErrorEvent auerror;
}AuEvent;

she's a union so like, one of these at a time, the type member is your girl telling you which one you're actually looking at 👀 no cap.

✨ Members ✨

• type — tells you the event type. rn the event types defined are: AuEventTypeElementNotify, AuEventTypeGrabNotify, or AuEventTypeMonitorNotify. read this first, always, she's the vibe check 🌈
• auany — a generic event structure holding the members that all event types share. like the group chat everyone's in 💅
• auelementnotify — sent to client applications to notify them of a watermark condition or a state change. lowkey the most dramatic one, she's always got news 📣
• aumonitornotify — sent to client applications to notify them of monitor data. she's just keeping you in the loop, very thoughtful of her 🫶
• augrabnotify — Not Implemented. 😭 yeah. she's not here. do not expect her. do not build on her. fr fr.
• auerror — sent to client applications to notify them of non-fatal errors encountered while processing requests. not fatal, just a little "bestie we hit a snag" 💀

💜 Description 💜

Events are the principal mechanism for the server to communicate with a client application. that's it, that's the whole relationship — the server speaks, you listen, and AuEvent is the envelope every message shows up in 📬✨

🦋 See Also 🦋

• audiolib — Network Audio System C Language Interface

heads up bestie: augrabnotify is literally Not Implemented, so if you were planning a whole thing around it, maybe don't 🥲

and that's the page!! 🎀 this was audiolib - events, version 1.9.4, dated 1.9.4 — mwah, slay, go forth and handle your events, i'm obsessed with you, periodt 💅✨🦋