/*** This file is part of PulseAudio. Copyright 2005-2006 Lennart Poettering Copyright 2006 Pierre Ossman for Cendio AB PulseAudio 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 of the License, or (at your option) any later version. PulseAudio 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 General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with PulseAudio; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. ***/ #ifdef HAVE_CONFIG_H #include #endif #include #include #include #include #include #include #include "channelmap.h" const char *const table[PA_CHANNEL_POSITION_MAX] = { [PA_CHANNEL_POSITION_MONO] = "mono", [PA_CHANNEL_POSITION_FRONT_CENTER] = "front-center", [PA_CHANNEL_POSITION_FRONT_LEFT] = "front-left", [PA_CHANNEL_POSITION_FRONT_RIGHT] = "front-right", [PA_CHANNEL_POSITION_REAR_CENTER] = "rear-center", [PA_CHANNEL_POSITION_REAR_LEFT] = "rear-left", [PA_CHANNEL_POSITION_REAR_RIGHT] = "rear-right", [PA_CHANNEL_POSITION_LFE] = "lfe", [PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER] = "front-left-of-center", [PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER] = "front-right-of-center", [PA_CHANNEL_POSITION_SIDE_LEFT] = "side-left", [PA_CHANNEL_POSITION_SIDE_RIGHT] = "side-right", [PA_CHANNEL_POSITION_AUX0] = "aux0", [PA_CHANNEL_POSITION_AUX1] = "aux1", [PA_CHANNEL_POSITION_AUX2] = "aux2", [PA_CHANNEL_POSITION_AUX3] = "aux3", [PA_CHANNEL_POSITION_AUX4] = "aux4", [PA_CHANNEL_POSITION_AUX5] = "aux5", [PA_CHANNEL_POSITION_AUX6] = "aux6", [PA_CHANNEL_POSITION_AUX7] = "aux7", [PA_CHANNEL_POSITION_AUX8] = "aux8", [PA_CHANNEL_POSITION_AUX9] = "aux9", [PA_CHANNEL_POSITION_AUX10] = "aux10", [PA_CHANNEL_POSITION_AUX11] = "aux11", [PA_CHANNEL_POSITION_AUX12] = "aux12", [PA_CHANNEL_POSITION_AUX13] = "aux13", [PA_CHANNEL_POSITION_AUX14] = "aux14", [PA_CHANNEL_POSITION_AUX15] = "aux15", [PA_CHANNEL_POSITION_AUX16] = "aux16", [PA_CHANNEL_POSITION_AUX17] = "aux17", [PA_CHANNEL_POSITION_AUX18] = "aux18", [PA_CHANNEL_POSITION_AUX19] = "aux19", [PA_CHANNEL_POSITION_AUX20] = "aux20", [PA_CHANNEL_POSITION_AUX21] = "aux21", [PA_CHANNEL_POSITION_AUX22] = "aux22", [PA_CHANNEL_POSITION_AUX23] = "aux23", [PA_CHANNEL_POSITION_AUX24] = "aux24", [PA_CHANNEL_POSITION_AUX25] = "aux25", [PA_CHANNEL_POSITION_AUX26] = "aux26", [PA_CHANNEL_POSITION_AUX27] = "aux27", [PA_CHANNEL_POSITION_AUX28] = "aux28", [PA_CHANNEL_POSITION_AUX29] = "aux29", [PA_CHANNEL_POSITION_AUX30] = "aux30", [PA_CHANNEL_POSITION_AUX31] = "aux31", [PA_CHANNEL_POSITION_TOP_CENTER] = "top-center", [PA_CHANNEL_POSITION_TOP_FRONT_CENTER] = "top-front-center", [PA_CHANNEL_POSITION_TOP_FRONT_LEFT] = "top-front-left", [PA_CHANNEL_POSITION_TOP_FRONT_RIGHT] = "top-front-right", [PA_CHANNEL_POSITION_TOP_REAR_CENTER] = "top-rear-center", [PA_CHANNEL_POSITION_TOP_REAR_LEFT] = "top-rear-left", [PA_CHANNEL_POSITION_TOP_REAR_RIGHT] = "top-rear-right" }; const char *const pretty_table[PA_CHANNEL_POSITION_MAX] = { [PA_CHANNEL_POSITION_MONO] = "Mono", [PA_CHANNEL_POSITION_FRONT_CENTER] = "Front Center", [PA_CHANNEL_POSITION_FRONT_LEFT] = "Front Left", [PA_CHANNEL_POSITION_FRONT_RIGHT] = "Front Right", [PA_CHANNEL_POSITION_REAR_CENTER] = "Rear Center", [PA_CHANNEL_POSITION_REAR_LEFT] = "Rear Left", [PA_CHANNEL_POSITION_REAR_RIGHT] = "Rear Right", [PA_CHANNEL_POSITION_LFE] = "Low Frequency Emmiter", [PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER] = "Front Left-of-center", [PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER] = "Front Right-of-center", [PA_CHANNEL_POSITION_SIDE_LEFT] = "Side Left", [PA_CHANNEL_POSITION_SIDE_RIGHT] = "Side Right", [PA_CHANNEL_POSITION_AUX0] = "Auxiliary 0", [PA_CHANNEL_POSITION_AUX1] = "Auxiliary 1", [PA_CHANNEL_POSITION_AUX2] = "Auxiliary 2", [PA_CHANNEL_POSITION_AUX3] = "Auxiliary 3", [PA_CHANNEL_POSITION_AUX4] = "Auxiliary 4", [PA_CHANNEL_POSITION_AUX5] = "Auxiliary 5", [PA_CHANNEL_POSITION_AUX6] = "Auxiliary 6", [PA_CHANNEL_POSITION_AUX7] = "Auxiliary 7", [PA_CHANNEL_POSITION_AUX8] = "Auxiliary 8", [PA_CHANNEL_POSITION_AUX9] = "Auxiliary 9", [PA_CHANNEL_POSITION_AUX10] = "Auxiliary 10", [PA_CHANNEL_POSITION_AUX11] = "Auxiliary 11", [PA_CHANNEL_POSITION_AUX12] = "Auxiliary 12", [PA_CHANNEL_POSITION_AUX13] = "Auxiliary 13", [PA_CHANNEL_POSITION_AUX14] = "Auxiliary 14", [PA_CHANNEL_POSITION_AUX15] = "Auxiliary 15", [PA_CHANNEL_POSITION_AUX16] = "Auxiliary 16", [PA_CHANNEL_POSITION_AUX17] = "Auxiliary 17", [PA_CHANNEL_POSITION_AUX18] = "Auxiliary 18", [PA_CHANNEL_POSITION_AUX19] = "Auxiliary 19", [PA_CHANNEL_POSITION_AUX20] = "Auxiliary 20", [PA_CHANNEL_POSITION_AUX21] = "Auxiliary 21", [PA_CHANNEL_POSITION_AUX22] = "Auxiliary 22", [PA_CHANNEL_POSITION_AUX23] = "Auxiliary 23", [PA_CHANNEL_POSITION_AUX24] = "Auxiliary 24", [PA_CHANNEL_POSITION_AUX25] = "Auxiliary 25", [PA_CHANNEL_POSITION_AUX26] = "Auxiliary 26", [PA_CHANNEL_POSITION_AUX27] = "Auxiliary 27", [PA_CHANNEL_POSITION_AUX28] = "Auxiliary 28", [PA_CHANNEL_POSITION_AUX29] = "Auxiliary 29", [PA_CHANNEL_POSITION_AUX30] = "Auxiliary 30", [PA_CHANNEL_POSITION_AUX31] = "Auxiliary 31", [PA_CHANNEL_POSITION_TOP_CENTER] = "Top Center", [PA_CHANNEL_POSITION_TOP_FRONT_CENTER] = "Top Front Center", [PA_CHANNEL_POSITION_TOP_FRONT_LEFT] = "Top Front Left", [PA_CHANNEL_POSITION_TOP_FRONT_RIGHT] = "Top Front Right", [PA_CHANNEL_POSITION_TOP_REAR_CENTER] = "Top Rear Center", [PA_CHANNEL_POSITION_TOP_REAR_LEFT] = "Top Rear left", [PA_CHANNEL_POSITION_TOP_REAR_RIGHT] = "Top Rear Right" }; pa_channel_map* pa_channel_map_init(pa_channel_map *m) { unsigned c; pa_assert(m); m->channels = 0; for (c = 0; c < PA_CHANNELS_MAX; c++) m->map[c] = PA_CHANNEL_POSITION_INVALID; return m; } pa_channel_map* pa_channel_map_init_mono(pa_channel_map *m) { pa_assert(m); pa_channel_map_init(m); m->channels = 1; m->map[0] = PA_CHANNEL_POSITION_MONO; return m; } pa_channel_map* pa_channel_map_init_stereo(pa_channel_map *m) { pa_assert(m); pa_channel_map_init(m); m->channels = 2; m->map[0] = PA_CHANNEL_POSITION_LEFT; m->map[1] = PA_CHANNEL_POSITION_RIGHT; return m; } pa_channel_map* pa_channel_map_init_auto(pa_channel_map *m, unsigned channels, pa_channel_map_def_t def) { pa_assert(m); pa_assert(channels > 0); pa_assert(channels <= PA_CHANNELS_MAX); pa_channel_map_init(m); m->channels = channels; switch (def) { case PA_CHANNEL_MAP_AIFF: /* This is somewhat compatible with RFC3551 */ switch (channels) { case 1: m->map[0] = PA_CHANNEL_POSITION_MONO; return m; case 6: m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT; m->map[1] = PA_CHANNEL_POSITION_SIDE_LEFT; m->map[2] = PA_CHANNEL_POSITION_FRONT_CENTER; m->map[3] = PA_CHANNEL_POSITION_FRONT_RIGHT; m->map[4] = PA_CHANNEL_POSITION_SIDE_RIGHT; m->map[5] = PA_CHANNEL_POSITION_LFE; return m; case 5: m->map[2] = PA_CHANNEL_POSITION_FRONT_CENTER; m->map[3] = PA_CHANNEL_POSITION_REAR_LEFT; m->map[4] = PA_CHANNEL_POSITION_REAR_RIGHT; /* Fall through */ case 2: m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT; m->map[1] = PA_CHANNEL_POSITION_FRONT_RIGHT; return m; case 3: m->map[0] = PA_CHANNEL_POSITION_LEFT; m->map[1] = PA_CHANNEL_POSITION_RIGHT; m->map[2] = PA_CHANNEL_POSITION_CENTER; return m; case 4: m->map[0] = PA_CHANNEL_POSITION_LEFT; m->map[1] = PA_CHANNEL_POSITION_CENTER; m->map[2] = PA_CHANNEL_POSITION_RIGHT; m->map[3] = PA_CHANNEL_POSITION_LFE; return m; default: return NULL; } case PA_CHANNEL_MAP_ALSA: switch (channels) { case 1: m->map[0] = PA_CHANNEL_POSITION_MONO; return m; case 8: m->map[6] = PA_CHANNEL_POSITION_SIDE_LEFT; m->map[7] = PA_CHANNEL_POSITION_SIDE_RIGHT; /* Fall through */ case 6: m->map[5] = PA_CHANNEL_POSITION_LFE; /* Fall through */ case 5: m->map[4] = PA_CHANNEL_POSITION_FRONT_CENTER; /* Fall through */ case 4: m->map[2] = PA_CHANNEL_POSITION_REAR_LEFT; m->map[3] = PA_CHANNEL_POSITION_REAR_RIGHT; /* Fall through */ case 2: m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT; m->map[1] = PA_CHANNEL_POSITION_FRONT_RIGHT; return m; default: return NULL; } case PA_CHANNEL_MAP_AUX: { unsigned i; if (channels >= PA_CHANNELS_MAX) return NULL; for (i = 0; i < channels; i++) m->map[i] = PA_CHANNEL_POSITION_AUX0 + i; return m; } case PA_CHANNEL_MAP_WAVEEX: switch (channels) { case 1: m->map[0] = PA_CHANNEL_POSITION_MONO; return m; case 18: m->map[15] = PA_CHANNEL_POSITION_TOP_REAR_LEFT; m->map[16] = PA_CHANNEL_POSITION_TOP_REAR_CENTER; m->map[17] = PA_CHANNEL_POSITION_TOP_REAR_RIGHT; /* Fall through */ case 15: m->map[12] = PA_CHANNEL_POSITION_TOP_FRONT_LEFT; m->map[13] = PA_CHANNEL_POSITION_TOP_FRONT_CENTER; m->map[14] = PA_CHANNEL_POSITION_TOP_FRONT_RIGHT; /* Fall through */ case 12: m->map[11] = PA_CHANNEL_POSITION_TOP_CENTER; /* Fall through */ case 11: m->map[9] = PA_CHANNEL_POSITION_SIDE_LEFT; m->map[10] = PA_CHANNEL_POSITION_SIDE_RIGHT; /* Fall through */ case 9: m->map[8] = PA_CHANNEL_POSITION_REAR_CENTER; /* Fall through */ case 8: m->map[6] = PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER; m->map[7] = PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER; /* Fall through */ case 6: m->map[4] = PA_CHANNEL_POSITION_REAR_LEFT; m->map[5] = PA_CHANNEL_POSITION_REAR_RIGHT; /* Fall through */ case 4: m->map[3] = PA_CHANNEL_POSITION_LFE; /* Fall through */ case 3: m->map[2] = PA_CHANNEL_POSITION_FRONT_CENTER; /* Fall through */ case 2: m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT; m->map[1] = PA_CHANNEL_POSITION_FRONT_RIGHT; return m; default: return NULL; } case PA_CHANNEL_MAP_OSS: switch (channels) { case 1: m->map[0] = PA_CHANNEL_POSITION_MONO; return m; case 8: m->map[6] = PA_CHANNEL_POSITION_REAR_LEFT; m->map[7] = PA_CHANNEL_POSITION_REAR_RIGHT; /* Fall through */ case 6: m->map[4] = PA_CHANNEL_POSITION_SIDE_LEFT; m->map[5] = PA_CHANNEL_POSITION_SIDE_RIGHT; /* Fall through */ case 4: m->map[3] = PA_CHANNEL_POSITION_LFE; /* Fall through */ case 3: m->map[2] = PA_CHANNEL_POSITION_FRONT_CENTER; /* Fall through */ case 2: m->map[0] = PA_CHANNEL_POSITION_FRONT_LEFT; m->map[1] = PA_CHANNEL_POSITION_FRONT_RIGHT; return m; default: return NULL; } default: return NULL; } } pa_channel_map* pa_channel_map_init_extend(pa_channel_map *m, unsigned channels, pa_channel_map_def_t def) { unsigned c; pa_assert(m); pa_assert(channels > 0); pa_assert(channels <= PA_CHANNELS_MAX); pa_channel_map_init(m); for (c = channels; c > 0; c--) { if (pa_channel_map_init_auto(m, c, def)) { unsigned i = 0; for (; c < channels; c++) { m->map[c] = PA_CHANNEL_POSITION_AUX0 + i; i++; } m->channels = channels; return m; } } return NULL; } const char* pa_channel_position_to_string(pa_channel_position_t pos) { if (pos < 0 || pos >= PA_CHANNEL_POSITION_MAX) return NULL; return table[pos]; } const char* pa_channel_position_to_pretty_string(pa_channel_position_t pos) { if (pos < 0 || pos >= PA_CHANNEL_POSITION_MAX) return NULL; return pretty_table[pos]; } int pa_channel_map_equal(const pa_channel_map *a, const pa_channel_map *b) { unsigned c; pa_assert(a); pa_assert(b); if (a->channels != b->channels) return 0; for (c = 0; c < a->channels; c++) if (a->map[c] != b->map[c]) return 0; return 1; } char* pa_channel_map_snprint(char *s, size_t l, const pa_channel_map *map) { unsigned channel; int first = 1; char *e; pa_assert(s); pa_assert(l > 0); pa_assert(map); *(e = s) = 0; for (channel = 0; channel < map->channels && l > 1; channel++) { l -= pa_snprintf(e, l, "%s%s", first ? "" : ",", pa_channel_position_to_string(map->map[channel])); e = strchr(e, 0); first = 0; } return s; } pa_channel_map *pa_channel_map_parse(pa_channel_map *rmap, const char *s) { const char *state; pa_channel_map map; char *p; pa_assert(rmap); pa_assert(s); memset(&map, 0, sizeof(map)); if (strcmp(s, "stereo") == 0) { map.channels = 2; map.map[0] = PA_CHANNEL_POSITION_LEFT; map.map[1] = PA_CHANNEL_POSITION_RIGHT; goto finish; } state = NULL; map.channels = 0; while ((p = pa_split(s, ",", &state))) { if (map.channels >= PA_CHANNELS_MAX) { pa_xfree(p); return NULL; } /* Some special aliases */ if (strcmp(p, "left") == 0) map.map[map.channels++] = PA_CHANNEL_POSITION_LEFT; else if (strcmp(p, "right") == 0) map.map[map.channels++] = PA_CHANNEL_POSITION_RIGHT; else if (strcmp(p, "center") == 0) map.map[map.channels++] = PA_CHANNEL_POSITION_CENTER; else if (strcmp(p, "subwoofer") == 0) map.map[map.channels++] = PA_CHANNEL_POSITION_SUBWOOFER; else { pa_channel_position_t i; for (i = 0; i < PA_CHANNEL_POSITION_MAX; i++) if (strcmp(p, table[i]) == 0) { map.map[map.channels++] = i; break; } if (i >= PA_CHANNEL_POSITION_MAX) { pa_xfree(p); return NULL; } } pa_xfree(p); } finish: if (!pa_channel_map_valid(&map)) return NULL; *rmap = map; return rmap; } int pa_channel_map_valid(const pa_channel_map *map) { unsigned c; pa_assert(map); if (map->channels <= 0 || map->channels > PA_CHANNELS_MAX) return 0; for (c = 0; c < map->channels; c++) { if (map->map[c] < 0 ||map->map[c] >= PA_CHANNEL_POSITION_MAX) return 0; } return 1; }