Commit | Line | Data |
---|---|---|
7a2c7068 RK |
1 | /* |
2 | * This file is part of DisOrder. | |
3 | * Copyright (C) 2009 Richard Kettlewell | |
4 | * | |
5 | * This program is free software: you can redistribute it and/or modify | |
6 | * it under the terms of the GNU General Public License as published by | |
7 | * the Free Software Foundation, either version 3 of the License, or | |
8 | * (at your option) any later version. | |
9 | * | |
10 | * This program is distributed in the hope that it will be useful, | |
11 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
13 | * GNU General Public License for more details. | |
14 | * | |
15 | * You should have received a copy of the GNU General Public License | |
16 | * along with this program. If not, see <http://www.gnu.org/licenses/>. | |
17 | */ | |
18 | ||
19 | /** @file lib/uaudio.c | |
20 | * @brief Uniform audio interface | |
21 | */ | |
22 | ||
23 | #include "common.h" | |
24 | #include "uaudio.h" | |
25 | #include "hash.h" | |
26 | #include "mem.h" | |
27 | ||
28 | /** @brief Options for chosen uaudio API */ | |
29 | static hash *uaudio_options; | |
30 | ||
4fd38868 RK |
31 | /** @brief Sample rate (Hz) */ |
32 | int uaudio_rate; | |
33 | ||
34 | /** @brief Bits per channel */ | |
35 | int uaudio_bits; | |
36 | ||
37 | /** @brief Number of channels */ | |
38 | int uaudio_channels; | |
39 | ||
40 | /** @brief Whether samples are signed or unsigned */ | |
41 | int uaudio_signed; | |
42 | ||
43 | /** @brief Sample size in bytes | |
44 | * | |
45 | * NB one sample is a single point sample; up to @c uaudio_channels samples may | |
46 | * play at the same time through different speakers. Thus this value is | |
47 | * independent of @ref uaudio_channels. | |
48 | */ | |
49 | size_t uaudio_sample_size; | |
50 | ||
7a2c7068 RK |
51 | /** @brief Set a uaudio option */ |
52 | void uaudio_set(const char *name, const char *value) { | |
ba70caca RK |
53 | if(!value) { |
54 | if(uaudio_options) | |
55 | hash_remove(uaudio_options, name); | |
56 | return; | |
57 | } | |
7a2c7068 RK |
58 | if(!uaudio_options) |
59 | uaudio_options = hash_new(sizeof(char *)); | |
60 | value = xstrdup(value); | |
61 | hash_add(uaudio_options, name, &value, HASH_INSERT_OR_REPLACE); | |
62 | } | |
63 | ||
b50cfb8a RK |
64 | /** @brief Get a uaudio option */ |
65 | char *uaudio_get(const char *name, const char *default_value) { | |
ba70caca RK |
66 | if(!uaudio_options) |
67 | return default_value ? xstrdup(default_value) : 0; | |
68 | char **valuep = hash_find(uaudio_options, name); | |
69 | if(!valuep) | |
70 | return default_value ? xstrdup(default_value) : 0; | |
71 | return xstrdup(*valuep); | |
7a2c7068 RK |
72 | } |
73 | ||
4fd38868 RK |
74 | /** @brief Set sample format |
75 | * @param rate Sample rate in KHz | |
76 | * @param channels Number of channels (i.e. 2 for stereo) | |
77 | * @param bits Number of bits per channel (typically 8 or 16) | |
78 | * @param signed_ True for signed samples, false for unsigned | |
79 | * | |
80 | * Sets @ref uaudio_rate, @ref uaudio_channels, @ref uaudio_bits, @ref | |
81 | * uaudio_signed and @ref uaudio_sample_size. | |
82 | * | |
83 | * Currently there is no way to specify non-native endian formats even if the | |
84 | * underlying API can conveniently handle them. Actually this would be quite | |
85 | * convenient for playrtp, so it might be added at some point. | |
86 | * | |
87 | * Not all APIs can support all sample formats. Generally the @c start | |
88 | * function will do some error checking but some may be deferred to the point | |
89 | * the device is opened (which might be @c activate). | |
90 | */ | |
91 | void uaudio_set_format(int rate, int channels, int bits, int signed_) { | |
92 | uaudio_rate = rate; | |
93 | uaudio_channels = channels; | |
94 | uaudio_bits = bits; | |
95 | uaudio_signed = signed_; | |
96 | uaudio_sample_size = bits / CHAR_BIT; | |
97 | } | |
98 | ||
7a2c7068 RK |
99 | /* |
100 | Local Variables: | |
101 | c-basic-offset:2 | |
102 | comment-column:40 | |
103 | fill-column:79 | |
104 | indent-tabs-mode:nil | |
105 | End: | |
106 | */ |