AuGrabNotifyEvent(3)

✨ AuGrabNotifyEvent — the grab notify event structure 💅

okay bestie, so this is AuGrabNotifyEvent(3) from the Library Functions Manual, and it's literally the struct that tells you when a component got grabbed or released. it's giving "event union member energy". let's get into it 🫶

---

🌸 Structures 🌸

first up, you gotta know it lives inside the big AuEvent union. here's the vibe:

#include <audio/audiolib.h>

typedef union _AuEvent
{
    . . .
    AuGrabNotifyEvent augrabnotify;
    . . .
}AuEvent;

typedef struct _AuGrabNotifyEvent
{
    int type;
    AuUint32 serial;
    AuBool send_event;
    AuServer *server;
    AuTime time;
    AuID id;
    unsigned char kind;
    unsigned char pad1;
    unsigned short pad2;
    AuID client;
}AuGrabNotifyEvent;

so yeah, augrabnotify is one of the members hanging out in that union. iconic ✨

---

🎀 Members 🎀

every single field, no skips, no cap:

• type — the event type, bestie. GrabNotify events are type AuEventTypeGrabNotify.
• serial — the serial ID of the event, expanded from the 16 bit value the server sent. glow-up fr.
• send_event — AuTrue if the event came from a SendEvent protocol request. otherwise not, obviously 💅
• server — the connection to the audio server that this event was read from.
• time — the server time in milliseconds for when the event was generated. 🕐
• id — the ID of the component that got grabbed.
• kind — either AuGrabNotifyKindRequested or AuGrabNotifyKindReleased. pick your fighter 🥊
• pad1 — (no description, it's just padding, we love a filler era 🙈)
• pad2 — (same deal, more padding, slay)
• client — the client making the grab.

---

🦋 Description 🦋

GrabNotify events get sent to client applications to notify them that a component has been grabbed or released. that's the whole point, that's the assignment, periodt. 💖

---

⭐ Notes ⭐

Not implemented. So this is all just speculation. 😭

like, don't build your whole app around this, bestie, it's a theory not a promise.

---

🌈 See Also 🌈

• AuAnyEvent
• AuElementNotifyEvent
• AuErrorEvent
• AuMonitorNotifyEvent
• audiolib — Network Audio System C Language Interface

---

and that's the whole page 🎀 this was AuGrabNotifyEvent(3), part of audiolib - events, version 1.9.5. thanks for coming to my ted talk, go grab (or release) something, ily 🫶✨