1 | //audio.h: |
---|
2 | |
---|
3 | /* |
---|
4 | * Copyright (C) Philipp 'ph3-der-loewe' Schafft - 2008 |
---|
5 | * |
---|
6 | * This file is part of RoarAudio, |
---|
7 | * a cross-platform sound system for both, home and professional use. |
---|
8 | * See README for details. |
---|
9 | * |
---|
10 | * This file is free software; you can redistribute it and/or modify |
---|
11 | * it under the terms of the GNU Lesser General Public License version 3 |
---|
12 | * as published by the Free Software Foundation. |
---|
13 | * |
---|
14 | * RoarAudio is distributed in the hope that it will be useful, |
---|
15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
17 | * GNU Lesser General Public License for more details. |
---|
18 | * |
---|
19 | * You should have received a copy of the GNU Lesser General Public License |
---|
20 | * along with this software; see the file COPYING. If not, write to |
---|
21 | * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. |
---|
22 | * |
---|
23 | * NOTE: Even though this file is LGPLed it (may) include GPLed files |
---|
24 | * so the license of this file is/may therefore downgraded to GPL. |
---|
25 | * See HACKING for details. |
---|
26 | */ |
---|
27 | |
---|
28 | #ifndef _ROARAUDIO_AUDIO_H_ |
---|
29 | #define _ROARAUDIO_AUDIO_H_ |
---|
30 | |
---|
31 | #define ROAR_CODEC_PCM_LE ROAR_CODEC_PCM_S_LE |
---|
32 | #define ROAR_CODEC_PCM_BE ROAR_CODEC_PCM_S_BE |
---|
33 | #define ROAR_CODEC_PCM_PDP ROAR_CODEC_PCM_S_PDP |
---|
34 | |
---|
35 | /* |
---|
36 | Bits: |
---|
37 | 76543210 |
---|
38 | |||||||\---\ byte- |
---|
39 | ||||||\----/ order |
---|
40 | |||||\-----> unsigned? |
---|
41 | ||||\------> PCM(0) or MIDI(1)? |
---|
42 | |||\-------> PCM/MIDI(0) or hi-level codecs(1) |
---|
43 | ||\--------> MISC(0) or RIFF/WAVE like(1) |
---|
44 | |\---------> first set(0) or second set(1) |
---|
45 | \----------> (0) |
---|
46 | |
---|
47 | BB = Byte order / MSB/LSB |
---|
48 | |
---|
49 | -- First Set: |
---|
50 | |
---|
51 | MIDI 0x08: |
---|
52 | 76543210 |
---|
53 | 000 0x08 -> MIDI File |
---|
54 | |
---|
55 | hi-level 0x10: |
---|
56 | 76543210 |
---|
57 | 0000 0x10 -> Ogg Vorbis |
---|
58 | 0001 0x11 -> Native FLAC |
---|
59 | 0010 0x12 -> Ogg Speex |
---|
60 | 0011 0x13 -> Reserved for CELT |
---|
61 | 0100 0x14 -> Ogg FLAC |
---|
62 | 0101 0x15 -> Ogg General |
---|
63 | 0110 0x16 -> Ogg CELT |
---|
64 | 0111 0x17 -> Ogg |
---|
65 | [...] |
---|
66 | **** 0x1a -> ROAR CELT |
---|
67 | **** 0x1b -> ROAR SPEEX |
---|
68 | **** 0x1c -> RAUM |
---|
69 | **** 0x1d -> RAUM Vorbis |
---|
70 | **** 0x1e -> RAUM FLAC |
---|
71 | |
---|
72 | RIFF/WAVE like 0x20: |
---|
73 | 76543210 |
---|
74 | 0000 0x20 -> RIFF/WAVE |
---|
75 | |
---|
76 | LOG Codecs 0x30: |
---|
77 | 76543210 |
---|
78 | 00BB 0x30 -> A-Law (base) |
---|
79 | 01BB 0x34 -> mu-Law (base) |
---|
80 | |
---|
81 | -- Second Set: |
---|
82 | |
---|
83 | Bits: |
---|
84 | 76543210 |
---|
85 | |||||||\---\ byte- |
---|
86 | ||||||\----/ order |
---|
87 | |||||\-----> unsigned? (or other flags) |
---|
88 | ||||\------> META: text(0) or binary(1) |
---|
89 | |||\-------> META(0)/CONTAINER(1) |
---|
90 | ||\--------> Specal codecs(0) |
---|
91 | |\---------> second set(1) |
---|
92 | \----------> (0) |
---|
93 | |
---|
94 | Meta Codecs 0x40: |
---|
95 | 76543210 |
---|
96 | 0000 0x40 -> Meta Text: Vorbis Comment Like |
---|
97 | [...] |
---|
98 | 0100 0x44 -> Meta Text: RoarAudio Like |
---|
99 | [...] |
---|
100 | 11BB 0x4c -> Meta Binary: RoarAudio Like |
---|
101 | |
---|
102 | Container 0x50: |
---|
103 | 76543210 |
---|
104 | 0000 0x50 -> Null container: pass |
---|
105 | 0001 0x51 -> Gzip |
---|
106 | 0010 0x52 -> Bzip2 |
---|
107 | 0011 0x53 -> OpenPGP bin |
---|
108 | 0100 0x54 -> OpenPGP asc |
---|
109 | 0101 0x55 -> TAR |
---|
110 | |
---|
111 | Bits: |
---|
112 | 76543210 |
---|
113 | |||||||\---\ byte- |
---|
114 | ||||||\----/ order |
---|
115 | |||||\-----> unsigned? (or other flags) |
---|
116 | ||||\------> (0) |
---|
117 | |||\-------> MIDI(0)/Light(1) |
---|
118 | ||\--------> MIDI and Light(1) |
---|
119 | |\---------> second set(1) |
---|
120 | \----------> (0) |
---|
121 | |
---|
122 | MIDI 0x60: |
---|
123 | 76543210 |
---|
124 | 0000 -> MIDI |
---|
125 | |
---|
126 | Light 0x70: |
---|
127 | 76543210 |
---|
128 | 0000 -> DMX512 |
---|
129 | 0001 -> RoarDMX |
---|
130 | |
---|
131 | Bits: |
---|
132 | 76543210 |
---|
133 | |||||||\---\ byte- |
---|
134 | ||||||\----/ order |
---|
135 | |||||\-----> unsigned? (or other flags) |
---|
136 | ||||\------> ID |
---|
137 | |||\-------> RDTCS(0) / User/Vendor Specific(1) |
---|
138 | ||\--------> first subset(0) |
---|
139 | |\---------> first set(0) |
---|
140 | \----------> (1) |
---|
141 | |
---|
142 | RDTCS 0x80: |
---|
143 | 76543210 |
---|
144 | 0000 -> RDS |
---|
145 | |
---|
146 | User 0x90: |
---|
147 | 76543210 |
---|
148 | 0000 -> USER0 |
---|
149 | [...] |
---|
150 | 1111 -> USER15 |
---|
151 | |
---|
152 | */ |
---|
153 | |
---|
154 | #define ROAR_CODEC_IS_SIGNED(x) (((x) & ROAR_CODEC_UNSIGNED) == 0 ? 1 : 0) |
---|
155 | #define ROAR_CODEC_BYTE_ORDER(x) ((x) & 0x03) |
---|
156 | |
---|
157 | #define ROAR_CODEC_UNSIGNED (1 << 2) |
---|
158 | #define ROAR_CODEC_LE 0x01 |
---|
159 | #define ROAR_CODEC_BE 0x02 |
---|
160 | #define ROAR_CODEC_PDP 0x03 |
---|
161 | |
---|
162 | #define ROAR_CODEC_MSB 0x00 |
---|
163 | #define ROAR_CODEC_LSB 0x01 |
---|
164 | |
---|
165 | #define ROAR_CODEC_PCM 0x00 |
---|
166 | #define ROAR_CODEC_PCM_S_LE (ROAR_CODEC_PCM | ROAR_CODEC_LE ) |
---|
167 | #define ROAR_CODEC_PCM_S_BE (ROAR_CODEC_PCM | ROAR_CODEC_BE ) |
---|
168 | #define ROAR_CODEC_PCM_S_PDP (ROAR_CODEC_PCM | ROAR_CODEC_PDP) |
---|
169 | |
---|
170 | #define ROAR_CODEC_PCM_U_LE (ROAR_CODEC_PCM_S_LE | ROAR_CODEC_UNSIGNED) |
---|
171 | #define ROAR_CODEC_PCM_U_BE (ROAR_CODEC_PCM_S_BE | ROAR_CODEC_UNSIGNED) |
---|
172 | #define ROAR_CODEC_PCM_U_PDP (ROAR_CODEC_PCM_S_PDP | ROAR_CODEC_UNSIGNED) |
---|
173 | |
---|
174 | #define ROAR_CODEC_MIDI_FILE 0x08 |
---|
175 | |
---|
176 | #define ROAR_CODEC_OGG_VORBIS 0x10 |
---|
177 | #define ROAR_CODEC_FLAC 0x11 /* native FLAC without Ogg container */ |
---|
178 | #define ROAR_CODEC_OGG_SPEEX 0x12 |
---|
179 | /* #define ROAR_CODEC_CELT/OGG_CELT 0x13 Reserved for CELT */ |
---|
180 | #define ROAR_CODEC_OGG_FLAC 0x14 |
---|
181 | #define ROAR_CODEC_OGG_GENERAL 0x15 |
---|
182 | #define ROAR_CODEC_OGG_CELT 0x16 |
---|
183 | #define ROAR_CODEC_OGG 0x17 |
---|
184 | |
---|
185 | #define ROAR_CODEC_ROAR_CELT 0x1a |
---|
186 | #define ROAR_CODEC_ROAR_SPEEX 0x1b |
---|
187 | |
---|
188 | #define ROAR_CODEC_RAUM 0x1c |
---|
189 | #define ROAR_CODEC_RAUM_VORBIS 0x1d |
---|
190 | #define ROAR_CODEC_RAUM_FLAC 0x1e |
---|
191 | |
---|
192 | #define ROAR_CODEC_RIFF_WAVE 0x20 |
---|
193 | |
---|
194 | #define ROAR_CODEC_ALAW 0x30 |
---|
195 | #define ROAR_CODEC_MULAW 0x34 |
---|
196 | |
---|
197 | // Meta Codecs: |
---|
198 | #define ROAR_CODEC_META_VCLT 0x40 /* VCLT = Vorbis Comment Like Text */ |
---|
199 | #define ROAR_CODEC_META_RALT 0x44 /* RALT = RoarAudio Like Text */ |
---|
200 | #define ROAR_CODEC_META_RALB 0x4c /* RALB = RoarAudio Like Binary */ |
---|
201 | /* if no byte order is given then you |
---|
202 | should assume BE as it is network |
---|
203 | byte order */ |
---|
204 | #define ROAR_CODEC_META_RALB_LE (ROAR_CODEC_META_RALB | ROAR_CODEC_LE) |
---|
205 | #define ROAR_CODEC_META_RALB_BE (ROAR_CODEC_META_RALB | ROAR_CODEC_BE) |
---|
206 | #define ROAR_CODEC_META_RALB_PDP (ROAR_CODEC_META_RALB | ROAR_CODEC_PDP) |
---|
207 | |
---|
208 | // Container Codecs: |
---|
209 | /* |
---|
210 | Container 0x50: |
---|
211 | 76543210 |
---|
212 | 0000 0x50 -> Null container: pass |
---|
213 | 0001 0x51 -> Gzip |
---|
214 | 0010 0x52 -> Bzip2 |
---|
215 | 0011 0x53 -> OpenPGP bin |
---|
216 | 0100 0x54 -> OpenPGP asc |
---|
217 | 0101 0x55 -> TAR |
---|
218 | */ |
---|
219 | #define ROAR_CODEC_CONT_NULL 0x50 |
---|
220 | #define ROAR_CODEC_CONT_BASE ROAR_CODEC_CONT_NULL |
---|
221 | #define ROAR_CODEC_CONT_GZIP 0x51 |
---|
222 | #define ROAR_CODEC_CONT_BZIP2 0x52 |
---|
223 | #define ROAR_CODEC_CONT_OPGPBIN 0x53 |
---|
224 | #define ROAR_CODEC_CONT_OPGPASC 0x54 |
---|
225 | #define ROAR_CODEC_CONT_TAR 0x55 |
---|
226 | |
---|
227 | |
---|
228 | // MIDI: |
---|
229 | #define ROAR_CODEC_MIDI 0x60 |
---|
230 | |
---|
231 | // Light COntrol: |
---|
232 | #define ROAR_CODEC_DMX512 0x70 |
---|
233 | #define ROAR_CODEC_ROARDMX 0x71 |
---|
234 | |
---|
235 | // RDTCS: |
---|
236 | #define ROAR_CODEC_RDS 0x80 |
---|
237 | |
---|
238 | // User specific: |
---|
239 | #define ROAR_CODEC_USER0 0x90 |
---|
240 | #define ROAR_CODEC_USER1 0x91 |
---|
241 | #define ROAR_CODEC_USER2 0x92 |
---|
242 | #define ROAR_CODEC_USER3 0x93 |
---|
243 | #define ROAR_CODEC_USER4 0x94 |
---|
244 | #define ROAR_CODEC_USER5 0x95 |
---|
245 | #define ROAR_CODEC_USER6 0x96 |
---|
246 | #define ROAR_CODEC_USER7 0x97 |
---|
247 | #define ROAR_CODEC_USER8 0x98 |
---|
248 | #define ROAR_CODEC_USER9 0x99 |
---|
249 | #define ROAR_CODEC_USER10 0x9a |
---|
250 | #define ROAR_CODEC_USER11 0x9b |
---|
251 | #define ROAR_CODEC_USER12 0x9c |
---|
252 | #define ROAR_CODEC_USER13 0x9d |
---|
253 | #define ROAR_CODEC_USER14 0x9e |
---|
254 | #define ROAR_CODEC_USER15 0x9f |
---|
255 | |
---|
256 | #if BYTE_ORDER == BIG_ENDIAN |
---|
257 | |
---|
258 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_BE |
---|
259 | |
---|
260 | #define ROAR_CODEC_DEFAULT ROAR_CODEC_PCM_BE |
---|
261 | #define ROAR_BE2DEF(x) (x) |
---|
262 | |
---|
263 | #elif BYTE_ORDER == LITTLE_ENDIAN |
---|
264 | |
---|
265 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_LE |
---|
266 | |
---|
267 | #define ROAR_CODEC_DEFAULT ROAR_CODEC_PCM_LE |
---|
268 | #define ROAR_LE2DEF(x) (x) |
---|
269 | |
---|
270 | #else |
---|
271 | |
---|
272 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_PDP |
---|
273 | |
---|
274 | #define ROAR_CODEC_DEFAULT ROAR_CODEC_PCM_PDP |
---|
275 | #define ROAR_PDP2DEF(x) (x) |
---|
276 | |
---|
277 | #endif |
---|
278 | |
---|
279 | |
---|
280 | #define ROAR_CODEC_NATIVE ROAR_CODEC_DEFAULT |
---|
281 | |
---|
282 | #define ROAR_BITS_MAX 32 |
---|
283 | |
---|
284 | #ifndef ROAR_BITS_DEFAULT |
---|
285 | #define ROAR_BITS_DEFAULT 16 |
---|
286 | #endif |
---|
287 | #ifndef ROAR_CHANNELS_DEFAULT |
---|
288 | #define ROAR_CHANNELS_DEFAULT 2 |
---|
289 | #endif |
---|
290 | #ifndef ROAR_RATE_DEFAULT |
---|
291 | #define ROAR_RATE_DEFAULT 44100 |
---|
292 | #endif |
---|
293 | |
---|
294 | #define ROAR_MIDI_TICKS_PER_BEAT 96 |
---|
295 | #define ROAR_MIDI_BITS 8 |
---|
296 | #define ROAR_MIDI_CHANNELS_DEFAULT 16 |
---|
297 | |
---|
298 | #define ROAR_MAX_CHANNELS 64 |
---|
299 | |
---|
300 | #define ROAR_SET_VOL_ALL 1 |
---|
301 | #define ROAR_SET_VOL_ONE 2 |
---|
302 | |
---|
303 | |
---|
304 | #define ROAR_SPEEX_MAX_CC 256 |
---|
305 | #define ROAR_SPEEX_MAGIC "RoarSpeex" |
---|
306 | #define ROAR_SPEEX_MAGIC_LEN 9 |
---|
307 | #define ROAR_SPEEX_MODE_NB 1 |
---|
308 | #define ROAR_SPEEX_MODE_WB 2 |
---|
309 | #define ROAR_SPEEX_MODE_UWB 3 |
---|
310 | |
---|
311 | #define ROAR_CELT_MAGIC "RoarCELT0" |
---|
312 | #define ROAR_CELT_MAGIC_LEN 9 |
---|
313 | |
---|
314 | struct roar_audio_info { |
---|
315 | unsigned int rate; |
---|
316 | unsigned int bits; |
---|
317 | unsigned int channels; |
---|
318 | unsigned int codec; |
---|
319 | }; |
---|
320 | |
---|
321 | struct roar_mixer_settings { |
---|
322 | //unsigned channels; |
---|
323 | roar_intm16 scale; |
---|
324 | roar_intm16 rpg_mul; // rpg = ReplayGain |
---|
325 | roar_intm16 rpg_div; |
---|
326 | roar_intm16 mixer[ROAR_MAX_CHANNELS]; |
---|
327 | }; |
---|
328 | |
---|
329 | #define ROAR_MIXER(x) ((struct roar_mixer_settings *)x) |
---|
330 | |
---|
331 | #endif |
---|
332 | |
---|
333 | //ll |
---|