]> code.delx.au - pulseaudio/blob - src/pulsecore/core-format.c
format, core-format: Constify some function parameters
[pulseaudio] / src / pulsecore / core-format.c
1 /***
2 This file is part of PulseAudio.
3
4 PulseAudio is free software; you can redistribute it and/or modify
5 it under the terms of the GNU Lesser General Public License as published
6 by the Free Software Foundation; either version 2.1 of the License,
7 or (at your option) any later version.
8
9 PulseAudio is distributed in the hope that it will be useful, but
10 WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public License
15 along with PulseAudio; if not, write to the Free Software
16 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
17 USA.
18 ***/
19
20 #ifdef HAVE_CONFIG_H
21 #include <config.h>
22 #endif
23
24 #include "core-format.h"
25
26 #include <pulse/def.h>
27 #include <pulse/xmalloc.h>
28
29 #include <pulsecore/macro.h>
30
31 int pa_format_info_get_sample_format(const pa_format_info *f, pa_sample_format_t *sf) {
32 int r;
33 char *sf_str;
34 pa_sample_format_t sf_local;
35
36 pa_assert(f);
37 pa_assert(sf);
38
39 r = pa_format_info_get_prop_string(f, PA_PROP_FORMAT_SAMPLE_FORMAT, &sf_str);
40 if (r < 0)
41 return r;
42
43 sf_local = pa_parse_sample_format(sf_str);
44 pa_xfree(sf_str);
45
46 if (!pa_sample_format_valid(sf_local)) {
47 pa_log_debug("Invalid sample format.");
48 return -PA_ERR_INVALID;
49 }
50
51 *sf = sf_local;
52
53 return 0;
54 }
55
56 int pa_format_info_get_rate(const pa_format_info *f, uint32_t *rate) {
57 int r;
58 int rate_local;
59
60 pa_assert(f);
61 pa_assert(rate);
62
63 r = pa_format_info_get_prop_int(f, PA_PROP_FORMAT_RATE, &rate_local);
64 if (r < 0)
65 return r;
66
67 if (!pa_sample_rate_valid(rate_local)) {
68 pa_log_debug("Invalid sample rate: %i", rate_local);
69 return -PA_ERR_INVALID;
70 }
71
72 *rate = rate_local;
73
74 return 0;
75 }
76
77 int pa_format_info_get_channels(const pa_format_info *f, uint8_t *channels) {
78 int r;
79 int channels_local;
80
81 pa_assert(f);
82 pa_assert(channels);
83
84 r = pa_format_info_get_prop_int(f, PA_PROP_FORMAT_CHANNELS, &channels_local);
85 if (r < 0)
86 return r;
87
88 if (!pa_channels_valid(channels_local)) {
89 pa_log_debug("Invalid channel count: %i", channels_local);
90 return -PA_ERR_INVALID;
91 }
92
93 *channels = channels_local;
94
95 return 0;
96 }
97
98 int pa_format_info_get_channel_map(const pa_format_info *f, pa_channel_map *map) {
99 int r;
100 char *map_str;
101
102 pa_assert(f);
103 pa_assert(map);
104
105 r = pa_format_info_get_prop_string(f, PA_PROP_FORMAT_CHANNEL_MAP, &map_str);
106 if (r < 0)
107 return r;
108
109 map = pa_channel_map_parse(map, map_str);
110 pa_xfree(map_str);
111
112 if (!map) {
113 pa_log_debug("Failed to parse channel map.");
114 return -PA_ERR_INVALID;
115 }
116
117 return 0;
118 }
119
120 pa_format_info *pa_format_info_from_sample_spec2(const pa_sample_spec *ss, const pa_channel_map *map, bool set_format,
121 bool set_rate, bool set_channels) {
122 pa_format_info *format = NULL;
123
124 pa_assert(ss);
125
126 format = pa_format_info_new();
127 format->encoding = PA_ENCODING_PCM;
128
129 if (set_format)
130 pa_format_info_set_sample_format(format, ss->format);
131
132 if (set_rate)
133 pa_format_info_set_rate(format, ss->rate);
134
135 if (set_channels) {
136 pa_format_info_set_channels(format, ss->channels);
137
138 if (map) {
139 if (map->channels != ss->channels) {
140 pa_log_debug("Channel map is incompatible with the sample spec.");
141 goto fail;
142 }
143
144 pa_format_info_set_channel_map(format, map);
145 }
146 }
147
148 return format;
149
150 fail:
151 if (format)
152 pa_format_info_free(format);
153
154 return NULL;
155 }
156
157 int pa_format_info_to_sample_spec2(const pa_format_info *f, pa_sample_spec *ss, pa_channel_map *map,
158 const pa_sample_spec *fallback_ss, const pa_channel_map *fallback_map) {
159 int r, r2;
160 pa_sample_spec ss_local;
161 pa_channel_map map_local;
162
163 pa_assert(f);
164 pa_assert(ss);
165 pa_assert(map);
166 pa_assert(fallback_ss);
167 pa_assert(fallback_map);
168
169 if (!pa_format_info_is_pcm(f))
170 return pa_format_info_to_sample_spec_fake(f, ss, map);
171
172 r = pa_format_info_get_sample_format(f, &ss_local.format);
173 if (r == -PA_ERR_NOENTITY)
174 ss_local.format = fallback_ss->format;
175 else if (r < 0)
176 return r;
177
178 pa_assert(pa_sample_format_valid(ss_local.format));
179
180 r = pa_format_info_get_rate(f, &ss_local.rate);
181 if (r == -PA_ERR_NOENTITY)
182 ss_local.rate = fallback_ss->rate;
183 else if (r < 0)
184 return r;
185
186 pa_assert(pa_sample_rate_valid(ss_local.rate));
187
188 r = pa_format_info_get_channels(f, &ss_local.channels);
189 r2 = pa_format_info_get_channel_map(f, &map_local);
190 if (r == -PA_ERR_NOENTITY && r2 >= 0)
191 ss_local.channels = map_local.channels;
192 else if (r == -PA_ERR_NOENTITY)
193 ss_local.channels = fallback_ss->channels;
194 else if (r < 0)
195 return r;
196
197 pa_assert(pa_channels_valid(ss_local.channels));
198
199 if (r2 >= 0 && map_local.channels != ss_local.channels) {
200 pa_log_debug("Channel map is not compatible with the sample spec.");
201 return -PA_ERR_INVALID;
202 }
203
204 if (r2 == -PA_ERR_NOENTITY) {
205 if (fallback_map->channels == ss_local.channels)
206 map_local = *fallback_map;
207 else
208 pa_channel_map_init_extend(&map_local, ss_local.channels, PA_CHANNEL_MAP_DEFAULT);
209 } else if (r2 < 0)
210 return r2;
211
212 pa_assert(pa_channel_map_valid(&map_local));
213 pa_assert(ss_local.channels == map_local.channels);
214
215 *ss = ss_local;
216 *map = map_local;
217
218 return 0;
219 }
220
221 int pa_format_info_to_sample_spec_fake(const pa_format_info *f, pa_sample_spec *ss, pa_channel_map *map) {
222 int rate;
223
224 pa_assert(f);
225 pa_assert(ss);
226
227 /* Note: When we add support for non-IEC61937 encapsulated compressed
228 * formats, this function should return a non-zero values for these. */
229
230 ss->format = PA_SAMPLE_S16LE;
231 ss->channels = 2;
232
233 if (map)
234 pa_channel_map_init_stereo(map);
235
236 pa_return_val_if_fail(pa_format_info_get_prop_int(f, PA_PROP_FORMAT_RATE, &rate) == 0, -PA_ERR_INVALID);
237 ss->rate = (uint32_t) rate;
238
239 if (f->encoding == PA_ENCODING_EAC3_IEC61937)
240 ss->rate *= 4;
241
242 return 0;
243 }