182 lines
9.6 KiB
C
182 lines
9.6 KiB
C
/**********************************************************************************************
|
|
*
|
|
* raylib.audio - Basic funtionality to work with audio
|
|
*
|
|
* FEATURES:
|
|
* - Manage audio device (init/close)
|
|
* - Load and unload audio files
|
|
* - Format wave data (sample rate, size, channels)
|
|
* - Play/Stop/Pause/Resume loaded audio
|
|
* - Manage mixing channels
|
|
* - Manage raw audio context
|
|
*
|
|
* LIMITATIONS (only OpenAL Soft):
|
|
* Only up to two channels supported: MONO and STEREO (for additional channels, use AL_EXT_MCFORMATS)
|
|
* Only the following sample sizes supported: 8bit PCM, 16bit PCM, 32-bit float PCM (using AL_EXT_FLOAT32)
|
|
*
|
|
* DEPENDENCIES:
|
|
* mini_al - Audio device/context management (https://github.com/dr-soft/mini_al)
|
|
* stb_vorbis - OGG audio files loading (http://www.nothings.org/stb_vorbis/)
|
|
* jar_xm - XM module file loading
|
|
* jar_mod - MOD audio file loading
|
|
* dr_flac - FLAC audio file loading
|
|
*
|
|
* *OpenAL Soft - Audio device management, still used on HTML5 and OSX platforms
|
|
*
|
|
* CONTRIBUTORS:
|
|
* David Reid (github: @mackron) (Nov. 2017):
|
|
* - Complete port to mini_al library
|
|
*
|
|
* Joshua Reisenauer (github: @kd7tck) (2015)
|
|
* - XM audio module support (jar_xm)
|
|
* - MOD audio module support (jar_mod)
|
|
* - Mixing channels support
|
|
* - Raw audio context support
|
|
*
|
|
*
|
|
* LICENSE: zlib/libpng
|
|
*
|
|
* Copyright (c) 2014-2018 Ramon Santamaria (@raysan5)
|
|
*
|
|
* This software is provided "as-is", without any express or implied warranty. In no event
|
|
* will the authors be held liable for any damages arising from the use of this software.
|
|
*
|
|
* Permission is granted to anyone to use this software for any purpose, including commercial
|
|
* applications, and to alter it and redistribute it freely, subject to the following restrictions:
|
|
*
|
|
* 1. The origin of this software must not be misrepresented; you must not claim that you
|
|
* wrote the original software. If you use this software in a product, an acknowledgment
|
|
* in the product documentation would be appreciated but is not required.
|
|
*
|
|
* 2. Altered source versions must be plainly marked as such, and must not be misrepresented
|
|
* as being the original software.
|
|
*
|
|
* 3. This notice may not be removed or altered from any source distribution.
|
|
*
|
|
**********************************************************************************************/
|
|
|
|
#ifndef AUDIO_H
|
|
#define AUDIO_H
|
|
|
|
//----------------------------------------------------------------------------------
|
|
// Defines and Macros
|
|
//----------------------------------------------------------------------------------
|
|
//...
|
|
|
|
//----------------------------------------------------------------------------------
|
|
// Types and Structures Definition
|
|
// NOTE: Below types are required for CAMERA_STANDALONE usage
|
|
//----------------------------------------------------------------------------------
|
|
#ifndef __cplusplus
|
|
// Boolean type
|
|
#if !defined(_STDBOOL_H)
|
|
typedef enum { false, true } bool;
|
|
#define _STDBOOL_H
|
|
#endif
|
|
#endif
|
|
|
|
// Wave type, defines audio wave data
|
|
typedef struct Wave {
|
|
unsigned int sampleCount; // Number of samples
|
|
unsigned int sampleRate; // Frequency (samples per second)
|
|
unsigned int sampleSize; // Bit depth (bits per sample): 8, 16, 32 (24 not supported)
|
|
unsigned int channels; // Number of channels (1-mono, 2-stereo)
|
|
void *data; // Buffer data pointer
|
|
} Wave;
|
|
|
|
// Sound source type
|
|
typedef struct Sound {
|
|
void *audioBuffer; // Pointer to internal data used by the audio system
|
|
|
|
unsigned int source; // Audio source id
|
|
unsigned int buffer; // Audio buffer id
|
|
int format; // Audio format specifier
|
|
} Sound;
|
|
|
|
// Music type (file streaming from memory)
|
|
// NOTE: Anything longer than ~10 seconds should be streamed
|
|
typedef struct MusicData *Music;
|
|
|
|
// Audio stream type
|
|
// NOTE: Useful to create custom audio streams not bound to a specific file
|
|
typedef struct AudioStream {
|
|
unsigned int sampleRate; // Frequency (samples per second)
|
|
unsigned int sampleSize; // Bit depth (bits per sample): 8, 16, 32 (24 not supported)
|
|
unsigned int channels; // Number of channels (1-mono, 2-stereo)
|
|
|
|
void *audioBuffer; // Pointer to internal data used by the audio system.
|
|
|
|
int format; // Audio format specifier
|
|
unsigned int source; // Audio source id
|
|
unsigned int buffers[2]; // Audio buffers (double buffering)
|
|
} AudioStream;
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" { // Prevents name mangling of functions
|
|
#endif
|
|
|
|
//----------------------------------------------------------------------------------
|
|
// Global Variables Definition
|
|
//----------------------------------------------------------------------------------
|
|
//...
|
|
|
|
//----------------------------------------------------------------------------------
|
|
// Module Functions Declaration
|
|
//----------------------------------------------------------------------------------
|
|
void InitAudioDevice(void); // Initialize audio device and context
|
|
void CloseAudioDevice(void); // Close the audio device and context
|
|
bool IsAudioDeviceReady(void); // Check if audio device has been initialized successfully
|
|
void SetMasterVolume(float volume); // Set master volume (listener)
|
|
|
|
Wave LoadWave(const char *fileName); // Load wave data from file
|
|
Wave LoadWaveEx(void *data, int sampleCount, int sampleRate, int sampleSize, int channels); // Load wave data from raw array data
|
|
Sound LoadSound(const char *fileName); // Load sound from file
|
|
Sound LoadSoundFromWave(Wave wave); // Load sound from wave data
|
|
void UpdateSound(Sound sound, const void *data, int samplesCount);// Update sound buffer with new data
|
|
void UnloadWave(Wave wave); // Unload wave data
|
|
void UnloadSound(Sound sound); // Unload sound
|
|
void PlaySound(Sound sound); // Play a sound
|
|
void PauseSound(Sound sound); // Pause a sound
|
|
void ResumeSound(Sound sound); // Resume a paused sound
|
|
void StopSound(Sound sound); // Stop playing a sound
|
|
bool IsSoundPlaying(Sound sound); // Check if a sound is currently playing
|
|
void SetSoundVolume(Sound sound, float volume); // Set volume for a sound (1.0 is max level)
|
|
void SetSoundPitch(Sound sound, float pitch); // Set pitch for a sound (1.0 is base level)
|
|
void WaveFormat(Wave *wave, int sampleRate, int sampleSize, int channels); // Convert wave data to desired format
|
|
Wave WaveCopy(Wave wave); // Copy a wave to a new wave
|
|
void WaveCrop(Wave *wave, int initSample, int finalSample); // Crop a wave to defined samples range
|
|
float *GetWaveData(Wave wave); // Get samples data from wave as a floats array
|
|
Music LoadMusicStream(const char *fileName); // Load music stream from file
|
|
void UnloadMusicStream(Music music); // Unload music stream
|
|
void PlayMusicStream(Music music); // Start music playing
|
|
void UpdateMusicStream(Music music); // Updates buffers for music streaming
|
|
void StopMusicStream(Music music); // Stop music playing
|
|
void PauseMusicStream(Music music); // Pause music playing
|
|
void ResumeMusicStream(Music music); // Resume playing paused music
|
|
bool IsMusicPlaying(Music music); // Check if music is playing
|
|
void SetMusicVolume(Music music, float volume); // Set volume for music (1.0 is max level)
|
|
void SetMusicPitch(Music music, float pitch); // Set pitch for a music (1.0 is base level)
|
|
void SetMusicLoopCount(Music music, int count); // Set music loop count (loop repeats)
|
|
float GetMusicTimeLength(Music music); // Get music time length (in seconds)
|
|
float GetMusicTimePlayed(Music music); // Get current music time played (in seconds)
|
|
|
|
// AudioStream management functions
|
|
AudioStream InitAudioStream(unsigned int sampleRate,
|
|
unsigned int sampleSize,
|
|
unsigned int channels); // Init audio stream (to stream raw audio pcm data)
|
|
void UpdateAudioStream(AudioStream stream, const void *data, int samplesCount); // Update audio stream buffers with data
|
|
void CloseAudioStream(AudioStream stream); // Close audio stream and free memory
|
|
bool IsAudioBufferProcessed(AudioStream stream); // Check if any audio stream buffers requires refill
|
|
void PlayAudioStream(AudioStream stream); // Play audio stream
|
|
void PauseAudioStream(AudioStream stream); // Pause audio stream
|
|
void ResumeAudioStream(AudioStream stream); // Resume audio stream
|
|
bool IsAudioStreamPlaying(AudioStream stream); // Check if audio stream is playing
|
|
void StopAudioStream(AudioStream stream); // Stop audio stream
|
|
void SetAudioStreamVolume(AudioStream stream, float volume); // Set volume for audio stream (1.0 is max level)
|
|
void SetAudioStreamPitch(AudioStream stream, float pitch); // Set pitch for audio stream (1.0 is base level)
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // AUDIO_H
|