include/vlc_codecs.h

   1 /*****************************************************************************
   2  * vlc_codecs.h: codec related structures needed by the demuxers and decoders
   3  *****************************************************************************
   4  * Copyright (C) 1999-2001 VLC authors and VideoLAN
   5  *
   6  * Author: Gildas Bazin <gbazin@videolan.org>
   7  *
   8  * This program is free software; you can redistribute it and/or modify it
   9  * under the terms of the GNU Lesser General Public License as published by
  10  * the Free Software Foundation; either version 2.1 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16  * GNU Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public License
  19  * along with this program; if not, write to the Free Software Foundation,
  20  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  21  *****************************************************************************/
  22
  23 #ifndef VLC_CODECS_H
  24 #define VLC_CODECS_H 1
  25
  26 #include <vlc_fourcc.h>
  27 /**
  28  * \file
  29  * This file defines codec related structures needed by the demuxers and decoders
  30  */
  31
  32 /* Structures exported to the demuxers and decoders */
  33
  34 #if !(defined _GUID_DEFINED || defined GUID_DEFINED)
  35 #define GUID_DEFINED
  36 typedef struct _GUID
  37 {
  38     uint32_t Data1;
  39     uint16_t Data2;
  40     uint16_t Data3;
  41     uint8_t  Data4[8];
  42 } GUID, *REFGUID, *LPGUID;
  43 #endif /* GUID_DEFINED */
  44
  45 typedef GUID vlc_guid_t;
  46
  47 #ifdef HAVE_ATTRIBUTE_PACKED
  48 #   define ATTR_PACKED __attribute__((__packed__))
  49 #elif defined(__SUNPRO_C) || defined(_MSC_VER)
  50 #   pragma pack(1)
  51 #   define ATTR_PACKED
  52 #elif defined(__APPLE__)
  53 #   pragma pack(push, 1)
  54 #   define ATTR_PACKED
  55 #else
  56 #   error FIXME
  57 #endif
  58
  59 #ifndef _WAVEFORMATEX_
  60 #define _WAVEFORMATEX_
  61 typedef struct
  62 ATTR_PACKED
  63 _WAVEFORMATEX {
  64     uint16_t   wFormatTag;
  65     uint16_t   nChannels;
  66     uint32_t   nSamplesPerSec;
  67     uint32_t   nAvgBytesPerSec;
  68     uint16_t   nBlockAlign;
  69     uint16_t   wBitsPerSample;
  70     uint16_t   cbSize;
  71 } WAVEFORMATEX, *PWAVEFORMATEX, *NPWAVEFORMATEX, *LPWAVEFORMATEX;
  72 #endif /* _WAVEFORMATEX_ */
  73
  74 #ifndef _WAVEFORMATEXTENSIBLE_
  75 #define _WAVEFORMATEXTENSIBLE_
  76 typedef struct
  77 ATTR_PACKED
  78 _WAVEFORMATEXTENSIBLE {
  79     WAVEFORMATEX Format;
  80     union {
  81         uint16_t wValidBitsPerSample;       /* bits of precision  */
  82         uint16_t wSamplesPerBlock;          /* valid if wBitsPerSample==0 */
  83         uint16_t wReserved;                 /* If neither applies, set to zero. */
  84     } Samples;
  85
  86     uint32_t     dwChannelMask;             /* Channels present */
  87
  88     GUID SubFormat;
  89 } WAVEFORMATEXTENSIBLE, *PWAVEFORMATEXTENSIBLE;
  90 #endif /* _WAVEFORMATEXTENSIBLE_ */
  91
  92 #ifndef _WAVEFORMATEXTENSIBLE_IEC61937_
  93 #define _WAVEFORMATEXTENSIBLE_IEC61937_
  94 typedef struct
  95 ATTR_PACKED
  96 _WAVEFORMATEXTENSIBLE_IEC61937 {
  97     WAVEFORMATEXTENSIBLE    FormatExt;
  98     uint32_t                dwEncodedSamplesPerSec;
  99     uint32_t                dwEncodedChannelCount;
 100     uint32_t                dwAverageBytesPerSec;
 101 } WAVEFORMATEXTENSIBLE_IEC61937, *PWAVEFORMATEXTENSIBLE_IEC61937;
 102 #endif /* _WAVEFORMATEXTENSIBLE_IEC61937_ */
 103
 104 #ifndef _WAVEHEADER_
 105 #define _WAVEHEADER_
 106 typedef struct
 107 ATTR_PACKED
 108 _WAVEHEADER {
 109     uint32_t MainChunkID;
 110     uint32_t Length;
 111     uint32_t ChunkTypeID;
 112     uint32_t SubChunkID;
 113     uint32_t SubChunkLength;
 114     uint16_t Format;
 115     uint16_t Modus;
 116     uint32_t SampleFreq;
 117     uint32_t BytesPerSec;
 118     uint16_t BytesPerSample;
 119     uint16_t BitsPerSample;
 120     uint32_t DataChunkID;
 121     uint32_t DataLength;
 122 } WAVEHEADER;
 123 #endif /* _WAVEHEADER_ */
 124
 125 #ifndef _VLC_BITMAPINFOHEADER_
 126 #define _VLC_BITMAPINFOHEADER_
 127
 128 typedef struct
 129 ATTR_PACKED
 130 {
 131     uint32_t   biSize;
 132     uint32_t   biWidth;
 133     uint32_t   biHeight;
 134     uint16_t   biPlanes;
 135     uint16_t   biBitCount;
 136     uint32_t   biCompression;
 137     uint32_t   biSizeImage;
 138     uint32_t   biXPelsPerMeter;
 139     uint32_t   biYPelsPerMeter;
 140     uint32_t   biClrUsed;
 141     uint32_t   biClrImportant;
 142 } VLC_BITMAPINFOHEADER, *VLC_PBITMAPINFOHEADER, *VLC_LPBITMAPINFOHEADER;
 143
 144 typedef struct
 145 ATTR_PACKED
 146 {
 147     VLC_BITMAPINFOHEADER bmiHeader;
 148     int                  bmiColors[1];
 149 } VLC_BITMAPINFO, *VLC_LPBITMAPINFO;
 150 #endif
 151
 152 #ifndef _RECT32_
 153 #define _RECT32_
 154 typedef struct
 155 ATTR_PACKED
 156 {
 157     int left, top, right, bottom;
 158 } RECT32;
 159 #endif
 160
 161 #ifndef _REFERENCE_TIME_
 162 #define _REFERENCE_TIME_
 163 typedef int64_t REFERENCE_TIME;
 164 #endif
 165
 166 #ifndef _VIDEOINFOHEADER_
 167 #define _VIDEOINFOHEADER_
 168 typedef struct
 169 ATTR_PACKED
 170 {
 171     RECT32                  rcSource;
 172     RECT32                  rcTarget;
 173     uint32_t                dwBitRate;
 174     uint32_t                dwBitErrorRate;
 175     REFERENCE_TIME          AvgTimePerFrame;
 176     VLC_BITMAPINFOHEADER    bmiHeader;
 177 } VIDEOINFOHEADER;
 178 #endif
 179
 180 #if defined(__SUNPRO_C) || defined(_MSC_VER)
 181 #   pragma pack()
 182 #elif defined(__APPLE__) && !HAVE_ATTRIBUTE_PACKED
 183 #   pragma pack(pop)
 184 #endif
 185
 186 /* WAVE format wFormatTag IDs */
 187 /* See http://msdn.microsoft.com/en-us/library/aa904731%28v=vs.80%29.aspx */
 188 #define WAVE_FORMAT_UNKNOWN             0x0000 /* Microsoft Corporation */
 189 #define WAVE_FORMAT_PCM                 0x0001 /* Microsoft Corporation */
 190 #define WAVE_FORMAT_ADPCM               0x0002 /* Microsoft Corporation */
 191 #define WAVE_FORMAT_IEEE_FLOAT          0x0003 /* Microsoft Corporation */
 192 #define WAVE_FORMAT_ALAW                0x0006 /* Microsoft Corporation */
 193 #define WAVE_FORMAT_MULAW               0x0007 /* Microsoft Corporation */
 194 #define WAVE_FORMAT_DTS_MS              0x0008 /* Microsoft Corporation */
 195 #define WAVE_FORMAT_WMAS                0x000a /* WMA 9 Speech */
 196 #define WAVE_FORMAT_IMA_ADPCM           0x0011 /* Intel Corporation */
 197 #define WAVE_FORMAT_YAMAHA_ADPCM        0x0020 /* Yamaha */
 198 #define WAVE_FORMAT_TRUESPEECH          0x0022 /* TrueSpeech */
 199 #define WAVE_FORMAT_GSM610              0x0031 /* Microsoft Corporation */
 200 #define WAVE_FORMAT_MSNAUDIO            0x0032 /* Microsoft Corporation */
 201 #define WAVE_FORMAT_AMR_NB_2            0x0038 /* AMR NB rogue */
 202 #define WAVE_FORMAT_MSG723              0x0042 /* Microsoft G.723 [G723.1] */
 203 #define WAVE_FORMAT_G726                0x0045 /* ITU-T standard  */
 204 #define WAVE_FORMAT_MPEG                0x0050 /* Microsoft Corporation */
 205 #define WAVE_FORMAT_MPEGLAYER3          0x0055 /* ISO/MPEG Layer3 Format Tag */
 206 #define WAVE_FORMAT_AMR_NB              0x0057 /* AMR NB */
 207 #define WAVE_FORMAT_AMR_WB              0x0058 /* AMR Wideband */
 208 #define WAVE_FORMAT_G726_ADPCM          0x0064 /* G.726 ADPCM  */
 209 #define WAVE_FORMAT_VOXWARE_RT29        0x0075 /* VoxWare MetaSound */
 210 #define WAVE_FORMAT_DOLBY_AC3_SPDIF     0x0092 /* Sonic Foundry */
 211 #define WAVE_FORMAT_VIVOG723            0x0111 /* Vivo G.723.1 */
 212
 213 #define WAVE_FORMAT_AAC                 0x00FF /* */
 214 #define WAVE_FORMAT_AAC_MS              0xa106 /* Microsoft AAC */
 215 #define WAVE_FORMAT_SIPRO               0x0130 /* Sipro Lab Telecom Inc. */
 216
 217 #define WAVE_FORMAT_WMA1                0x0160 /* WMA version 1 */
 218 #define WAVE_FORMAT_WMA2                0x0161 /* WMA (v2) 7, 8, 9 Series */
 219 #define WAVE_FORMAT_WMAP                0x0162 /* WMA 9 Professional */
 220 #define WAVE_FORMAT_WMAL                0x0163 /* WMA 9 Lossless */
 221
 222 #define WAVE_FORMAT_CREATIVE_ADPCM      0x0200 /* Creative */
 223
 224 #define WAVE_FORMAT_ULEAD_DV_AUDIO_NTSC 0x0215 /* Ulead */
 225 #define WAVE_FORMAT_ULEAD_DV_AUDIO_PAL  0x0216 /* Ulead */
 226
 227 #define WAVE_FORMAT_ATRAC3              0x0270 /* Atrac3, != from MSDN doc */
 228 #define WAVE_FORMAT_SONY_ATRAC3         0x0272 /* Atrac3, != from MSDN doc */
 229
 230 #define WAVE_FORMAT_IMC                 0x0401
 231 #define WAVE_FORMAT_INDEO_AUDIO         0x0402 /* Indeo Audio Coder */
 232
 233 #define WAVE_FORMAT_ON2_AVC             0x0500 /* VP7 */
 234 #define WAVE_FORMAT_ON2_AVC_2           0x0501 /* VP6 */
 235
 236 #define WAVE_FORMAT_QNAP_ADTS           0x0AAC /* Qnap ADTS */
 237 #define WAVE_FORMAT_AAC_ADTS            0x1600 /* AAC/ADTS */
 238 #define WAVE_FORMAT_AAC_2               0x1601 /* Other AAC */
 239 #define WAVE_FORMAT_AAC_LATM            0x1602 /* AAC/LATM */
 240 #define WAVE_FORMAT_HEAAC               0x1610
 241
 242 #define WAVE_FORMAT_A52                 0x2000 /* a52 */
 243 #define WAVE_FORMAT_DTS                 0x2001 /* DTS */
 244 #define WAVE_FORMAT_AVCODEC_AAC         0x706D
 245 #define WAVE_FORMAT_DIVIO_AAC           0x4143 /* Divio's AAC */
 246
 247 #define WAVE_FORMAT_GSM_AMR_FIXED       0x7A21 /* Fixed bitrate, no SID */
 248 #define WAVE_FORMAT_GSM_AMR             0x7A22 /* Variable bitrate, including SID */
 249
 250 #define WAVE_FORMAT_DK3                 0x0062
 251 #define WAVE_FORMAT_DK4                 0x0061
 252
 253 /* At least libavformat use that ID: from libavformat/riff.c ('Vo' == 0x566f)
 254  * { CODEC_ID_VORBIS, ('V'<<8)+'o' }, //HACK/FIXME, does vorbis in WAV/AVI have an (in)official id?
 255  */
 256 #define WAVE_FORMAT_VORBIS              0x566f
 257
 258 /* It seems that these IDs are used by braindead & obsolete VorbisACM encoder
 259  * (Windows only)
 260  * A few info is available except VorbisACM source (remember, Windows only)
 261  * (available on http://svn.xiph.org), but it seems that vo3+ at least is
 262  * made of Vorbis data encapsulated in Ogg container...
 263  */
 264 #define WAVE_FORMAT_VORB_1              0x674f
 265 #define WAVE_FORMAT_VORB_2              0x6750
 266 #define WAVE_FORMAT_VORB_3              0x6751
 267 #define WAVE_FORMAT_VORB_1PLUS          0x676f
 268 #define WAVE_FORMAT_VORB_2PLUS          0x6770
 269 #define WAVE_FORMAT_VORB_3PLUS          0x6771
 270
 271 #define WAVE_FORMAT_G723_1              0xa100
 272 #define WAVE_FORMAT_AAC_3               0xa106
 273 #define WAVE_FORMAT_SPEEX               0xa109 /* Speex audio */
 274 #define WAVE_FORMAT_FLAC                0xf1ac /* Xiph Flac */
 275
 276 #if !defined(WAVE_FORMAT_EXTENSIBLE)
 277   #define WAVE_FORMAT_EXTENSIBLE          0xFFFE /* Microsoft */
 278 #endif
 279
 280 /* GUID SubFormat IDs */
 281 #define VLC_KSDATAFORMAT_SUBTYPE_ATRAC3P {0xE923AABF, 0xCB58, 0x4471, {0xA1, 0x19, 0xFF, 0xFA, 0x01, 0xE4, 0xCE, 0x62}} /* Undocumented */
 282 #define VLC_KSDATAFORMAT_SUBTYPE_UNKNOWN {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}
 283 #define VLC_WAVEFORMATEX_GUIDBASE        {0x00000000, 0x0000, 0x0010, {0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}} /* Generated from Wave Format */
 284 #define VLC_AMBISONIC_SUBTYPE_PCM        {0x00000001, 0x0721, 0x11D3, {0x86, 0x44, 0xC8, 0xC1, 0xCA, 0x00, 0x00, 0x00}} /* AMBISONIC_B_FORMAT_PCM */
 285 #define VLC_AMBISONIC_SUBTYPE_IEEE_FLOAT {0x00000003, 0x0721, 0x11D3, {0x86, 0x44, 0xC8, 0xC1, 0xCA, 0x00, 0x00, 0x00}} /* AMBISONIC_B_FORMAT_IEEE_FLOAT */
 286
 287 /* Microsoft speaker definitions */
 288 #define WAVE_SPEAKER_FRONT_LEFT             0x1
 289 #define WAVE_SPEAKER_FRONT_RIGHT            0x2
 290 #define WAVE_SPEAKER_FRONT_CENTER           0x4
 291 #define WAVE_SPEAKER_LOW_FREQUENCY          0x8
 292 #define WAVE_SPEAKER_BACK_LEFT              0x10
 293 #define WAVE_SPEAKER_BACK_RIGHT             0x20
 294 #define WAVE_SPEAKER_FRONT_LEFT_OF_CENTER   0x40
 295 #define WAVE_SPEAKER_FRONT_RIGHT_OF_CENTER  0x80
 296 #define WAVE_SPEAKER_BACK_CENTER            0x100
 297 #define WAVE_SPEAKER_SIDE_LEFT              0x200
 298 #define WAVE_SPEAKER_SIDE_RIGHT             0x400
 299 #define WAVE_SPEAKER_TOP_CENTER             0x800
 300 #define WAVE_SPEAKER_TOP_FRONT_LEFT         0x1000
 301 #define WAVE_SPEAKER_TOP_FRONT_CENTER       0x2000
 302 #define WAVE_SPEAKER_TOP_FRONT_RIGHT        0x4000
 303 #define WAVE_SPEAKER_TOP_BACK_LEFT          0x8000
 304 #define WAVE_SPEAKER_TOP_BACK_CENTER        0x10000
 305 #define WAVE_SPEAKER_TOP_BACK_RIGHT         0x20000
 306 #define WAVE_SPEAKER_RESERVED               0x80000000
 307
 308 static const struct
 309 {
 310     uint16_t     i_tag;
 311     vlc_fourcc_t i_fourcc;
 312     const char  *psz_name;
 313 }
 314 wave_format_tag_to_fourcc[] =
 315 {
 316     { WAVE_FORMAT_PCM,              VLC_FOURCC( 'a', 'r', 'a', 'w' ), "Raw audio" },
 317     { WAVE_FORMAT_PCM,              VLC_CODEC_S8,                     "PCM S8 audio" },
 318     { WAVE_FORMAT_PCM,              VLC_CODEC_S16L,                   "PCM S16L audio" },
 319     { WAVE_FORMAT_PCM,              VLC_CODEC_S24L,                   "PCM S24L audio" },
 320     { WAVE_FORMAT_PCM,              VLC_CODEC_S32L,                   "PCM S32L audio" },
 321     { WAVE_FORMAT_ADPCM,            VLC_CODEC_ADPCM_MS,               "ADPCM" },
 322     { WAVE_FORMAT_IEEE_FLOAT,       VLC_FOURCC( 'a', 'f', 'l', 't' ), "IEEE Float audio" },
 323     { WAVE_FORMAT_IEEE_FLOAT,       VLC_CODEC_F32L,                   "PCM 32 (Float) audio" },
 324     { WAVE_FORMAT_IEEE_FLOAT,       VLC_CODEC_F64L,                   "PCM 64 (Float) audio" },
 325     { WAVE_FORMAT_ALAW,             VLC_CODEC_ALAW,                   "A-Law" },
 326     { WAVE_FORMAT_MULAW,            VLC_CODEC_MULAW,                  "Mu-Law" },
 327     { WAVE_FORMAT_IMA_ADPCM,        VLC_CODEC_ADPCM_IMA_WAV,          "Ima-ADPCM" },
 328     { WAVE_FORMAT_CREATIVE_ADPCM,   VLC_CODEC_ADPCM_CREATIVE,         "Creative ADPCM" },
 329     { WAVE_FORMAT_YAMAHA_ADPCM,     VLC_CODEC_ADPCM_YAMAHA,           "Yamaha ADPCM" },
 330     { WAVE_FORMAT_TRUESPEECH,       VLC_CODEC_TRUESPEECH,             "Truespeech" },
 331     { WAVE_FORMAT_GSM610,           VLC_CODEC_GSM_MS,                 "Microsoft WAV GSM" },
 332     { WAVE_FORMAT_MSNAUDIO,         VLC_CODEC_GSM_MS,                 "Microsoft MSN Audio" },
 333     { WAVE_FORMAT_G726,             VLC_CODEC_ADPCM_G726,             "G.726 ADPCM" },
 334     { WAVE_FORMAT_G726_ADPCM,       VLC_CODEC_ADPCM_G726,             "G.726 ADPCM" },
 335     { WAVE_FORMAT_G723_1,           VLC_CODEC_G723_1,                 "G.723.1" },
 336     { WAVE_FORMAT_MSG723,           VLC_CODEC_G723_1,                 "Microsoft G.723 [G723.1]" },
 337     { WAVE_FORMAT_VIVOG723,         VLC_CODEC_G723_1,                 "Vivo G.723.1" },
 338     { WAVE_FORMAT_MPEGLAYER3,       VLC_CODEC_MP3,                    "Mpeg Audio Layer 3" },
 339     { WAVE_FORMAT_MPEG,             VLC_CODEC_MPGA,                   "Mpeg Audio" },
 340     { WAVE_FORMAT_AMR_NB,           VLC_CODEC_AMR_NB,                 "AMR NB" },
 341     { WAVE_FORMAT_AMR_NB_2,         VLC_CODEC_AMR_NB,                 "AMR NB" },
 342     { WAVE_FORMAT_AMR_WB,           VLC_CODEC_AMR_WB,                 "AMR Wideband" },
 343     { WAVE_FORMAT_SIPRO,            VLC_CODEC_SIPR,                   "Sipr Audio" },
 344     { WAVE_FORMAT_A52,              VLC_CODEC_A52,                    "A/52" },
 345     { WAVE_FORMAT_WMA1,             VLC_CODEC_WMA1,                   "Window Media Audio v1" },
 346     { WAVE_FORMAT_WMA2,             VLC_CODEC_WMA2,                   "Window Media Audio v2" },
 347     { WAVE_FORMAT_WMAP,             VLC_CODEC_WMAP,                   "Window Media Audio 9 Professional" },
 348     { WAVE_FORMAT_WMAL,             VLC_CODEC_WMAL,                   "Window Media Audio 9 Lossless" },
 349     { WAVE_FORMAT_WMAS,             VLC_CODEC_WMAS,                   "Window Media Audio 9 Speech" },
 350     { WAVE_FORMAT_ATRAC3,           VLC_CODEC_ATRAC3,                 "Sony Atrac3" },
 351     { WAVE_FORMAT_SONY_ATRAC3,      VLC_CODEC_ATRAC3,                 "Sony Atrac3" },
 352     { WAVE_FORMAT_DK3,              VLC_CODEC_ADPCM_DK3,              "Duck DK3" },
 353     { WAVE_FORMAT_DK4,              VLC_CODEC_ADPCM_DK4,              "Duck DK4" },
 354     { WAVE_FORMAT_DTS,              VLC_CODEC_DTS,                    "DTS Coherent Acoustics" },
 355     { WAVE_FORMAT_DTS_MS,           VLC_CODEC_DTS,                    "DTS Coherent Acoustics" },
 356     { WAVE_FORMAT_DIVIO_AAC,        VLC_CODEC_MP4A,                   "MPEG-4 Audio (Divio)" },
 357     { WAVE_FORMAT_AAC,              VLC_CODEC_MP4A,                   "MPEG-4 Audio" },
 358     { WAVE_FORMAT_QNAP_ADTS,        VLC_CODEC_MP4A,                   "MPEG-4 ADTS Audio" },
 359     { WAVE_FORMAT_AAC_ADTS,         VLC_CODEC_MP4A,                   "MPEG-4 ADTS Audio" },
 360     { WAVE_FORMAT_AAC_2,            VLC_CODEC_MP4A,                   "MPEG-4 Audio" },
 361     { WAVE_FORMAT_AAC_3,            VLC_CODEC_MP4A,                   "MPEG-4 Audio" },
 362     { WAVE_FORMAT_AAC_LATM,         VLC_CODEC_MP4A,                   "MPEG-4 LATM Audio" },
 363     { WAVE_FORMAT_HEAAC,            VLC_CODEC_MP4A,                   "MPEG-4 Audio" },
 364     { WAVE_FORMAT_AVCODEC_AAC,      VLC_CODEC_MP4A,                   "MPEG-4 Audio" },
 365     { WAVE_FORMAT_AAC_MS,           VLC_CODEC_MP4A,                   "MPEG-4 Audio" },
 366     { WAVE_FORMAT_VORBIS,           VLC_CODEC_VORBIS,                 "Vorbis Audio" },
 367     { WAVE_FORMAT_VORB_1,           VLC_FOURCC( 'v', 'o', 'r', '1' ), "Vorbis 1 Audio" },
 368     { WAVE_FORMAT_VORB_1PLUS,       VLC_FOURCC( 'v', 'o', '1', '+' ), "Vorbis 1+ Audio" },
 369     { WAVE_FORMAT_VORB_2,           VLC_FOURCC( 'v', 'o', 'r', '2' ), "Vorbis 2 Audio" },
 370     { WAVE_FORMAT_VORB_2PLUS,       VLC_FOURCC( 'v', 'o', '2', '+' ), "Vorbis 2+ Audio" },
 371     { WAVE_FORMAT_VORB_3,           VLC_FOURCC( 'v', 'o', 'r', '3' ), "Vorbis 3 Audio" },
 372     { WAVE_FORMAT_VORB_3PLUS,       VLC_FOURCC( 'v', 'o', '3', '+' ), "Vorbis 3+ Audio" },
 373     { WAVE_FORMAT_SPEEX,            VLC_CODEC_SPEEX,                  "Speex Audio" },
 374     { WAVE_FORMAT_FLAC,             VLC_CODEC_FLAC,                   "FLAC Audio" },
 375     { WAVE_FORMAT_GSM_AMR_FIXED,    VLC_CODEC_AMR_NB,                 "GSM-AMR Audio CBR, no SID" },
 376     { WAVE_FORMAT_GSM_AMR,          VLC_CODEC_AMR_NB,                 "GSM-AMR Audio VBR, SID" },
 377     { WAVE_FORMAT_ULEAD_DV_AUDIO_NTSC, VLC_CODEC_ULEAD_DV_AUDIO_NTSC, "Ulead DV audio NTSC" },
 378     { WAVE_FORMAT_ULEAD_DV_AUDIO_PAL, VLC_CODEC_ULEAD_DV_AUDIO_PAL,   "Ulead DV audio PAL" },
 379     { WAVE_FORMAT_IMC,              VLC_CODEC_IMC,                    "IMC" },
 380     { WAVE_FORMAT_INDEO_AUDIO,      VLC_CODEC_INDEO_AUDIO,            "Indeo Audio Coder" },
 381     { WAVE_FORMAT_VOXWARE_RT29,     VLC_CODEC_METASOUND,              "VoxWare MetaSound" },
 382     { WAVE_FORMAT_ON2_AVC,          VLC_CODEC_ON2AVC,                 "On2 Audio for Video Codec (VP7)" },
 383     { WAVE_FORMAT_ON2_AVC_2,        VLC_CODEC_ON2AVC,                 "On2 Audio for Video Codec (VP6)" },
 384
 385     { WAVE_FORMAT_UNKNOWN,          VLC_CODEC_UNKNOWN,                "Unknown" }
 386 };
 387
 388 static inline void wf_tag_to_fourcc( uint16_t i_tag, vlc_fourcc_t *fcc,
 389                                      const char **ppsz_name )
 390 {
 391     int i;
 392     for( i = 0; wave_format_tag_to_fourcc[i].i_tag != 0; i++ )
 393     {
 394         if( wave_format_tag_to_fourcc[i].i_tag == i_tag ) break;
 395     }
 396     if( fcc ) *fcc = wave_format_tag_to_fourcc[i].i_fourcc;
 397     if( ppsz_name ) *ppsz_name = wave_format_tag_to_fourcc[i].psz_name;
 398 }
 399
 400 static inline void fourcc_to_wf_tag( vlc_fourcc_t fcc, uint16_t *pi_tag )
 401 {
 402     int i;
 403     for( i = 0; wave_format_tag_to_fourcc[i].i_tag != 0; i++ )
 404     {
 405         if( wave_format_tag_to_fourcc[i].i_fourcc == fcc ) break;
 406     }
 407     if( pi_tag ) *pi_tag = wave_format_tag_to_fourcc[i].i_tag;
 408 }
 409
 410 /* If wFormatTag is WAVEFORMATEXTENSIBLE, we must look at the SubFormat tag
 411  * to determine the actual format.  Microsoft has stopped giving out wFormatTag
 412  * assignments in lieu of letting 3rd parties generate their own GUIDs
 413  */
 414 static const struct
 415 {
 416     const GUID   guid_tag;
 417     const vlc_fourcc_t i_fourcc;
 418     const char  *psz_name;
 419 }
 420 sub_format_tag_to_fourcc[] =
 421 {
 422     { VLC_AMBISONIC_SUBTYPE_PCM,        VLC_FOURCC( 'a', 'r', 'a', 'w' ), "Ambisonic B format (PCM)" },
 423     { VLC_AMBISONIC_SUBTYPE_IEEE_FLOAT, VLC_FOURCC( 'a', 'f', 'l', 't' ), "Ambisonic B format (IEEE float)" },
 424     { VLC_KSDATAFORMAT_SUBTYPE_ATRAC3P, VLC_CODEC_ATRAC3P,                "Sony Atrac3+" },
 425     { VLC_KSDATAFORMAT_SUBTYPE_UNKNOWN, VLC_CODEC_UNKNOWN,      "Unknown" }
 426 };
 427
 428 static inline int guidcmpbase( const GUID *s1, const GUID *s2 )
 429 {
 430     return( s1->Data2 == s2->Data2 &&
 431             s1->Data3 == s2->Data3 && !memcmp( s1->Data4, s2->Data4, 8 ) );
 432 }
 433
 434 /* compares two GUIDs, returns 1 if identical, 0 otherwise */
 435 static inline int guidcmp( const GUID *s1, const GUID *s2 )
 436 {
 437     return( s1->Data1 == s2->Data1 && guidcmpbase( s1, s2 ) );
 438 }
 439
 440 #define GUID_FMT "0x%8.8x-0x%4.4x-0x%4.4x-0x%2.2x%2.2x%2.2x%2.2x%2.2x%2.2x%2.2x%2.2x"
 441 #define GUID_PRINT( guid )  \
 442     (unsigned)(guid).Data1,              \
 443     (guid).Data2,              \
 444     (guid).Data3,              \
 445     (guid).Data4[0],(guid).Data4[1],(guid).Data4[2],(guid).Data4[3],    \
 446     (guid).Data4[4],(guid).Data4[5],(guid).Data4[6],(guid).Data4[7]
 447
 448
 449 static inline void sf_tag_to_fourcc( const GUID *guid_tag,
 450                                      vlc_fourcc_t *fcc, const char **ppsz_name )
 451 {
 452     int i;
 453     bool b_found = false;
 454
 455     const GUID unknown = VLC_KSDATAFORMAT_SUBTYPE_UNKNOWN;
 456     const GUID waveformatex = VLC_WAVEFORMATEX_GUIDBASE;
 457
 458     for( i = 0; !guidcmp( &sub_format_tag_to_fourcc[i].guid_tag,
 459                           &unknown ); i++ )
 460     {
 461         if( guidcmp( &sub_format_tag_to_fourcc[i].guid_tag, guid_tag ) )
 462         {
 463             b_found = true;
 464             break;
 465         }
 466     }
 467
 468     if( !b_found && guidcmpbase(guid_tag, &waveformatex) )
 469     {
 470         wf_tag_to_fourcc(guid_tag->Data1, fcc, ppsz_name);
 471     }
 472     else
 473     {
 474         if( fcc ) *fcc = sub_format_tag_to_fourcc[i].i_fourcc;
 475         if( ppsz_name ) *ppsz_name = sub_format_tag_to_fourcc[i].psz_name;
 476     }
 477 }
 478
 479 #endif /* "codecs.h" */