AUSOUNDCREATEBUCKETFROMFILE(3nas)

okay bestie, welcome to AuSoundCreateBucketFromFile(3) from the Library Functions Manual. It's giving soundlib section 3 energy, and the header is out here truncating the name to AuSoundCre...ketFromFile(3) like it's too cool for vowels. We still know her. 💅

💖 Name 💖

AuSoundCreateBucketFromFile — she creates a bucket and initializes its contents. That's the whole name section. Periodt. ✨

✨ Synopsis ✨

       #include <audio/audiolib.h>
       #include <audio/soundlib.h>

       AuBucketID AuSoundCreateBucketFromFile(server, filename, access,
       attributes, status)
           AuServer *server;
           char *filename;
           AuUint32 access;
           AuBucketAttributes **attributes; /* RETURN */
           AuStatus *status; /* RETURN */

🎀 Arguments 🎀

• server — specifies the connection to the audio server. The plug to the audio server, basically. 🔌
• filename — specifies the name of the file. The file whose audio data is about to get bucket-ified. 📁
• access — specifies the access restrictions the bucket should have. Who gets to touch the bucket, bestie. 🔐
• attributes — if non-NUll, returns the attributes of the created bucket. (Yes, the page spells it non-NUll; I'm just reporting the chaos.) 📝
• status — if non-NULL, flush the output buffer and return the status from the server. Flush it and report back. 🚽✨

🌸 Description 🌸

AuSoundCreateBucketFromFile creates a bucket, initializing the contents with the audio data from filename, and returns the bucket ID or AuNone if there was error. So: new bucket, audio data loaded in, bucket ID handed over. If something breaks, you get AuNone instead. No bucket, just tears. 😭

💀 Errors 💀

The error squad is:

• AuBadValue
• AuBadLength
• AuBadAlloc

🔗 See Also 🔗

• AuSoundCreateBucketFromData.
• audiolib - Network Audio System C Language Interface.

mwah 💋 this page is from soundlib version 1.9.4, and the footer signs off as AuSoundCre...ketFromFile(3). byeee, go make buckets 🫶🎀