AUMAKEELEMENTEXPORTCLIENT(3x)

💖 AuMakeElementExportClient 💖

okay bestie, welcome to the Library Functions Manual — yes we're in AuMakeElem...xportClient(3) territory and honestly? it's giving foundational. this is the function that sets up an ExportClient element for you, no cap. let's get into it 🫶

---

✨ NAME ✨

AuMakeElementExportClient — initialize an ExportClient element

like. that's the whole job. it initializes. it's iconic for that. 👑

---

🌸 SYNOPSIS 🌸

#include <audio/audiolib.h>

AuMakeElementExportClient(element, input, sample_rate, format,
num_tracks, discard, max_samples, high_water_mark, num_actions, actions)
    AuElement *element; /* RETURN */
    unsigned short input;
    unsigned short sample_rate;
    unsigned char format;
    unsigned char num_tracks;
    unsigned char discard;
    AuUint32 max_samples;
    AuUint32 high_water_mark;
    int num_actions;
    AuElementAction *actions;

look at that parameter list. it's long. it's serving. we're gonna go through every single one, don't worry, i would never leave you hanging 💅

---

🎀 ARGUMENTS 🎀

• element — this one's the RETURN value, bestie. it hands you back the initialized element. it's the whole point. the main character, fr fr.
• input — the index of the element that's supplying audio data to this element. like, who's feeding us? that's input. 🔥
• sample_rate — the sample rate of the audio data. yeah. exactly what it sounds like.
• format — the format of the audio data. and listen, currently these are the formats that are defined, and i am listing every single one because we don't skip: AuFormatULAW8, AuFormatLinearUnsigned8, AuFormatLinearSigned8, AuFormatLinearSigned16MSB, AuFormatLinearUnsigned16MSB, AuFormatSignedLinear16LSB, and AuFormatLinearUnsigned16LSB. that's the roster. 💜
• num_tracks — how many tracks are in the audio data. count 'em.
• discard — specifies if the flow should pause initially. normally it's AuTrue. so like, the default vibe is "pause at first", iykyk.
• max_samples — the maximum number of samples to send to the client in a single write. 🫶 important caveat though: this is Ignored for "trivial" flows. so if your flow is trivial, this does absolutely nothing. don't come for me, that's what the page says.
• high_water_mark — this is when to tell the client application to read the audio data from the server. specifically: when this number of samples is reached in the buffer, an ElementNotify event with kind set to AuElementNotifyKindHighWater gets sent to the client application. so it's the "hey bestie, come get your data" threshold. 🌊
• num_actions — the number of actions in actions. just the count.
• actions — the list of actions to associate with this element. entries in this list can be initialized with AuMakeChangeStateAction, AuMakeSendNotifyAction, and AuMakeNoopAction. also — it May be NULL. so if you got no actions, that's fine, pass NULL, live your truth. 🌈

---

🦋 DESCRIPTION 🦋

so what does AuMakeElementExportClient actually do? it sets the type member of element to AuElementTypeExportClient, and then it initializes the exportclient member of element with the remaining arguments. that's it. that's the whole thing. clean, simple, slays. ✨

and here's a little detail that lowkey matters: AuMakeElementExportClient is implemented as a macro. not a function. a macro. so keep that in mind, it's not doing any fancy function-call business, it's a macro, periodt. 💅

---

👑 SEE ALSO 👑

go read these next, they're all part of the family:

• AuElementNotifyEvent
• AuMakeElementAddConstant
• AuMakeElementBundle
• AuMakeElementExportBucket
• AuMakeElementExportDevice
• AuMakeElementExportMonitor
• AuMakeElementImportBucket
• AuMakeElementImportClient
• AuMakeElementImportDevice
• AuMakeElementImportWaveForm
• AuMakeElementMultiplyConstant
• AuMakeElementSum

and also:

• audiolib — Network Audio System C Language Interface

---

okay that's the whole page, bestie!! 🧚 this was audiolib — element initialization, version 1.9.5, dated AuMakeElem...xportClient(3), and honestly? reading manpages is self care. go initialize something. mwah 💖🎀🦋