AuSetElementParameters(3)

πŸ’– AuSetElementParameters β€” bestie edition πŸ’–

okay so this is a page from the audiolib manual (that's the Network Audio System C Language Interface, the library this whole thing lives in). It's about setting element parameters inside a flow. Iconic behaviour, honestly. Let's get into it πŸŽ€


✨ NAME ✨

AuSetElementParameters β€” set the parameters of elements in a flow πŸ’…


🌸 SYNOPSIS 🌸

#include <audio/audiolib.h>

void AuSetElementParameters(server, num_parameters, parameters, status)
    AuServer *server;
    int num_parameters;
    AuElementParameters *parameters;
    AuStatus *status; /* RETURN */

like, yes, that's the whole signature, copy it exactly bestie, don't be creative here 🫢


πŸ¦‹ ARGUMENTS πŸ¦‹

  • server β€” the connection to the audio server. your lil hotline to the sound machine πŸ“ž
  • num_parameters β€” how many parameters we're talking about. the count, the number, the amount πŸ’«
  • parameters β€” a list that gives the flow, the element number, and the parameters of the elements you wanna change. this is the main character argument fr fr πŸ‘‘
  • status β€” if it's non-NULL, the output buffer gets flushed and you get the status back from the server. so it's a RETURN situation, iykyk 😌

πŸ’œ DESCRIPTION πŸ’œ

AuSetElementParameters changes those element parameters that can be changed dynamically. so the ones that are allowed to wiggle, wiggle. 🧚

Changes in element types is not allowed. hard no. nope. not happening. that's not a vibe that's permitted πŸ’€

Also, there isn't any way to specify only one parameter of a multi-parameter element. So bestie, you have to set all of the element's parameters. the whole set. no picking and choosing 🌈


⭐ NOTE ⭐

Attempts to change non-existant parameters will be silently ignored. like, ghosted. no error, no drama, just nothing. πŸ™ˆ


πŸ’€ ERRORS πŸ’€

  • AuBadFlow
  • AuBadElement

these are the two ways to upset it. do with that what you will 🌸


πŸŽ€ SEE ALSO πŸŽ€

  • AuGetElementParameters. β€” the read-your-parameters counterpart, obsessed with the symmetry tbh
  • audiolib β€” Network Audio System C Language Interface ✨

and that's a wrap on AuSetElementParameters(3) from the audiolib pages β€” this one's audiolib - flow elements parameters, version 1.9.4, and it belongs to the Library Functions Manual. slay, go set those parameters, periodt πŸ’…πŸ’–

πŸ“¦ where this page comes from