/*** This file is part of PulseAudio. Copyright 2011 Intel Corporation Copyright 2011 Collabora Multimedia Copyright 2011 Arun Raghavan 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.1 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, see . ***/ #ifdef HAVE_CONFIG_H #include #endif #include #include #include #include #include #include #include #include #include "format.h" #define PA_JSON_MIN_KEY "min" #define PA_JSON_MAX_KEY "max" static int pa_format_info_prop_compatible(const char *one, const char *two); static const char* const _encoding_str_table[]= { [PA_ENCODING_PCM] = "pcm", [PA_ENCODING_AC3_IEC61937] = "ac3-iec61937", [PA_ENCODING_EAC3_IEC61937] = "eac3-iec61937", [PA_ENCODING_MPEG_IEC61937] = "mpeg-iec61937", [PA_ENCODING_DTS_IEC61937] = "dts-iec61937", [PA_ENCODING_MPEG2_AAC_IEC61937] = "mpeg2-aac-iec61937", [PA_ENCODING_TRUEHD_IEC61937] = "truehd-iec61937", [PA_ENCODING_DTSHD_IEC61937] = "dtshd-iec61937", [PA_ENCODING_ANY] = "any", }; const char *pa_encoding_to_string(pa_encoding_t e) { if (e < 0 || e >= PA_ENCODING_MAX) return NULL; return _encoding_str_table[e]; } pa_encoding_t pa_encoding_from_string(const char *encoding) { pa_encoding_t e; for (e = PA_ENCODING_ANY; e < PA_ENCODING_MAX; e++) if (pa_streq(_encoding_str_table[e], encoding)) return e; return PA_ENCODING_INVALID; } pa_format_info* pa_format_info_new(void) { pa_format_info *f = pa_xnew(pa_format_info, 1); f->encoding = PA_ENCODING_INVALID; f->plist = pa_proplist_new(); return f; } pa_format_info* pa_format_info_copy(const pa_format_info *src) { pa_format_info *dest; pa_assert(src); dest = pa_xnew(pa_format_info, 1); dest->encoding = src->encoding; if (src->plist) dest->plist = pa_proplist_copy(src->plist); else dest->plist = NULL; return dest; } void pa_format_info_free(pa_format_info *f) { pa_assert(f); pa_proplist_free(f->plist); pa_xfree(f); } int pa_format_info_valid(const pa_format_info *f) { return (f->encoding >= 0 && f->encoding < PA_ENCODING_MAX && f->plist != NULL); } int pa_format_info_is_pcm(const pa_format_info *f) { return f->encoding == PA_ENCODING_PCM; } char *pa_format_info_snprint(char *s, size_t l, const pa_format_info *f) { char *tmp; pa_assert(s); pa_assert(l > 0); pa_assert(f); pa_init_i18n(); if (!pa_format_info_valid(f)) pa_snprintf(s, l, _("(invalid)")); else { tmp = pa_proplist_to_string_sep(f->plist, " "); if (tmp[0]) pa_snprintf(s, l, "%s, %s", pa_encoding_to_string(f->encoding), tmp); else pa_snprintf(s, l, "%s", pa_encoding_to_string(f->encoding)); pa_xfree(tmp); } return s; } pa_format_info* pa_format_info_from_string(const char *str) { pa_format_info *f = pa_format_info_new(); char *encoding = NULL, *properties = NULL; size_t pos; pos = strcspn(str, ","); encoding = pa_xstrndup(str, pos); f->encoding = pa_encoding_from_string(pa_strip(encoding)); if (f->encoding == PA_ENCODING_INVALID) goto error; if (pos != strlen(str)) { pa_proplist *plist; properties = pa_xstrdup(&str[pos+1]); plist = pa_proplist_from_string(properties); if (!plist) goto error; pa_proplist_free(f->plist); f->plist = plist; } out: if (encoding) pa_xfree(encoding); if (properties) pa_xfree(properties); return f; error: pa_format_info_free(f); f = NULL; goto out; } int pa_format_info_is_compatible(const pa_format_info *first, const pa_format_info *second) { const char *key; void *state = NULL; pa_assert(first); pa_assert(second); if (first->encoding != second->encoding) return false; while ((key = pa_proplist_iterate(first->plist, &state))) { const char *value_one, *value_two; value_one = pa_proplist_gets(first->plist, key); value_two = pa_proplist_gets(second->plist, key); if (!value_two || !pa_format_info_prop_compatible(value_one, value_two)) return false; } return true; } pa_format_info* pa_format_info_from_sample_spec(const pa_sample_spec *ss, const pa_channel_map *map) { char cm[PA_CHANNEL_MAP_SNPRINT_MAX]; pa_format_info *f; pa_assert(ss && pa_sample_spec_valid(ss)); pa_assert(!map || pa_channel_map_valid(map)); f = pa_format_info_new(); f->encoding = PA_ENCODING_PCM; pa_format_info_set_sample_format(f, ss->format); pa_format_info_set_rate(f, ss->rate); pa_format_info_set_channels(f, ss->channels); if (map) { pa_channel_map_snprint(cm, sizeof(cm), map); pa_format_info_set_prop_string(f, PA_PROP_FORMAT_CHANNEL_MAP, cm); } return f; } /* For PCM streams */ int pa_format_info_to_sample_spec(const pa_format_info *f, pa_sample_spec *ss, pa_channel_map *map) { pa_assert(f); pa_assert(ss); if (!pa_format_info_is_pcm(f)) return pa_format_info_to_sample_spec_fake(f, ss, map); if (pa_format_info_get_sample_format(f, &ss->format) < 0) return -PA_ERR_INVALID; if (pa_format_info_get_rate(f, &ss->rate) < 0) return -PA_ERR_INVALID; if (pa_format_info_get_channels(f, &ss->channels) < 0) return -PA_ERR_INVALID; if (map && pa_format_info_get_channel_map(f, map) < 0) return -PA_ERR_INVALID; return 0; } pa_prop_type_t pa_format_info_get_prop_type(const pa_format_info *f, const char *key) { const char *str; pa_json_object *o; const pa_json_object *o1; pa_prop_type_t type; pa_assert(f); pa_assert(key); str = pa_proplist_gets(f->plist, key); if (!str) return PA_PROP_TYPE_INVALID; o = pa_json_parse(str); if (!o) return PA_PROP_TYPE_INVALID; switch (pa_json_object_get_type(o)) { case PA_JSON_TYPE_INT: type = PA_PROP_TYPE_INT; break; case PA_JSON_TYPE_STRING: type = PA_PROP_TYPE_STRING; break; case PA_JSON_TYPE_ARRAY: if (pa_json_object_get_array_length(o) == 0) { /* Unlikely, but let's account for this anyway. We need at * least one element to figure out the array type. */ type = PA_PROP_TYPE_INVALID; break; } o1 = pa_json_object_get_array_member(o, 0); if (pa_json_object_get_type(o1) == PA_JSON_TYPE_INT) type = PA_PROP_TYPE_INT_ARRAY; else if (pa_json_object_get_type(o1) == PA_JSON_TYPE_STRING) type = PA_PROP_TYPE_STRING_ARRAY; else type = PA_PROP_TYPE_INVALID; break; case PA_JSON_TYPE_OBJECT: /* We actually know at this point that it's a int range, but let's * confirm. */ if (!pa_json_object_get_object_member(o, PA_JSON_MIN_KEY)) { type = PA_PROP_TYPE_INVALID; break; } if (!pa_json_object_get_object_member(o, PA_JSON_MAX_KEY)) { type = PA_PROP_TYPE_INVALID; break; } type = PA_PROP_TYPE_INT_RANGE; break; default: type = PA_PROP_TYPE_INVALID; break; } pa_json_object_free(o); return type; } int pa_format_info_get_prop_int(const pa_format_info *f, const char *key, int *v) { const char *str; pa_json_object *o; pa_assert(f); pa_assert(key); pa_assert(v); str = pa_proplist_gets(f->plist, key); if (!str) return -PA_ERR_NOENTITY; o = pa_json_parse(str); if (!o) { pa_log_debug("Failed to parse format info property '%s'.", key); return -PA_ERR_INVALID; } if (pa_json_object_get_type(o) != PA_JSON_TYPE_INT) { pa_log_debug("Format info property '%s' type is not int.", key); pa_json_object_free(o); return -PA_ERR_INVALID; } *v = pa_json_object_get_int(o); pa_json_object_free(o); return 0; } int pa_format_info_get_prop_int_range(const pa_format_info *f, const char *key, int *min, int *max) { const char *str; pa_json_object *o; const pa_json_object *o1; int ret = -PA_ERR_INVALID; pa_assert(f); pa_assert(key); pa_assert(min); pa_assert(max); str = pa_proplist_gets(f->plist, key); if (!str) return -PA_ERR_NOENTITY; o = pa_json_parse(str); if (!o) { pa_log_debug("Failed to parse format info property '%s'.", key); return -PA_ERR_INVALID; } if (pa_json_object_get_type(o) != PA_JSON_TYPE_OBJECT) goto out; if (!(o1 = pa_json_object_get_object_member(o, PA_JSON_MIN_KEY)) || (pa_json_object_get_type(o1) != PA_JSON_TYPE_INT)) goto out; *min = pa_json_object_get_int(o1); if (!(o1 = pa_json_object_get_object_member(o, PA_JSON_MAX_KEY)) || (pa_json_object_get_type(o1) != PA_JSON_TYPE_INT)) goto out; *max = pa_json_object_get_int(o1); ret = 0; out: if (ret < 0) pa_log_debug("Format info property '%s' is not a valid int range.", key); pa_json_object_free(o); return ret; } int pa_format_info_get_prop_int_array(const pa_format_info *f, const char *key, int **values, int *n_values) { const char *str; pa_json_object *o; const pa_json_object *o1; int i, ret = -PA_ERR_INVALID; pa_assert(f); pa_assert(key); pa_assert(values); pa_assert(n_values); str = pa_proplist_gets(f->plist, key); if (!str) return -PA_ERR_NOENTITY; o = pa_json_parse(str); if (!o) { pa_log_debug("Failed to parse format info property '%s'.", key); return -PA_ERR_INVALID; } if (pa_json_object_get_type(o) != PA_JSON_TYPE_ARRAY) goto out; *n_values = pa_json_object_get_array_length(o); *values = pa_xnew(int, *n_values); for (i = 0; i < *n_values; i++) { o1 = pa_json_object_get_array_member(o, i); if (pa_json_object_get_type(o1) != PA_JSON_TYPE_INT) { goto out; } (*values)[i] = pa_json_object_get_int(o1); } ret = 0; out: if (ret < 0) pa_log_debug("Format info property '%s' is not a valid int array.", key); pa_json_object_free(o); return ret; } int pa_format_info_get_prop_string(const pa_format_info *f, const char *key, char **v) { const char *str = NULL; pa_json_object *o; pa_assert(f); pa_assert(key); pa_assert(v); str = pa_proplist_gets(f->plist, key); if (!str) return -PA_ERR_NOENTITY; o = pa_json_parse(str); if (!o) { pa_log_debug("Failed to parse format info property '%s'.", key); return -PA_ERR_INVALID; } if (pa_json_object_get_type(o) != PA_JSON_TYPE_STRING) { pa_log_debug("Format info property '%s' type is not string.", key); pa_json_object_free(o); return -PA_ERR_INVALID; } *v = pa_xstrdup(pa_json_object_get_string(o)); pa_json_object_free(o); return 0; } int pa_format_info_get_prop_string_array(const pa_format_info *f, const char *key, char ***values, int *n_values) { const char *str; pa_json_object *o; const pa_json_object *o1; int i, ret = -PA_ERR_INVALID; pa_assert(f); pa_assert(key); pa_assert(values); pa_assert(n_values); str = pa_proplist_gets(f->plist, key); if (!str) return -PA_ERR_NOENTITY; o = pa_json_parse(str); if (!o) { pa_log_debug("Failed to parse format info property '%s'.", key); return -PA_ERR_INVALID; } if (pa_json_object_get_type(o) != PA_JSON_TYPE_ARRAY) goto out; *n_values = pa_json_object_get_array_length(o); *values = pa_xnew(char *, *n_values); for (i = 0; i < *n_values; i++) { o1 = pa_json_object_get_array_member(o, i); if (pa_json_object_get_type(o1) != PA_JSON_TYPE_STRING) { goto out; } (*values)[i] = pa_xstrdup(pa_json_object_get_string(o1)); } ret = 0; out: if (ret < 0) pa_log_debug("Format info property '%s' is not a valid string array.", key); pa_json_object_free(o); return ret; } void pa_format_info_free_string_array(char **values, int n_values) { int i; for (i = 0; i < n_values; i++) pa_xfree(values[i]); pa_xfree(values); } int pa_format_info_get_sample_format(const pa_format_info *f, pa_sample_format_t *sf) { int r; char *sf_str; pa_sample_format_t sf_local; pa_assert(f); pa_assert(sf); r = pa_format_info_get_prop_string(f, PA_PROP_FORMAT_SAMPLE_FORMAT, &sf_str); if (r < 0) return r; sf_local = pa_parse_sample_format(sf_str); pa_xfree(sf_str); if (!pa_sample_format_valid(sf_local)) { pa_log_debug("Invalid sample format."); return -PA_ERR_INVALID; } *sf = sf_local; return 0; } int pa_format_info_get_rate(const pa_format_info *f, uint32_t *rate) { int r; int rate_local; pa_assert(f); pa_assert(rate); r = pa_format_info_get_prop_int(f, PA_PROP_FORMAT_RATE, &rate_local); if (r < 0) return r; if (!pa_sample_rate_valid(rate_local)) { pa_log_debug("Invalid sample rate: %i", rate_local); return -PA_ERR_INVALID; } *rate = rate_local; return 0; } int pa_format_info_get_channels(const pa_format_info *f, uint8_t *channels) { int r; int channels_local; pa_assert(f); pa_assert(channels); r = pa_format_info_get_prop_int(f, PA_PROP_FORMAT_CHANNELS, &channels_local); if (r < 0) return r; if (!pa_channels_valid(channels_local)) { pa_log_debug("Invalid channel count: %i", channels_local); return -PA_ERR_INVALID; } *channels = channels_local; return 0; } int pa_format_info_get_channel_map(const pa_format_info *f, pa_channel_map *map) { int r; char *map_str; pa_assert(f); pa_assert(map); r = pa_format_info_get_prop_string(f, PA_PROP_FORMAT_CHANNEL_MAP, &map_str); if (r < 0) return r; map = pa_channel_map_parse(map, map_str); pa_xfree(map_str); if (!map) { pa_log_debug("Failed to parse channel map."); return -PA_ERR_INVALID; } return 0; } void pa_format_info_set_sample_format(pa_format_info *f, pa_sample_format_t sf) { pa_format_info_set_prop_string(f, PA_PROP_FORMAT_SAMPLE_FORMAT, pa_sample_format_to_string(sf)); } void pa_format_info_set_rate(pa_format_info *f, int rate) { pa_format_info_set_prop_int(f, PA_PROP_FORMAT_RATE, rate); } void pa_format_info_set_channels(pa_format_info *f, int channels) { pa_format_info_set_prop_int(f, PA_PROP_FORMAT_CHANNELS, channels); } void pa_format_info_set_channel_map(pa_format_info *f, const pa_channel_map *map) { char map_str[PA_CHANNEL_MAP_SNPRINT_MAX]; pa_channel_map_snprint(map_str, sizeof(map_str), map); pa_format_info_set_prop_string(f, PA_PROP_FORMAT_CHANNEL_MAP, map_str); } void pa_format_info_set_prop_int(pa_format_info *f, const char *key, int value) { pa_assert(f); pa_assert(key); pa_proplist_setf(f->plist, key, "%d", value); } void pa_format_info_set_prop_int_array(pa_format_info *f, const char *key, const int *values, int n_values) { pa_strbuf *buf; char *str; int i; pa_assert(f); pa_assert(key); pa_assert(n_values > 0); buf = pa_strbuf_new(); pa_strbuf_printf(buf, "[ %d", values[0]); for (i = 1; i < n_values; i++) pa_strbuf_printf(buf, ", %d", values[i]); pa_strbuf_printf(buf, " ]"); str = pa_strbuf_to_string_free(buf); pa_proplist_sets(f->plist, key, str); pa_xfree (str); } void pa_format_info_set_prop_int_range(pa_format_info *f, const char *key, int min, int max) { pa_assert(f); pa_assert(key); pa_proplist_setf(f->plist, key, "{ \"" PA_JSON_MIN_KEY "\": %d, \"" PA_JSON_MAX_KEY "\": %d }", min, max); } void pa_format_info_set_prop_string(pa_format_info *f, const char *key, const char *value) { pa_assert(f); pa_assert(key); pa_proplist_setf(f->plist, key, "\"%s\"", value); } void pa_format_info_set_prop_string_array(pa_format_info *f, const char *key, const char **values, int n_values) { pa_strbuf *buf; char *str; int i; pa_assert(f); pa_assert(key); buf = pa_strbuf_new(); pa_strbuf_printf(buf, "[ \"%s\"", values[0]); for (i = 1; i < n_values; i++) pa_strbuf_printf(buf, ", \"%s\"", values[i]); pa_strbuf_printf(buf, " ]"); str = pa_strbuf_to_string_free(buf); pa_proplist_sets(f->plist, key, str); pa_xfree (str); } static bool pa_json_is_fixed_type(pa_json_object *o) { switch(pa_json_object_get_type(o)) { case PA_JSON_TYPE_OBJECT: case PA_JSON_TYPE_ARRAY: return false; default: return true; } } static int pa_format_info_prop_compatible(const char *one, const char *two) { pa_json_object *o1 = NULL, *o2 = NULL; int i, ret = 0; o1 = pa_json_parse(one); if (!o1) goto out; o2 = pa_json_parse(two); if (!o2) goto out; /* We don't deal with both values being non-fixed - just because there is no immediate need (FIXME) */ pa_return_val_if_fail(pa_json_is_fixed_type(o1) || pa_json_is_fixed_type(o2), false); if (pa_json_is_fixed_type(o1) && pa_json_is_fixed_type(o2)) { ret = pa_json_object_equal(o1, o2); goto out; } if (pa_json_is_fixed_type(o1)) { pa_json_object *tmp = o2; o2 = o1; o1 = tmp; } /* o2 is now a fixed type, and o1 is not */ if (pa_json_object_get_type(o1) == PA_JSON_TYPE_ARRAY) { for (i = 0; i < pa_json_object_get_array_length(o1); i++) { if (pa_json_object_equal(pa_json_object_get_array_member(o1, i), o2)) { ret = 1; break; } } } else if (pa_json_object_get_type(o1) == PA_JSON_TYPE_OBJECT) { /* o1 should be a range type */ int min, max, v; const pa_json_object *o_min = NULL, *o_max = NULL; if (pa_json_object_get_type(o2) != PA_JSON_TYPE_INT) { /* We don't support non-integer ranges */ goto out; } if (!(o_min = pa_json_object_get_object_member(o1, PA_JSON_MIN_KEY)) || pa_json_object_get_type(o_min) != PA_JSON_TYPE_INT) goto out; if (!(o_max = pa_json_object_get_object_member(o1, PA_JSON_MAX_KEY)) || pa_json_object_get_type(o_max) != PA_JSON_TYPE_INT) goto out; v = pa_json_object_get_int(o2); min = pa_json_object_get_int(o_min); max = pa_json_object_get_int(o_max); ret = v >= min && v <= max; } else { pa_log_warn("Got a format type that we don't support"); } out: if (o1) pa_json_object_free(o1); if (o2) pa_json_object_free(o2); return ret; }