[0] | 1 | //audio.h: |
---|
| 2 | |
---|
[704] | 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 | |
---|
[0] | 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 |
---|
[1211] | 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) |
---|
[318] | 46 | |
---|
[733] | 47 | BB = Byte order / MSB/LSB |
---|
| 48 | |
---|
[1211] | 49 | -- First Set: |
---|
| 50 | |
---|
[318] | 51 | MIDI 0x08: |
---|
| 52 | 76543210 |
---|
| 53 | 000 0x08 -> MIDI File |
---|
| 54 | |
---|
| 55 | hi-level 0x10: |
---|
[1211] | 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 |
---|
[2681] | 64 | 0111 0x17 -> Ogg |
---|
[1211] | 65 | [...] |
---|
| 66 | **** 0x1a -> ROAR CELT |
---|
| 67 | **** 0x1b -> ROAR SPEEX |
---|
| 68 | **** 0x1c -> RAUM |
---|
| 69 | **** 0x1d -> RAUM Vorbis |
---|
[2332] | 70 | **** 0x1e -> RAUM FLAC |
---|
[560] | 71 | |
---|
| 72 | RIFF/WAVE like 0x20: |
---|
| 73 | 76543210 |
---|
[733] | 74 | 0000 0x20 -> RIFF/WAVE |
---|
| 75 | |
---|
| 76 | LOG Codecs 0x30: |
---|
| 77 | 76543210 |
---|
| 78 | 00BB 0x30 -> A-Law (base) |
---|
| 79 | 01BB 0x34 -> mu-Law (base) |
---|
[1211] | 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) |
---|
[1294] | 89 | |||\-------> META(0)/CONTAINER(1) |
---|
[1820] | 90 | ||\--------> Specal codecs(0) |
---|
[1211] | 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 | |
---|
[1294] | 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 | |
---|
[1820] | 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 |
---|
[1962] | 129 | 0001 -> RoarDMX |
---|
[1820] | 130 | |
---|
[2709] | 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 | |
---|
[0] | 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) |
---|
[733] | 158 | #define ROAR_CODEC_LE 0x01 |
---|
| 159 | #define ROAR_CODEC_BE 0x02 |
---|
| 160 | #define ROAR_CODEC_PDP 0x03 |
---|
[0] | 161 | |
---|
[733] | 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) |
---|
[0] | 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 | |
---|
[318] | 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 |
---|
[2681] | 182 | #define ROAR_CODEC_OGG_CELT 0x16 |
---|
| 183 | #define ROAR_CODEC_OGG 0x17 |
---|
[318] | 184 | |
---|
[329] | 185 | #define ROAR_CODEC_ROAR_CELT 0x1a |
---|
| 186 | #define ROAR_CODEC_ROAR_SPEEX 0x1b |
---|
| 187 | |
---|
[879] | 188 | #define ROAR_CODEC_RAUM 0x1c |
---|
| 189 | #define ROAR_CODEC_RAUM_VORBIS 0x1d |
---|
[2332] | 190 | #define ROAR_CODEC_RAUM_FLAC 0x1e |
---|
[560] | 191 | |
---|
| 192 | #define ROAR_CODEC_RIFF_WAVE 0x20 |
---|
| 193 | |
---|
[733] | 194 | #define ROAR_CODEC_ALAW 0x30 |
---|
| 195 | #define ROAR_CODEC_MULAW 0x34 |
---|
| 196 | |
---|
[1211] | 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) |
---|
[733] | 207 | |
---|
[1294] | 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 | |
---|
[1820] | 227 | |
---|
[2709] | 228 | // MIDI: |
---|
[1820] | 229 | #define ROAR_CODEC_MIDI 0x60 |
---|
[2709] | 230 | |
---|
| 231 | // Light COntrol: |
---|
[1820] | 232 | #define ROAR_CODEC_DMX512 0x70 |
---|
[1962] | 233 | #define ROAR_CODEC_ROARDMX 0x71 |
---|
[1820] | 234 | |
---|
[2709] | 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 | |
---|
[0] | 256 | #if BYTE_ORDER == BIG_ENDIAN |
---|
| 257 | |
---|
[870] | 258 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_BE |
---|
| 259 | |
---|
[0] | 260 | #define ROAR_CODEC_DEFAULT ROAR_CODEC_PCM_BE |
---|
| 261 | #define ROAR_BE2DEF(x) (x) |
---|
| 262 | |
---|
| 263 | #elif BYTE_ORDER == LITTLE_ENDIAN |
---|
| 264 | |
---|
[870] | 265 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_LE |
---|
| 266 | |
---|
[0] | 267 | #define ROAR_CODEC_DEFAULT ROAR_CODEC_PCM_LE |
---|
| 268 | #define ROAR_LE2DEF(x) (x) |
---|
| 269 | |
---|
| 270 | #else |
---|
| 271 | |
---|
[870] | 272 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_PDP |
---|
| 273 | |
---|
[0] | 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 | |
---|
[1062] | 284 | #ifndef ROAR_BITS_DEFAULT |
---|
[0] | 285 | #define ROAR_BITS_DEFAULT 16 |
---|
[1062] | 286 | #endif |
---|
| 287 | #ifndef ROAR_CHANNELS_DEFAULT |
---|
[0] | 288 | #define ROAR_CHANNELS_DEFAULT 2 |
---|
[1062] | 289 | #endif |
---|
| 290 | #ifndef ROAR_RATE_DEFAULT |
---|
[0] | 291 | #define ROAR_RATE_DEFAULT 44100 |
---|
[1062] | 292 | #endif |
---|
[0] | 293 | |
---|
[2398] | 294 | #define ROAR_MIDI_TICKS_PER_BEAT 96 |
---|
| 295 | #define ROAR_MIDI_BITS 8 |
---|
| 296 | #define ROAR_MIDI_CHANNELS_DEFAULT 16 |
---|
| 297 | |
---|
[16] | 298 | #define ROAR_MAX_CHANNELS 64 |
---|
| 299 | |
---|
[17] | 300 | #define ROAR_SET_VOL_ALL 1 |
---|
| 301 | #define ROAR_SET_VOL_ONE 2 |
---|
| 302 | |
---|
[393] | 303 | |
---|
[394] | 304 | #define ROAR_SPEEX_MAX_CC 256 |
---|
[622] | 305 | #define ROAR_SPEEX_MAGIC "RoarSpeex" |
---|
| 306 | #define ROAR_SPEEX_MAGIC_LEN 9 |
---|
[393] | 307 | #define ROAR_SPEEX_MODE_NB 1 |
---|
| 308 | #define ROAR_SPEEX_MODE_WB 2 |
---|
| 309 | #define ROAR_SPEEX_MODE_UWB 3 |
---|
| 310 | |
---|
[636] | 311 | #define ROAR_CELT_MAGIC "RoarCELT0" |
---|
| 312 | #define ROAR_CELT_MAGIC_LEN 9 |
---|
[393] | 313 | |
---|
[0] | 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 { |
---|
[17] | 322 | //unsigned channels; |
---|
[0] | 323 | roar_intm16 scale; |
---|
[319] | 324 | roar_intm16 rpg_mul; // rpg = ReplayGain |
---|
| 325 | roar_intm16 rpg_div; |
---|
[16] | 326 | roar_intm16 mixer[ROAR_MAX_CHANNELS]; |
---|
[0] | 327 | }; |
---|
| 328 | |
---|
[1671] | 329 | #define ROAR_MIXER(x) ((struct roar_mixer_settings *)x) |
---|
| 330 | |
---|
[0] | 331 | #endif |
---|
| 332 | |
---|
| 333 | //ll |
---|