save_sample(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

✨ save_sample(3) ✨

okay bestie, so this is a page from the Allegro manual and it's literally all about save_sample — the function that writes a sample into a file. game programming library energy, fr fr. 🎀

🌸 NAME 🌸

save_sample — Writes a sample into a file. Allegro game programming library.

🦋 SYNOPSIS 🦋

#include <allegro.h>

int save_sample(const char *filename, SAMPLE *spl);

like, that's the whole signature. two args, one int coming back at you. 💅

💖 DESCRIPTION 💖

Writes a sample into a file. no cap. But here's the tea: the output format is determined from the filename extension — so the name you give it is doing real work, bestie, it's not just a vibe. 🫶

And now the part that's giving plot twist: at present Allegro does not natively support the writing of any sample formats. Not one. Zero. Nada. 😭 So if you want to actually save anything, you must register a custom saver routine with register_sample_file_type(). That's the whole assignment. go do it.

Example time, because we love a demo:

if (save_sample("sound.wav", sample) != 0)
   abort_on_error("Couldn't save sample!");

see how it checks for non-zero and then panics politely? that's the move. ⭐

🔥 RETURN VALUE 🔥

Returns zero on success, non-zero otherwise. classic. if it's not zero, something went sideways and you should probably care about it. 👑

👑 SEE ALSO 👑

and that's the page!! mwah 💜 this whole thing lives in Allegro, version 4.4.3 — so if you're out here saving samples, go register that file type first, bestie, i'm literally begging. slay, bye!! ✨🎀🦋

📦 where this page comes from