1
/* $Id: channelmap.c 1033 2006-06-19 21:53:48Z lennart $ */
4
This file is part of PulseAudio.
6
PulseAudio is free software; you can redistribute it and/or modify
7
it under the terms of the GNU Lesser General Public License as published
8
by the Free Software Foundation; either version 2 of the License,
9
or (at your option) any later version.
11
PulseAudio is distributed in the hope that it will be useful, but
12
WITHOUT ANY WARRANTY; without even the implied warranty of
13
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14
General Public License for more details.
16
You should have received a copy of the GNU Lesser General Public License
17
along with PulseAudio; if not, write to the Free Software
18
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
31
#include <pulse/xmalloc.h>
32
#include <pulsecore/core-util.h>
34
#include "channelmap.h"
36
const char *const table[] = {
37
[PA_CHANNEL_POSITION_MONO] = "mono",
39
[PA_CHANNEL_POSITION_FRONT_CENTER] = "front-center",
40
[PA_CHANNEL_POSITION_FRONT_LEFT] = "front-left",
41
[PA_CHANNEL_POSITION_FRONT_RIGHT] = "front-right",
43
[PA_CHANNEL_POSITION_REAR_CENTER] = "rear-center",
44
[PA_CHANNEL_POSITION_REAR_LEFT] = "rear-left",
45
[PA_CHANNEL_POSITION_REAR_RIGHT] = "rear-right",
47
[PA_CHANNEL_POSITION_LFE] = "lfe",
49
[PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER] = "front-left-of-center",
50
[PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER] = "front-right-of-center",
52
[PA_CHANNEL_POSITION_SIDE_LEFT] = "side-left",
53
[PA_CHANNEL_POSITION_SIDE_RIGHT] = "side-right",
55
[PA_CHANNEL_POSITION_AUX0] = "aux0",
56
[PA_CHANNEL_POSITION_AUX1] = "aux1",
57
[PA_CHANNEL_POSITION_AUX2] = "aux2",
58
[PA_CHANNEL_POSITION_AUX3] = "aux3",
59
[PA_CHANNEL_POSITION_AUX4] = "aux4",
60
[PA_CHANNEL_POSITION_AUX5] = "aux5",
61
[PA_CHANNEL_POSITION_AUX6] = "aux6",
62
[PA_CHANNEL_POSITION_AUX7] = "aux7",
63
[PA_CHANNEL_POSITION_AUX8] = "aux8",
64
[PA_CHANNEL_POSITION_AUX9] = "aux9",
65
[PA_CHANNEL_POSITION_AUX10] = "aux10",
66
[PA_CHANNEL_POSITION_AUX11] = "aux11",
67
[PA_CHANNEL_POSITION_AUX12] = "aux12",
68
[PA_CHANNEL_POSITION_AUX13] = "aux13",
69
[PA_CHANNEL_POSITION_AUX14] = "aux14",
70
[PA_CHANNEL_POSITION_AUX15] = "aux15",
72
[PA_CHANNEL_POSITION_TOP_CENTER] = "top-center",
74
[PA_CHANNEL_POSITION_TOP_FRONT_LEFT] = "top-front-left",
75
[PA_CHANNEL_POSITION_TOP_FRONT_RIGHT] = "top-front-right",
76
[PA_CHANNEL_POSITION_TOP_FRONT_CENTER] = "top-front-center",
78
[PA_CHANNEL_POSITION_TOP_REAR_LEFT] = "top-rear-left",
79
[PA_CHANNEL_POSITION_TOP_REAR_RIGHT] = "top-rear-right",
80
[PA_CHANNEL_POSITION_TOP_REAR_CENTER] = "top-rear-center"
83
pa_channel_map* pa_channel_map_init(pa_channel_map *m) {
89
for (c = 0; c < PA_CHANNELS_MAX; c++)
90
m->map[c] = PA_CHANNEL_POSITION_INVALID;
95
pa_channel_map* pa_channel_map_init_mono(pa_channel_map *m) {
98
pa_channel_map_init(m);
101
m->map[0] = PA_CHANNEL_POSITION_MONO;
105
pa_channel_map* pa_channel_map_init_stereo(pa_channel_map *m) {
108
pa_channel_map_init(m);
111
m->map[0] = PA_CHANNEL_POSITION_LEFT;
112
m->map[1] = PA_CHANNEL_POSITION_RIGHT;
116
pa_channel_map* pa_channel_map_init_auto(pa_channel_map *m, unsigned channels, pa_channel_map_def_t def) {
118
assert(channels > 0);
119
assert(channels <= PA_CHANNELS_MAX);
121
pa_channel_map_init(m);
123
m->channels = channels;
126
case PA_CHANNEL_MAP_AIFF:
128
/* This is somewhat compatible with RFC3551 */
132
m->map[0] = PA_CHANNEL_POSITION_MONO;
136
m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT;
137
m->map[1] = PA_CHANNEL_POSITION_SIDE_LEFT;
138
m->map[2] = PA_CHANNEL_POSITION_FRONT_CENTER;
139
m->map[3] = PA_CHANNEL_POSITION_FRONT_RIGHT;
140
m->map[4] = PA_CHANNEL_POSITION_SIDE_RIGHT;
141
m->map[5] = PA_CHANNEL_POSITION_LFE;
145
m->map[2] = PA_CHANNEL_POSITION_FRONT_CENTER;
146
m->map[3] = PA_CHANNEL_POSITION_REAR_LEFT;
147
m->map[4] = PA_CHANNEL_POSITION_REAR_RIGHT;
151
m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT;
152
m->map[1] = PA_CHANNEL_POSITION_FRONT_RIGHT;
156
m->map[0] = PA_CHANNEL_POSITION_LEFT;
157
m->map[1] = PA_CHANNEL_POSITION_RIGHT;
158
m->map[2] = PA_CHANNEL_POSITION_CENTER;
162
m->map[0] = PA_CHANNEL_POSITION_LEFT;
163
m->map[1] = PA_CHANNEL_POSITION_CENTER;
164
m->map[2] = PA_CHANNEL_POSITION_RIGHT;
165
m->map[3] = PA_CHANNEL_POSITION_LFE;
172
case PA_CHANNEL_MAP_ALSA:
176
m->map[0] = PA_CHANNEL_POSITION_MONO;
180
m->map[6] = PA_CHANNEL_POSITION_SIDE_LEFT;
181
m->map[7] = PA_CHANNEL_POSITION_SIDE_RIGHT;
185
m->map[5] = PA_CHANNEL_POSITION_LFE;
189
m->map[4] = PA_CHANNEL_POSITION_FRONT_CENTER;
193
m->map[2] = PA_CHANNEL_POSITION_REAR_LEFT;
194
m->map[3] = PA_CHANNEL_POSITION_REAR_RIGHT;
198
m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT;
199
m->map[1] = PA_CHANNEL_POSITION_FRONT_RIGHT;
206
case PA_CHANNEL_MAP_AUX: {
209
if (channels >= PA_CHANNELS_MAX)
212
for (i = 0; i < channels; i++)
213
m->map[i] = PA_CHANNEL_POSITION_AUX0 + i;
218
case PA_CHANNEL_MAP_WAVEEX:
222
m->map[0] = PA_CHANNEL_POSITION_MONO;
226
m->map[15] = PA_CHANNEL_POSITION_TOP_REAR_LEFT;
227
m->map[16] = PA_CHANNEL_POSITION_TOP_REAR_CENTER;
228
m->map[17] = PA_CHANNEL_POSITION_TOP_REAR_RIGHT;
232
m->map[12] = PA_CHANNEL_POSITION_TOP_FRONT_LEFT;
233
m->map[13] = PA_CHANNEL_POSITION_TOP_FRONT_CENTER;
234
m->map[14] = PA_CHANNEL_POSITION_TOP_FRONT_RIGHT;
238
m->map[11] = PA_CHANNEL_POSITION_TOP_CENTER;
242
m->map[9] = PA_CHANNEL_POSITION_SIDE_LEFT;
243
m->map[10] = PA_CHANNEL_POSITION_SIDE_RIGHT;
247
m->map[8] = PA_CHANNEL_POSITION_REAR_CENTER;
251
m->map[6] = PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER;
252
m->map[7] = PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER;
256
m->map[4] = PA_CHANNEL_POSITION_REAR_LEFT;
257
m->map[5] = PA_CHANNEL_POSITION_REAR_RIGHT;
261
m->map[3] = PA_CHANNEL_POSITION_LFE;
265
m->map[2] = PA_CHANNEL_POSITION_FRONT_CENTER;
269
m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT;
270
m->map[1] = PA_CHANNEL_POSITION_FRONT_RIGHT;
277
case PA_CHANNEL_MAP_OSS:
281
m->map[0] = PA_CHANNEL_POSITION_MONO;
285
m->map[6] = PA_CHANNEL_POSITION_REAR_LEFT;
286
m->map[7] = PA_CHANNEL_POSITION_REAR_RIGHT;
290
m->map[4] = PA_CHANNEL_POSITION_SIDE_LEFT;
291
m->map[5] = PA_CHANNEL_POSITION_SIDE_RIGHT;
295
m->map[3] = PA_CHANNEL_POSITION_LFE;
299
m->map[2] = PA_CHANNEL_POSITION_FRONT_CENTER;
303
m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT;
304
m->map[1] = PA_CHANNEL_POSITION_FRONT_RIGHT;
318
const char* pa_channel_position_to_string(pa_channel_position_t pos) {
320
if (pos < 0 || pos >= PA_CHANNEL_POSITION_MAX)
326
int pa_channel_map_equal(const pa_channel_map *a, const pa_channel_map *b) {
332
if (a->channels != b->channels)
335
for (c = 0; c < a->channels; c++)
336
if (a->map[c] != b->map[c])
342
char* pa_channel_map_snprint(char *s, size_t l, const pa_channel_map *map) {
353
for (channel = 0; channel < map->channels && l > 1; channel++) {
354
l -= snprintf(e, l, "%s%s",
356
pa_channel_position_to_string(map->map[channel]));
365
pa_channel_map *pa_channel_map_parse(pa_channel_map *rmap, const char *s) {
373
memset(&map, 0, sizeof(map));
375
if (strcmp(s, "stereo") == 0) {
377
map.map[0] = PA_CHANNEL_POSITION_LEFT;
378
map.map[1] = PA_CHANNEL_POSITION_RIGHT;
385
while ((p = pa_split(s, ",", &state))) {
387
if (map.channels >= PA_CHANNELS_MAX) {
392
/* Some special aliases */
393
if (strcmp(p, "left") == 0)
394
map.map[map.channels++] = PA_CHANNEL_POSITION_LEFT;
395
else if (strcmp(p, "right") == 0)
396
map.map[map.channels++] = PA_CHANNEL_POSITION_RIGHT;
397
else if (strcmp(p, "center") == 0)
398
map.map[map.channels++] = PA_CHANNEL_POSITION_CENTER;
399
else if (strcmp(p, "subwoofer") == 0)
400
map.map[map.channels++] = PA_CHANNEL_POSITION_SUBWOOFER;
402
pa_channel_position_t i;
404
for (i = 0; i < PA_CHANNEL_POSITION_MAX; i++)
405
if (strcmp(p, table[i]) == 0) {
406
map.map[map.channels++] = i;
410
if (i >= PA_CHANNEL_POSITION_MAX) {
421
if (!pa_channel_map_valid(&map))
428
int pa_channel_map_valid(const pa_channel_map *map) {
433
if (map->channels <= 0 || map->channels > PA_CHANNELS_MAX)
436
for (c = 0; c < map->channels; c++) {
438
if (map->map[c] < 0 ||map->map[c] >= PA_CHANNEL_POSITION_MAX)