2 This file is part of PulseAudio.
4 Copyright 2005-2006 Lennart Poettering
5 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
7 PulseAudio is free software; you can redistribute it and/or modify
8 it under the terms of the GNU Lesser General Public License as published
9 by the Free Software Foundation; either version 2 of the License,
10 or (at your option) any later version.
12 PulseAudio is distributed in the hope that it will be useful, but
13 WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 General Public License for more details.
17 You should have received a copy of the GNU Lesser General Public License
18 along with PulseAudio; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
31 #include <pulse/xmalloc.h>
32 #include <pulse/i18n.h>
33 #include <pulsecore/core-util.h>
34 #include <pulsecore/macro.h>
36 #include "channelmap.h"
38 const char *const table
[PA_CHANNEL_POSITION_MAX
] = {
39 [PA_CHANNEL_POSITION_MONO
] = "mono",
41 [PA_CHANNEL_POSITION_FRONT_CENTER
] = "front-center",
42 [PA_CHANNEL_POSITION_FRONT_LEFT
] = "front-left",
43 [PA_CHANNEL_POSITION_FRONT_RIGHT
] = "front-right",
45 [PA_CHANNEL_POSITION_REAR_CENTER
] = "rear-center",
46 [PA_CHANNEL_POSITION_REAR_LEFT
] = "rear-left",
47 [PA_CHANNEL_POSITION_REAR_RIGHT
] = "rear-right",
49 [PA_CHANNEL_POSITION_LFE
] = "lfe",
51 [PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER
] = "front-left-of-center",
52 [PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER
] = "front-right-of-center",
54 [PA_CHANNEL_POSITION_SIDE_LEFT
] = "side-left",
55 [PA_CHANNEL_POSITION_SIDE_RIGHT
] = "side-right",
57 [PA_CHANNEL_POSITION_AUX0
] = "aux0",
58 [PA_CHANNEL_POSITION_AUX1
] = "aux1",
59 [PA_CHANNEL_POSITION_AUX2
] = "aux2",
60 [PA_CHANNEL_POSITION_AUX3
] = "aux3",
61 [PA_CHANNEL_POSITION_AUX4
] = "aux4",
62 [PA_CHANNEL_POSITION_AUX5
] = "aux5",
63 [PA_CHANNEL_POSITION_AUX6
] = "aux6",
64 [PA_CHANNEL_POSITION_AUX7
] = "aux7",
65 [PA_CHANNEL_POSITION_AUX8
] = "aux8",
66 [PA_CHANNEL_POSITION_AUX9
] = "aux9",
67 [PA_CHANNEL_POSITION_AUX10
] = "aux10",
68 [PA_CHANNEL_POSITION_AUX11
] = "aux11",
69 [PA_CHANNEL_POSITION_AUX12
] = "aux12",
70 [PA_CHANNEL_POSITION_AUX13
] = "aux13",
71 [PA_CHANNEL_POSITION_AUX14
] = "aux14",
72 [PA_CHANNEL_POSITION_AUX15
] = "aux15",
73 [PA_CHANNEL_POSITION_AUX16
] = "aux16",
74 [PA_CHANNEL_POSITION_AUX17
] = "aux17",
75 [PA_CHANNEL_POSITION_AUX18
] = "aux18",
76 [PA_CHANNEL_POSITION_AUX19
] = "aux19",
77 [PA_CHANNEL_POSITION_AUX20
] = "aux20",
78 [PA_CHANNEL_POSITION_AUX21
] = "aux21",
79 [PA_CHANNEL_POSITION_AUX22
] = "aux22",
80 [PA_CHANNEL_POSITION_AUX23
] = "aux23",
81 [PA_CHANNEL_POSITION_AUX24
] = "aux24",
82 [PA_CHANNEL_POSITION_AUX25
] = "aux25",
83 [PA_CHANNEL_POSITION_AUX26
] = "aux26",
84 [PA_CHANNEL_POSITION_AUX27
] = "aux27",
85 [PA_CHANNEL_POSITION_AUX28
] = "aux28",
86 [PA_CHANNEL_POSITION_AUX29
] = "aux29",
87 [PA_CHANNEL_POSITION_AUX30
] = "aux30",
88 [PA_CHANNEL_POSITION_AUX31
] = "aux31",
90 [PA_CHANNEL_POSITION_TOP_CENTER
] = "top-center",
92 [PA_CHANNEL_POSITION_TOP_FRONT_CENTER
] = "top-front-center",
93 [PA_CHANNEL_POSITION_TOP_FRONT_LEFT
] = "top-front-left",
94 [PA_CHANNEL_POSITION_TOP_FRONT_RIGHT
] = "top-front-right",
96 [PA_CHANNEL_POSITION_TOP_REAR_CENTER
] = "top-rear-center",
97 [PA_CHANNEL_POSITION_TOP_REAR_LEFT
] = "top-rear-left",
98 [PA_CHANNEL_POSITION_TOP_REAR_RIGHT
] = "top-rear-right"
101 const char *const pretty_table
[PA_CHANNEL_POSITION_MAX
] = {
102 [PA_CHANNEL_POSITION_MONO
] = N_("Mono"),
104 [PA_CHANNEL_POSITION_FRONT_CENTER
] = N_("Front Center"),
105 [PA_CHANNEL_POSITION_FRONT_LEFT
] = N_("Front Left"),
106 [PA_CHANNEL_POSITION_FRONT_RIGHT
] = N_("Front Right"),
108 [PA_CHANNEL_POSITION_REAR_CENTER
] = N_("Rear Center"),
109 [PA_CHANNEL_POSITION_REAR_LEFT
] = N_("Rear Left"),
110 [PA_CHANNEL_POSITION_REAR_RIGHT
] = N_("Rear Right"),
112 [PA_CHANNEL_POSITION_LFE
] = N_("Low Frequency Emmiter"),
114 [PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER
] = N_("Front Left-of-center"),
115 [PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER
] = N_("Front Right-of-center"),
117 [PA_CHANNEL_POSITION_SIDE_LEFT
] = N_("Side Left"),
118 [PA_CHANNEL_POSITION_SIDE_RIGHT
] = N_("Side Right"),
120 [PA_CHANNEL_POSITION_AUX0
] = N_("Auxiliary 0"),
121 [PA_CHANNEL_POSITION_AUX1
] = N_("Auxiliary 1"),
122 [PA_CHANNEL_POSITION_AUX2
] = N_("Auxiliary 2"),
123 [PA_CHANNEL_POSITION_AUX3
] = N_("Auxiliary 3"),
124 [PA_CHANNEL_POSITION_AUX4
] = N_("Auxiliary 4"),
125 [PA_CHANNEL_POSITION_AUX5
] = N_("Auxiliary 5"),
126 [PA_CHANNEL_POSITION_AUX6
] = N_("Auxiliary 6"),
127 [PA_CHANNEL_POSITION_AUX7
] = N_("Auxiliary 7"),
128 [PA_CHANNEL_POSITION_AUX8
] = N_("Auxiliary 8"),
129 [PA_CHANNEL_POSITION_AUX9
] = N_("Auxiliary 9"),
130 [PA_CHANNEL_POSITION_AUX10
] = N_("Auxiliary 10"),
131 [PA_CHANNEL_POSITION_AUX11
] = N_("Auxiliary 11"),
132 [PA_CHANNEL_POSITION_AUX12
] = N_("Auxiliary 12"),
133 [PA_CHANNEL_POSITION_AUX13
] = N_("Auxiliary 13"),
134 [PA_CHANNEL_POSITION_AUX14
] = N_("Auxiliary 14"),
135 [PA_CHANNEL_POSITION_AUX15
] = N_("Auxiliary 15"),
136 [PA_CHANNEL_POSITION_AUX16
] = N_("Auxiliary 16"),
137 [PA_CHANNEL_POSITION_AUX17
] = N_("Auxiliary 17"),
138 [PA_CHANNEL_POSITION_AUX18
] = N_("Auxiliary 18"),
139 [PA_CHANNEL_POSITION_AUX19
] = N_("Auxiliary 19"),
140 [PA_CHANNEL_POSITION_AUX20
] = N_("Auxiliary 20"),
141 [PA_CHANNEL_POSITION_AUX21
] = N_("Auxiliary 21"),
142 [PA_CHANNEL_POSITION_AUX22
] = N_("Auxiliary 22"),
143 [PA_CHANNEL_POSITION_AUX23
] = N_("Auxiliary 23"),
144 [PA_CHANNEL_POSITION_AUX24
] = N_("Auxiliary 24"),
145 [PA_CHANNEL_POSITION_AUX25
] = N_("Auxiliary 25"),
146 [PA_CHANNEL_POSITION_AUX26
] = N_("Auxiliary 26"),
147 [PA_CHANNEL_POSITION_AUX27
] = N_("Auxiliary 27"),
148 [PA_CHANNEL_POSITION_AUX28
] = N_("Auxiliary 28"),
149 [PA_CHANNEL_POSITION_AUX29
] = N_("Auxiliary 29"),
150 [PA_CHANNEL_POSITION_AUX30
] = N_("Auxiliary 30"),
151 [PA_CHANNEL_POSITION_AUX31
] = N_("Auxiliary 31"),
153 [PA_CHANNEL_POSITION_TOP_CENTER
] = N_("Top Center"),
155 [PA_CHANNEL_POSITION_TOP_FRONT_CENTER
] = N_("Top Front Center"),
156 [PA_CHANNEL_POSITION_TOP_FRONT_LEFT
] = N_("Top Front Left"),
157 [PA_CHANNEL_POSITION_TOP_FRONT_RIGHT
] = N_("Top Front Right"),
159 [PA_CHANNEL_POSITION_TOP_REAR_CENTER
] = N_("Top Rear Center"),
160 [PA_CHANNEL_POSITION_TOP_REAR_LEFT
] = N_("Top Rear left"),
161 [PA_CHANNEL_POSITION_TOP_REAR_RIGHT
] = N_("Top Rear Right")
164 pa_channel_map
* pa_channel_map_init(pa_channel_map
*m
) {
170 for (c
= 0; c
< PA_CHANNELS_MAX
; c
++)
171 m
->map
[c
] = PA_CHANNEL_POSITION_INVALID
;
176 pa_channel_map
* pa_channel_map_init_mono(pa_channel_map
*m
) {
179 pa_channel_map_init(m
);
182 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
186 pa_channel_map
* pa_channel_map_init_stereo(pa_channel_map
*m
) {
189 pa_channel_map_init(m
);
192 m
->map
[0] = PA_CHANNEL_POSITION_LEFT
;
193 m
->map
[1] = PA_CHANNEL_POSITION_RIGHT
;
197 pa_channel_map
* pa_channel_map_init_auto(pa_channel_map
*m
, unsigned channels
, pa_channel_map_def_t def
) {
199 pa_assert(channels
> 0);
200 pa_assert(channels
<= PA_CHANNELS_MAX
);
202 pa_channel_map_init(m
);
204 m
->channels
= channels
;
207 case PA_CHANNEL_MAP_AIFF
:
209 /* This is somewhat compatible with RFC3551 */
213 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
217 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
218 m
->map
[1] = PA_CHANNEL_POSITION_SIDE_LEFT
;
219 m
->map
[2] = PA_CHANNEL_POSITION_FRONT_CENTER
;
220 m
->map
[3] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
221 m
->map
[4] = PA_CHANNEL_POSITION_SIDE_RIGHT
;
222 m
->map
[5] = PA_CHANNEL_POSITION_LFE
;
226 m
->map
[2] = PA_CHANNEL_POSITION_FRONT_CENTER
;
227 m
->map
[3] = PA_CHANNEL_POSITION_REAR_LEFT
;
228 m
->map
[4] = PA_CHANNEL_POSITION_REAR_RIGHT
;
232 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
233 m
->map
[1] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
237 m
->map
[0] = PA_CHANNEL_POSITION_LEFT
;
238 m
->map
[1] = PA_CHANNEL_POSITION_RIGHT
;
239 m
->map
[2] = PA_CHANNEL_POSITION_CENTER
;
243 m
->map
[0] = PA_CHANNEL_POSITION_LEFT
;
244 m
->map
[1] = PA_CHANNEL_POSITION_CENTER
;
245 m
->map
[2] = PA_CHANNEL_POSITION_RIGHT
;
246 m
->map
[3] = PA_CHANNEL_POSITION_LFE
;
253 case PA_CHANNEL_MAP_ALSA
:
257 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
261 m
->map
[6] = PA_CHANNEL_POSITION_SIDE_LEFT
;
262 m
->map
[7] = PA_CHANNEL_POSITION_SIDE_RIGHT
;
266 m
->map
[5] = PA_CHANNEL_POSITION_LFE
;
270 m
->map
[4] = PA_CHANNEL_POSITION_FRONT_CENTER
;
274 m
->map
[2] = PA_CHANNEL_POSITION_REAR_LEFT
;
275 m
->map
[3] = PA_CHANNEL_POSITION_REAR_RIGHT
;
279 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
280 m
->map
[1] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
287 case PA_CHANNEL_MAP_AUX
: {
290 if (channels
>= PA_CHANNELS_MAX
)
293 for (i
= 0; i
< channels
; i
++)
294 m
->map
[i
] = PA_CHANNEL_POSITION_AUX0
+ i
;
299 case PA_CHANNEL_MAP_WAVEEX
:
303 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
307 m
->map
[15] = PA_CHANNEL_POSITION_TOP_REAR_LEFT
;
308 m
->map
[16] = PA_CHANNEL_POSITION_TOP_REAR_CENTER
;
309 m
->map
[17] = PA_CHANNEL_POSITION_TOP_REAR_RIGHT
;
313 m
->map
[12] = PA_CHANNEL_POSITION_TOP_FRONT_LEFT
;
314 m
->map
[13] = PA_CHANNEL_POSITION_TOP_FRONT_CENTER
;
315 m
->map
[14] = PA_CHANNEL_POSITION_TOP_FRONT_RIGHT
;
319 m
->map
[11] = PA_CHANNEL_POSITION_TOP_CENTER
;
323 m
->map
[9] = PA_CHANNEL_POSITION_SIDE_LEFT
;
324 m
->map
[10] = PA_CHANNEL_POSITION_SIDE_RIGHT
;
328 m
->map
[8] = PA_CHANNEL_POSITION_REAR_CENTER
;
332 m
->map
[6] = PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER
;
333 m
->map
[7] = PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER
;
337 m
->map
[4] = PA_CHANNEL_POSITION_REAR_LEFT
;
338 m
->map
[5] = PA_CHANNEL_POSITION_REAR_RIGHT
;
342 m
->map
[3] = PA_CHANNEL_POSITION_LFE
;
346 m
->map
[2] = PA_CHANNEL_POSITION_FRONT_CENTER
;
350 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
351 m
->map
[1] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
358 case PA_CHANNEL_MAP_OSS
:
362 m
->map
[0] = PA_CHANNEL_POSITION_MONO
;
366 m
->map
[6] = PA_CHANNEL_POSITION_REAR_LEFT
;
367 m
->map
[7] = PA_CHANNEL_POSITION_REAR_RIGHT
;
371 m
->map
[4] = PA_CHANNEL_POSITION_SIDE_LEFT
;
372 m
->map
[5] = PA_CHANNEL_POSITION_SIDE_RIGHT
;
376 m
->map
[3] = PA_CHANNEL_POSITION_LFE
;
380 m
->map
[2] = PA_CHANNEL_POSITION_FRONT_CENTER
;
384 m
->map
[0] = PA_CHANNEL_POSITION_FRONT_LEFT
;
385 m
->map
[1] = PA_CHANNEL_POSITION_FRONT_RIGHT
;
398 pa_channel_map
* pa_channel_map_init_extend(pa_channel_map
*m
, unsigned channels
, pa_channel_map_def_t def
) {
402 pa_assert(channels
> 0);
403 pa_assert(channels
<= PA_CHANNELS_MAX
);
405 pa_channel_map_init(m
);
407 for (c
= channels
; c
> 0; c
--) {
409 if (pa_channel_map_init_auto(m
, c
, def
)) {
412 for (; c
< channels
; c
++) {
414 m
->map
[c
] = PA_CHANNEL_POSITION_AUX0
+ i
;
418 m
->channels
= channels
;
427 const char* pa_channel_position_to_string(pa_channel_position_t pos
) {
429 if (pos
< 0 || pos
>= PA_CHANNEL_POSITION_MAX
)
435 const char* pa_channel_position_to_pretty_string(pa_channel_position_t pos
) {
439 if (pos
< 0 || pos
>= PA_CHANNEL_POSITION_MAX
)
442 return _(pretty_table
[pos
]);
445 int pa_channel_map_equal(const pa_channel_map
*a
, const pa_channel_map
*b
) {
451 if (a
->channels
!= b
->channels
)
454 for (c
= 0; c
< a
->channels
; c
++)
455 if (a
->map
[c
] != b
->map
[c
])
461 char* pa_channel_map_snprint(char *s
, size_t l
, const pa_channel_map
*map
) {
472 for (channel
= 0; channel
< map
->channels
&& l
> 1; channel
++) {
473 l
-= pa_snprintf(e
, l
, "%s%s",
475 pa_channel_position_to_string(map
->map
[channel
]));
484 pa_channel_map
*pa_channel_map_parse(pa_channel_map
*rmap
, const char *s
) {
492 memset(&map
, 0, sizeof(map
));
494 if (strcmp(s
, "stereo") == 0) {
496 map
.map
[0] = PA_CHANNEL_POSITION_LEFT
;
497 map
.map
[1] = PA_CHANNEL_POSITION_RIGHT
;
504 while ((p
= pa_split(s
, ",", &state
))) {
506 if (map
.channels
>= PA_CHANNELS_MAX
) {
511 /* Some special aliases */
512 if (strcmp(p
, "left") == 0)
513 map
.map
[map
.channels
++] = PA_CHANNEL_POSITION_LEFT
;
514 else if (strcmp(p
, "right") == 0)
515 map
.map
[map
.channels
++] = PA_CHANNEL_POSITION_RIGHT
;
516 else if (strcmp(p
, "center") == 0)
517 map
.map
[map
.channels
++] = PA_CHANNEL_POSITION_CENTER
;
518 else if (strcmp(p
, "subwoofer") == 0)
519 map
.map
[map
.channels
++] = PA_CHANNEL_POSITION_SUBWOOFER
;
521 pa_channel_position_t i
;
523 for (i
= 0; i
< PA_CHANNEL_POSITION_MAX
; i
++)
524 if (strcmp(p
, table
[i
]) == 0) {
525 map
.map
[map
.channels
++] = i
;
529 if (i
>= PA_CHANNEL_POSITION_MAX
) {
540 if (!pa_channel_map_valid(&map
))
547 int pa_channel_map_valid(const pa_channel_map
*map
) {
552 if (map
->channels
<= 0 || map
->channels
> PA_CHANNELS_MAX
)
555 for (c
= 0; c
< map
->channels
; c
++) {
557 if (map
->map
[c
] < 0 ||map
->map
[c
] >= PA_CHANNEL_POSITION_MAX
)