DOKK / manpages / debian 11 / allegro4-doc / load_sample.3alleg4.en
load_sample(3alleg4) Allegro manual load_sample(3alleg4)

load_sample - Loads a sample from a file. Allegro game programming library.

#include <allegro.h>

SAMPLE *load_sample(const char *filename);

Loads a sample from a file, supporting both mono and stereo WAV and mono VOC files, in 8 or 16-bit formats, as well as formats handled by functions registered using register_sample_file_type(). Example:


SAMPLE *sample = load_sample(user_input);
if (!sample)
abort_on_error("Couldn't load sample!");

Returns a pointer to the SAMPLE or NULL on error. Remember to free this sample later to avoid memory leaks.

destroy_sample(3alleg4), load_voc(3alleg4), load_wav(3alleg4), play_sample(3alleg4), save_sample(3alleg4), register_sample_file_type(3alleg4), exsample(3alleg4)

version 4.4.3 Allegro