create_sample(3alleg4)

📦 version 4.4.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

create_sample — she constructs a brand new sample structure of whatever type you specify, bestie 💖 it's giving Allegro game programming library energy.

🎀 SYNOPSIS 🎀

#include <allegro.h>

SAMPLE *create_sample(int bits, int stereo, int freq, int len);

🦋 DESCRIPTION 🦋

okay so basically create_sample constructs a new sample structure of the specified type — like, it hands you a freshly minted SAMPLE and it's all yours 💅

if you wanna know what's inside that struct, go read the chapter "Structures and types defined by Allegro" — it has the whole internal description of the SAMPLE structure, and honestly? worth the read, no cap 📖✨

now let's talk about the parameters, because they matter, bestie:

  • bits — can be 8 or 16. that's it. those are the options. periodt.
  • stereo — 0 (zero) means mono samples, and non-zero means stereo samples. so like, any non-zero value = stereo. got it? got it. 🎧
  • freq — the frequency, in hertz 🌊
  • len — the number of samples you want to allocate for the full sound buffer 🌈

👑 RETURN VALUE 👑

it returns a pointer to the created sample 🫶

but — and this is important — it returns NULL if the sample could not be created 😭 so like, always check, okay?

⚠️ and bestie, remember to free this sample later to avoid memory leaks!! don't just leave her hanging, that's not the vibe 💀

💜 SEE ALSO 💜

Allegro 🌸 version 4.4.3 🌸 create_sample(3alleg4)

and that's the whole page, bestie — slay 💅✨ go make some sounds 🎀🦋💖

📦 where this page comes from