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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
/**
* OpenAL++ - an object oriented toolkit for spatial sound
* Copyright (C) 2002 VRlab, Ume University
*
* OpenAL++ was created using the libraries:
* OpenAL (http://www.openal.org),
* PortAudio (http://www.portaudio.com/), and
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
*/
#ifndef GROUPSOURCE_H_INCLUDED_C427B440
#define GROUPSOURCE_H_INCLUDED_C427B440
#include "openalpp/source.h"
#include "openalpp/audioconvert.h"
#include <vector>
#include <math.h>
#include <stdlib.h>
#include "openalpp/export.h"
#include "openalpp/ref_ptr.h"
namespace openalpp {
/**
* Class for group sources.
* Used for mixing together several sources _before_ they are played. This can
* be used to play more sounds with less processing power. Of course the
* problem is that the sources cannot be moved separately.
*/
class OPENALPP_API GroupSource : public SourceBase {
/**
* Flag for whether the sources have been mixed yet.
*/
bool mixed_;
/**
* Vector containing the sources in the group.
*/
std::vector<openalpp::ref_ptr<Source> > sources_;
/**
* OpenAL buffer for the group source.
*/
ALuint buffer_;
typedef enum Speaker {Left,Right};
/**
* Handles distance attenuation and directional sources.
* @param source is the source to filter.
* @return the gain.
*/
ALfloat filterDistance(ALuint source,Speaker speaker);
/**
* Reverb filter.
* @param source is (a pointer to) the source.
* @param buffer is (a pointer to) the buffer (=memory area).
* @param size is the size of the buffer.
* @param frequency is the freguency of the sound.
* @return new pointer to buffer.
*/
ALshort *filterReverb(Source *source,ALshort *buffer,
ALsizei &size,unsigned int frequency);
/**
* Apply filters.
* @param source is (a pointer to) the source.
* @param buffer is the buffer containing the sound.
* @param size is the size of the buffer.
* @param frequency is the frequency of the sound.
* @return (new) pointer to buffer.
*/
ALshort *applyFilters(Source *source,ALshort *buffer,ALsizei &size,
unsigned int frequency);
public:
/**
* Constructor.
* Creates the group source at the specified position.
* @param x x coordinate.
* @param y y coordinate.
* @param z z coordinate.
*/
GroupSource(float x = 0.0, float y = 0.0, float z = 0.0) throw (NameError);
/**
* Same as SourceBase::Play, except that this mixes the sources in the
* group if it haven't been done yet.
*/
void play() throw (InitError,FileError);
/**
* Mix all added sources into one. This function will be called by
* Play(), if sources have been included since the last time MixSamples()
* was called, so if you want the source to start playing as fast as
* possible after the Play()-call, MixSources() should be called
* separately
* @param frequency is the frequency that will be used when mixing.
*/
void mixSources(unsigned int frequency=22050)
throw (InitError,FileError,FatalError,MemoryError,ValueError);
/**
* Includes a source in the group.
* Returns an identifier that can be used as an argument to ExcludeSource().
* This identifier is also the OpenAL name for the included source.
* @param source is (a pointer to) the source to include.
* @return identifier for the source.
*/
ALuint includeSource(Source *source) throw (ValueError);
/**
* Removes a source from the group.
* This will of course require the remaining sources to be mixed again.
* @param source is the source to exclude.
*/
void excludeSource(const Source &source) throw (NameError);
/**
* Removes a source from the group.
* This will of course require the remaining sources to be mixed again.
* @param source is the identifier of the source to exclude.
*/
void excludeSource(ALuint source) throw (NameError);
/**
* Copy constructor.
*/
GroupSource(const GroupSource &groupsource);
/**
* Assignment operator.
*/
GroupSource &operator=(const GroupSource &groupsource);
protected:
/**
* Destructor.
*/
virtual ~GroupSource();
};
}
#endif /* GROUPSOURCE_H_INCLUDED_C427B440 */
|
