1 /*****************************************************************************
2 * codecs.h: codec related structures needed by the demuxers and decoders
3 *****************************************************************************
4 * Copyright (C) 1999-2001 the VideoLAN team
7 * Author: Gildas Bazin <gbazin@videolan.org>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
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 General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
24 #if !defined( __LIBVLC__ )
25 #error You are not libvlc or one of its plugins. You cannot include this file
29 #define _VLC_CODECS_H 1
31 /* Structures exported to the demuxers and decoders */
33 #if !(defined _GUID_DEFINED || defined GUID_DEFINED)
41 } GUID
, *REFGUID
, *LPGUID
;
42 #endif /* GUID_DEFINED */
44 #ifndef _WAVEFORMATEX_
45 #define _WAVEFORMATEX_
51 uint32_t nSamplesPerSec
;
52 uint32_t nAvgBytesPerSec
;
54 uint16_t wBitsPerSample
;
56 } WAVEFORMATEX
, *PWAVEFORMATEX
, *NPWAVEFORMATEX
, *LPWAVEFORMATEX
;
57 #endif /* _WAVEFORMATEX_ */
59 #ifndef _WAVEFORMATEXTENSIBLE_
60 #define _WAVEFORMATEXTENSIBLE_
63 _WAVEFORMATEXTENSIBLE
{
66 uint16_t wValidBitsPerSample
;
67 uint16_t wSamplesPerBlock
;
70 uint32_t dwChannelMask
;
72 } WAVEFORMATEXTENSIBLE
, *PWAVEFORMATEXTENSIBLE
;
73 #endif /* _WAVEFORMATEXTENSIBLE_ */
84 uint32_t SubChunkLength
;
89 uint16_t BytesPerSample
;
90 uint16_t BitsPerSample
;
94 #endif /* _WAVEHEADER_ */
96 #if !defined(_BITMAPINFOHEADER_) && !defined(WIN32)
97 #define _BITMAPINFOHEADER_
106 uint32_t biCompression
;
107 uint32_t biSizeImage
;
108 uint32_t biXPelsPerMeter
;
109 uint32_t biYPelsPerMeter
;
111 uint32_t biClrImportant
;
112 } BITMAPINFOHEADER
, *PBITMAPINFOHEADER
, *LPBITMAPINFOHEADER
;
117 BITMAPINFOHEADER bmiHeader
;
119 } BITMAPINFO
, *LPBITMAPINFO
;
127 int left
, top
, right
, bottom
;
131 #ifndef _REFERENCE_TIME_
132 #define _REFERENCE_TIME_
133 typedef int64_t REFERENCE_TIME
;
136 #ifndef _VIDEOINFOHEADER_
137 #define _VIDEOINFOHEADER_
144 uint32_t dwBitErrorRate
;
145 REFERENCE_TIME AvgTimePerFrame
;
146 BITMAPINFOHEADER bmiHeader
;
162 #ifndef _TRUECOLORINFO_
163 #define _TRUECOLORINFO_
167 uint32_t dwBitMasks
[3];
168 RGBQUAD1 bmiColors
[256];
180 uint32_t dwBitErrorRate
;
181 REFERENCE_TIME AvgTimePerFrame
;
182 BITMAPINFOHEADER bmiHeader
;
186 RGBQUAD1 bmiColors
[256]; /* Colour palette */
187 uint32_t dwBitMasks
[3]; /* True colour masks */
188 TRUECOLORINFO TrueColorInfo
; /* Both of the above */
194 /* WAVE format wFormatTag IDs */
195 #define WAVE_FORMAT_UNKNOWN 0x0000 /* Microsoft Corporation */
196 #define WAVE_FORMAT_PCM 0x0001 /* Microsoft Corporation */
197 #define WAVE_FORMAT_ADPCM 0x0002 /* Microsoft Corporation */
198 #define WAVE_FORMAT_IEEE_FLOAT 0x0003 /* Microsoft Corporation */
199 #define WAVE_FORMAT_ALAW 0x0006 /* Microsoft Corporation */
200 #define WAVE_FORMAT_MULAW 0x0007 /* Microsoft Corporation */
201 #define WAVE_FORMAT_DTS_MS 0x0008 /* Microsoft Corporation */
202 #define WAVE_FORMAT_WMAS 0x000a /* WMA 9 Speech */
203 #define WAVE_FORMAT_IMA_ADPCM 0x0011 /* Intel Corporation */
204 #define WAVE_FORMAT_GSM610 0x0031 /* Microsoft Corporation */
205 #define WAVE_FORMAT_MSNAUDIO 0x0032 /* Microsoft Corporation */
206 #define WAVE_FORMAT_G726 0x0045 /* ITU-T standard */
207 #define WAVE_FORMAT_MPEG 0x0050 /* Microsoft Corporation */
208 #define WAVE_FORMAT_MPEGLAYER3 0x0055 /* ISO/MPEG Layer3 Format Tag */
209 #define WAVE_FORMAT_DOLBY_AC3_SPDIF 0x0092 /* Sonic Foundry */
211 #define WAVE_FORMAT_A52 0x2000
212 #define WAVE_FORMAT_DTS 0x2001
213 #define WAVE_FORMAT_WMA1 0x0160 /* WMA version 1 */
214 #define WAVE_FORMAT_WMA2 0x0161 /* WMA (v2) 7, 8, 9 Series */
215 #define WAVE_FORMAT_WMAP 0x0162 /* WMA 9 Professional */
216 #define WAVE_FORMAT_WMAL 0x0163 /* WMA 9 Lossless */
217 #define WAVE_FORMAT_DIVIO_AAC 0x4143
218 #define WAVE_FORMAT_AAC 0x00FF
219 #define WAVE_FORMAT_FFMPEG_AAC 0x706D
221 /* Need to check these */
222 #define WAVE_FORMAT_DK3 0x0061
223 #define WAVE_FORMAT_DK4 0x0062
225 /* At least FFmpeg use that ID: from libavformat/riff.c ('Vo' == 0x566f)
226 * { CODEC_ID_VORBIS, ('V'<<8)+'o' }, //HACK/FIXME, does vorbis in WAV/AVI have an (in)official id?
228 #define WAVE_FORMAT_VORBIS 0x566f
230 /* It seems that these IDs are used by braindead & obsolete VorbisACM encoder
232 * A few info is available except VorbisACM source (remember, Windows only)
233 * (available on http://svn.xiph.org), but it seems that vo3+ at least is
234 * made of Vorbis data encapsulated in Ogg container...
236 #define WAVE_FORMAT_VORB_1 0x674f
237 #define WAVE_FORMAT_VORB_2 0x6750
238 #define WAVE_FORMAT_VORB_3 0x6751
239 #define WAVE_FORMAT_VORB_1PLUS 0x676f
240 #define WAVE_FORMAT_VORB_2PLUS 0x6770
241 #define WAVE_FORMAT_VORB_3PLUS 0x6771
243 #define WAVE_FORMAT_SPEEX 0xa109 /* Speex audio */
246 #if !defined(WAVE_FORMAT_EXTENSIBLE)
247 #define WAVE_FORMAT_EXTENSIBLE 0xFFFE /* Microsoft */
250 /* GUID SubFormat IDs */
251 /* We need both b/c const variables are not compile-time constants in C, giving
252 * us an error if we use the const GUID in an enum */
254 #ifndef _KSDATAFORMAT_SUBTYPE_PCM_
255 #define _KSDATAFORMAT_SUBTYPE_PCM_ {0x00000001, 0x0000, 0x0010, {0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}}
256 static const GUID VLC_KSDATAFORMAT_SUBTYPE_PCM
= {0xE923AABF, 0xCB58, 0x4471, {0xA1, 0x19, 0xFF, 0xFA, 0x01, 0xE4, 0xCE, 0x62}};
257 #define KSDATAFORMAT_SUBTYPE_PCM VLC_KSDATAFORMAT_SUBTYPE_PCM
260 #ifndef _KSDATAFORMAT_SUBTYPE_UNKNOWN_
261 #define _KSDATAFORMAT_SUBTYPE_UNKNOWN_ {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}
262 static const GUID VLC_KSDATAFORMAT_SUBTYPE_UNKNOWN
= {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}};
263 #define KSDATAFORMAT_SUBTYPE_UNKNOWN VLC_KSDATAFORMAT_SUBTYPE_UNKNOWN
266 /* Microsoft speaker definitions */
267 #define WAVE_SPEAKER_FRONT_LEFT 0x1
268 #define WAVE_SPEAKER_FRONT_RIGHT 0x2
269 #define WAVE_SPEAKER_FRONT_CENTER 0x4
270 #define WAVE_SPEAKER_LOW_FREQUENCY 0x8
271 #define WAVE_SPEAKER_BACK_LEFT 0x10
272 #define WAVE_SPEAKER_BACK_RIGHT 0x20
273 #define WAVE_SPEAKER_FRONT_LEFT_OF_CENTER 0x40
274 #define WAVE_SPEAKER_FRONT_RIGHT_OF_CENTER 0x80
275 #define WAVE_SPEAKER_BACK_CENTER 0x100
276 #define WAVE_SPEAKER_SIDE_LEFT 0x200
277 #define WAVE_SPEAKER_SIDE_RIGHT 0x400
278 #define WAVE_SPEAKER_TOP_CENTER 0x800
279 #define WAVE_SPEAKER_TOP_FRONT_LEFT 0x1000
280 #define WAVE_SPEAKER_TOP_FRONT_CENTER 0x2000
281 #define WAVE_SPEAKER_TOP_FRONT_RIGHT 0x4000
282 #define WAVE_SPEAKER_TOP_BACK_LEFT 0x8000
283 #define WAVE_SPEAKER_TOP_BACK_CENTER 0x10000
284 #define WAVE_SPEAKER_TOP_BACK_RIGHT 0x20000
285 #define WAVE_SPEAKER_RESERVED 0x80000000
290 vlc_fourcc_t i_fourcc
;
291 const char *psz_name
;
293 wave_format_tag_to_fourcc
[] =
295 { WAVE_FORMAT_PCM
, VLC_FOURCC( 'a', 'r', 'a', 'w' ), "Raw audio" },
296 { WAVE_FORMAT_ADPCM
, VLC_FOURCC( 'm', 's', 0x00,0x02), "ADPCM" },
297 { WAVE_FORMAT_IEEE_FLOAT
, VLC_FOURCC( 'a', 'f', 'l', 't' ), "IEEE Float audio" },
298 { WAVE_FORMAT_ALAW
, VLC_FOURCC( 'a', 'l', 'a', 'w' ), "A-Law" },
299 { WAVE_FORMAT_MULAW
, VLC_FOURCC( 'm', 'l', 'a', 'w' ), "Mu-Law" },
300 { WAVE_FORMAT_IMA_ADPCM
, VLC_FOURCC( 'm', 's', 0x00,0x11), "Ima-ADPCM" },
301 { WAVE_FORMAT_G726
, VLC_FOURCC( 'g', '7', '2', '6' ), "G.726 ADPCM" },
302 { WAVE_FORMAT_MPEGLAYER3
, VLC_FOURCC( 'm', 'p', 'g', 'a' ), "Mpeg Audio" },
303 { WAVE_FORMAT_MPEG
, VLC_FOURCC( 'm', 'p', 'g', 'a' ), "Mpeg Audio" },
304 { WAVE_FORMAT_A52
, VLC_FOURCC( 'a', '5', '2', ' ' ), "A/52" },
305 { WAVE_FORMAT_WMA1
, VLC_FOURCC( 'w', 'm', 'a', '1' ), "Window Media Audio v1" },
306 { WAVE_FORMAT_WMA2
, VLC_FOURCC( 'w', 'm', 'a', '2' ), "Window Media Audio v2" },
307 { WAVE_FORMAT_WMA2
, VLC_FOURCC( 'w', 'm', 'a', ' ' ), "Window Media Audio v2" },
308 { WAVE_FORMAT_WMAP
, VLC_FOURCC( 'w', 'm', 'a', 'p' ), "Window Media Audio 9 Professional" },
309 { WAVE_FORMAT_WMAL
, VLC_FOURCC( 'w', 'm', 'a', 'l' ), "Window Media Audio 9 Lossless" },
310 { WAVE_FORMAT_WMAS
, VLC_FOURCC( 'w', 'm', 'a', 's' ), "Window Media Audio 9 Speech" },
311 { WAVE_FORMAT_DK3
, VLC_FOURCC( 'm', 's', 0x00,0x61), "Duck DK3" },
312 { WAVE_FORMAT_DK4
, VLC_FOURCC( 'm', 's', 0x00,0x62), "Duck DK4" },
313 { WAVE_FORMAT_DTS
, VLC_FOURCC( 'd', 't', 's', ' ' ), "DTS Coherent Acoustics" },
314 { WAVE_FORMAT_DTS_MS
, VLC_FOURCC( 'd', 't', 's', ' ' ), "DTS Coherent Acoustics" },
315 { WAVE_FORMAT_DIVIO_AAC
, VLC_FOURCC( 'm', 'p', '4', 'a' ), "MPEG-4 Audio (Divio)" },
316 { WAVE_FORMAT_AAC
, VLC_FOURCC( 'm', 'p', '4', 'a' ), "MPEG-4 Audio" },
317 { WAVE_FORMAT_FFMPEG_AAC
, VLC_FOURCC( 'm', 'p', '4', 'a' ), "MPEG-4 Audio" },
318 { WAVE_FORMAT_VORBIS
, VLC_FOURCC( 'v', 'o', 'r', 'b' ), "Vorbis Audio" },
319 { WAVE_FORMAT_VORB_1
, VLC_FOURCC( 'v', 'o', 'r', '1' ), "Vorbis 1 Audio" },
320 { WAVE_FORMAT_VORB_1PLUS
, VLC_FOURCC( 'v', 'o', '1', '+' ), "Vorbis 1+ Audio" },
321 { WAVE_FORMAT_VORB_2
, VLC_FOURCC( 'v', 'o', 'r', '2' ), "Vorbis 2 Audio" },
322 { WAVE_FORMAT_VORB_2PLUS
, VLC_FOURCC( 'v', 'o', '2', '+' ), "Vorbis 2+ Audio" },
323 { WAVE_FORMAT_VORB_3
, VLC_FOURCC( 'v', 'o', 'r', '3' ), "Vorbis 3 Audio" },
324 { WAVE_FORMAT_VORB_3PLUS
, VLC_FOURCC( 'v', 'o', '3', '+' ), "Vorbis 3+ Audio" },
325 { WAVE_FORMAT_SPEEX
, VLC_FOURCC( 's', 'p', 'x', ' ' ), "Speex Audio" },
326 { WAVE_FORMAT_UNKNOWN
, VLC_FOURCC( 'u', 'n', 'd', 'f' ), "Unknown" }
329 static inline void wf_tag_to_fourcc( uint16_t i_tag
, vlc_fourcc_t
*fcc
,
330 const char **ppsz_name
)
333 for( i
= 0; wave_format_tag_to_fourcc
[i
].i_tag
!= 0; i
++ )
335 if( wave_format_tag_to_fourcc
[i
].i_tag
== i_tag
) break;
337 if( fcc
) *fcc
= wave_format_tag_to_fourcc
[i
].i_fourcc
;
338 if( ppsz_name
) *ppsz_name
= wave_format_tag_to_fourcc
[i
].psz_name
;
341 static inline void fourcc_to_wf_tag( vlc_fourcc_t fcc
, uint16_t *pi_tag
)
344 for( i
= 0; wave_format_tag_to_fourcc
[i
].i_tag
!= 0; i
++ )
346 if( wave_format_tag_to_fourcc
[i
].i_fourcc
== fcc
) break;
348 if( pi_tag
) *pi_tag
= wave_format_tag_to_fourcc
[i
].i_tag
;
351 /* If wFormatTag is WAVEFORMATEXTENSIBLE, we must look at the SubFormat tag
352 * to determine the actual format. Microsoft has stopped giving out wFormatTag
353 * assignments in lieu of letting 3rd parties generate their own GUIDs
358 vlc_fourcc_t i_fourcc
;
359 const char *psz_name
;
361 sub_format_tag_to_fourcc
[] =
363 { _KSDATAFORMAT_SUBTYPE_PCM_
, VLC_FOURCC( 'p', 'c', 'm', ' ' ), "PCM" },
364 { _KSDATAFORMAT_SUBTYPE_UNKNOWN_
, VLC_FOURCC( 'u', 'n', 'd', 'f' ), "Unknown" }
367 /* compares two GUIDs, returns 1 if identical, 0 otherwise */
368 static inline int guidcmp( const GUID
*s1
, const GUID
*s2
)
370 return( s1
->Data1
== s2
->Data1
&& s1
->Data2
== s2
->Data2
&&
371 s1
->Data3
== s2
->Data3
&& !memcmp( s1
->Data4
, s2
->Data4
, 8 ) );
374 static inline void sf_tag_to_fourcc( GUID
*guid_tag
,
375 vlc_fourcc_t
*fcc
, const char **ppsz_name
)
379 for( i
= 0; !guidcmp( &sub_format_tag_to_fourcc
[i
].guid_tag
,
380 &KSDATAFORMAT_SUBTYPE_UNKNOWN
); i
++ )
382 if( guidcmp( &sub_format_tag_to_fourcc
[i
].guid_tag
, guid_tag
) ) break;
384 if( fcc
) *fcc
= sub_format_tag_to_fourcc
[i
].i_fourcc
;
385 if( ppsz_name
) *ppsz_name
= sub_format_tag_to_fourcc
[i
].psz_name
;
389 * Structure to hold information concerning subtitles.
390 * Used between demuxers and decoders of subtitles.
392 typedef struct es_sys_t
394 char *psz_header
; /* for 'ssa ' and 'subt' */
397 unsigned int i_orig_height
;
398 unsigned int i_orig_width
;
399 unsigned int i_origin_x
;
400 unsigned int i_origin_y
;
401 unsigned int i_scale_h
;
402 unsigned int i_scale_v
;
403 unsigned int i_alpha
;
407 unsigned int i_align
;
408 mtime_t i_time_offset
;
410 unsigned int palette
[16];
411 unsigned int colors
[4];
415 #endif /* "codecs.h" */