[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 |
---|
| 64 | [...] |
---|
| 65 | **** 0x1a -> ROAR CELT |
---|
| 66 | **** 0x1b -> ROAR SPEEX |
---|
| 67 | **** 0x1c -> RAUM |
---|
| 68 | **** 0x1d -> RAUM Vorbis |
---|
[560] | 69 | |
---|
| 70 | RIFF/WAVE like 0x20: |
---|
| 71 | 76543210 |
---|
[733] | 72 | 0000 0x20 -> RIFF/WAVE |
---|
| 73 | |
---|
| 74 | LOG Codecs 0x30: |
---|
| 75 | 76543210 |
---|
| 76 | 00BB 0x30 -> A-Law (base) |
---|
| 77 | 01BB 0x34 -> mu-Law (base) |
---|
[1211] | 78 | |
---|
| 79 | -- Second Set: |
---|
| 80 | |
---|
| 81 | Bits: |
---|
| 82 | 76543210 |
---|
| 83 | |||||||\---\ byte- |
---|
| 84 | ||||||\----/ order |
---|
| 85 | |||||\-----> unsigned? (or other flags) |
---|
| 86 | ||||\------> META: text(0) or binary(1) |
---|
| 87 | |||\-------> META(0) |
---|
| 88 | ||\--------> (0) |
---|
| 89 | |\---------> second set(1) |
---|
| 90 | \----------> (0) |
---|
| 91 | |
---|
| 92 | Meta Codecs 0x40: |
---|
| 93 | 76543210 |
---|
| 94 | 0000 0x40 -> Meta Text: Vorbis Comment Like |
---|
| 95 | [...] |
---|
| 96 | 0100 0x44 -> Meta Text: RoarAudio Like |
---|
| 97 | [...] |
---|
| 98 | 11BB 0x4c -> Meta Binary: RoarAudio Like |
---|
| 99 | |
---|
[0] | 100 | */ |
---|
| 101 | |
---|
| 102 | #define ROAR_CODEC_IS_SIGNED(x) (((x) & ROAR_CODEC_UNSIGNED) == 0 ? 1 : 0) |
---|
| 103 | #define ROAR_CODEC_BYTE_ORDER(x) ((x) & 0x03) |
---|
| 104 | |
---|
| 105 | #define ROAR_CODEC_UNSIGNED (1 << 2) |
---|
[733] | 106 | #define ROAR_CODEC_LE 0x01 |
---|
| 107 | #define ROAR_CODEC_BE 0x02 |
---|
| 108 | #define ROAR_CODEC_PDP 0x03 |
---|
[0] | 109 | |
---|
[733] | 110 | #define ROAR_CODEC_MSB 0x00 |
---|
| 111 | #define ROAR_CODEC_LSB 0x01 |
---|
| 112 | |
---|
| 113 | #define ROAR_CODEC_PCM 0x00 |
---|
| 114 | #define ROAR_CODEC_PCM_S_LE (ROAR_CODEC_PCM | ROAR_CODEC_LE ) |
---|
| 115 | #define ROAR_CODEC_PCM_S_BE (ROAR_CODEC_PCM | ROAR_CODEC_BE ) |
---|
| 116 | #define ROAR_CODEC_PCM_S_PDP (ROAR_CODEC_PCM | ROAR_CODEC_PDP) |
---|
[0] | 117 | |
---|
| 118 | #define ROAR_CODEC_PCM_U_LE (ROAR_CODEC_PCM_S_LE | ROAR_CODEC_UNSIGNED) |
---|
| 119 | #define ROAR_CODEC_PCM_U_BE (ROAR_CODEC_PCM_S_BE | ROAR_CODEC_UNSIGNED) |
---|
| 120 | #define ROAR_CODEC_PCM_U_PDP (ROAR_CODEC_PCM_S_PDP | ROAR_CODEC_UNSIGNED) |
---|
| 121 | |
---|
[318] | 122 | #define ROAR_CODEC_MIDI_FILE 0x08 |
---|
| 123 | |
---|
| 124 | #define ROAR_CODEC_OGG_VORBIS 0x10 |
---|
| 125 | #define ROAR_CODEC_FLAC 0x11 /* native FLAC without Ogg container */ |
---|
| 126 | #define ROAR_CODEC_OGG_SPEEX 0x12 |
---|
| 127 | /* #define ROAR_CODEC_CELT/OGG_CELT 0x13 Reserved for CELT */ |
---|
| 128 | #define ROAR_CODEC_OGG_FLAC 0x14 |
---|
| 129 | #define ROAR_CODEC_OGG_GENERAL 0x15 |
---|
| 130 | |
---|
[329] | 131 | #define ROAR_CODEC_ROAR_CELT 0x1a |
---|
| 132 | #define ROAR_CODEC_ROAR_SPEEX 0x1b |
---|
| 133 | |
---|
[879] | 134 | #define ROAR_CODEC_RAUM 0x1c |
---|
| 135 | #define ROAR_CODEC_RAUM_VORBIS 0x1d |
---|
[560] | 136 | |
---|
| 137 | #define ROAR_CODEC_RIFF_WAVE 0x20 |
---|
| 138 | |
---|
[733] | 139 | #define ROAR_CODEC_ALAW 0x30 |
---|
| 140 | #define ROAR_CODEC_MULAW 0x34 |
---|
| 141 | |
---|
[1211] | 142 | // Meta Codecs: |
---|
| 143 | #define ROAR_CODEC_META_VCLT 0x40 /* VCLT = Vorbis Comment Like Text */ |
---|
| 144 | #define ROAR_CODEC_META_RALT 0x44 /* RALT = RoarAudio Like Text */ |
---|
| 145 | #define ROAR_CODEC_META_RALB 0x4c /* RALB = RoarAudio Like Binary */ |
---|
| 146 | /* if no byte order is given then you |
---|
| 147 | should assume BE as it is network |
---|
| 148 | byte order */ |
---|
| 149 | #define ROAR_CODEC_META_RALB_LE (ROAR_CODEC_META_RALB | ROAR_CODEC_LE) |
---|
| 150 | #define ROAR_CODEC_META_RALB_BE (ROAR_CODEC_META_RALB | ROAR_CODEC_BE) |
---|
| 151 | #define ROAR_CODEC_META_RALB_PDP (ROAR_CODEC_META_RALB | ROAR_CODEC_PDP) |
---|
[733] | 152 | |
---|
[0] | 153 | #if BYTE_ORDER == BIG_ENDIAN |
---|
| 154 | |
---|
[870] | 155 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_BE |
---|
| 156 | |
---|
[0] | 157 | #define ROAR_CODEC_DEFAULT ROAR_CODEC_PCM_BE |
---|
| 158 | #define ROAR_BE2DEF(x) (x) |
---|
| 159 | |
---|
| 160 | #elif BYTE_ORDER == LITTLE_ENDIAN |
---|
| 161 | |
---|
[870] | 162 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_LE |
---|
| 163 | |
---|
[0] | 164 | #define ROAR_CODEC_DEFAULT ROAR_CODEC_PCM_LE |
---|
| 165 | #define ROAR_LE2DEF(x) (x) |
---|
| 166 | |
---|
| 167 | #else |
---|
| 168 | |
---|
[870] | 169 | #define ROAR_CODEC_NATIVE_ENDIAN ROAR_CODEC_PDP |
---|
| 170 | |
---|
[0] | 171 | #define ROAR_CODEC_DEFAULT ROAR_CODEC_PCM_PDP |
---|
| 172 | #define ROAR_PDP2DEF(x) (x) |
---|
| 173 | |
---|
| 174 | #endif |
---|
| 175 | |
---|
| 176 | |
---|
| 177 | #define ROAR_CODEC_NATIVE ROAR_CODEC_DEFAULT |
---|
| 178 | |
---|
| 179 | #define ROAR_BITS_MAX 32 |
---|
| 180 | |
---|
[1062] | 181 | #ifndef ROAR_BITS_DEFAULT |
---|
[0] | 182 | #define ROAR_BITS_DEFAULT 16 |
---|
[1062] | 183 | #endif |
---|
| 184 | #ifndef ROAR_CHANNELS_DEFAULT |
---|
[0] | 185 | #define ROAR_CHANNELS_DEFAULT 2 |
---|
[1062] | 186 | #endif |
---|
| 187 | #ifndef ROAR_RATE_DEFAULT |
---|
[0] | 188 | #define ROAR_RATE_DEFAULT 44100 |
---|
[1062] | 189 | #endif |
---|
[0] | 190 | |
---|
[16] | 191 | #define ROAR_MAX_CHANNELS 64 |
---|
| 192 | |
---|
[17] | 193 | #define ROAR_SET_VOL_ALL 1 |
---|
| 194 | #define ROAR_SET_VOL_ONE 2 |
---|
| 195 | |
---|
[393] | 196 | |
---|
[394] | 197 | #define ROAR_SPEEX_MAX_CC 256 |
---|
[622] | 198 | #define ROAR_SPEEX_MAGIC "RoarSpeex" |
---|
| 199 | #define ROAR_SPEEX_MAGIC_LEN 9 |
---|
[393] | 200 | #define ROAR_SPEEX_MODE_NB 1 |
---|
| 201 | #define ROAR_SPEEX_MODE_WB 2 |
---|
| 202 | #define ROAR_SPEEX_MODE_UWB 3 |
---|
| 203 | |
---|
[636] | 204 | #define ROAR_CELT_MAGIC "RoarCELT0" |
---|
| 205 | #define ROAR_CELT_MAGIC_LEN 9 |
---|
[393] | 206 | |
---|
[0] | 207 | struct roar_audio_info { |
---|
| 208 | unsigned int rate; |
---|
| 209 | unsigned int bits; |
---|
| 210 | unsigned int channels; |
---|
| 211 | unsigned int codec; |
---|
| 212 | }; |
---|
| 213 | |
---|
| 214 | struct roar_mixer_settings { |
---|
[17] | 215 | //unsigned channels; |
---|
[0] | 216 | roar_intm16 scale; |
---|
[319] | 217 | roar_intm16 rpg_mul; // rpg = ReplayGain |
---|
| 218 | roar_intm16 rpg_div; |
---|
[16] | 219 | roar_intm16 mixer[ROAR_MAX_CHANNELS]; |
---|
[0] | 220 | }; |
---|
| 221 | |
---|
| 222 | #endif |
---|
| 223 | |
---|
| 224 | //ll |
---|