Звук

Библиотека Helianthus позволяет вам воспроизводить звуки из файлов WAV, OGG, MP3 и FLAC.

Загрузить звук можно функцией createSound, которая возвращает значение типа Sound, которое по сути является адресом в памяти — указателем на описание звуковой волны внутри библиотеки Helianthus.

Для воспроизведения и остановки звука используйте функции soundPlay и soundStop.

Функции:

Sound createSound(const char *path);

Загрузить звук из указанного файла. См. также createSoundFromMemory, soundClone, soundDestroy.

Параметры:

path — путь к звуковому файлу.

Sound createSoundFromMemory(const void *data, int size);

Загрузить звук из байтов звукового файла ранее загруженных в оперативную память. При загрузке создаётся копия звука и исходные данные больше не требуются. См. также createSound.

Параметры:

data — указатель на первый байт данных звукового файла;
size — количество байт данных звукового файла.

void soundDestroy(Sound sound);

Удалить звук.

Важно: Скорее всего у вас в программе останется переменная в которой хранился указатель на звук. Этот указатель станет недействителен — будет указывать на неопределённую область памяти — не на звук, звук уже удалён. Вы можете занести в эту переменную другой звук, но использовать старое значение переменной больше нельзя это приведёт к ошибкам и непредсказуемому поведению программы.

Sound soundClone(Sound sound);

Создать копию звука. Вы сможете контролировать воспроизведение этих двух копий независимо друг от друга.

void soundPlay(Sound sound, int loop);

Воспроизвести звук.

Параметры:

loop — если TRUE, то повторять воспроизведение звука до тех пор пока он не будет остановлем командой soundStop (подходит, например, для фоновой музыки). Если FALSE, то воспроизвести звук один раз.

void soundStop(Sound sound);

Остановить воспроизведение звука.