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