4 This file is part of PulseAudio.
6 Copyright 2005-2006 Lennart Poettering
7 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
9 PulseAudio is free software; you can redistribute it and/or modify
10 it under the terms of the GNU Lesser General Public License as published
11 by the Free Software Foundation; either version 2 of the License,
12 or (at your option) any later version.
14 PulseAudio is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public License
20 along with PulseAudio; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
34 #include <pulse/xmalloc.h>
35 #include <pulsecore/core-util.h>
37 #include "channelmap.h"
39 const char *const table
[] = {
40 [PA_CHANNEL_POSITION_MONO
] = "mono",
42 [PA_CHANNEL_POSITION_FRONT_CENTER
] = "front-center",
43 [PA_CHANNEL_POSITION_FRONT_LEFT
] = "front-left",
44 [PA_CHANNEL_POSITION_FRONT_RIGHT
] = "front-right",
46 [PA_CHANNEL_POSITION_REAR_CENTER
] = "rear-center",
47 [PA_CHANNEL_POSITION_REAR_LEFT
] = "rear-left",
48 [PA_CHANNEL_POSITION_REAR_RIGHT
] = "rear-right",
50 [PA_CHANNEL_POSITION_LFE
] = "lfe",
52 [PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER
] = "front-left-of-center",
53 [PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER
] = "front-right-of-center",
55 [PA_CHANNEL_POSITION_SIDE_LEFT
] = "side-left",
56 [PA_CHANNEL_POSITION_SIDE_RIGHT
] = "side-right",
58 [PA_CHANNEL_POSITION_AUX0
] = "aux0",
59 [PA_CHANNEL_POSITION_AUX1
] = "aux1",
60 [PA_CHANNEL_POSITION_AUX2
] = "aux2",
61 [PA_CHANNEL_POSITION_AUX3
] = "aux3",
62 [PA_CHANNEL_POSITION_AUX4
] = "aux4",
63 [PA_CHANNEL_POSITION_AUX5
] = "aux5",
64 [PA_CHANNEL_POSITION_AUX6
] = "aux6",
65 [PA_CHANNEL_POSITION_AUX7
] = "aux7",
66 [PA_CHANNEL_POSITION_AUX8
] = "aux8",
67 [PA_CHANNEL_POSITION_AUX9
] = "aux9",
68 [PA_CHANNEL_POSITION_AUX10
] = "aux10",
69 [PA_CHANNEL_POSITION_AUX11
] = "aux11",
70 [PA_CHANNEL_POSITION_AUX12
] = "aux12",
71 [PA_CHANNEL_POSITION_AUX13
] = "aux13",
72 [PA_CHANNEL_POSITION_AUX14
] = "aux14",
73 [PA_CHANNEL_POSITION_AUX15
] = "aux15",
74 [PA_CHANNEL_POSITION_AUX16
] = "aux16",
75 [PA_CHANNEL_POSITION_AUX17
] = "aux17",
76 [PA_CHANNEL_POSITION_AUX18
] = "aux18",
77 [PA_CHANNEL_POSITION_AUX19
] = "aux19",
78 [PA_CHANNEL_POSITION_AUX20
] = "aux20",
79 [PA_CHANNEL_POSITION_AUX21
] = "aux21",
80 [PA_CHANNEL_POSITION_AUX22
] = "aux22",
81 [PA_CHANNEL_POSITION_AUX23
] = "aux23",
82 [PA_CHANNEL_POSITION_AUX24
] = "aux24",
83 [PA_CHANNEL_POSITION_AUX25
] = "aux25",
84 [PA_CHANNEL_POSITION_AUX26
] = "aux26",
85 [PA_CHANNEL_POSITION_AUX27
] = "aux27",
86 [PA_CHANNEL_POSITION_AUX28
] = "aux28",
87 [PA_CHANNEL_POSITION_AUX29
] = "aux29",
88 [PA_CHANNEL_POSITION_AUX30
] = "aux30",
89 [PA_CHANNEL_POSITION_AUX31
] = "aux31",
91 [PA_CHANNEL_POSITION_TOP_CENTER
] = "top-center",
93 [PA_CHANNEL_POSITION_TOP_FRONT_LEFT
] = "top-front-left",
94 [PA_CHANNEL_POSITION_TOP_FRONT_RIGHT
] = "top-front-right",
95 [PA_CHANNEL_POSITION_TOP_FRONT_CENTER
] = "top-front-center",
97 [PA_CHANNEL_POSITION_TOP_REAR_LEFT
] = "top-rear-left",
98 [PA_CHANNEL_POSITION_TOP_REAR_RIGHT
] = "top-rear-right",
99 [PA_CHANNEL_POSITION_TOP_REAR_CENTER
] = "top-rear-center"
102 pa_channel_map
* pa_channel_map_init(pa_channel_map
*m
) {
108 for (c
= 0; c
< PA_CHANNELS_MAX
; c
++)
109 m
->map
[c
] = PA_CHANNEL_POSITION_INVALID
;
114 pa_channel_map
* pa_channel_map_init_mono(pa_channel_map
*m
) {
117 pa_channel_map_init(m
);
120 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
124 pa_channel_map
* pa_channel_map_init_stereo(pa_channel_map
*m
) {
127 pa_channel_map_init(m
);
130 m
->map
[0] = PA_CHANNEL_POSITION_LEFT
;
131 m
->map
[1] = PA_CHANNEL_POSITION_RIGHT
;
135 pa_channel_map
* pa_channel_map_init_auto(pa_channel_map
*m
, unsigned channels
, pa_channel_map_def_t def
) {
137 assert(channels
> 0);
138 assert(channels
<= PA_CHANNELS_MAX
);
140 pa_channel_map_init(m
);
142 m
->channels
= channels
;
145 case PA_CHANNEL_MAP_AIFF
:
147 /* This is somewhat compatible with RFC3551 */
151 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
155 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
156 m
->map
[1] = PA_CHANNEL_POSITION_SIDE_LEFT
;
157 m
->map
[2] = PA_CHANNEL_POSITION_FRONT_CENTER
;
158 m
->map
[3] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
159 m
->map
[4] = PA_CHANNEL_POSITION_SIDE_RIGHT
;
160 m
->map
[5] = PA_CHANNEL_POSITION_LFE
;
164 m
->map
[2] = PA_CHANNEL_POSITION_FRONT_CENTER
;
165 m
->map
[3] = PA_CHANNEL_POSITION_REAR_LEFT
;
166 m
->map
[4] = PA_CHANNEL_POSITION_REAR_RIGHT
;
170 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
171 m
->map
[1] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
175 m
->map
[0] = PA_CHANNEL_POSITION_LEFT
;
176 m
->map
[1] = PA_CHANNEL_POSITION_RIGHT
;
177 m
->map
[2] = PA_CHANNEL_POSITION_CENTER
;
181 m
->map
[0] = PA_CHANNEL_POSITION_LEFT
;
182 m
->map
[1] = PA_CHANNEL_POSITION_CENTER
;
183 m
->map
[2] = PA_CHANNEL_POSITION_RIGHT
;
184 m
->map
[3] = PA_CHANNEL_POSITION_LFE
;
191 case PA_CHANNEL_MAP_ALSA
:
195 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
199 m
->map
[6] = PA_CHANNEL_POSITION_SIDE_LEFT
;
200 m
->map
[7] = PA_CHANNEL_POSITION_SIDE_RIGHT
;
204 m
->map
[5] = PA_CHANNEL_POSITION_LFE
;
208 m
->map
[4] = PA_CHANNEL_POSITION_FRONT_CENTER
;
212 m
->map
[2] = PA_CHANNEL_POSITION_REAR_LEFT
;
213 m
->map
[3] = PA_CHANNEL_POSITION_REAR_RIGHT
;
217 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
218 m
->map
[1] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
225 case PA_CHANNEL_MAP_AUX
: {
228 if (channels
>= PA_CHANNELS_MAX
)
231 for (i
= 0; i
< channels
; i
++)
232 m
->map
[i
] = PA_CHANNEL_POSITION_AUX0
+ i
;
237 case PA_CHANNEL_MAP_WAVEEX
:
241 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
245 m
->map
[15] = PA_CHANNEL_POSITION_TOP_REAR_LEFT
;
246 m
->map
[16] = PA_CHANNEL_POSITION_TOP_REAR_CENTER
;
247 m
->map
[17] = PA_CHANNEL_POSITION_TOP_REAR_RIGHT
;
251 m
->map
[12] = PA_CHANNEL_POSITION_TOP_FRONT_LEFT
;
252 m
->map
[13] = PA_CHANNEL_POSITION_TOP_FRONT_CENTER
;
253 m
->map
[14] = PA_CHANNEL_POSITION_TOP_FRONT_RIGHT
;
257 m
->map
[11] = PA_CHANNEL_POSITION_TOP_CENTER
;
261 m
->map
[9] = PA_CHANNEL_POSITION_SIDE_LEFT
;
262 m
->map
[10] = PA_CHANNEL_POSITION_SIDE_RIGHT
;
266 m
->map
[8] = PA_CHANNEL_POSITION_REAR_CENTER
;
270 m
->map
[6] = PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER
;
271 m
->map
[7] = PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER
;
275 m
->map
[4] = PA_CHANNEL_POSITION_REAR_LEFT
;
276 m
->map
[5] = PA_CHANNEL_POSITION_REAR_RIGHT
;
280 m
->map
[3] = PA_CHANNEL_POSITION_LFE
;
284 m
->map
[2] = PA_CHANNEL_POSITION_FRONT_CENTER
;
288 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
289 m
->map
[1] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
296 case PA_CHANNEL_MAP_OSS
:
300 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
304 m
->map
[6] = PA_CHANNEL_POSITION_REAR_LEFT
;
305 m
->map
[7] = PA_CHANNEL_POSITION_REAR_RIGHT
;
309 m
->map
[4] = PA_CHANNEL_POSITION_SIDE_LEFT
;
310 m
->map
[5] = PA_CHANNEL_POSITION_SIDE_RIGHT
;
314 m
->map
[3] = PA_CHANNEL_POSITION_LFE
;
318 m
->map
[2] = PA_CHANNEL_POSITION_FRONT_CENTER
;
322 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
323 m
->map
[1] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
337 const char* pa_channel_position_to_string(pa_channel_position_t pos
) {
339 if (pos
< 0 || pos
>= PA_CHANNEL_POSITION_MAX
)
345 int pa_channel_map_equal(const pa_channel_map
*a
, const pa_channel_map
*b
) {
351 if (a
->channels
!= b
->channels
)
354 for (c
= 0; c
< a
->channels
; c
++)
355 if (a
->map
[c
] != b
->map
[c
])
361 char* pa_channel_map_snprint(char *s
, size_t l
, const pa_channel_map
*map
) {
372 for (channel
= 0; channel
< map
->channels
&& l
> 1; channel
++) {
373 l
-= snprintf(e
, l
, "%s%s",
375 pa_channel_position_to_string(map
->map
[channel
]));
384 pa_channel_map
*pa_channel_map_parse(pa_channel_map
*rmap
, const char *s
) {
392 memset(&map
, 0, sizeof(map
));
394 if (strcmp(s
, "stereo") == 0) {
396 map
.map
[0] = PA_CHANNEL_POSITION_LEFT
;
397 map
.map
[1] = PA_CHANNEL_POSITION_RIGHT
;
404 while ((p
= pa_split(s
, ",", &state
))) {
406 if (map
.channels
>= PA_CHANNELS_MAX
) {
411 /* Some special aliases */
412 if (strcmp(p
, "left") == 0)
413 map
.map
[map
.channels
++] = PA_CHANNEL_POSITION_LEFT
;
414 else if (strcmp(p
, "right") == 0)
415 map
.map
[map
.channels
++] = PA_CHANNEL_POSITION_RIGHT
;
416 else if (strcmp(p
, "center") == 0)
417 map
.map
[map
.channels
++] = PA_CHANNEL_POSITION_CENTER
;
418 else if (strcmp(p
, "subwoofer") == 0)
419 map
.map
[map
.channels
++] = PA_CHANNEL_POSITION_SUBWOOFER
;
421 pa_channel_position_t i
;
423 for (i
= 0; i
< PA_CHANNEL_POSITION_MAX
; i
++)
424 if (strcmp(p
, table
[i
]) == 0) {
425 map
.map
[map
.channels
++] = i
;
429 if (i
>= PA_CHANNEL_POSITION_MAX
) {
440 if (!pa_channel_map_valid(&map
))
447 int pa_channel_map_valid(const pa_channel_map
*map
) {
452 if (map
->channels
<= 0 || map
->channels
> PA_CHANNELS_MAX
)
455 for (c
= 0; c
< map
->channels
; c
++) {
457 if (map
->map
[c
] < 0 ||map
->map
[c
] >= PA_CHANNEL_POSITION_MAX
)