?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
Simplify setting a fontsound link
[openal-soft.git] / Alc / panning.c
blob30a1e571056ccf8650ade9094d43dde3cf3fbe7f
1 /**
2 * OpenAL cross platform audio library
3 * Copyright (C) 1999-2010 by authors.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
13 *
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
18 * Or go to http://www.gnu.org/copyleft/lgpl.html
19 */
20
21 #include "config.h"
22
23 #include <math.h>
24 #include <stdlib.h>
25 #include <string.h>
26 #include <ctype.h>
27 #include <assert.h>
28
29 #include "alMain.h"
30 #include "AL/al.h"
31 #include "AL/alc.h"
32 #include "alu.h"
33
34 extern inline void SetGains(const ALCdevice *device, ALfloat ingain, ALfloat gains[MaxChannels]);
35
36 static void SetSpeakerArrangement(const char *name, ALfloat SpeakerAngle[MaxChannels],
37 enum Channel Speaker2Chan[MaxChannels], ALint chans)
38 {
39 char *confkey, *next;
40 char *layout_str;
41 char *sep, *end;
42 enum Channel val;
43 const char *str;
44 int i;
45
46 if(!ConfigValueStr(NULL, name, &str) && !ConfigValueStr(NULL, "layout", &str))
47 return;
48
49 layout_str = strdup(str);
50 next = confkey = layout_str;
51 while(next && *next)
52 {
53 confkey = next;
54 next = strchr(confkey, ',');
55 if(next)
56 {
57 *next = 0;
58 do {
59 next++;
60 } while(isspace(*next) || *next == ',');
61 }
62
63 sep = strchr(confkey, '=');
64 if(!sep || confkey == sep)
65 {
66 ERR("Malformed speaker key: %s\n", confkey);
67 continue;
68 }
69
70 end = sep - 1;
71 while(isspace(*end) && end != confkey)
72 end--;
73 *(++end) = 0;
74
75 if(strcmp(confkey, "fl") == 0 || strcmp(confkey, "front-left") == 0)
76 val = FrontLeft;
77 else if(strcmp(confkey, "fr") == 0 || strcmp(confkey, "front-right") == 0)
78 val = FrontRight;
79 else if(strcmp(confkey, "fc") == 0 || strcmp(confkey, "front-center") == 0)
80 val = FrontCenter;
81 else if(strcmp(confkey, "bl") == 0 || strcmp(confkey, "back-left") == 0)
82 val = BackLeft;
83 else if(strcmp(confkey, "br") == 0 || strcmp(confkey, "back-right") == 0)
84 val = BackRight;
85 else if(strcmp(confkey, "bc") == 0 || strcmp(confkey, "back-center") == 0)
86 val = BackCenter;
87 else if(strcmp(confkey, "sl") == 0 || strcmp(confkey, "side-left") == 0)
88 val = SideLeft;
89 else if(strcmp(confkey, "sr") == 0 || strcmp(confkey, "side-right") == 0)
90 val = SideRight;
91 else
92 {
93 ERR("Unknown speaker for %s: \"%s\"\n", name, confkey);
94 continue;
95 }
96
97 *(sep++) = 0;
98 while(isspace(*sep))
99 sep++;
100
101 for(i = 0;i < chans;i++)
102 {
103 if(Speaker2Chan[i] == val)
104 {
105 long angle = strtol(sep, NULL, 10);
106 if(angle >= -180 && angle <= 180)
107 SpeakerAngle[i] = DEG2RAD(angle);
108 else
109 ERR("Invalid angle for speaker \"%s\": %ld\n", confkey, angle);
110 break;
111 }
112 }
113 }
114 free(layout_str);
115 layout_str = NULL;
116
117 for(i = 0;i < chans;i++)
118 {
119 int min = i;
120 int i2;
121
122 for(i2 = i+1;i2 < chans;i2++)
123 {
124 if(SpeakerAngle[i2] < SpeakerAngle[min])
125 min = i2;
126 }
127
128 if(min != i)
129 {
130 ALfloat tmpf;
131 enum Channel tmpc;
132
133 tmpf = SpeakerAngle[i];
134 SpeakerAngle[i] = SpeakerAngle[min];
135 SpeakerAngle[min] = tmpf;
136
137 tmpc = Speaker2Chan[i];
138 Speaker2Chan[i] = Speaker2Chan[min];
139 Speaker2Chan[min] = tmpc;
140 }
141 }
142 }
143
144
145 void ComputeAngleGains(const ALCdevice *device, ALfloat angle, ALfloat hwidth, ALfloat ingain, ALfloat gains[MaxChannels])
146 {
147 ALfloat tmpgains[MaxChannels] = { 0.0f, 0.0f, 0.0f, 0.0f, 0.0f, 0.0f, 0.0f, 0.0f };
148 enum Channel Speaker2Chan[MaxChannels];
149 ALfloat SpeakerAngle[MaxChannels];
150 ALfloat langle, rangle;
151 ALfloat a;
152 ALuint i;
153
154 for(i = 0;i < device->NumChan;i++)
155 Speaker2Chan[i] = device->Speaker2Chan[i];
156 for(i = 0;i < device->NumChan;i++)
157 SpeakerAngle[i] = device->SpeakerAngle[i];
158
159 /* Some easy special-cases first... */
160 if(device->NumChan <= 1 || hwidth >= F_PI)
161 {
162 /* Full coverage for all speakers. */
163 for(i = 0;i < MaxChannels;i++)
164 gains[i] = 0.0f;
165 for(i = 0;i < device->NumChan;i++)
166 {
167 enum Channel chan = Speaker2Chan[i];
168 gains[chan] = ingain;
169 }
170 return;
171 }
172 if(hwidth <= 0.0f)
173 {
174 /* Infinitely small sound point. */
175 for(i = 0;i < MaxChannels;i++)
176 gains[i] = 0.0f;
177 for(i = 0;i < device->NumChan-1;i++)
178 {
179 if(angle >= SpeakerAngle[i] && angle < SpeakerAngle[i+1])
180 {
181 /* Sound is between speakers i and i+1 */
182 a = (angle-SpeakerAngle[i]) /
183 (SpeakerAngle[i+1]-SpeakerAngle[i]);
184 gains[Speaker2Chan[i]] = sqrtf(1.0f-a) * ingain;
185 gains[Speaker2Chan[i+1]] = sqrtf( a) * ingain;
186 return;
187 }
188 }
189 /* Sound is between last and first speakers */
190 if(angle < SpeakerAngle[0])
191 angle += F_2PI;
192 a = (angle-SpeakerAngle[i]) /
193 (F_2PI + SpeakerAngle[0]-SpeakerAngle[i]);
194 gains[Speaker2Chan[i]] = sqrtf(1.0f-a) * ingain;
195 gains[Speaker2Chan[0]] = sqrtf( a) * ingain;
196 return;
197 }
198
199 if(fabsf(angle)+hwidth > F_PI)
200 {
201 /* The coverage area would go outside of -pi...+pi. Instead, rotate the
202 * speaker angles so it would be as if angle=0, and keep them wrapped
203 * within -pi...+pi. */
204 if(angle > 0.0f)
205 {
206 ALuint done;
207 ALuint i = 0;
208 while(i < device->NumChan && device->SpeakerAngle[i]-angle < -F_PI)
209 i++;
210 for(done = 0;i < device->NumChan;done++)
211 {
212 SpeakerAngle[done] = device->SpeakerAngle[i]-angle;
213 Speaker2Chan[done] = device->Speaker2Chan[i];
214 i++;
215 }
216 for(i = 0;done < device->NumChan;i++)
217 {
218 SpeakerAngle[done] = device->SpeakerAngle[i]-angle + F_2PI;
219 Speaker2Chan[done] = device->Speaker2Chan[i];
220 done++;
221 }
222 }
223 else
224 {
225 /* NOTE: '< device->NumChan' on the iterators is correct here since
226 * we need to handle index 0. Because the iterators are unsigned,
227 * they'll underflow and wrap to become 0xFFFFFFFF, which will
228 * break as expected. */
229 ALuint done;
230 ALuint i = device->NumChan-1;
231 while(i < device->NumChan && device->SpeakerAngle[i]-angle > F_PI)
232 i--;
233 for(done = device->NumChan-1;i < device->NumChan;done--)
234 {
235 SpeakerAngle[done] = device->SpeakerAngle[i]-angle;
236 Speaker2Chan[done] = device->Speaker2Chan[i];
237 i--;
238 }
239 for(i = device->NumChan-1;done < device->NumChan;i--)
240 {
241 SpeakerAngle[done] = device->SpeakerAngle[i]-angle - F_2PI;
242 Speaker2Chan[done] = device->Speaker2Chan[i];
243 done--;
244 }
245 }
246 angle = 0.0f;
247 }
248 langle = angle - hwidth;
249 rangle = angle + hwidth;
250
251 /* First speaker */
252 i = 0;
253 do {
254 ALuint last = device->NumChan-1;
255 enum Channel chan = Speaker2Chan[i];
256
257 if(SpeakerAngle[i] >= langle && SpeakerAngle[i] <= rangle)
258 {
259 tmpgains[chan] = 1.0f;
260 continue;
261 }
262
263 if(SpeakerAngle[i] < langle && SpeakerAngle[i+1] > langle)
264 {
265 a = (langle-SpeakerAngle[i]) /
266 (SpeakerAngle[i+1]-SpeakerAngle[i]);
267 tmpgains[chan] = lerp(tmpgains[chan], 1.0f, 1.0f-a);
268 }
269 if(SpeakerAngle[i] > rangle)
270 {
271 a = (F_2PI + rangle-SpeakerAngle[last]) /
272 (F_2PI + SpeakerAngle[i]-SpeakerAngle[last]);
273 tmpgains[chan] = lerp(tmpgains[chan], 1.0f, a);
274 }
275 else if(SpeakerAngle[last] < rangle)
276 {
277 a = (rangle-SpeakerAngle[last]) /
278 (F_2PI + SpeakerAngle[i]-SpeakerAngle[last]);
279 tmpgains[chan] = lerp(tmpgains[chan], 1.0f, a);
280 }
281 } while(0);
282
283 for(i = 1;i < device->NumChan-1;i++)
284 {
285 enum Channel chan = Speaker2Chan[i];
286 if(SpeakerAngle[i] >= langle && SpeakerAngle[i] <= rangle)
287 {
288 tmpgains[chan] = 1.0f;
289 continue;
290 }
291
292 if(SpeakerAngle[i] < langle && SpeakerAngle[i+1] > langle)
293 {
294 a = (langle-SpeakerAngle[i]) /
295 (SpeakerAngle[i+1]-SpeakerAngle[i]);
296 tmpgains[chan] = lerp(tmpgains[chan], 1.0f, 1.0f-a);
297 }
298 if(SpeakerAngle[i] > rangle && SpeakerAngle[i-1] < rangle)
299 {
300 a = (rangle-SpeakerAngle[i-1]) /
301 (SpeakerAngle[i]-SpeakerAngle[i-1]);
302 tmpgains[chan] = lerp(tmpgains[chan], 1.0f, a);
303 }
304 }
305
306 /* Last speaker */
307 i = device->NumChan-1;
308 do {
309 enum Channel chan = Speaker2Chan[i];
310 if(SpeakerAngle[i] >= langle && SpeakerAngle[i] <= rangle)
311 {
312 tmpgains[Speaker2Chan[i]] = 1.0f;
313 continue;
314 }
315 if(SpeakerAngle[i] > rangle && SpeakerAngle[i-1] < rangle)
316 {
317 a = (rangle-SpeakerAngle[i-1]) /
318 (SpeakerAngle[i]-SpeakerAngle[i-1]);
319 tmpgains[chan] = lerp(tmpgains[chan], 1.0f, a);
320 }
321 if(SpeakerAngle[i] < langle)
322 {
323 a = (langle-SpeakerAngle[i]) /
324 (F_2PI + SpeakerAngle[0]-SpeakerAngle[i]);
325 tmpgains[chan] = lerp(tmpgains[chan], 1.0f, 1.0f-a);
326 }
327 else if(SpeakerAngle[0] > langle)
328 {
329 a = (F_2PI + langle-SpeakerAngle[i]) /
330 (F_2PI + SpeakerAngle[0]-SpeakerAngle[i]);
331 tmpgains[chan] = lerp(tmpgains[chan], 1.0f, 1.0f-a);
332 }
333 } while(0);
334
335 for(i = 0;i < device->NumChan;i++)
336 {
337 enum Channel chan = device->Speaker2Chan[i];
338 gains[chan] = sqrtf(tmpgains[chan]) * ingain;
339 }
340 }
341
342
343 ALvoid aluInitPanning(ALCdevice *Device)
344 {
345 const char *layoutname = NULL;
346 enum Channel *Speaker2Chan;
347 ALfloat *SpeakerAngle;
348
349 Speaker2Chan = Device->Speaker2Chan;
350 SpeakerAngle = Device->SpeakerAngle;
351 switch(Device->FmtChans)
352 {
353 case DevFmtMono:
354 Device->NumChan = 1;
355 Speaker2Chan[0] = FrontCenter;
356 SpeakerAngle[0] = DEG2RAD(0.0f);
357 layoutname = NULL;
358 break;
359
360 case DevFmtStereo:
361 Device->NumChan = 2;
362 Speaker2Chan[0] = FrontLeft;
363 Speaker2Chan[1] = FrontRight;
364 SpeakerAngle[0] = DEG2RAD(-90.0f);
365 SpeakerAngle[1] = DEG2RAD( 90.0f);
366 layoutname = "layout_stereo";
367 break;
368
369 case DevFmtQuad:
370 Device->NumChan = 4;
371 Speaker2Chan[0] = BackLeft;
372 Speaker2Chan[1] = FrontLeft;
373 Speaker2Chan[2] = FrontRight;
374 Speaker2Chan[3] = BackRight;
375 SpeakerAngle[0] = DEG2RAD(-135.0f);
376 SpeakerAngle[1] = DEG2RAD( -45.0f);
377 SpeakerAngle[2] = DEG2RAD( 45.0f);
378 SpeakerAngle[3] = DEG2RAD( 135.0f);
379 layoutname = "layout_quad";
380 break;
381
382 case DevFmtX51:
383 Device->NumChan = 5;
384 Speaker2Chan[0] = BackLeft;
385 Speaker2Chan[1] = FrontLeft;
386 Speaker2Chan[2] = FrontCenter;
387 Speaker2Chan[3] = FrontRight;
388 Speaker2Chan[4] = BackRight;
389 SpeakerAngle[0] = DEG2RAD(-110.0f);
390 SpeakerAngle[1] = DEG2RAD( -30.0f);
391 SpeakerAngle[2] = DEG2RAD( 0.0f);
392 SpeakerAngle[3] = DEG2RAD( 30.0f);
393 SpeakerAngle[4] = DEG2RAD( 110.0f);
394 layoutname = "layout_surround51";
395 break;
396
397 case DevFmtX51Side:
398 Device->NumChan = 5;
399 Speaker2Chan[0] = SideLeft;
400 Speaker2Chan[1] = FrontLeft;
401 Speaker2Chan[2] = FrontCenter;
402 Speaker2Chan[3] = FrontRight;
403 Speaker2Chan[4] = SideRight;
404 SpeakerAngle[0] = DEG2RAD(-90.0f);
405 SpeakerAngle[1] = DEG2RAD(-30.0f);
406 SpeakerAngle[2] = DEG2RAD( 0.0f);
407 SpeakerAngle[3] = DEG2RAD( 30.0f);
408 SpeakerAngle[4] = DEG2RAD( 90.0f);
409 layoutname = "layout_side51";
410 break;
411
412 case DevFmtX61:
413 Device->NumChan = 6;
414 Speaker2Chan[0] = SideLeft;
415 Speaker2Chan[1] = FrontLeft;
416 Speaker2Chan[2] = FrontCenter;
417 Speaker2Chan[3] = FrontRight;
418 Speaker2Chan[4] = SideRight;
419 Speaker2Chan[5] = BackCenter;
420 SpeakerAngle[0] = DEG2RAD(-90.0f);
421 SpeakerAngle[1] = DEG2RAD(-30.0f);
422 SpeakerAngle[2] = DEG2RAD( 0.0f);
423 SpeakerAngle[3] = DEG2RAD( 30.0f);
424 SpeakerAngle[4] = DEG2RAD( 90.0f);
425 SpeakerAngle[5] = DEG2RAD(180.0f);
426 layoutname = "layout_surround61";
427 break;
428
429 case DevFmtX71:
430 Device->NumChan = 7;
431 Speaker2Chan[0] = BackLeft;
432 Speaker2Chan[1] = SideLeft;
433 Speaker2Chan[2] = FrontLeft;
434 Speaker2Chan[3] = FrontCenter;
435 Speaker2Chan[4] = FrontRight;
436 Speaker2Chan[5] = SideRight;
437 Speaker2Chan[6] = BackRight;
438 SpeakerAngle[0] = DEG2RAD(-150.0f);
439 SpeakerAngle[1] = DEG2RAD( -90.0f);
440 SpeakerAngle[2] = DEG2RAD( -30.0f);
441 SpeakerAngle[3] = DEG2RAD( 0.0f);
442 SpeakerAngle[4] = DEG2RAD( 30.0f);
443 SpeakerAngle[5] = DEG2RAD( 90.0f);
444 SpeakerAngle[6] = DEG2RAD( 150.0f);
445 layoutname = "layout_surround71";
446 break;
447 }
448 if(layoutname && Device->Type != Loopback)
449 SetSpeakerArrangement(layoutname, SpeakerAngle, Speaker2Chan, Device->NumChan);
450 }
Software OpenAL implementation