Project::OSiRiON - Git repositories
Project::OSiRiON
News . About . Screenshots . Downloads . Forum . Wiki . Tracker . Git
summaryrefslogtreecommitdiff
blob: 073fb67f74c015633bcc7dc9c29092f8c41ab440 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
/*
   audio/audio.h
   This file is part of the Osirion project and is distributed under
   the terms of the GNU General Public License version 2
*/

#ifndef __INCLUDED_AUDIO_AUDIO_H__
#define __INCLUDED_AUDIO_AUDIO_H__

#include <iostream>
#include "sys/sys.h"

#ifdef _WIN32
#include <windows.h>
#endif

#ifdef _OSX
#include "OpenAL/al.h"
#include "OpenAL/alc.h"
#else
#include "AL/al.h"
#include "AL/alc.h"
#endif

#include "math/vector3f.h"
#include "math/axis.h"

/// functions to handle audio
namespace audio
{

/// initialize the audio subsystem
void init();

/// shut down the audio subsystem
void shutdown();

/// reload audio
void reset();

/// load an audio sample
void load(const char *name);

/// play a previously loaded audio sample on the ui channel
size_t play(const char *name);

/// playe a sound from a specific buffer on a specific source
size_t play(size_t source_index, size_t buffer_index, float pitch = 1.0f, float gain = 1.0f);

/// play a looping sound on a specified source
size_t loop(size_t source_index, const char *name, float pitch = 1.0f, float gain = 1.0f);

/// play a looping sound from a specified buffer on a specified source
size_t loop(size_t source_index, size_t buffer_index, float pitch, float gain);

/// update source parameters
void update_source(size_t source_index, math::Vector3f const & location, math::Vector3f const & velocity, float pitch = 1.0f, float gain = 1.0f);

/// update listener parameters
void update_listener(math::Vector3f const &location, math::Axis const &axis, math::Vector3f const & velocity, float gain = 1.0f);

/// return true is a source is playing
bool is_playing(const size_t source_index);

/// return true if audio is initialized
bool initialized();

}

#endif // __INCLUDED_AUDIO_AUDIO_H__