Blame doc/ru/sound.html

Ivan Mahonin 7a004b
<html>
Ivan Mahonin 7a004b
<head>
Ivan Mahonin 7a004b
<meta charset="UTF-8" />
Ivan Mahonin 7a004b
<link rel="stylesheet" type="text/css" href="style.css" />
Ivan Mahonin 7a004b
<title>Звук - Helianthus</title>
Ivan Mahonin 7a004b
</head>
Ivan Mahonin 7a004b
<body>
Ivan Mahonin 7a004b
Ivan Mahonin 77a314
  

Helianthus

Ivan Mahonin 77a314
  
Ivan Mahonin 77a314
  

Helianthus: Документация

Ivan Mahonin 77a314
  

Установка

Ivan Mahonin 7a004b
  

Запуск и общие функции

Ivan Mahonin 7a004b
  

Клавиатура и мышь

Ivan Mahonin 7a004b
  

Рисование

Ivan Mahonin cece70
  

Шрифты и текст

Ivan Mahonin cece70
  

Текстуры и анимация

Ivan Mahonin cece70
  

Буфер кадра

Ivan Mahonin 7a004b
  

Спрайты

Ivan Mahonin 7a004b
  

Группы спрайтов

Ivan Mahonin 7a004b
  

Звук

Ivan Mahonin e9aada
  

Пользовательский интерфейс

Ivan Mahonin 7a004b
  
Ivan Mahonin 7a004b
  

Все функции

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b
Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

Звук

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

Функции:

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

Sound createSound(const char *path);

Ivan Mahonin 7a004b
Ivan Mahonin cece70

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

Ivan Mahonin 7a004b
Ivan Mahonin cece70

Параметры:

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin cece70

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

Ivan Mahonin cece70
Ivan Mahonin cece70

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

Ivan Mahonin cece70
Ivan Mahonin cece70

Параметры:

Ivan Mahonin cece70
Ivan Mahonin cece70

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

Ivan Mahonin cece70
size — количество байт данных звукового файла.

Ivan Mahonin cece70
Ivan Mahonin 7a004b

void soundDestroy(Sound sound);

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin cece70

Sound soundClone(Sound sound);

Ivan Mahonin cece70
Ivan Mahonin cece70

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

Ivan Mahonin cece70
Ivan Mahonin 7a004b

void soundPlay(Sound sound, int loop);

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

Параметры:

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

void soundStop(Sound sound);

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b

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

Ivan Mahonin 7a004b
Ivan Mahonin 7a004b
Ivan Mahonin 7a004b
</body>
Ivan Mahonin 7a004b
</html>