Statistics
| Branch: | Revision:

ffmpeg / libavcodec / avcodec.h @ 650cec0c

History | View | Annotate | Download (67.5 KB)

1 a96b68b7 Fabrice Bellard
#ifndef AVCODEC_H
2
#define AVCODEC_H
3
4 36df8805 Michael Niedermayer
/**
5
 * @file avcodec.h
6 d33c949c Michael Niedermayer
 * external api header.
7 36df8805 Michael Niedermayer
 */
8
9
10 02d697aa Zdenek Kabelac
#ifdef __cplusplus
11
extern "C" {
12
#endif
13
14 de6d9b64 Fabrice Bellard
#include "common.h"
15 5ff85f1d Michael Niedermayer
#include "rational.h"
16 4b813d5c Zdenek Kabelac
#include <sys/types.h> /* size_t */
17 de6d9b64 Fabrice Bellard
18 c79b8011 Michael Niedermayer
#define FFMPEG_VERSION_INT     0x000409
19
#define FFMPEG_VERSION         "0.4.9-pre1"
20 0fd6aea1 Michael Niedermayer
#define LIBAVCODEC_BUILD       4736
21 4b1f4f23 Juanjo
22 7b7d86f1 Fabrice Bellard
#define LIBAVCODEC_VERSION_INT FFMPEG_VERSION_INT
23
#define LIBAVCODEC_VERSION     FFMPEG_VERSION
24
25
#define AV_STRINGIFY(s)        AV_TOSTRING(s)
26
#define AV_TOSTRING(s) #s
27
#define LIBAVCODEC_IDENT        "FFmpeg" LIBAVCODEC_VERSION "b" AV_STRINGIFY(LIBAVCODEC_BUILD)
28 ce2749d2 Alex Beregszaszi
29 2a24fe4c Gael Chardon
#define AV_NOPTS_VALUE int64_t_C(0x8000000000000000)
30 9740beff Michael Niedermayer
#define AV_TIME_BASE 1000000
31
32 de6d9b64 Fabrice Bellard
enum CodecID {
33
    CODEC_ID_NONE, 
34
    CODEC_ID_MPEG1VIDEO,
35 dcedf586 Fabrice Bellard
    CODEC_ID_MPEG2VIDEO, /* prefered ID for MPEG Video 1 or 2 decoding */
36 fb364ada Ivan Kalvachev
    CODEC_ID_MPEG2VIDEO_XVMC,
37 c6148de2 Michael Niedermayer
    CODEC_ID_H261,
38 de6d9b64 Fabrice Bellard
    CODEC_ID_H263,
39
    CODEC_ID_RV10,
40 68b94c35 Michael Niedermayer
    CODEC_ID_RV20,
41 de6d9b64 Fabrice Bellard
    CODEC_ID_MJPEG,
42 b135d9fb Alex Beregszaszi
    CODEC_ID_MJPEGB,
43 b1e6b355 Michael Niedermayer
    CODEC_ID_LJPEG,
44 5e83dec4 Alex Beregszaszi
    CODEC_ID_SP5X,
45 bf89e6b1 Fabrice Bellard
    CODEC_ID_MPEG4,
46 de6d9b64 Fabrice Bellard
    CODEC_ID_RAWVIDEO,
47 84afee34 Michael Niedermayer
    CODEC_ID_MSMPEG4V1,
48
    CODEC_ID_MSMPEG4V2,
49
    CODEC_ID_MSMPEG4V3,
50 e1a9dbff Michael Niedermayer
    CODEC_ID_WMV1,
51 b50eef3a Michael Niedermayer
    CODEC_ID_WMV2,
52 de6d9b64 Fabrice Bellard
    CODEC_ID_H263P,
53
    CODEC_ID_H263I,
54 d4f5d74a Garrick Meeker
    CODEC_ID_FLV1,
55 be8ffec9 Nick Kurshev
    CODEC_ID_SVQ1,
56 8b82a956 Michael Niedermayer
    CODEC_ID_SVQ3,
57 020fcc94 Fabrice Bellard
    CODEC_ID_DVVIDEO,
58 11f18faf Michael Niedermayer
    CODEC_ID_HUFFYUV,
59 f70f7c6d Michael Niedermayer
    CODEC_ID_CYUV,
60 0da71265 Michael Niedermayer
    CODEC_ID_H264,
61 deabd4fd Mike Melanson
    CODEC_ID_INDEO3,
62 d86053a4 Mike Melanson
    CODEC_ID_VP3,
63 f44ee2c3 Alex Beregszaszi
    CODEC_ID_THEORA,
64 3d2e8cce Michael Niedermayer
    CODEC_ID_ASV1,
65 9b56edf5 Michael Niedermayer
    CODEC_ID_ASV2,
66 5e20f836 Michael Niedermayer
    CODEC_ID_FFV1,
67 e2a7bb28 Mike Melanson
    CODEC_ID_4XM,
68 be3564ed Michael Niedermayer
    CODEC_ID_VCR1,
69 3aff069b Alex Beregszaszi
    CODEC_ID_CLJR,
70 c3bf0288 Michael Niedermayer
    CODEC_ID_MDEC,
71 3ef8be2b Mike Melanson
    CODEC_ID_ROQ,
72
    CODEC_ID_INTERPLAY_VIDEO,
73 9937e686 Mike Melanson
    CODEC_ID_XAN_WC3,
74
    CODEC_ID_XAN_WC4,
75 2fdf638b Mike Melanson
    CODEC_ID_RPZA,
76
    CODEC_ID_CINEPAK,
77
    CODEC_ID_WS_VQA,
78
    CODEC_ID_MSRLE,
79
    CODEC_ID_MSVIDEO1,
80 4120a53a Mike Melanson
    CODEC_ID_IDCIN,
81 1dc1ed99 Roberto Togni
    CODEC_ID_8BPS,
82 11e29a41 Mike Melanson
    CODEC_ID_SMC,
83 42cad81a Mike Melanson
    CODEC_ID_FLIC,
84 9a4117d5 Mike Melanson
    CODEC_ID_TRUEMOTION1,
85 fafa0b75 Mike Melanson
    CODEC_ID_VMDVIDEO,
86 a273bbfb Roberto Togni
    CODEC_ID_MSZH,
87
    CODEC_ID_ZLIB,
88 070ed1bc Mike Melanson
    CODEC_ID_QTRLE,
89 791e7b83 Michael Niedermayer
    CODEC_ID_SNOW,
90 9d53d58e Mike Melanson
    CODEC_ID_TSCC,
91 d0a0bbd2 Mike Melanson
    CODEC_ID_ULTI,
92 d08d7142 Mike Melanson
    CODEC_ID_QDRAW,
93 ab711b3c Mike Melanson
    CODEC_ID_VIXL,
94 acfd8f0f Mike Melanson
    CODEC_ID_QPEG,
95 17179d2d Michael Niedermayer
    CODEC_ID_XVID,
96
    CODEC_ID_PNG,
97
    CODEC_ID_PPM,
98
    CODEC_ID_PBM,
99
    CODEC_ID_PGM,
100
    CODEC_ID_PGMYUV,
101
    CODEC_ID_PAM,
102 f37b9768 Loren Merritt
    CODEC_ID_FFVHUFF,
103 a96b68b7 Fabrice Bellard
104
    /* various pcm "codecs" */
105 17179d2d Michael Niedermayer
    CODEC_ID_PCM_S16LE= 0x10000,
106 a96b68b7 Fabrice Bellard
    CODEC_ID_PCM_S16BE,
107
    CODEC_ID_PCM_U16LE,
108
    CODEC_ID_PCM_U16BE,
109
    CODEC_ID_PCM_S8,
110
    CODEC_ID_PCM_U8,
111
    CODEC_ID_PCM_MULAW,
112
    CODEC_ID_PCM_ALAW,
113 0147f198 François Revol
114
    /* various adpcm codecs */
115 17179d2d Michael Niedermayer
    CODEC_ID_ADPCM_IMA_QT= 0x11000,
116 0147f198 François Revol
    CODEC_ID_ADPCM_IMA_WAV,
117 9937e686 Mike Melanson
    CODEC_ID_ADPCM_IMA_DK3,
118
    CODEC_ID_ADPCM_IMA_DK4,
119 2fdf638b Mike Melanson
    CODEC_ID_ADPCM_IMA_WS,
120 7d8379f2 Mike Melanson
    CODEC_ID_ADPCM_IMA_SMJPEG,
121 0147f198 François Revol
    CODEC_ID_ADPCM_MS,
122 e2a7bb28 Mike Melanson
    CODEC_ID_ADPCM_4XM,
123 fc384777 Mike Melanson
    CODEC_ID_ADPCM_XA,
124
    CODEC_ID_ADPCM_ADX,
125 7d8379f2 Mike Melanson
    CODEC_ID_ADPCM_EA,
126 e5966052 Roman Shaposhnik
    CODEC_ID_ADPCM_G726,
127 b3bfb299 Mike Melanson
    CODEC_ID_ADPCM_CT,
128 891f64b3 joca@rixmail.se
129 17179d2d Michael Niedermayer
    /* AMR */
130
    CODEC_ID_AMR_NB= 0x12000,
131 d663a1fd Michael Niedermayer
    CODEC_ID_AMR_WB,
132
133 b8414bbd Nick Kurshev
    /* RealAudio codecs*/
134 17179d2d Michael Niedermayer
    CODEC_ID_RA_144= 0x13000,
135 b8414bbd Nick Kurshev
    CODEC_ID_RA_288,
136 3ef8be2b Mike Melanson
137
    /* various DPCM codecs */
138 17179d2d Michael Niedermayer
    CODEC_ID_ROQ_DPCM= 0x14000,
139 3ef8be2b Mike Melanson
    CODEC_ID_INTERPLAY_DPCM,
140 9937e686 Mike Melanson
    CODEC_ID_XAN_DPCM,
141 d08d7142 Mike Melanson
    CODEC_ID_SOL_DPCM,
142 985180a1 Fabrice Bellard
    
143 17179d2d Michael Niedermayer
    CODEC_ID_MP2= 0x15000,
144
    CODEC_ID_MP3, /* prefered ID for MPEG Audio layer 1, 2 or3 decoding */
145
    CODEC_ID_AAC,
146
    CODEC_ID_MPEG4AAC,
147
    CODEC_ID_AC3,
148
    CODEC_ID_DTS,
149
    CODEC_ID_VORBIS,
150
    CODEC_ID_DVAUDIO,
151
    CODEC_ID_WMAV1,
152
    CODEC_ID_WMAV2,
153
    CODEC_ID_MACE3,
154
    CODEC_ID_MACE6,
155
    CODEC_ID_VMDAUDIO,
156
    CODEC_ID_SONIC,
157
    CODEC_ID_SONIC_LS,
158 ac2570a8 Michael Niedermayer
    CODEC_ID_FLAC,
159
    
160 17179d2d Michael Niedermayer
    CODEC_ID_MPEG2TS= 0x20000, /* _FAKE_ codec to indicate a raw MPEG2 transport
161 985180a1 Fabrice Bellard
                         stream (only used by libavformat) */
162 de6d9b64 Fabrice Bellard
};
163 dcedf586 Fabrice Bellard
164
/* CODEC_ID_MP3LAME is absolete */
165
#define CODEC_ID_MP3LAME CODEC_ID_MP3
166 de6d9b64 Fabrice Bellard
167
enum CodecType {
168 4a663d80 Philip Gladstone
    CODEC_TYPE_UNKNOWN = -1,
169 de6d9b64 Fabrice Bellard
    CODEC_TYPE_VIDEO,
170
    CODEC_TYPE_AUDIO,
171 985180a1 Fabrice Bellard
    CODEC_TYPE_DATA,
172 de6d9b64 Fabrice Bellard
};
173
174 64863965 Michael Niedermayer
/**
175 0f371e3e Mike Melanson
 * Pixel format. Notes: 
176
 *
177
 * PIX_FMT_RGBA32 is handled in an endian-specific manner. A RGBA
178
 * color is put together as:
179
 *  (A << 24) | (R << 16) | (G << 8) | B
180
 * This is stored as BGRA on little endian CPU architectures and ARGB on
181
 * big endian CPUs.
182
 *
183
 * When the pixel format is palettized RGB (PIX_FMT_PAL8), the palettized
184
 * image data is stored in AVFrame.data[0]. The palette is transported in
185
 * AVFrame.data[1] and, is 1024 bytes long (256 4-byte entries) and is
186
 * formatted the same as in PIX_FMT_RGBA32 described above (i.e., it is
187 fc384777 Mike Melanson
 * also endian-specific). Note also that the individual RGB palette
188
 * components stored in AVFrame.data[1] should be in the range 0..255.
189
 * This is important as many custom PAL8 video codecs that were designed
190
 * to run on the IBM VGA graphics adapter use 6-bit palette components.
191 64863965 Michael Niedermayer
 */
192 de6d9b64 Fabrice Bellard
enum PixelFormat {
193 cd394651 Michael Niedermayer
    PIX_FMT_YUV420P,   ///< Planar YUV 4:2:0 (1 Cr & Cb sample per 2x2 Y samples)
194 ebb177dd Todd Kirby
    PIX_FMT_YUV422,    ///< Packed pixel, Y0 Cb Y1 Cr 
195 cd394651 Michael Niedermayer
    PIX_FMT_RGB24,     ///< Packed pixel, 3 bytes per pixel, RGBRGB...
196
    PIX_FMT_BGR24,     ///< Packed pixel, 3 bytes per pixel, BGRBGR...
197
    PIX_FMT_YUV422P,   ///< Planar YUV 4:2:2 (1 Cr & Cb sample per 2x1 Y samples)
198
    PIX_FMT_YUV444P,   ///< Planar YUV 4:4:4 (1 Cr & Cb sample per 1x1 Y samples)
199 0f371e3e Mike Melanson
    PIX_FMT_RGBA32,    ///< Packed pixel, 4 bytes per pixel, BGRABGRA..., stored in cpu endianness
200 cd394651 Michael Niedermayer
    PIX_FMT_YUV410P,   ///< Planar YUV 4:1:0 (1 Cr & Cb sample per 4x4 Y samples)
201
    PIX_FMT_YUV411P,   ///< Planar YUV 4:1:1 (1 Cr & Cb sample per 4x1 Y samples)
202 64863965 Michael Niedermayer
    PIX_FMT_RGB565,    ///< always stored in cpu endianness 
203
    PIX_FMT_RGB555,    ///< always stored in cpu endianness, most significant bit to 1 
204 dab64ebc Fabrice Bellard
    PIX_FMT_GRAY8,
205 64863965 Michael Niedermayer
    PIX_FMT_MONOWHITE, ///< 0 is white 
206
    PIX_FMT_MONOBLACK, ///< 0 is black 
207
    PIX_FMT_PAL8,      ///< 8 bit with RGBA palette 
208 cd394651 Michael Niedermayer
    PIX_FMT_YUVJ420P,  ///< Planar YUV 4:2:0 full scale (jpeg)
209
    PIX_FMT_YUVJ422P,  ///< Planar YUV 4:2:2 full scale (jpeg)
210
    PIX_FMT_YUVJ444P,  ///< Planar YUV 4:4:4 full scale (jpeg)
211 fb364ada Ivan Kalvachev
    PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing(xvmc_render.h)
212
    PIX_FMT_XVMC_MPEG2_IDCT,
213 ebb177dd Todd Kirby
    PIX_FMT_UYVY422,   ///< Packed pixel, Cb Y0 Cr Y1 
214 f02be79d Roman Shaposhnik
    PIX_FMT_UYVY411,   ///< Packed pixel, Cb Y0 Y1 Cr Y2 Y3
215 dab64ebc Fabrice Bellard
    PIX_FMT_NB,
216 de6d9b64 Fabrice Bellard
};
217
218 a96b68b7 Fabrice Bellard
/* currently unused, may be used if 24/32 bits samples ever supported */
219
enum SampleFormat {
220 64863965 Michael Niedermayer
    SAMPLE_FMT_S16 = 0,         ///< signed 16 bits 
221 a96b68b7 Fabrice Bellard
};
222
223 de6d9b64 Fabrice Bellard
/* in bytes */
224 bc8d1857 Fabrice Bellard
#define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
225 de6d9b64 Fabrice Bellard
226 d7425f59 Michael Niedermayer
/**
227 cf713bb8 Michael Niedermayer
 * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
228
 * this is mainly needed because some optimized bitstream readers read 
229
 * 32 or 64 bit at once and could read over the end<br>
230
 * Note, if the first 23 bits of the additional bytes are not 0 then damaged
231
 * MPEG bitstreams could cause overread and segfault
232 d7425f59 Michael Niedermayer
 */
233
#define FF_INPUT_BUFFER_PADDING_SIZE 8
234
235 e4986da9 Juanjo
/* motion estimation type, EPZS by default */
236
enum Motion_Est_ID {
237 101bea5f Juanjo
    ME_ZERO = 1,
238 e4986da9 Juanjo
    ME_FULL,
239
    ME_LOG,
240
    ME_PHODS,
241
    ME_EPZS,
242
    ME_X1
243
};
244
245 1f018225 Michael Niedermayer
enum AVRounding {
246
    AV_ROUND_ZERO     = 0, ///< round toward zero
247
    AV_ROUND_INF      = 1, ///< round away from zero
248
    AV_ROUND_DOWN     = 2, ///< round toward -infinity
249
    AV_ROUND_UP       = 3, ///< round toward +infinity
250
    AV_ROUND_NEAR_INF = 5, ///< round to nearest and halfway cases away from zero
251
};
252
253 ce980a95 Michael Niedermayer
typedef struct RcOverride{
254
    int start_frame;
255
    int end_frame;
256
    int qscale; // if this is 0 then quality_factor will be used instead
257
    float quality_factor;
258
} RcOverride;
259
260 101bea5f Juanjo
/* only for ME compatiblity with old apps */
261
extern int motion_estimation_method;
262
263 4e00e76b Michael Niedermayer
#define FF_MAX_B_FRAMES 8
264 9dbcbd92 Michael Niedermayer
265 a949d72e Michael Niedermayer
/* encoding support
266
   these flags can be passed in AVCodecContext.flags before initing 
267
   Note: note not everything is supported yet 
268
*/
269 de6d9b64 Fabrice Bellard
270 64863965 Michael Niedermayer
#define CODEC_FLAG_QSCALE 0x0002  ///< use fixed qscale 
271 dba019da Michael Niedermayer
#define CODEC_FLAG_4MV    0x0004  ///< 4 MV per MB allowed / Advanced prediction for H263
272 64863965 Michael Niedermayer
#define CODEC_FLAG_QPEL   0x0010  ///< use qpel MC 
273
#define CODEC_FLAG_GMC    0x0020  ///< use GMC 
274 ca7d05d5 Michael Niedermayer
#define CODEC_FLAG_MV0    0x0040  ///< always try a MB with MV=<0,0> 
275 64863965 Michael Niedermayer
#define CODEC_FLAG_PART   0x0080  ///< use data partitioning 
276 9dbcbd92 Michael Niedermayer
/* parent program gurantees that the input for b-frame containing streams is not written to 
277
   for at least s->max_b_frames+1 frames, if this is not set than the input will be copied */
278 8b4c7dbc Michael Niedermayer
#define CODEC_FLAG_INPUT_PRESERVED 0x0100
279 64863965 Michael Niedermayer
#define CODEC_FLAG_PASS1 0x0200   ///< use internal 2pass ratecontrol in first  pass mode 
280
#define CODEC_FLAG_PASS2 0x0400   ///< use internal 2pass ratecontrol in second pass mode 
281
#define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< use external huffman table (for mjpeg) 
282
#define CODEC_FLAG_GRAY  0x2000   ///< only decode/encode grayscale 
283
#define CODEC_FLAG_EMU_EDGE 0x4000///< dont draw edges 
284
#define CODEC_FLAG_PSNR           0x8000 ///< error[?] variables will be set during encoding 
285
#define CODEC_FLAG_TRUNCATED  0x00010000 /** input bitstream might be truncated at a random location instead 
286 d7425f59 Michael Niedermayer
                                            of only at frame boundaries */
287 64863965 Michael Niedermayer
#define CODEC_FLAG_NORMALIZE_AQP  0x00020000 ///< normalize adaptive quantization 
288
#define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< use interlaced dct 
289 3bb07d61 Michael Niedermayer
#define CODEC_FLAG_LOW_DELAY      0x00080000 ///< force low delay
290 64863965 Michael Niedermayer
#define CODEC_FLAG_ALT_SCAN       0x00100000 ///< use alternate scan 
291
#define CODEC_FLAG_TRELLIS_QUANT  0x00200000 ///< use trellis quantization 
292
#define CODEC_FLAG_GLOBAL_HEADER  0x00400000 ///< place global headers in extradata instead of every keyframe 
293
#define CODEC_FLAG_BITEXACT       0x00800000 ///< use only bitexact stuff (except (i)dct) 
294 21e59552 Michael Niedermayer
/* Fx : Flag for h263+ extra options */
295 8d8c0294 Michael Niedermayer
#define CODEC_FLAG_H263P_AIC      0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction (remove this)
296
#define CODEC_FLAG_AC_PRED        0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction
297 64863965 Michael Niedermayer
#define CODEC_FLAG_H263P_UMV      0x02000000 ///< Unlimited motion vector  
298 f2f6134b Michael Niedermayer
#define CODEC_FLAG_CBP_RD         0x04000000 ///< use rate distortion optimization for cbp
299 1f26c6f3 Michael Niedermayer
#define CODEC_FLAG_QP_RD          0x08000000 ///< use rate distortion optimization for qp selectioon
300 dba019da Michael Niedermayer
#define CODEC_FLAG_H263P_AIV      0x00000008 ///< H263 Alternative inter vlc
301 332f9ac4 Michael Niedermayer
#define CODEC_FLAG_OBMC           0x00000001 ///< OBMC
302
#define CODEC_FLAG_LOOP_FILTER    0x00000800 ///< loop filter
303 bb198e19 Michael Niedermayer
#define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000
304
#define CODEC_FLAG_INTERLACED_ME  0x20000000 ///< interlaced motion estimation
305 baaf3f46 Michael Niedermayer
#define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< will reserve space for SVCD scan offset user data
306 303e50e6 Michael Niedermayer
#define CODEC_FLAG_CLOSED_GOP     0x80000000
307 6fc5b059 Michael Niedermayer
#define CODEC_FLAG2_FAST          0x00000001 ///< allow non spec compliant speedup tricks
308 03581772 Michael Niedermayer
#define CODEC_FLAG2_STRICT_GOP    0x00000002 ///< strictly enforce GOP size
309 6fc5b059 Michael Niedermayer
310 21e59552 Michael Niedermayer
/* Unsupported options :
311
 *                 Syntax Arithmetic coding (SAC)
312
 *                 Reference Picture Selection
313 ba58dabc Michael Niedermayer
 *                 Independant Segment Decoding */
314 21e59552 Michael Niedermayer
/* /Fx */
315 bf89e6b1 Fabrice Bellard
/* codec capabilities */
316
317 64863965 Michael Niedermayer
#define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< decoder can use draw_horiz_band callback 
318 6814a25c Michael Niedermayer
/**
319
 * Codec uses get_buffer() for allocating buffers.
320
 * direct rendering method 1
321
 */
322
#define CODEC_CAP_DR1             0x0002
323 917e06c8 Fabrice Bellard
/* if 'parse_only' field is true, then avcodec_parse_frame() can be
324
   used */
325
#define CODEC_CAP_PARSE_ONLY      0x0004
326 d7425f59 Michael Niedermayer
#define CODEC_CAP_TRUNCATED       0x0008
327 5e5c247a Ivan Kalvachev
/* codec can export data for HW decoding (XvMC) */
328
#define CODEC_CAP_HWACCEL         0x0010
329 6f824977 Michael Niedermayer
/** codec has a non zero delay and needs to be feeded with NULL at the end to get the delayed data */
330
#define CODEC_CAP_DELAY           0x0020
331 bf89e6b1 Fabrice Bellard
332 8d7ec294 Wolfgang Hesseler
//the following defines might change, so dont expect compatibility if u use them
333
#define MB_TYPE_INTRA4x4   0x0001
334
#define MB_TYPE_INTRA16x16 0x0002 //FIXME h264 specific
335
#define MB_TYPE_INTRA_PCM  0x0004 //FIXME h264 specific
336
#define MB_TYPE_16x16      0x0008
337
#define MB_TYPE_16x8       0x0010
338
#define MB_TYPE_8x16       0x0020
339
#define MB_TYPE_8x8        0x0040
340
#define MB_TYPE_INTERLACED 0x0080
341
#define MB_TYPE_DIRECT2     0x0100 //FIXME
342
#define MB_TYPE_ACPRED     0x0200
343
#define MB_TYPE_GMC        0x0400
344
#define MB_TYPE_SKIP       0x0800
345
#define MB_TYPE_P0L0       0x1000
346
#define MB_TYPE_P1L0       0x2000
347
#define MB_TYPE_P0L1       0x4000
348
#define MB_TYPE_P1L1       0x8000
349
#define MB_TYPE_L0         (MB_TYPE_P0L0 | MB_TYPE_P1L0)
350
#define MB_TYPE_L1         (MB_TYPE_P0L1 | MB_TYPE_P1L1)
351
#define MB_TYPE_L0L1       (MB_TYPE_L0   | MB_TYPE_L1)
352
#define MB_TYPE_QUANT      0x00010000
353
#define MB_TYPE_CBP        0x00020000
354
//Note bits 24-31 are reserved for codec specific use (h264 ref0, mpeg1 0mv, ...)
355
356 fa384dcc Michael Niedermayer
/**
357
 * Pan Scan area.
358
 * this specifies the area which should be displayed. Note there may be multiple such areas for one frame
359
 */
360
typedef struct AVPanScan{
361
    /**
362
     * id.
363
     * - encoding: set by user.
364
     * - decoding: set by lavc
365
     */
366
    int id;
367
368
    /**
369
     * width and height in 1/16 pel
370
     * - encoding: set by user.
371
     * - decoding: set by lavc
372
     */
373
    int width;
374
    int height;
375
376
    /**
377
     * position of the top left corner in 1/16 pel for up to 3 fields/frames.
378
     * - encoding: set by user.
379
     * - decoding: set by lavc
380
     */
381
    int16_t position[3][2];
382
}AVPanScan;
383
384 492cd3a9 Michael Niedermayer
#define FF_COMMON_FRAME \
385 b536d0aa Michael Niedermayer
    /**\
386
     * pointer to the picture planes.\
387
     * this might be different from the first allocated byte\
388
     * - encoding: \
389
     * - decoding: \
390
     */\
391 1e491e29 Michael Niedermayer
    uint8_t *data[4];\
392
    int linesize[4];\
393
    /**\
394 32db2b1d Michael Niedermayer
     * pointer to the first allocated byte of the picture. can be used in get_buffer/release_buffer\
395 1e491e29 Michael Niedermayer
     * this isnt used by lavc unless the default get/release_buffer() is used\
396 64863965 Michael Niedermayer
     * - encoding: \
397
     * - decoding: \
398 1e491e29 Michael Niedermayer
     */\
399
    uint8_t *base[4];\
400
    /**\
401
     * 1 -> keyframe, 0-> not\
402 64863965 Michael Niedermayer
     * - encoding: set by lavc\
403
     * - decoding: set by lavc\
404 1e491e29 Michael Niedermayer
     */\
405
    int key_frame;\
406
\
407
    /**\
408 0da71265 Michael Niedermayer
     * picture type of the frame, see ?_TYPE below.\
409 64863965 Michael Niedermayer
     * - encoding: set by lavc for coded_picture (and set by user for input)\
410
     * - decoding: set by lavc\
411 1e491e29 Michael Niedermayer
     */\
412
    int pict_type;\
413
\
414
    /**\
415 9740beff Michael Niedermayer
     * presentation timestamp in AV_TIME_BASE (=micro seconds currently) (time when frame should be shown to user)\
416
     * if AV_NOPTS_VALUE then the frame_rate will be used as reference\
417 64863965 Michael Niedermayer
     * - encoding: MUST be set by user\
418
     * - decoding: set by lavc\
419 1e491e29 Michael Niedermayer
     */\
420 be6784dc Richard Hodges
    int64_t pts;\
421 1e491e29 Michael Niedermayer
\
422
    /**\
423
     * picture number in bitstream order.\
424 64863965 Michael Niedermayer
     * - encoding: set by\
425
     * - decoding: set by lavc\
426 1e491e29 Michael Niedermayer
     */\
427
    int coded_picture_number;\
428
    /**\
429
     * picture number in display order.\
430 64863965 Michael Niedermayer
     * - encoding: set by\
431
     * - decoding: set by lavc\
432 1e491e29 Michael Niedermayer
     */\
433
    int display_picture_number;\
434
\
435
    /**\
436 158c7f05 Michael Niedermayer
     * quality (between 1 (good) and FF_LAMBDA_MAX (bad)) \
437 64863965 Michael Niedermayer
     * - encoding: set by lavc for coded_picture (and set by user for input)\
438
     * - decoding: set by lavc\
439 1e491e29 Michael Niedermayer
     */\
440 158c7f05 Michael Niedermayer
    int quality; \
441 1e491e29 Michael Niedermayer
\
442
    /**\
443
     * buffer age (1->was last buffer and dint change, 2->..., ...).\
444 158c7f05 Michael Niedermayer
     * set to INT_MAX if the buffer has not been used yet \
445 64863965 Michael Niedermayer
     * - encoding: unused\
446
     * - decoding: MUST be set by get_buffer()\
447 1e491e29 Michael Niedermayer
     */\
448
    int age;\
449
\
450
    /**\
451
     * is this picture used as reference\
452 64863965 Michael Niedermayer
     * - encoding: unused\
453
     * - decoding: set by lavc (before get_buffer() call))\
454 1e491e29 Michael Niedermayer
     */\
455
    int reference;\
456
\
457
    /**\
458
     * QP table\
459 64863965 Michael Niedermayer
     * - encoding: unused\
460
     * - decoding: set by lavc\
461 1e491e29 Michael Niedermayer
     */\
462
    int8_t *qscale_table;\
463
    /**\
464
     * QP store stride\
465 64863965 Michael Niedermayer
     * - encoding: unused\
466
     * - decoding: set by lavc\
467 1e491e29 Michael Niedermayer
     */\
468
    int qstride;\
469
\
470
    /**\
471
     * mbskip_table[mb]>=1 if MB didnt change\
472
     * stride= mb_width = (width+15)>>4\
473 64863965 Michael Niedermayer
     * - encoding: unused\
474
     * - decoding: set by lavc\
475 1e491e29 Michael Niedermayer
     */\
476
    uint8_t *mbskip_table;\
477
\
478
    /**\
479 8d7ec294 Wolfgang Hesseler
     * Motion vector table\
480 a4d36c11 Michael Niedermayer
     * - encoding: set by user\
481 8d7ec294 Wolfgang Hesseler
     * - decoding: set by lavc\
482
     */\
483
    int16_t (*motion_val[2])[2];\
484
\
485
    /**\
486
     * Macroblock type table\
487
     * mb_type_base + mb_width + 2\
488 a4d36c11 Michael Niedermayer
     * - encoding: set by user\
489 8d7ec294 Wolfgang Hesseler
     * - decoding: set by lavc\
490
     */\
491
    uint32_t *mb_type;\
492
\
493
    /**\
494 f0b77c69 Michael Niedermayer
     * log2 of the size of the block which a single vector in motion_val represents: \
495
     * (4->16x16, 3->8x8, 2-> 4x4, 1-> 2x2)\
496 8d7ec294 Wolfgang Hesseler
     * - encoding: unused\
497
     * - decoding: set by lavc\
498
     */\
499
    uint8_t motion_subsample_log2;\
500
\
501
    /**\
502 1e491e29 Michael Niedermayer
     * for some private data of the user\
503 64863965 Michael Niedermayer
     * - encoding: unused\
504
     * - decoding: set by user\
505 1e491e29 Michael Niedermayer
     */\
506
    void *opaque;\
507 140cb663 Michael Niedermayer
\
508
    /**\
509
     * error\
510 64863965 Michael Niedermayer
     * - encoding: set by lavc if flags&CODEC_FLAG_PSNR\
511
     * - decoding: unused\
512 140cb663 Michael Niedermayer
     */\
513
    uint64_t error[4];\
514 4e00e76b Michael Niedermayer
\
515
    /**\
516
     * type of the buffer (to keep track of who has to dealloc data[*])\
517 64863965 Michael Niedermayer
     * - encoding: set by the one who allocs it\
518
     * - decoding: set by the one who allocs it\
519 3db320ea Falk Hüffner
     * Note: user allocated (direct rendering) & internal buffers can not coexist currently\
520 4e00e76b Michael Niedermayer
     */\
521
    int type;\
522 2ec23b6d Michael Niedermayer
    \
523
    /**\
524
     * when decoding, this signal how much the picture must be delayed.\
525
     * extra_delay = repeat_pict / (2*fps)\
526 64863965 Michael Niedermayer
     * - encoding: unused\
527
     * - decoding: set by lavc\
528 2ec23b6d Michael Niedermayer
     */\
529 0426af31 Michael Niedermayer
    int repeat_pict;\
530
    \
531
    /**\
532
     * \
533
     */\
534
    int qscale_type;\
535 2744ca9a Roman Shaposhnik
    \
536
    /**\
537
     * The content of the picture is interlaced.\
538
     * - encoding: set by user\
539
     * - decoding: set by lavc (default 0)\
540
     */\
541
    int interlaced_frame;\
542
    \
543
    /**\
544 9dad924e Michael Niedermayer
     * if the content is interlaced, is top field displayed first.\
545 2744ca9a Roman Shaposhnik
     * - encoding: set by user\
546 9dad924e Michael Niedermayer
     * - decoding: set by lavc\
547 2744ca9a Roman Shaposhnik
     */\
548 9dad924e Michael Niedermayer
    int top_field_first;\
549 fa384dcc Michael Niedermayer
    \
550
    /**\
551
     * Pan scan.\
552
     * - encoding: set by user\
553
     * - decoding: set by lavc\
554
     */\
555
    AVPanScan *pan_scan;\
556 2a2bbcb0 Mike Melanson
    \
557
    /**\
558
     * tell user application that palette has changed from previous frame.\
559
     * - encoding: ??? (no palette-enabled encoder yet)\
560
     * - decoding: set by lavc (default 0)\
561
     */\
562
    int palette_has_changed;\
563 074c4ca7 Roberto Togni
    \
564
    /**\
565
     * Codec suggestion on buffer type if != 0\
566
     * - encoding: unused\
567
     * - decoding: set by lavc (before get_buffer() call))\
568
     */\
569
    int buffer_hints;\
570 8289c6fa Wolfgang Hesseler
\
571
    /**\
572
     * DCT coeffitients\
573
     * - encoding: unused\
574
     * - decoding: set by lavc\
575
     */\
576
    short *dct_coeff;\
577 a4d36c11 Michael Niedermayer
\
578
    /**\
579
     * Motion referece frame index\
580
     * - encoding: set by user\
581
     * - decoding: set by lavc\
582
     */\
583
    int8_t *ref_index[2];
584 2ec23b6d Michael Niedermayer
585 0426af31 Michael Niedermayer
#define FF_QSCALE_TYPE_MPEG1        0
586
#define FF_QSCALE_TYPE_MPEG2        1
587 4e00e76b Michael Niedermayer
588
#define FF_BUFFER_TYPE_INTERNAL 1
589 9b56edf5 Michael Niedermayer
#define FF_BUFFER_TYPE_USER     2 ///< Direct rendering buffers (image is (de)allocated by user)
590 a4d36c11 Michael Niedermayer
#define FF_BUFFER_TYPE_SHARED   4 ///< buffer from somewher else, dont dealloc image (data/base), all other tables are not shared
591 9b56edf5 Michael Niedermayer
#define FF_BUFFER_TYPE_COPY     8 ///< just a (modified) copy of some other buffer, dont dealloc anything
592 4e00e76b Michael Niedermayer
593 1e491e29 Michael Niedermayer
594 140cb663 Michael Niedermayer
#define FF_I_TYPE 1 // Intra
595
#define FF_P_TYPE 2 // Predicted
596
#define FF_B_TYPE 3 // Bi-dir predicted
597
#define FF_S_TYPE 4 // S(GMC)-VOP MPEG4
598 0da71265 Michael Niedermayer
#define FF_SI_TYPE 5
599
#define FF_SP_TYPE 6
600 1e491e29 Michael Niedermayer
601 074c4ca7 Roberto Togni
#define FF_BUFFER_HINTS_VALID    0x01 // Buffer hints value is meaningful (if 0 ignore)
602
#define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer
603
#define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content
604
#define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update)
605
606 0da71265 Michael Niedermayer
/**
607
 * Audio Video Frame.
608
 */
609 492cd3a9 Michael Niedermayer
typedef struct AVFrame {
610
    FF_COMMON_FRAME
611
} AVFrame;
612 1e491e29 Michael Niedermayer
613 14bea432 Michael Niedermayer
#define DEFAULT_FRAME_RATE_BASE 1001000
614 d33c949c Michael Niedermayer
615
/**
616 bc874dae Michel Bardiaux
 * Used by av_log
617
 */
618
typedef struct AVCLASS AVClass;
619
struct AVCLASS {
620
    const char* class_name;
621
    const char* (*item_name)(void*); /* actually passing a pointer to an AVCodecContext
622
                                        or AVFormatContext, which begin with an AVClass.
623
                                        Needed because av_log is in libavcodec and has no visibility
624
                                        of AVIn/OutputFormat */
625
};
626
627
/**
628 d33c949c Michael Niedermayer
 * main external api structure.
629
 */
630 de6d9b64 Fabrice Bellard
typedef struct AVCodecContext {
631 b71901e6 Michael Niedermayer
    /**
632 bc874dae Michel Bardiaux
     * Info on struct for av_log
633
     * - set by avcodec_alloc_context
634
     */
635 43465395 Michael Niedermayer
    AVClass *av_class;
636 bc874dae Michel Bardiaux
    /**
637 64863965 Michael Niedermayer
     * the average bitrate.
638
     * - encoding: set by user. unused for constant quantizer encoding
639
     * - decoding: set by lavc. 0 or some bitrate if this info is available in the stream 
640 b71901e6 Michael Niedermayer
     */
641 de6d9b64 Fabrice Bellard
    int bit_rate;
642 b71901e6 Michael Niedermayer
643
    /**
644 64863965 Michael Niedermayer
     * number of bits the bitstream is allowed to diverge from the reference.
645 b71901e6 Michael Niedermayer
     *           the reference can be CBR (for CBR pass1) or VBR (for pass2)
646 64863965 Michael Niedermayer
     * - encoding: set by user. unused for constant quantizer encoding
647
     * - decoding: unused
648 b71901e6 Michael Niedermayer
     */
649
    int bit_rate_tolerance; 
650
651
    /**
652 64863965 Michael Niedermayer
     * CODEC_FLAG_*.
653
     * - encoding: set by user.
654
     * - decoding: set by user.
655 b71901e6 Michael Niedermayer
     */
656 de6d9b64 Fabrice Bellard
    int flags;
657 b71901e6 Michael Niedermayer
658
    /**
659
     * some codecs needs additionnal format info. It is stored here
660 64863965 Michael Niedermayer
     * - encoding: set by user. 
661
     * - decoding: set by lavc. (FIXME is this ok?)
662 b71901e6 Michael Niedermayer
     */
663
    int sub_id;
664
665
    /**
666 64863965 Michael Niedermayer
     * motion estimation algorithm used for video coding.
667
     * - encoding: MUST be set by user.
668
     * - decoding: unused
669 b71901e6 Michael Niedermayer
     */
670
    int me_method;
671
672
    /**
673 64863965 Michael Niedermayer
     * some codecs need / can use extra-data like huffman tables.
674 b71901e6 Michael Niedermayer
     * mjpeg: huffman tables
675
     * rv10: additional flags
676 b704e742 Michael Niedermayer
     * mpeg4: global headers (they can be in the bitstream or here)
677 dffcdbb5 Michael Niedermayer
     * the allocated memory should be FF_INPUT_BUFFER_PADDING_SIZE bytes larger
678
     * then extradata_size to avoid prolems if its read with the bitstream reader
679 64863965 Michael Niedermayer
     * - encoding: set/allocated/freed by lavc.
680
     * - decoding: set/allocated/freed by user.
681 b71901e6 Michael Niedermayer
     */
682 e84c31dc Arpi
    void *extradata;
683
    int extradata_size;
684
    
685 de6d9b64 Fabrice Bellard
    /* video only */
686 b71901e6 Michael Niedermayer
    /**
687 14bea432 Michael Niedermayer
     * frames per sec multiplied by frame_rate_base.
688 b71901e6 Michael Niedermayer
     * for variable fps this is the precission, so if the timestamps 
689 14bea432 Michael Niedermayer
     * can be specified in msec precssion then this is 1000*frame_rate_base
690 64863965 Michael Niedermayer
     * - encoding: MUST be set by user
691
     * - decoding: set by lavc. 0 or the frame_rate if available
692 b71901e6 Michael Niedermayer
     */
693
    int frame_rate;
694 14bea432 Michael Niedermayer
    
695
    /**
696 21adafec Michael Niedermayer
     * picture width / height.
697 64863965 Michael Niedermayer
     * - encoding: MUST be set by user. 
698 21adafec Michael Niedermayer
     * - decoding: set by lavc.
699
     * Note, for compatibility its possible to set this instead of 
700
     * coded_width/height before decoding
701 b71901e6 Michael Niedermayer
     */
702 de6d9b64 Fabrice Bellard
    int width, height;
703 b71901e6 Michael Niedermayer
    
704 e769f053 Alex Beregszaszi
#define FF_ASPECT_EXTENDED 15
705 b71901e6 Michael Niedermayer
706
    /**
707 64863965 Michael Niedermayer
     * the number of pictures in a group of pitures, or 0 for intra_only.
708
     * - encoding: set by user.
709
     * - decoding: unused
710 b71901e6 Michael Niedermayer
     */
711
    int gop_size;
712
713
    /**
714 64863965 Michael Niedermayer
     * pixel format, see PIX_FMT_xxx.
715 36b58e85 Roman Shaposhnik
     * - encoding: FIXME: used by ffmpeg to decide whether an pix_fmt
716
     *                    conversion is in order. This only works for
717
     *                    codecs with one supported pix_fmt, we should
718
     *                    do something for a generic case as well.
719 64863965 Michael Niedermayer
     * - decoding: set by lavc.
720 b71901e6 Michael Niedermayer
     */
721 e4eadb4b Michael Niedermayer
    enum PixelFormat pix_fmt;
722 bdfcbbed Max Krasnyansky
 
723
    /**
724
     * Frame rate emulation. If not zero lower layer (i.e. format handler) 
725
     * has to read frames at native frame rate.
726
     * - encoding: set by user.
727
     * - decoding: unused.
728
     */
729
    int rate_emu;
730
       
731 b71901e6 Michael Niedermayer
    /**
732
     * if non NULL, 'draw_horiz_band' is called by the libavcodec
733
     * decoder to draw an horizontal band. It improve cache usage. Not
734
     * all codecs can do that. You must check the codec capabilities
735
     * before
736 64863965 Michael Niedermayer
     * - encoding: unused
737
     * - decoding: set by user.
738 3bb07d61 Michael Niedermayer
     * @param height the height of the slice
739
     * @param y the y position of the slice
740
     * @param type 1->top field, 2->bottom field, 3->frame
741
     * @param offset offset into the AVFrame.data from which the slice should be read
742 b71901e6 Michael Niedermayer
     */
743 bf89e6b1 Fabrice Bellard
    void (*draw_horiz_band)(struct AVCodecContext *s,
744 da64ecc3 Drew Hess
                            const AVFrame *src, int offset[4],
745 3bb07d61 Michael Niedermayer
                            int y, int type, int height);
746 bf89e6b1 Fabrice Bellard
747 de6d9b64 Fabrice Bellard
    /* audio only */
748 64863965 Michael Niedermayer
    int sample_rate; ///< samples per sec 
749 de6d9b64 Fabrice Bellard
    int channels;
750 64863965 Michael Niedermayer
    int sample_fmt;  ///< sample format, currenly unused 
751 de6d9b64 Fabrice Bellard
752
    /* the following data should not be initialized */
753 64863965 Michael Niedermayer
    int frame_size;     ///< in samples, initialized when calling 'init' 
754
    int frame_number;   ///< audio or video frame number 
755
    int real_pict_num;  ///< returns the real picture number of previous encoded frame 
756 1e491e29 Michael Niedermayer
    
757 b71901e6 Michael Niedermayer
    /**
758
     * number of frames the decoded output will be delayed relative to 
759 64863965 Michael Niedermayer
     * the encoded input.
760
     * - encoding: set by lavc.
761
     * - decoding: unused
762 b71901e6 Michael Niedermayer
     */
763
    int delay;
764 1ff662cc Michael Niedermayer
    
765 64863965 Michael Niedermayer
    /* - encoding parameters */
766
    float qcompress;  ///< amount of qscale change between easy & hard scenes (0.0-1.0)
767
    float qblur;      ///< amount of qscale smoothing over time (0.0-1.0) 
768 b71901e6 Michael Niedermayer
    
769
    /**
770 64863965 Michael Niedermayer
     * minimum quantizer.
771
     * - encoding: set by user.
772
     * - decoding: unused
773 b71901e6 Michael Niedermayer
     */
774
    int qmin;
775
776
    /**
777 64863965 Michael Niedermayer
     * maximum quantizer.
778
     * - encoding: set by user.
779
     * - decoding: unused
780 b71901e6 Michael Niedermayer
     */
781
    int qmax;
782
783
    /**
784 64863965 Michael Niedermayer
     * maximum quantizer difference etween frames.
785
     * - encoding: set by user.
786
     * - decoding: unused
787 b71901e6 Michael Niedermayer
     */
788
    int max_qdiff;
789
790
    /**
791 64863965 Michael Niedermayer
     * maximum number of b frames between non b frames.
792 b71901e6 Michael Niedermayer
     * note: the output will be delayed by max_b_frames+1 relative to the input
793 64863965 Michael Niedermayer
     * - encoding: set by user.
794
     * - decoding: unused
795 b71901e6 Michael Niedermayer
     */
796
    int max_b_frames;
797
798
    /**
799 64863965 Michael Niedermayer
     * qscale factor between ip and b frames.
800
     * - encoding: set by user.
801
     * - decoding: unused
802 b71901e6 Michael Niedermayer
     */
803
    float b_quant_factor;
804
    
805
    /** obsolete FIXME remove */
806
    int rc_strategy;
807 8b4c7dbc Michael Niedermayer
    int b_frame_strategy;
808 9dbcbd92 Michael Niedermayer
809 b71901e6 Michael Niedermayer
    /**
810 64863965 Michael Niedermayer
     * hurry up amount.
811
     * - encoding: unused
812
     * - decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too, 5-> skip everything except header
813 b71901e6 Michael Niedermayer
     */
814
    int hurry_up;
815 2417652e Michael Niedermayer
    
816 de6d9b64 Fabrice Bellard
    struct AVCodec *codec;
817 b71901e6 Michael Niedermayer
    
818 de6d9b64 Fabrice Bellard
    void *priv_data;
819
820 ba58dabc Michael Niedermayer
    /* unused, FIXME remove*/
821
    int rtp_mode;
822 644d98a4 Juanjo
    
823
    int rtp_payload_size;   /* The size of the RTP payload, the coder will  */
824
                            /* do it's best to deliver a chunk with size    */
825
                            /* below rtp_payload_size, the chunk will start */
826
                            /* with a start code on some codecs like H.263  */
827
                            /* This doesn't take account of any particular  */
828
                            /* headers inside the transmited RTP payload    */
829 81401c1f Juanjo
830
    
831
    /* The RTP callcack: This function is called  */
832
    /* every time the encoder as a packet to send */
833
    /* Depends on the encoder if the data starts  */
834
    /* with a Start Code (it should) H.263 does   */
835 a7fcb3ea Chris Flerackers
    void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int packet_number); 
836 81401c1f Juanjo
837 098eefe1 Michael Niedermayer
    /* statistics, used for 2-pass encoding */
838
    int mv_bits;
839
    int header_bits;
840
    int i_tex_bits;
841
    int p_tex_bits;
842
    int i_count;
843
    int p_count;
844
    int skip_count;
845 b71901e6 Michael Niedermayer
    int misc_bits;
846
    
847
    /**
848 64863965 Michael Niedermayer
     * number of bits used for the previously encoded frame.
849
     * - encoding: set by lavc
850 7004ffb3 Michael Niedermayer
     * - decoding: unused
851 b71901e6 Michael Niedermayer
     */
852 098eefe1 Michael Niedermayer
    int frame_bits;
853 7004ffb3 Michael Niedermayer
854 b71901e6 Michael Niedermayer
    /**
855 64863965 Michael Niedermayer
     * private data of the user, can be used to carry app specific stuff.
856
     * - encoding: set by user
857
     * - decoding: set by user
858 b71901e6 Michael Niedermayer
     */
859
    void *opaque;
860
861 de6d9b64 Fabrice Bellard
    char codec_name[32];
862 4a663d80 Philip Gladstone
    enum CodecType codec_type; /* see CODEC_TYPE_xxx */
863
    enum CodecID codec_id; /* see CODEC_ID_xxx */
864 7004ffb3 Michael Niedermayer
    
865
    /**
866
     * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
867
     * this is used to workaround some encoder bugs
868 bd5a6020 Michael Niedermayer
     * - encoding: set by user, if not then the default based on codec_id will be used
869 7004ffb3 Michael Niedermayer
     * - decoding: set by user, will be converted to upper case by lavc during init
870
     */
871
    unsigned int codec_tag;
872 92ba5ffb Michael Niedermayer
    
873 b71901e6 Michael Niedermayer
    /**
874 64863965 Michael Niedermayer
     * workaround bugs in encoders which sometimes cannot be detected automatically.
875
     * - encoding: unused
876
     * - decoding: set by user
877 b71901e6 Michael Niedermayer
     */
878
    int workaround_bugs;
879 64863965 Michael Niedermayer
#define FF_BUG_AUTODETECT       1  ///< autodetection
880 4d2858de Michael Niedermayer
#define FF_BUG_OLD_MSMPEG4      2
881
#define FF_BUG_XVID_ILACE       4
882
#define FF_BUG_UMP4             8
883
#define FF_BUG_NO_PADDING       16
884 3116cb14 Michael Niedermayer
#define FF_BUG_AMV              32
885 ac0c6638 Michael Niedermayer
#define FF_BUG_AC_VLC           0  ///< will be removed, libavcodec can now handle these non compliant files by default
886 03e93d35 Michael Niedermayer
#define FF_BUG_QPEL_CHROMA      64
887 db794953 Michael Niedermayer
#define FF_BUG_STD_QPEL         128
888 36df8805 Michael Niedermayer
#define FF_BUG_QPEL_CHROMA2     256
889 c40c3482 Michael Niedermayer
#define FF_BUG_DIRECT_BLOCKSIZE 512
890 1c6dcb0f Michael Niedermayer
#define FF_BUG_EDGE             1024
891 b44bdf7e Michael Niedermayer
#define FF_BUG_HPEL_CHROMA      2048
892 4ccde216 Michael Niedermayer
#define FF_BUG_DC_CLIP          4096
893 4d2858de Michael Niedermayer
//#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
894
        
895 b71901e6 Michael Niedermayer
    /**
896 64863965 Michael Niedermayer
     * luma single coeff elimination threshold.
897
     * - encoding: set by user
898
     * - decoding: unused
899 b71901e6 Michael Niedermayer
     */
900 1f6b6e50 Michael Niedermayer
    int luma_elim_threshold;
901 b71901e6 Michael Niedermayer
    
902
    /**
903 64863965 Michael Niedermayer
     * chroma single coeff elimination threshold.
904
     * - encoding: set by user
905
     * - decoding: unused
906 b71901e6 Michael Niedermayer
     */
907 1f6b6e50 Michael Niedermayer
    int chroma_elim_threshold;
908 b71901e6 Michael Niedermayer
    
909
    /**
910 64863965 Michael Niedermayer
     * strictly follow the std (MPEG4, ...).
911
     * - encoding: set by user
912
     * - decoding: unused
913 b71901e6 Michael Niedermayer
     */
914
    int strict_std_compliance;
915
    
916
    /**
917 64863965 Michael Niedermayer
     * qscale offset between ip and b frames.
918 b3a391e8 Michael Niedermayer
     * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
919
     * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
920 64863965 Michael Niedermayer
     * - encoding: set by user.
921
     * - decoding: unused
922 b71901e6 Michael Niedermayer
     */
923
    float b_quant_offset;
924
    
925
    /**
926 ce3bcaed Michael Niedermayer
     * error resilience higher values will detect more errors but may missdetect
927 64863965 Michael Niedermayer
     * some more or less valid parts as errors.
928
     * - encoding: unused
929
     * - decoding: set by user
930 b71901e6 Michael Niedermayer
     */
931 1f6b6e50 Michael Niedermayer
    int error_resilience;
932 ce3bcaed Michael Niedermayer
#define FF_ER_CAREFULL        1
933
#define FF_ER_COMPLIANT       2
934
#define FF_ER_AGGRESSIVE      3
935
#define FF_ER_VERY_AGGRESSIVE 4
936 ae72cda6 Nick Kurshev
    
937 6b72ac63 Michael Niedermayer
    /**
938 1e491e29 Michael Niedermayer
     * called at the beginning of each frame to get a buffer for it.
939
     * if pic.reference is set then the frame will be read later by lavc
940 2b5296d2 Michael Niedermayer
     * avcodec_align_dimensions() should be used to find the required width and
941
     * height, as they normally need to be rounded up to the next multiple of 16
942 64863965 Michael Niedermayer
     * - encoding: unused
943
     * - decoding: set by lavc, user can override
944 b71901e6 Michael Niedermayer
     */
945 492cd3a9 Michael Niedermayer
    int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
946 b71901e6 Michael Niedermayer
    
947
    /**
948 1e491e29 Michael Niedermayer
     * called to release buffers which where allocated with get_buffer.
949
     * a released buffer can be reused in get_buffer()
950
     * pic.data[*] must be set to NULL
951 64863965 Michael Niedermayer
     * - encoding: unused
952
     * - decoding: set by lavc, user can override
953 b71901e6 Michael Niedermayer
     */
954 492cd3a9 Michael Niedermayer
    void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
955 0fd90455 Michael Niedermayer
956 b71901e6 Michael Niedermayer
    /**
957 e6a2ac34 Michael Niedermayer
     * if 1 the stream has a 1 frame delay during decoding.
958
     * - encoding: set by lavc
959 64863965 Michael Niedermayer
     * - decoding: set by lavc
960 b71901e6 Michael Niedermayer
     */
961
    int has_b_frames;
962
    
963 64863965 Michael Niedermayer
    int block_align; ///< used by some WAV based audio codecs
964 ce980a95 Michael Niedermayer
    
965 64863965 Michael Niedermayer
    int parse_only; /* - decoding only: if true, only parsing is done
966 917e06c8 Fabrice Bellard
                       (function avcodec_parse_frame()). The frame
967
                       data is returned. Only MPEG codecs support this now. */
968 ce980a95 Michael Niedermayer
    
969 b71901e6 Michael Niedermayer
    /**
970 e4eadb4b Michael Niedermayer
     * 0-> h263 quant 1-> mpeg quant.
971 64863965 Michael Niedermayer
     * - encoding: set by user.
972
     * - decoding: unused
973 b71901e6 Michael Niedermayer
     */
974
    int mpeg_quant;
975 ce980a95 Michael Niedermayer
    
976 b71901e6 Michael Niedermayer
    /**
977 64863965 Michael Niedermayer
     * pass1 encoding statistics output buffer.
978
     * - encoding: set by lavc
979
     * - decoding: unused
980 b71901e6 Michael Niedermayer
     */
981 64863965 Michael Niedermayer
    char *stats_out;
982 b71901e6 Michael Niedermayer
    
983
    /**
984
     * pass2 encoding statistics input buffer.
985
     * concatenated stuff from stats_out of pass1 should be placed here
986 64863965 Michael Niedermayer
     * - encoding: allocated/set/freed by user
987
     * - decoding: unused
988 b71901e6 Michael Niedermayer
     */
989
    char *stats_in;
990
    
991
    /**
992 64863965 Michael Niedermayer
     * ratecontrol qmin qmax limiting method.
993 b71901e6 Michael Niedermayer
     * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
994 64863965 Michael Niedermayer
     * - encoding: set by user.
995
     * - decoding: unused
996 b71901e6 Michael Niedermayer
     */
997 ce980a95 Michael Niedermayer
    float rc_qsquish;
998 b71901e6 Michael Niedermayer
999 ce980a95 Michael Niedermayer
    float rc_qmod_amp;
1000
    int rc_qmod_freq;
1001 b71901e6 Michael Niedermayer
    
1002
    /**
1003 64863965 Michael Niedermayer
     * ratecontrol override, see RcOverride.
1004
     * - encoding: allocated/set/freed by user.
1005
     * - decoding: unused
1006 b71901e6 Michael Niedermayer
     */
1007 ce980a95 Michael Niedermayer
    RcOverride *rc_override;
1008
    int rc_override_count;
1009 b71901e6 Michael Niedermayer
    
1010
    /**
1011 64863965 Michael Niedermayer
     * rate control equation.
1012
     * - encoding: set by user
1013
     * - decoding: unused
1014 b71901e6 Michael Niedermayer
     */
1015 ce980a95 Michael Niedermayer
    char *rc_eq;
1016 b71901e6 Michael Niedermayer
    
1017
    /**
1018 64863965 Michael Niedermayer
     * maximum bitrate.
1019
     * - encoding: set by user.
1020
     * - decoding: unused
1021 b71901e6 Michael Niedermayer
     */
1022 ce980a95 Michael Niedermayer
    int rc_max_rate;
1023 b71901e6 Michael Niedermayer
    
1024
    /**
1025 64863965 Michael Niedermayer
     * minimum bitrate.
1026
     * - encoding: set by user.
1027
     * - decoding: unused
1028 b71901e6 Michael Niedermayer
     */
1029 ce980a95 Michael Niedermayer
    int rc_min_rate;
1030 b71901e6 Michael Niedermayer
    
1031
    /**
1032 64863965 Michael Niedermayer
     * decoder bitstream buffer size.
1033
     * - encoding: set by user.
1034
     * - decoding: unused
1035 b71901e6 Michael Niedermayer
     */
1036 ce980a95 Michael Niedermayer
    int rc_buffer_size;
1037
    float rc_buffer_aggressivity;
1038 b71901e6 Michael Niedermayer
1039
    /**
1040 64863965 Michael Niedermayer
     * qscale factor between p and i frames.
1041 a1e257b2 Michael Niedermayer
     * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
1042
     * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
1043 64863965 Michael Niedermayer
     * - encoding: set by user.
1044
     * - decoding: unused
1045 b71901e6 Michael Niedermayer
     */
1046
    float i_quant_factor;
1047
    
1048
    /**
1049 64863965 Michael Niedermayer
     * qscale offset between p and i frames.
1050
     * - encoding: set by user.
1051
     * - decoding: unused
1052 b71901e6 Michael Niedermayer
     */
1053
    float i_quant_offset;
1054
    
1055
    /**
1056 64863965 Michael Niedermayer
     * initial complexity for pass1 ratecontrol.
1057
     * - encoding: set by user.
1058
     * - decoding: unused
1059 b71901e6 Michael Niedermayer
     */
1060 ce980a95 Michael Niedermayer
    float rc_initial_cplx;
1061 917e06c8 Fabrice Bellard
1062 b71901e6 Michael Niedermayer
    /**
1063 64863965 Michael Niedermayer
     * dct algorithm, see FF_DCT_* below.
1064
     * - encoding: set by user
1065
     * - decoding: unused
1066 b71901e6 Michael Niedermayer
     */
1067 28db7fce Michael Niedermayer
    int dct_algo;
1068 c7e07931 Martin Olschewski
#define FF_DCT_AUTO    0
1069 28db7fce Michael Niedermayer
#define FF_DCT_FASTINT 1
1070 c7e07931 Martin Olschewski
#define FF_DCT_INT     2
1071
#define FF_DCT_MMX     3
1072
#define FF_DCT_MLIB    4
1073 05c4072b Michael Niedermayer
#define FF_DCT_ALTIVEC 5
1074 65e4c8c9 Michael Niedermayer
#define FF_DCT_FAAN    6
1075 c5d309f2 Michael Niedermayer
    
1076
    /**
1077 64863965 Michael Niedermayer
     * luminance masking (0-> disabled).
1078
     * - encoding: set by user
1079
     * - decoding: unused
1080 c5d309f2 Michael Niedermayer
     */
1081
    float lumi_masking;
1082
    
1083
    /**
1084 64863965 Michael Niedermayer
     * temporary complexity masking (0-> disabled).
1085
     * - encoding: set by user
1086
     * - decoding: unused
1087 c5d309f2 Michael Niedermayer
     */
1088
    float temporal_cplx_masking;
1089
    
1090
    /**
1091 64863965 Michael Niedermayer
     * spatial complexity masking (0-> disabled).
1092
     * - encoding: set by user
1093
     * - decoding: unused
1094 c5d309f2 Michael Niedermayer
     */
1095
    float spatial_cplx_masking;
1096
    
1097
    /**
1098 64863965 Michael Niedermayer
     * p block masking (0-> disabled).
1099
     * - encoding: set by user
1100
     * - decoding: unused
1101 c5d309f2 Michael Niedermayer
     */
1102
    float p_masking;
1103 15415af4 Michael Niedermayer
1104 5e746b99 Michael Niedermayer
    /**
1105 64863965 Michael Niedermayer
     * darkness masking (0-> disabled).
1106
     * - encoding: set by user
1107
     * - decoding: unused
1108 5e746b99 Michael Niedermayer
     */
1109
    float dark_masking;
1110 0c2dd16e Michael Niedermayer
    
1111 3a694b04 Nick Kurshev
    
1112
    /* for binary compatibility */
1113
    int unused;
1114
    
1115 0c2dd16e Michael Niedermayer
    /**
1116 64863965 Michael Niedermayer
     * idct algorithm, see FF_IDCT_* below.
1117
     * - encoding: set by user
1118
     * - decoding: set by user
1119 2ad1516a Michael Niedermayer
     */
1120
    int idct_algo;
1121
#define FF_IDCT_AUTO         0
1122
#define FF_IDCT_INT          1
1123
#define FF_IDCT_SIMPLE       2
1124
#define FF_IDCT_SIMPLEMMX    3
1125
#define FF_IDCT_LIBMPEG2MMX  4
1126
#define FF_IDCT_PS2          5
1127
#define FF_IDCT_MLIB         6
1128
#define FF_IDCT_ARM          7
1129 05c4072b Michael Niedermayer
#define FF_IDCT_ALTIVEC      8
1130 b82cdc72 Michael Niedermayer
#define FF_IDCT_SH4          9
1131 bd7d1ea7 Alex Beregszaszi
#define FF_IDCT_SIMPLEARM    10
1132 0fa8158d Michael Niedermayer
#define FF_IDCT_H264         11
1133 2ad1516a Michael Niedermayer
1134 144f0625 Michael Niedermayer
    /**
1135 64863965 Michael Niedermayer
     * slice count.
1136
     * - encoding: set by lavc
1137
     * - decoding: set by user (or 0)
1138 144f0625 Michael Niedermayer
     */
1139
    int slice_count;
1140
    /**
1141 64863965 Michael Niedermayer
     * slice offsets in the frame in bytes.
1142
     * - encoding: set/allocated by lavc
1143
     * - decoding: set/allocated by user (or NULL)
1144 144f0625 Michael Niedermayer
     */
1145
    int *slice_offset;
1146
1147 4d2858de Michael Niedermayer
    /**
1148 64863965 Michael Niedermayer
     * error concealment flags.
1149
     * - encoding: unused
1150
     * - decoding: set by user
1151 4d2858de Michael Niedermayer
     */
1152
    int error_concealment;
1153
#define FF_EC_GUESS_MVS   1
1154
#define FF_EC_DEBLOCK     2
1155
1156 6b72ac63 Michael Niedermayer
    /**
1157 bec89a84 Zdenek Kabelac
     * dsp_mask could be add used to disable unwanted CPU features
1158 8350df97 Zdenek Kabelac
     * CPU features (i.e. MMX, SSE. ...)
1159 bec89a84 Zdenek Kabelac
     *
1160
     * with FORCE flag you may instead enable given CPU features
1161
     * (Dangerous: usable in case of misdetection, improper usage however will
1162
     * result into program crash)
1163
     */
1164
    unsigned dsp_mask;
1165
#define FF_MM_FORCE        0x80000000 /* force usage of selected flags (OR) */
1166
    /* lower 16 bits - CPU features */
1167
#ifdef HAVE_MMX
1168
#define FF_MM_MMX        0x0001 /* standard MMX */
1169
#define FF_MM_3DNOW        0x0004 /* AMD 3DNOW */
1170
#define FF_MM_MMXEXT        0x0002 /* SSE integer functions or AMD MMX ext */
1171
#define FF_MM_SSE        0x0008 /* SSE functions */
1172
#define FF_MM_SSE2        0x0010 /* PIV SSE2 functions */
1173 e42a152b Michael Niedermayer
#define FF_MM_3DNOWEXT        0x0020 /* AMD 3DNowExt */
1174 bec89a84 Zdenek Kabelac
#endif /* HAVE_MMX */
1175 11f18faf Michael Niedermayer
1176
    /**
1177 64863965 Michael Niedermayer
     * bits per sample/pixel from the demuxer (needed for huffyuv).
1178
     * - encoding: set by lavc
1179
     * - decoding: set by user
1180 11f18faf Michael Niedermayer
     */
1181
     int bits_per_sample;
1182
    
1183
    /**
1184 64863965 Michael Niedermayer
     * prediction method (needed for huffyuv).
1185
     * - encoding: set by user
1186
     * - decoding: unused
1187 11f18faf Michael Niedermayer
     */
1188
     int prediction_method;
1189
#define FF_PRED_LEFT   0
1190
#define FF_PRED_PLANE  1
1191
#define FF_PRED_MEDIAN 2
1192 5d3cea3a Michael Niedermayer
    
1193
    /**
1194 5ff85f1d Michael Niedermayer
     * sample aspect ratio (0 if unknown).
1195 1f26c6f3 Michael Niedermayer
     * numerator and denominator must be relative prime and smaller then 256 for some video standards
1196 64863965 Michael Niedermayer
     * - encoding: set by user.
1197
     * - decoding: set by lavc.
1198 5d3cea3a Michael Niedermayer
     */
1199 5ff85f1d Michael Niedermayer
    AVRational sample_aspect_ratio;
1200 1e491e29 Michael Niedermayer
1201
    /**
1202 64863965 Michael Niedermayer
     * the picture in the bitstream.
1203
     * - encoding: set by lavc
1204
     * - decoding: set by lavc
1205 1e491e29 Michael Niedermayer
     */
1206 492cd3a9 Michael Niedermayer
    AVFrame *coded_frame;
1207 c8c437bc Michael Niedermayer
1208
    /**
1209 64863965 Michael Niedermayer
     * debug.
1210
     * - encoding: set by user.
1211
     * - decoding: set by user.
1212 c8c437bc Michael Niedermayer
     */
1213
    int debug;
1214
#define FF_DEBUG_PICT_INFO 1
1215
#define FF_DEBUG_RC        2
1216
#define FF_DEBUG_BITSTREAM 4
1217
#define FF_DEBUG_MB_TYPE   8
1218
#define FF_DEBUG_QP        16
1219
#define FF_DEBUG_MV        32
1220 8289c6fa Wolfgang Hesseler
#define FF_DEBUG_DCT_COEFF 0x00000040
1221 41773b73 Michael Niedermayer
#define FF_DEBUG_SKIP      0x00000080
1222
#define FF_DEBUG_STARTCODE 0x00000100
1223
#define FF_DEBUG_PTS       0x00000200
1224 46b4feec Michael Niedermayer
#define FF_DEBUG_ER        0x00000400
1225 0da71265 Michael Niedermayer
#define FF_DEBUG_MMCO      0x00000800
1226 8fc6c2b5 Michael Niedermayer
#define FF_DEBUG_BUGS      0x00001000
1227 864119b6 Michael Niedermayer
#define FF_DEBUG_VIS_QP    0x00002000
1228
#define FF_DEBUG_VIS_MB_TYPE 0x00004000
1229 140cb663 Michael Niedermayer
    
1230
    /**
1231 0c9bbaec Wolfgang Hesseler
     * debug.
1232
     * - encoding: set by user.
1233
     * - decoding: set by user.
1234
     */
1235
    int debug_mv;
1236
#define FF_DEBUG_VIS_MV_P_FOR  0x00000001 //visualize forward predicted MVs of P frames
1237
#define FF_DEBUG_VIS_MV_B_FOR  0x00000002 //visualize forward predicted MVs of B frames
1238
#define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames
1239
1240
    /**
1241 64863965 Michael Niedermayer
     * error.
1242
     * - encoding: set by lavc if flags&CODEC_FLAG_PSNR
1243
     * - decoding: unused
1244 140cb663 Michael Niedermayer
     */
1245
    uint64_t error[4];
1246 17a70fde Michael Niedermayer
    
1247
    /**
1248 64863965 Michael Niedermayer
     * minimum MB quantizer.
1249
     * - encoding: set by user.
1250
     * - decoding: unused
1251 17a70fde Michael Niedermayer
     */
1252
    int mb_qmin;
1253
1254
    /**
1255 64863965 Michael Niedermayer
     * maximum MB quantizer.
1256
     * - encoding: set by user.
1257
     * - decoding: unused
1258 17a70fde Michael Niedermayer
     */
1259
    int mb_qmax;
1260 1457ab52 Michael Niedermayer
    
1261
    /**
1262 64863965 Michael Niedermayer
     * motion estimation compare function.
1263
     * - encoding: set by user.
1264
     * - decoding: unused
1265 1457ab52 Michael Niedermayer
     */
1266
    int me_cmp;
1267
    /**
1268 64863965 Michael Niedermayer
     * subpixel motion estimation compare function.
1269
     * - encoding: set by user.
1270
     * - decoding: unused
1271 1457ab52 Michael Niedermayer
     */
1272
    int me_sub_cmp;
1273
    /**
1274 64863965 Michael Niedermayer
     * macroblock compare function (not supported yet).
1275
     * - encoding: set by user.
1276
     * - decoding: unused
1277 1457ab52 Michael Niedermayer
     */
1278
    int mb_cmp;
1279 622348f9 Michael Niedermayer
    /**
1280
     * interlaced dct compare function
1281
     * - encoding: set by user.
1282
     * - decoding: unused
1283
     */
1284
    int ildct_cmp;
1285 1457ab52 Michael Niedermayer
#define FF_CMP_SAD  0
1286
#define FF_CMP_SSE  1
1287
#define FF_CMP_SATD 2
1288
#define FF_CMP_DCT  3
1289
#define FF_CMP_PSNR 4
1290
#define FF_CMP_BIT  5
1291
#define FF_CMP_RD   6
1292
#define FF_CMP_ZERO 7
1293 622348f9 Michael Niedermayer
#define FF_CMP_VSAD 8
1294
#define FF_CMP_VSSE 9
1295 e6a2ac34 Michael Niedermayer
#define FF_CMP_NSSE 10
1296 26efc54e Michael Niedermayer
#define FF_CMP_W53  11
1297
#define FF_CMP_W97  12
1298 0fd6aea1 Michael Niedermayer
#define FF_CMP_DCTMAX 13
1299 1457ab52 Michael Niedermayer
#define FF_CMP_CHROMA 256
1300
    
1301
    /**
1302 64863965 Michael Niedermayer
     * ME diamond size & shape.
1303
     * - encoding: set by user.
1304
     * - decoding: unused
1305 1457ab52 Michael Niedermayer
     */
1306
    int dia_size;
1307 b07a5980 Michael Niedermayer
1308
    /**
1309 64863965 Michael Niedermayer
     * amount of previous MV predictors (2a+1 x 2a+1 square).
1310
     * - encoding: set by user.
1311
     * - decoding: unused
1312 b07a5980 Michael Niedermayer
     */
1313
    int last_predictor_count;
1314 70ac76c0 Michael Niedermayer
1315 f5fb6b34 Michael Niedermayer
    /**
1316 64863965 Michael Niedermayer
     * pre pass for motion estimation.
1317
     * - encoding: set by user.
1318
     * - decoding: unused
1319 f5fb6b34 Michael Niedermayer
     */
1320
    int pre_me;
1321 b07a5980 Michael Niedermayer
1322 70ac76c0 Michael Niedermayer
    /**
1323 64863965 Michael Niedermayer
     * motion estimation pre pass compare function.
1324
     * - encoding: set by user.
1325
     * - decoding: unused
1326 70ac76c0 Michael Niedermayer
     */
1327
    int me_pre_cmp;
1328 826f429a Michael Niedermayer
1329 70ac76c0 Michael Niedermayer
    /**
1330 64863965 Michael Niedermayer
     * ME pre pass diamond size & shape.
1331
     * - encoding: set by user.
1332
     * - decoding: unused
1333 70ac76c0 Michael Niedermayer
     */
1334
    int pre_dia_size;
1335
1336 826f429a Michael Niedermayer
    /**
1337 64863965 Michael Niedermayer
     * subpel ME quality.
1338
     * - encoding: set by user.
1339
     * - decoding: unused
1340 826f429a Michael Niedermayer
     */
1341
    int me_subpel_quality;
1342
1343 a33c7159 Michael Niedermayer
    /**
1344 64863965 Michael Niedermayer
     * callback to negotiate the pixelFormat.
1345 a33c7159 Michael Niedermayer
     * @param fmt is the list of formats which are supported by the codec,
1346
     * its terminated by -1 as 0 is a valid format, the formats are ordered by quality
1347
     * the first is allways the native one
1348
     * @return the choosen format
1349 64863965 Michael Niedermayer
     * - encoding: unused
1350
     * - decoding: set by user, if not set then the native format will always be choosen
1351 a33c7159 Michael Niedermayer
     */
1352 494c56d3 Ivan Kalvachev
    enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt);
1353 e2f9490e Fabrice Bellard
1354
    /**
1355
     * DTG active format information (additionnal aspect ratio
1356
     * information only used in DVB MPEG2 transport streams). 0 if
1357
     * not set.
1358
     * 
1359 64863965 Michael Niedermayer
     * - encoding: unused.
1360
     * - decoding: set by decoder 
1361 e2f9490e Fabrice Bellard
     */
1362
    int dtg_active_format;
1363
#define FF_DTG_AFD_SAME         8
1364
#define FF_DTG_AFD_4_3          9
1365
#define FF_DTG_AFD_16_9         10
1366
#define FF_DTG_AFD_14_9         11
1367
#define FF_DTG_AFD_4_3_SP_14_9  13
1368
#define FF_DTG_AFD_16_9_SP_14_9 14
1369
#define FF_DTG_AFD_SP_4_3       15
1370
1371 ebbcdc9a Michael Niedermayer
    /**
1372
     * Maximum motion estimation search range in subpel units.
1373
     * if 0 then no limit
1374
     * 
1375 64863965 Michael Niedermayer
     * - encoding: set by user.
1376
     * - decoding: unused.
1377 ebbcdc9a Michael Niedermayer
     */
1378 59e0ac8e Zdenek Kabelac
    int me_range;
1379 ebbcdc9a Michael Niedermayer
1380 65f7062d Michael Niedermayer
    /**
1381
     * frame_rate_base.
1382
     * for variable fps this is 1
1383
     * - encoding: set by user.
1384
     * - decoding: set by lavc.
1385
     * @todo move this after frame_rate
1386
     */
1387
1388 1984f635 Michael Niedermayer
    int frame_rate_base;
1389
    /**
1390
     * intra quantizer bias.
1391
     * - encoding: set by user.
1392
     * - decoding: unused
1393
     */
1394
    int intra_quant_bias;
1395
#define FF_DEFAULT_QUANT_BIAS 999999
1396
    
1397
    /**
1398
     * inter quantizer bias.
1399
     * - encoding: set by user.
1400
     * - decoding: unused
1401
     */
1402
    int inter_quant_bias;
1403 5cd62665 Zdenek Kabelac
1404
    /**
1405
     * color table ID.
1406
     * - encoding: unused.
1407
     * - decoding: which clrtable should be used for 8bit RGB images
1408
     *             table have to be stored somewhere FIXME
1409
     */
1410
    int color_table_id;
1411 1984f635 Michael Niedermayer
    
1412 d90cf87b Michael Niedermayer
    /**
1413
     * internal_buffer count. 
1414
     * Dont touch, used by lavc default_get_buffer()
1415
     */
1416
    int internal_buffer_count;
1417
    
1418
    /**
1419
     * internal_buffers. 
1420
     * Dont touch, used by lavc default_get_buffer()
1421
     */
1422
    void *internal_buffer;
1423 158c7f05 Michael Niedermayer
1424
#define FF_LAMBDA_SHIFT 7
1425
#define FF_LAMBDA_SCALE (1<<FF_LAMBDA_SHIFT)
1426
#define FF_QP2LAMBDA 118 ///< factor to convert from H.263 QP to lambda
1427
#define FF_LAMBDA_MAX (256*128-1)
1428
1429
#define FF_QUALITY_SCALE FF_LAMBDA_SCALE //FIXME maybe remove
1430 3d2e8cce Michael Niedermayer
    /**
1431
     * global quality for codecs which cannot change it per frame.
1432
     * this should be proportional to MPEG1/2/4 qscale.
1433
     * - encoding: set by user.
1434
     * - decoding: unused
1435
     */
1436
    int global_quality;
1437 11e659c2 Michael Niedermayer
    
1438
#define FF_CODER_TYPE_VLC   0
1439
#define FF_CODER_TYPE_AC    1
1440
    /**
1441
     * coder type
1442
     * - encoding: set by user.
1443
     * - decoding: unused
1444
     */
1445
    int coder_type;
1446
1447
    /**
1448
     * context model
1449
     * - encoding: set by user.
1450
     * - decoding: unused
1451
     */
1452
    int context_model;
1453 3bb07d61 Michael Niedermayer
    
1454
    /**
1455
     * slice flags
1456
     * - encoding: unused
1457
     * - decoding: set by user.
1458
     */
1459
    int slice_flags;
1460
#define SLICE_FLAG_CODED_ORDER    0x0001 ///< draw_horiz_band() is called in coded order instead of display
1461
#define SLICE_FLAG_ALLOW_FIELD    0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics)
1462
#define SLICE_FLAG_ALLOW_PLANE    0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)
1463
1464 fb364ada Ivan Kalvachev
    /**
1465
     * XVideo Motion Acceleration
1466
     * - encoding: forbidden
1467
     * - decoding: set by decoder
1468
     */
1469
    int xvmc_acceleration;
1470 7d1c3fc1 Michael Niedermayer
    
1471
    /**
1472
     * macroblock decision mode
1473
     * - encoding: set by user.
1474
     * - decoding: unused
1475
     */
1476
    int mb_decision;
1477
#define FF_MB_DECISION_SIMPLE 0        ///< uses mb_cmp
1478
#define FF_MB_DECISION_BITS   1        ///< chooses the one which needs the fewest bits
1479
#define FF_MB_DECISION_RD     2        ///< rate distoration
1480 d6eb3c50 Michael Niedermayer
1481
    /**
1482
     * custom intra quantization matrix
1483
     * - encoding: set by user, can be NULL
1484
     * - decoding: set by lavc
1485
     */
1486
    uint16_t *intra_matrix;
1487
1488
    /**
1489
     * custom inter quantization matrix
1490
     * - encoding: set by user, can be NULL
1491
     * - decoding: set by lavc
1492
     */
1493
    uint16_t *inter_matrix;
1494 7d1c3fc1 Michael Niedermayer
    
1495 541ae140 Michael Niedermayer
    /**
1496
     * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
1497
     * this is used to workaround some encoder bugs
1498
     * - encoding: unused
1499
     * - decoding: set by user, will be converted to upper case by lavc during init
1500
     */
1501
    unsigned int stream_codec_tag;
1502 05fbd0a2 Michael Niedermayer
1503
    /**
1504
     * scene change detection threshold.
1505
     * 0 is default, larger means fewer detected scene changes
1506
     * - encoding: set by user.
1507
     * - decoding: unused
1508
     */
1509
    int scenechange_threshold;
1510 158c7f05 Michael Niedermayer
1511
    /**
1512
     * minimum lagrange multipler
1513
     * - encoding: set by user.
1514
     * - decoding: unused
1515
     */
1516
    int lmin;
1517
1518
    /**
1519
     * maximum lagrange multipler
1520
     * - encoding: set by user.
1521
     * - decoding: unused
1522
     */
1523
    int lmax;
1524 2a2bbcb0 Mike Melanson
1525
    /**
1526
     * Palette control structure
1527
     * - encoding: ??? (no palette-enabled encoder yet)
1528
     * - decoding: set by user.
1529
     */
1530
    struct AVPaletteControl *palctrl;
1531 821cb11f Michael Niedermayer
1532
    /**
1533
     * noise reduction strength
1534
     * - encoding: set by user.
1535
     * - decoding: unused
1536
     */
1537
    int noise_reduction;
1538 fa384dcc Michael Niedermayer
    
1539 074c4ca7 Roberto Togni
    /**
1540 e1c2a5a0 Roberto Togni
     * called at the beginning of a frame to get cr buffer for it.
1541
     * buffer type (size, hints) must be the same. lavc won't check it.
1542
     * lavc will pass previous buffer in pic, function should return
1543
     * same buffer or new buffer with old frame "painted" into it.
1544
     * if pic.data[0] == NULL must behave like get_buffer().
1545 074c4ca7 Roberto Togni
     * - encoding: unused
1546 e1c2a5a0 Roberto Togni
     * - decoding: set by lavc, user can override
1547 074c4ca7 Roberto Togni
     */
1548 e1c2a5a0 Roberto Togni
    int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic);
1549 ba58dabc Michael Niedermayer
1550
    /**
1551
     * number of bits which should be loaded into the rc buffer before decoding starts
1552
     * - encoding: set by user.
1553
     * - decoding: unused
1554
     */
1555
    int rc_initial_buffer_occupancy;
1556
1557
    /**
1558
     *
1559
     * - encoding: set by user.
1560
     * - decoding: unused
1561
     */
1562
    int inter_threshold;
1563
1564
    /**
1565
     * CODEC_FLAG2_*.
1566
     * - encoding: set by user.
1567
     * - decoding: set by user.
1568
     */
1569
    int flags2;
1570 7ebfc0ea Michael Niedermayer
1571
    /**
1572
     * simulates errors in the bitstream to test error concealment.
1573
     * - encoding: set by user.
1574
     * - decoding: unused.
1575
     */
1576
    int error_rate;
1577 a1e257b2 Michael Niedermayer
    
1578
    /**
1579
     * MP3 antialias algorithm, see FF_AA_* below.
1580
     * - encoding: unused
1581
     * - decoding: set by user
1582
     */
1583
    int antialias_algo;
1584
#define FF_AA_AUTO    0
1585
#define FF_AA_FASTINT 1 //not implemented yet
1586
#define FF_AA_INT     2
1587
#define FF_AA_FLOAT   3
1588 77ea0d4b Michael Niedermayer
    /**
1589
     * Quantizer noise shaping.
1590
     * - encoding: set by user
1591
     * - decoding: unused
1592
     */
1593
    int quantizer_noise_shaping;
1594 9c3d33d6 Michael Niedermayer
1595
    /**
1596
     * Thread count.
1597
     * is used to decide how many independant tasks should be passed to execute()
1598
     * - encoding: set by user
1599
     * - decoding: set by user
1600
     */
1601
    int thread_count;
1602
    
1603
    /**
1604
     * the codec may call this to execute several independant things. it will return only after
1605
     * finishing all tasks, the user may replace this with some multithreaded implementation, the
1606
     * default implementation will execute the parts serially
1607 399cec2f Michael Niedermayer
     * @param count the number of things to execute
1608 9c3d33d6 Michael Niedermayer
     * - encoding: set by lavc, user can override
1609
     * - decoding: set by lavc, user can override
1610
     */
1611
    int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void **arg2, int *ret, int count);
1612
    
1613
    /**
1614
     * Thread opaque.
1615
     * can be used by execute() to store some per AVCodecContext stuff.
1616
     * - encoding: set by execute()
1617
     * - decoding: set by execute()
1618
     */
1619
    void *thread_opaque;
1620 a4d36c11 Michael Niedermayer
1621
    /**
1622 f20f8a8b Michael Niedermayer
     * Motion estimation threshold. under which no motion estimation is 
1623
     * performed, but instead the user specified motion vectors are used
1624 a4d36c11 Michael Niedermayer
     * 
1625
     * - encoding: set by user
1626 f20f8a8b Michael Niedermayer
     * - decoding: unused
1627 a4d36c11 Michael Niedermayer
     */
1628 2750b827 Michael Niedermayer
     int me_threshold;
1629 f20f8a8b Michael Niedermayer
1630
    /**
1631
     * Macroblock threshold. under which the user specified macroblock types will be used
1632
     * - encoding: set by user
1633
     * - decoding: unused
1634
     */
1635
     int mb_threshold;
1636 bf266e19 Michael Niedermayer
1637
    /**
1638 d4c5d2ad Michael Niedermayer
     * precision of the intra dc coefficient - 8.
1639 bf266e19 Michael Niedermayer
     * - encoding: set by user
1640
     * - decoding: unused
1641
     */
1642
     int intra_dc_precision;
1643 d4c5d2ad Michael Niedermayer
1644
    /**
1645
     * noise vs. sse weight for the nsse comparsion function.
1646
     * - encoding: set by user
1647
     * - decoding: unused
1648
     */
1649
     int nsse_weight;
1650 0dfd33c3 Michael Niedermayer
1651
    /**
1652
     * number of macroblock rows at the top which are skiped.
1653
     * - encoding: unused
1654
     * - decoding: set by user
1655
     */
1656
     int skip_top;
1657
1658
    /**
1659
     * number of macroblock rows at the bottom which are skiped.
1660
     * - encoding: unused
1661
     * - decoding: set by user
1662
     */
1663
     int skip_bottom;
1664 baced9f5 Michael Niedermayer
1665
    /**
1666
     * profile
1667
     * - encoding: set by user
1668
     * - decoding: set by lavc
1669
     */
1670
     int profile;
1671
#define FF_PROFILE_UNKNOWN -99
1672
1673
    /**
1674
     * level
1675
     * - encoding: set by user
1676
     * - decoding: set by lavc
1677
     */
1678
     int level;
1679
#define FF_LEVEL_UNKNOWN -99
1680 178fcca8 Michael Niedermayer
1681
    /**
1682
     * low resolution decoding. 1-> 1/2 size, 2->1/4 size
1683
     * - encoding: unused
1684
     * - decoding: set by user
1685
     */
1686
     int lowres;
1687 21adafec Michael Niedermayer
1688
    /**
1689 bbf18b21 Michael Niedermayer
     * bitsream width / height. may be different from width/height if lowres
1690 21adafec Michael Niedermayer
     * or other things are used
1691
     * - encoding: unused
1692
     * - decoding: set by user before init if known, codec should override / dynamically change if needed
1693
     */
1694
    int coded_width, coded_height;
1695 bbf18b21 Michael Niedermayer
1696
    /**
1697
     * frame skip threshold
1698
     * - encoding: set by user
1699
     * - decoding: unused
1700
     */
1701
    int frame_skip_threshold;
1702
1703
    /**
1704
     * frame skip factor
1705
     * - encoding: set by user
1706
     * - decoding: unused
1707
     */
1708
    int frame_skip_factor;
1709 0fd6aea1 Michael Niedermayer
1710
    /**
1711
     * frame skip exponent
1712
     * - encoding: set by user
1713
     * - decoding: unused
1714
     */
1715
    int frame_skip_exp;
1716
1717
    /**
1718
     * frame skip comparission function
1719
     * - encoding: set by user.
1720
     * - decoding: unused
1721
     */
1722
    int frame_skip_cmp;
1723 de6d9b64 Fabrice Bellard
} AVCodecContext;
1724
1725 97d96aaa Zdenek Kabelac
1726 64863965 Michael Niedermayer
/**
1727
 * AVOption.
1728
 */
1729 97d96aaa Zdenek Kabelac
typedef struct AVOption {
1730
    /** options' name */
1731
    const char *name; /* if name is NULL, it indicates a link to next */
1732 bec89a84 Zdenek Kabelac
    /** short English text help or const struct AVOption* subpointer */
1733
    const char *help; //        const struct AVOption* sub;
1734 97d96aaa Zdenek Kabelac
    /** offset to context structure where the parsed value should be stored */
1735
    int offset;
1736
    /** options' type */
1737
    int type;
1738 64863965 Michael Niedermayer
#define FF_OPT_TYPE_BOOL 1      ///< boolean - true,1,on  (or simply presence)
1739
#define FF_OPT_TYPE_DOUBLE 2    ///< double
1740
#define FF_OPT_TYPE_INT 3       ///< integer
1741
#define FF_OPT_TYPE_STRING 4    ///< string (finished with \0)
1742
#define FF_OPT_TYPE_MASK 0x1f        ///< mask for types - upper bits are various flags
1743 97d96aaa Zdenek Kabelac
//#define FF_OPT_TYPE_EXPERT 0x20 // flag for expert option
1744
#define FF_OPT_TYPE_FLAG (FF_OPT_TYPE_BOOL | 0x40)
1745
#define FF_OPT_TYPE_RCOVERRIDE (FF_OPT_TYPE_STRING | 0x80)
1746
    /** min value  (min == max   ->  no limits) */
1747
    double min;
1748
    /** maximum value for double/int */
1749
    double max;
1750
    /** default boo [0,1]l/double/int value */
1751
    double defval;
1752
    /**
1753
     * default string value (with optional semicolon delimited extra option-list
1754
     * i.e.   option1;option2;option3
1755
     * defval might select other then first argument as default
1756
     */
1757
    const char *defstr;
1758
#define FF_OPT_MAX_DEPTH 10
1759
} AVOption;
1760
1761 64863965 Michael Niedermayer
/**
1762 bec89a84 Zdenek Kabelac
 * Parse option(s) and sets fields in passed structure
1763
 * @param strct        structure where the parsed results will be written
1764
 * @param list  list with AVOptions
1765
 * @param opts        string with options for parsing
1766
 */
1767
int avoption_parse(void* strct, const AVOption* list, const char* opts);
1768
1769
1770
/**
1771 64863965 Michael Niedermayer
 * AVCodec.
1772
 */
1773 de6d9b64 Fabrice Bellard
typedef struct AVCodec {
1774 18f77016 Zdenek Kabelac
    const char *name;
1775 5d234974 Zdenek Kabelac
    enum CodecType type;
1776 9297ddd3 Michael Niedermayer
    enum CodecID id;
1777 de6d9b64 Fabrice Bellard
    int priv_data_size;
1778
    int (*init)(AVCodecContext *);
1779 0c1a9eda Zdenek Kabelac
    int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
1780 de6d9b64 Fabrice Bellard
    int (*close)(AVCodecContext *);
1781 0fd90455 Michael Niedermayer
    int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
1782 0c1a9eda Zdenek Kabelac
                  uint8_t *buf, int buf_size);
1783 bf89e6b1 Fabrice Bellard
    int capabilities;
1784 97d96aaa Zdenek Kabelac
    const AVOption *options;
1785 de6d9b64 Fabrice Bellard
    struct AVCodec *next;
1786 7a06ff14 Michael Niedermayer
    void (*flush)(AVCodecContext *);
1787 b0df362b Zdenek Kabelac
    const AVRational *supported_framerates; ///array of supported framerates, or NULL if any, array is terminated by {0,0}
1788 fcee0164 Michael Niedermayer
    const enum PixelFormat *pix_fmts;       ///array of supported pixel formats, or NULL if unknown, array is terminanted by -1
1789 de6d9b64 Fabrice Bellard
} AVCodec;
1790
1791 97d96aaa Zdenek Kabelac
/**
1792 d7425f59 Michael Niedermayer
 * four components are given, that's all.
1793
 * the last component is alpha
1794
 */
1795 de6d9b64 Fabrice Bellard
typedef struct AVPicture {
1796 0c1a9eda Zdenek Kabelac
    uint8_t *data[4];
1797 cd394651 Michael Niedermayer
    int linesize[4];       ///< number of bytes per line
1798 de6d9b64 Fabrice Bellard
} AVPicture;
1799
1800 ba118447 Mike Melanson
/**
1801
 * AVPaletteControl
1802
 * This structure defines a method for communicating palette changes
1803
 * between and demuxer and a decoder.
1804
 */
1805 2e99641b Roberto Togni
#define AVPALETTE_SIZE 1024
1806 432d84c3 Michael Niedermayer
#define AVPALETTE_COUNT 256
1807 ba118447 Mike Melanson
typedef struct AVPaletteControl {
1808
1809
    /* demuxer sets this to 1 to indicate the palette has changed;
1810
     * decoder resets to 0 */
1811
    int palette_changed;
1812
1813 2a2bbcb0 Mike Melanson
    /* 4-byte ARGB palette entries, stored in native byte order; note that
1814
     * the individual palette components should be on a 8-bit scale; if
1815
     * the palette data comes from a IBM VGA native format, the component
1816
     * data is probably 6 bits in size and needs to be scaled */
1817 2e99641b Roberto Togni
    unsigned int palette[AVPALETTE_COUNT];
1818 ba118447 Mike Melanson
1819
} AVPaletteControl;
1820
1821 de6d9b64 Fabrice Bellard
extern AVCodec ac3_encoder;
1822
extern AVCodec mp2_encoder;
1823 9d36bdc9 Juanjo
extern AVCodec mp3lame_encoder;
1824 81e0d0b4 Mark Hills
extern AVCodec oggvorbis_encoder;
1825 29d48296 Michael Niedermayer
extern AVCodec faac_encoder;
1826 1ddadfa9 Adam Thayer
extern AVCodec xvid_encoder;
1827 de6d9b64 Fabrice Bellard
extern AVCodec mpeg1video_encoder;
1828 029911d1 Michael Niedermayer
extern AVCodec mpeg2video_encoder;
1829 1c3990db Michael Niedermayer
extern AVCodec h261_encoder;
1830 de6d9b64 Fabrice Bellard
extern AVCodec h263_encoder;
1831
extern AVCodec h263p_encoder;
1832 d4f5d74a Garrick Meeker
extern AVCodec flv_encoder;
1833 de6d9b64 Fabrice Bellard
extern AVCodec rv10_encoder;
1834 68b94c35 Michael Niedermayer
extern AVCodec rv20_encoder;
1835 6faa4645 Roman Shaposhnik
extern AVCodec dvvideo_encoder;
1836 de6d9b64 Fabrice Bellard
extern AVCodec mjpeg_encoder;
1837 b1e6b355 Michael Niedermayer
extern AVCodec ljpeg_encoder;
1838 4eff7cf4 Michael Niedermayer
extern AVCodec png_encoder;
1839 5b6d5596 Michael Niedermayer
extern AVCodec ppm_encoder;
1840
extern AVCodec pgm_encoder;
1841
extern AVCodec pgmyuv_encoder;
1842
extern AVCodec pbm_encoder;
1843
extern AVCodec pam_encoder;
1844 bf89e6b1 Fabrice Bellard
extern AVCodec mpeg4_encoder;
1845 84afee34 Michael Niedermayer
extern AVCodec msmpeg4v1_encoder;
1846
extern AVCodec msmpeg4v2_encoder;
1847
extern AVCodec msmpeg4v3_encoder;
1848 0151a6f5 Michael Niedermayer
extern AVCodec wmv1_encoder;
1849
extern AVCodec wmv2_encoder;
1850 11f18faf Michael Niedermayer
extern AVCodec huffyuv_encoder;
1851 f37b9768 Loren Merritt
extern AVCodec ffvhuff_encoder;
1852 0da71265 Michael Niedermayer
extern AVCodec h264_encoder;
1853 3d2e8cce Michael Niedermayer
extern AVCodec asv1_encoder;
1854 9b56edf5 Michael Niedermayer
extern AVCodec asv2_encoder;
1855 be3564ed Michael Niedermayer
extern AVCodec vcr1_encoder;
1856 5e20f836 Michael Niedermayer
extern AVCodec ffv1_encoder;
1857 791e7b83 Michael Niedermayer
extern AVCodec snow_encoder;
1858 c3bf0288 Michael Niedermayer
extern AVCodec mdec_encoder;
1859 a273bbfb Roberto Togni
extern AVCodec zlib_encoder;
1860 54f5fd22 Alex Beregszaszi
extern AVCodec sonic_encoder;
1861
extern AVCodec sonic_ls_encoder;
1862 3b64893d Mike Melanson
extern AVCodec svq1_encoder;
1863 de6d9b64 Fabrice Bellard
1864
extern AVCodec h263_decoder;
1865 c6148de2 Michael Niedermayer
extern AVCodec h261_decoder;
1866 bf89e6b1 Fabrice Bellard
extern AVCodec mpeg4_decoder;
1867 84afee34 Michael Niedermayer
extern AVCodec msmpeg4v1_decoder;
1868
extern AVCodec msmpeg4v2_decoder;
1869
extern AVCodec msmpeg4v3_decoder;
1870 e1a9dbff Michael Niedermayer
extern AVCodec wmv1_decoder;
1871 0151a6f5 Michael Niedermayer
extern AVCodec wmv2_decoder;
1872 922bc38d Michael Niedermayer
extern AVCodec mpeg1video_decoder;
1873
extern AVCodec mpeg2video_decoder;
1874 c512b303 Ivan Kalvachev
extern AVCodec mpegvideo_decoder;
1875 fb364ada Ivan Kalvachev
extern AVCodec mpeg_xvmc_decoder;
1876 de6d9b64 Fabrice Bellard
extern AVCodec h263i_decoder;
1877 d4f5d74a Garrick Meeker
extern AVCodec flv_decoder;
1878 de6d9b64 Fabrice Bellard
extern AVCodec rv10_decoder;
1879 68b94c35 Michael Niedermayer
extern AVCodec rv20_decoder;
1880 be8ffec9 Nick Kurshev
extern AVCodec svq1_decoder;
1881 8b82a956 Michael Niedermayer
extern AVCodec svq3_decoder;
1882 020fcc94 Fabrice Bellard
extern AVCodec dvvideo_decoder;
1883 bc8d1857 Fabrice Bellard
extern AVCodec wmav1_decoder;
1884
extern AVCodec wmav2_decoder;
1885 4e66ab3b Fabrice Bellard
extern AVCodec mjpeg_decoder;
1886 b135d9fb Alex Beregszaszi
extern AVCodec mjpegb_decoder;
1887 5e83dec4 Alex Beregszaszi
extern AVCodec sp5x_decoder;
1888 4eff7cf4 Michael Niedermayer
extern AVCodec png_decoder;
1889 4b1f4f23 Juanjo
extern AVCodec mp2_decoder;
1890 a96b68b7 Fabrice Bellard
extern AVCodec mp3_decoder;
1891 3f95e843 François Revol
extern AVCodec mace3_decoder;
1892
extern AVCodec mace6_decoder;
1893 11f18faf Michael Niedermayer
extern AVCodec huffyuv_decoder;
1894 f37b9768 Loren Merritt
extern AVCodec ffvhuff_decoder;
1895 3aca208a Mark Hills
extern AVCodec oggvorbis_decoder;
1896 f70f7c6d Michael Niedermayer
extern AVCodec cyuv_decoder;
1897 0da71265 Michael Niedermayer
extern AVCodec h264_decoder;
1898 deabd4fd Mike Melanson
extern AVCodec indeo3_decoder;
1899 d86053a4 Mike Melanson
extern AVCodec vp3_decoder;
1900 f44ee2c3 Alex Beregszaszi
extern AVCodec theora_decoder;
1901 891f64b3 joca@rixmail.se
extern AVCodec amr_nb_decoder;
1902 bc634f6f Zdenek Kabelac
extern AVCodec amr_nb_encoder;
1903 d663a1fd Michael Niedermayer
extern AVCodec amr_wb_encoder;
1904
extern AVCodec amr_wb_decoder;
1905 280bd7b7 Zdenek Kabelac
extern AVCodec aac_decoder;
1906
extern AVCodec mpeg4aac_decoder;
1907 3d2e8cce Michael Niedermayer
extern AVCodec asv1_decoder;
1908 9b56edf5 Michael Niedermayer
extern AVCodec asv2_decoder;
1909 be3564ed Michael Niedermayer
extern AVCodec vcr1_decoder;
1910 3aff069b Alex Beregszaszi
extern AVCodec cljr_decoder;
1911 5e20f836 Michael Niedermayer
extern AVCodec ffv1_decoder;
1912 791e7b83 Michael Niedermayer
extern AVCodec snow_decoder;
1913 8809cfee Michael Niedermayer
extern AVCodec fourxm_decoder;
1914 c3bf0288 Michael Niedermayer
extern AVCodec mdec_decoder;
1915 3ef8be2b Mike Melanson
extern AVCodec roq_decoder;
1916
extern AVCodec interplay_video_decoder;
1917 9937e686 Mike Melanson
extern AVCodec xan_wc3_decoder;
1918 2fdf638b Mike Melanson
extern AVCodec rpza_decoder;
1919
extern AVCodec cinepak_decoder;
1920
extern AVCodec msrle_decoder;
1921
extern AVCodec msvideo1_decoder;
1922 6955a882 Mike Melanson
extern AVCodec vqa_decoder;
1923 4120a53a Mike Melanson
extern AVCodec idcin_decoder;
1924 1dc1ed99 Roberto Togni
extern AVCodec eightbps_decoder;
1925 11e29a41 Mike Melanson
extern AVCodec smc_decoder;
1926 42cad81a Mike Melanson
extern AVCodec flic_decoder;
1927 fafa0b75 Mike Melanson
extern AVCodec vmdvideo_decoder;
1928
extern AVCodec vmdaudio_decoder;
1929 9a4117d5 Mike Melanson
extern AVCodec truemotion1_decoder;
1930 a273bbfb Roberto Togni
extern AVCodec mszh_decoder;
1931
extern AVCodec zlib_decoder;
1932 b8414bbd Nick Kurshev
extern AVCodec ra_144_decoder;
1933
extern AVCodec ra_288_decoder;
1934 3ef8be2b Mike Melanson
extern AVCodec roq_dpcm_decoder;
1935
extern AVCodec interplay_dpcm_decoder;
1936 9937e686 Mike Melanson
extern AVCodec xan_dpcm_decoder;
1937 d08d7142 Mike Melanson
extern AVCodec sol_dpcm_decoder;
1938 54f5fd22 Alex Beregszaszi
extern AVCodec sonic_decoder;
1939 070ed1bc Mike Melanson
extern AVCodec qtrle_decoder;
1940 ac2570a8 Michael Niedermayer
extern AVCodec flac_decoder;
1941 9d53d58e Mike Melanson
extern AVCodec tscc_decoder;
1942 d0a0bbd2 Mike Melanson
extern AVCodec ulti_decoder;
1943 d08d7142 Mike Melanson
extern AVCodec qdraw_decoder;
1944 ab711b3c Mike Melanson
extern AVCodec xl_decoder;
1945 acfd8f0f Mike Melanson
extern AVCodec qpeg_decoder;
1946 de6d9b64 Fabrice Bellard
1947 a96b68b7 Fabrice Bellard
/* pcm codecs */
1948
#define PCM_CODEC(id, name) \
1949
extern AVCodec name ## _decoder; \
1950 f11d3f23 Michael Niedermayer
extern AVCodec name ## _encoder
1951 a96b68b7 Fabrice Bellard
1952
PCM_CODEC(CODEC_ID_PCM_S16LE, pcm_s16le);
1953
PCM_CODEC(CODEC_ID_PCM_S16BE, pcm_s16be);
1954
PCM_CODEC(CODEC_ID_PCM_U16LE, pcm_u16le);
1955
PCM_CODEC(CODEC_ID_PCM_U16BE, pcm_u16be);
1956
PCM_CODEC(CODEC_ID_PCM_S8, pcm_s8);
1957
PCM_CODEC(CODEC_ID_PCM_U8, pcm_u8);
1958
PCM_CODEC(CODEC_ID_PCM_ALAW, pcm_alaw);
1959
PCM_CODEC(CODEC_ID_PCM_MULAW, pcm_mulaw);
1960
1961 0147f198 François Revol
/* adpcm codecs */
1962
1963
PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
1964
PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
1965 9937e686 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_IMA_DK3, adpcm_ima_dk3);
1966
PCM_CODEC(CODEC_ID_ADPCM_IMA_DK4, adpcm_ima_dk4);
1967 2fdf638b Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_IMA_WS, adpcm_ima_ws);
1968 7d8379f2 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_SMJPEG, adpcm_ima_smjpeg);
1969 0147f198 François Revol
PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);
1970 4b465299 Michael Niedermayer
PCM_CODEC(CODEC_ID_ADPCM_4XM, adpcm_4xm);
1971 fc384777 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_XA, adpcm_xa);
1972
PCM_CODEC(CODEC_ID_ADPCM_ADX, adpcm_adx);
1973 7d8379f2 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_EA, adpcm_ea);
1974 e5966052 Roman Shaposhnik
PCM_CODEC(CODEC_ID_ADPCM_G726, adpcm_g726);
1975 b3bfb299 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_CT, adpcm_ct);
1976 0147f198 François Revol
1977 a96b68b7 Fabrice Bellard
#undef PCM_CODEC
1978
1979
/* dummy raw video codec */
1980 63167088 Roman Shaposhnik
extern AVCodec rawvideo_encoder;
1981
extern AVCodec rawvideo_decoder;
1982 de6d9b64 Fabrice Bellard
1983
/* the following codecs use external GPL libs */
1984
extern AVCodec ac3_decoder;
1985 23c99253 Michael Niedermayer
extern AVCodec dts_decoder;
1986 de6d9b64 Fabrice Bellard
1987
/* resample.c */
1988
1989
struct ReSampleContext;
1990 aaaf1635 Michael Niedermayer
struct AVResampleContext;
1991 de6d9b64 Fabrice Bellard
1992
typedef struct ReSampleContext ReSampleContext;
1993
1994
ReSampleContext *audio_resample_init(int output_channels, int input_channels, 
1995
                                     int output_rate, int input_rate);
1996
int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
1997
void audio_resample_close(ReSampleContext *s);
1998
1999 6e225de2 Michael Niedermayer
struct AVResampleContext *av_resample_init(int out_rate, int in_rate, int filter_length, int log2_phase_count, int linear, double cutoff);
2000 aaaf1635 Michael Niedermayer
int av_resample(struct AVResampleContext *c, short *dst, short *src, int *consumed, int src_size, int dst_size, int update_ctx);
2001 2d48eddd Michael Niedermayer
void av_resample_compensate(struct AVResampleContext *c, int sample_delta, int compensation_distance);
2002 d88443ae William Juwono
void av_resample_close(struct AVResampleContext *c);
2003 aaaf1635 Michael Niedermayer
2004 de6d9b64 Fabrice Bellard
/* YUV420 format is assumed ! */
2005
2006
struct ImgReSampleContext;
2007
2008
typedef struct ImgReSampleContext ImgReSampleContext;
2009
2010
ImgReSampleContext *img_resample_init(int output_width, int output_height,
2011
                                      int input_width, int input_height);
2012 ab6d194a Michael Niedermayer
2013
ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
2014
                                      int iwidth, int iheight,
2015
                                      int topBand, int bottomBand,
2016 1ff93ffc Todd Kirby
                                      int leftBand, int rightBand,
2017
                                      int padtop, int padbottom,
2018
                                      int padleft, int padright);
2019
2020 ab6d194a Michael Niedermayer
2021 de6d9b64 Fabrice Bellard
void img_resample(ImgReSampleContext *s, 
2022 da64ecc3 Drew Hess
                  AVPicture *output, const AVPicture *input);
2023 de6d9b64 Fabrice Bellard
2024
void img_resample_close(ImgReSampleContext *s);
2025
2026 75917b88 Drew Hess
/**
2027
 * Allocate memory for a picture.  Call avpicture_free to free it.
2028
 *
2029
 * @param picture the picture to be filled in.
2030
 * @param pix_fmt the format of the picture.
2031
 * @param width the width of the picture.
2032
 * @param height the height of the picture.
2033
 * @return 0 if successful, -1 if not.
2034
 */
2035
int avpicture_alloc(AVPicture *picture, int pix_fmt, int width, int height);
2036
2037
/* Free a picture previously allocated by avpicture_alloc. */
2038
void avpicture_free(AVPicture *picture);
2039
2040 0c1a9eda Zdenek Kabelac
int avpicture_fill(AVPicture *picture, uint8_t *ptr,
2041 2d1a4094 Fabrice Bellard
                   int pix_fmt, int width, int height);
2042 da64ecc3 Drew Hess
int avpicture_layout(const AVPicture* src, int pix_fmt, int width, int height,
2043 63167088 Roman Shaposhnik
                     unsigned char *dest, int dest_size);
2044 219b06c6 Fabrice Bellard
int avpicture_get_size(int pix_fmt, int width, int height);
2045 dab64ebc Fabrice Bellard
void avcodec_get_chroma_sub_sample(int pix_fmt, int *h_shift, int *v_shift);
2046
const char *avcodec_get_pix_fmt_name(int pix_fmt);
2047 21adafec Michael Niedermayer
void avcodec_set_dimensions(AVCodecContext *s, int width, int height);
2048 63167088 Roman Shaposhnik
enum PixelFormat avcodec_get_pix_fmt(const char* name);
2049 d07730dd Michael Niedermayer
unsigned int avcodec_pix_fmt_to_codec_tag(enum PixelFormat p);
2050 219b06c6 Fabrice Bellard
2051 fab21997 Fabrice Bellard
#define FF_LOSS_RESOLUTION  0x0001 /* loss due to resolution change */
2052
#define FF_LOSS_DEPTH       0x0002 /* loss due to color depth change */
2053
#define FF_LOSS_COLORSPACE  0x0004 /* loss due to color space conversion */
2054
#define FF_LOSS_ALPHA       0x0008 /* loss of alpha bits */
2055
#define FF_LOSS_COLORQUANT  0x0010 /* loss due to color quantization */
2056
#define FF_LOSS_CHROMA      0x0020 /* loss of chroma (e.g. rgb to gray conversion) */
2057
2058
int avcodec_get_pix_fmt_loss(int dst_pix_fmt, int src_pix_fmt,
2059
                             int has_alpha);
2060
int avcodec_find_best_pix_fmt(int pix_fmt_mask, int src_pix_fmt,
2061
                              int has_alpha, int *loss_ptr);
2062
2063 0469baf1 Fabrice Bellard
#define FF_ALPHA_TRANSP       0x0001 /* image has some totally transparent pixels */
2064
#define FF_ALPHA_SEMI_TRANSP  0x0002 /* image has some transparent pixels */
2065 da64ecc3 Drew Hess
int img_get_alpha_info(const AVPicture *src,
2066
                       int pix_fmt, int width, int height);
2067 0469baf1 Fabrice Bellard
2068 219b06c6 Fabrice Bellard
/* convert among pixel formats */
2069
int img_convert(AVPicture *dst, int dst_pix_fmt,
2070 da64ecc3 Drew Hess
                const AVPicture *src, int pix_fmt, 
2071 219b06c6 Fabrice Bellard
                int width, int height);
2072
2073
/* deinterlace a picture */
2074 da64ecc3 Drew Hess
int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
2075 de6d9b64 Fabrice Bellard
                          int pix_fmt, int width, int height);
2076
2077
/* external high level API */
2078
2079
extern AVCodec *first_avcodec;
2080
2081 156e5023 Nick Kurshev
/* returns LIBAVCODEC_VERSION_INT constant */
2082 51a49663 Fabrice Bellard
unsigned avcodec_version(void);
2083 8bceb6af Nick Kurshev
/* returns LIBAVCODEC_BUILD constant */
2084 51a49663 Fabrice Bellard
unsigned avcodec_build(void);
2085 de6d9b64 Fabrice Bellard
void avcodec_init(void);
2086
2087
void register_avcodec(AVCodec *format);
2088
AVCodec *avcodec_find_encoder(enum CodecID id);
2089 98f3b098 Arpi
AVCodec *avcodec_find_encoder_by_name(const char *name);
2090 de6d9b64 Fabrice Bellard
AVCodec *avcodec_find_decoder(enum CodecID id);
2091
AVCodec *avcodec_find_decoder_by_name(const char *name);
2092
void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
2093
2094 1e491e29 Michael Niedermayer
void avcodec_get_context_defaults(AVCodecContext *s);
2095 7ffbb60e Falk Hüffner
AVCodecContext *avcodec_alloc_context(void);
2096 7906085f Falk Hüffner
void avcodec_get_frame_defaults(AVFrame *pic);
2097 492cd3a9 Michael Niedermayer
AVFrame *avcodec_alloc_frame(void);
2098 1e491e29 Michael Niedermayer
2099 492cd3a9 Michael Niedermayer
int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
2100
void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
2101 3a569751 Michael Niedermayer
int avcodec_default_reget_buffer(AVCodecContext *s, AVFrame *pic);
2102
void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height);
2103
enum PixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum PixelFormat * fmt);
2104 1e491e29 Michael Niedermayer
2105 5a815088 Michael Niedermayer
int avcodec_thread_init(AVCodecContext *s, int thread_count);
2106
void avcodec_thread_free(AVCodecContext *s);
2107
int avcodec_thread_execute(AVCodecContext *s, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
2108 3a569751 Michael Niedermayer
int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
2109 9c3d33d6 Michael Niedermayer
//FIXME func typedef
2110
2111 7a06ff14 Michael Niedermayer
/**
2112
 * opens / inits the AVCodecContext.
2113
 * not thread save!
2114
 */
2115 de6d9b64 Fabrice Bellard
int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
2116 7a06ff14 Michael Niedermayer
2117 0c1a9eda Zdenek Kabelac
int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples, 
2118 de6d9b64 Fabrice Bellard
                         int *frame_size_ptr,
2119 0c1a9eda Zdenek Kabelac
                         uint8_t *buf, int buf_size);
2120 492cd3a9 Michael Niedermayer
int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture, 
2121 de6d9b64 Fabrice Bellard
                         int *got_picture_ptr,
2122 0c1a9eda Zdenek Kabelac
                         uint8_t *buf, int buf_size);
2123
int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata, 
2124 917e06c8 Fabrice Bellard
                        int *data_size_ptr,
2125 0c1a9eda Zdenek Kabelac
                        uint8_t *buf, int buf_size);
2126
int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size, 
2127 de6d9b64 Fabrice Bellard
                         const short *samples);
2128 0c1a9eda Zdenek Kabelac
int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size, 
2129 492cd3a9 Michael Niedermayer
                         const AVFrame *pict);
2130 de6d9b64 Fabrice Bellard
2131
int avcodec_close(AVCodecContext *avctx);
2132
2133
void avcodec_register_all(void);
2134 a96b68b7 Fabrice Bellard
2135 1c2a8c7f Michael Niedermayer
void avcodec_flush_buffers(AVCodecContext *avctx);
2136
2137 14bea432 Michael Niedermayer
/* misc usefull functions */
2138 d8085ea7 Michael Niedermayer
2139
/**
2140
 * returns a single letter to describe the picture type
2141
 */
2142
char av_get_pict_type_char(int pict_type);
2143
2144 14bea432 Michael Niedermayer
/**
2145
 * reduce a fraction.
2146
 * this is usefull for framerate calculations
2147
 * @param max the maximum allowed for dst_nom & dst_den
2148
 * @return 1 if exact, 0 otherwise
2149
 */
2150
int av_reduce(int *dst_nom, int *dst_den, int64_t nom, int64_t den, int64_t max);
2151
2152
/**
2153 1f018225 Michael Niedermayer
 * rescale a 64bit integer with rounding to nearest.
2154 14bea432 Michael Niedermayer
 * a simple a*b/c isnt possible as it can overflow
2155
 */
2156 4c263142 Michael Niedermayer
int64_t av_rescale(int64_t a, int64_t b, int64_t c);
2157 628d601b Zdenek Kabelac
2158 1f018225 Michael Niedermayer
/**
2159
 * rescale a 64bit integer with specified rounding.
2160
 * a simple a*b/c isnt possible as it can overflow
2161
 */
2162
int64_t av_rescale_rnd(int64_t a, int64_t b, int64_t c, enum AVRounding);
2163 628d601b Zdenek Kabelac
2164 8424cf50 Fabrice Bellard
/* frame parsing */
2165
typedef struct AVCodecParserContext {
2166
    void *priv_data;
2167
    struct AVCodecParser *parser;
2168
    int64_t frame_offset; /* offset of the current frame */
2169
    int64_t cur_offset; /* current offset 
2170
                           (incremented by each av_parser_parse()) */
2171
    int64_t last_frame_offset; /* offset of the last frame */
2172
    /* video info */
2173
    int pict_type; /* XXX: put it back in AVCodecContext */
2174
    int repeat_pict; /* XXX: put it back in AVCodecContext */
2175 b84f2a35 Fabrice Bellard
    int64_t pts;     /* pts of the current frame */
2176
    int64_t dts;     /* dts of the current frame */
2177
2178
    /* private data */
2179
    int64_t last_pts;
2180
    int64_t last_dts;
2181 a62aecce Michael Niedermayer
    int fetch_timestamp;
2182 b84f2a35 Fabrice Bellard
2183
#define AV_PARSER_PTS_NB 4
2184
    int cur_frame_start_index;
2185
    int64_t cur_frame_offset[AV_PARSER_PTS_NB];
2186
    int64_t cur_frame_pts[AV_PARSER_PTS_NB];
2187
    int64_t cur_frame_dts[AV_PARSER_PTS_NB];
2188 8424cf50 Fabrice Bellard
} AVCodecParserContext;
2189
2190
typedef struct AVCodecParser {
2191 99f06236 Michael Niedermayer
    int codec_ids[5]; /* several codec IDs are permitted */
2192 8424cf50 Fabrice Bellard
    int priv_data_size;
2193
    int (*parser_init)(AVCodecParserContext *s);
2194
    int (*parser_parse)(AVCodecParserContext *s, 
2195
                        AVCodecContext *avctx,
2196
                        uint8_t **poutbuf, int *poutbuf_size, 
2197
                        const uint8_t *buf, int buf_size);
2198
    void (*parser_close)(AVCodecParserContext *s);
2199
    struct AVCodecParser *next;
2200
} AVCodecParser;
2201
2202
extern AVCodecParser *av_first_parser;
2203
2204
void av_register_codec_parser(AVCodecParser *parser);
2205
AVCodecParserContext *av_parser_init(int codec_id);
2206
int av_parser_parse(AVCodecParserContext *s, 
2207
                    AVCodecContext *avctx,
2208
                    uint8_t **poutbuf, int *poutbuf_size, 
2209 b84f2a35 Fabrice Bellard
                    const uint8_t *buf, int buf_size,
2210
                    int64_t pts, int64_t dts);
2211 8424cf50 Fabrice Bellard
void av_parser_close(AVCodecParserContext *s);
2212
2213
extern AVCodecParser mpegvideo_parser;
2214
extern AVCodecParser mpeg4video_parser;
2215 c6148de2 Michael Niedermayer
extern AVCodecParser h261_parser;
2216 8424cf50 Fabrice Bellard
extern AVCodecParser h263_parser;
2217
extern AVCodecParser h264_parser;
2218 8e6325b9 Michael Niedermayer
extern AVCodecParser mjpeg_parser;
2219 99f06236 Michael Niedermayer
extern AVCodecParser pnm_parser;
2220 8424cf50 Fabrice Bellard
extern AVCodecParser mpegaudio_parser;
2221
extern AVCodecParser ac3_parser;
2222
2223 544eb99c Fabrice Bellard
/* memory */
2224 e4eadb4b Michael Niedermayer
void *av_malloc(unsigned int size);
2225 18f77016 Zdenek Kabelac
void *av_mallocz(unsigned int size);
2226 8e1e6f31 Fabrice Bellard
void *av_realloc(void *ptr, unsigned int size);
2227 544eb99c Fabrice Bellard
void av_free(void *ptr);
2228 8e1e6f31 Fabrice Bellard
char *av_strdup(const char *s);
2229 81c5f887 Michael Niedermayer
void av_freep(void *ptr);
2230 97d96aaa Zdenek Kabelac
void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
2231 855ea723 Zdenek Kabelac
/* for static data only */
2232
/* call av_free_static to release all staticaly allocated tables */
2233 628d601b Zdenek Kabelac
void av_free_static(void);
2234 8d1f2ba5 Michael Niedermayer
void *av_mallocz_static(unsigned int size);
2235 073c2593 Burkhard Plaum
void *av_realloc_static(void *ptr, unsigned int size);
2236 544eb99c Fabrice Bellard
2237 fc384777 Mike Melanson
/* add by bero : in adx.c */
2238
int is_adx(const unsigned char *buf,size_t bufsize);
2239
2240 e1c2a5a0 Roberto Togni
void img_copy(AVPicture *dst, const AVPicture *src,
2241
              int pix_fmt, int width, int height);
2242
2243 9b879566 Michel Bardiaux
/* av_log API */
2244
2245
#include <stdarg.h>
2246
2247 d8019eb5 Allen Day
#define AV_LOG_QUIET -1
2248 9b879566 Michel Bardiaux
#define AV_LOG_ERROR 0
2249
#define AV_LOG_INFO 1
2250
#define AV_LOG_DEBUG 2
2251
2252 f4bd8cf0 Michael Niedermayer
#ifdef __GNUC__
2253 bc874dae Michel Bardiaux
extern void av_log(void*, int level, const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4)));
2254 f4bd8cf0 Michael Niedermayer
#else
2255
extern void av_log(void*, int level, const char *fmt, ...);
2256
#endif
2257
2258 bc874dae Michel Bardiaux
extern void av_vlog(void*, int level, const char *fmt, va_list);
2259 9b879566 Michel Bardiaux
extern int av_log_get_level(void);
2260
extern void av_log_set_level(int);
2261 bc874dae Michel Bardiaux
extern void av_log_set_callback(void (*)(void*, int, const char*, va_list));
2262 9b879566 Michel Bardiaux
2263 3a278992 Mike Melanson
/* endian macros */
2264 e96682e6 Michael Niedermayer
#if !defined(BE_16) || !defined(BE_32) || !defined(LE_16) || !defined(LE_32)
2265 3a278992 Mike Melanson
#define BE_16(x)  ((((uint8_t*)(x))[0] << 8) | ((uint8_t*)(x))[1])
2266
#define BE_32(x)  ((((uint8_t*)(x))[0] << 24) | \
2267
                   (((uint8_t*)(x))[1] << 16) | \
2268
                   (((uint8_t*)(x))[2] << 8) | \
2269
                    ((uint8_t*)(x))[3])
2270
#define LE_16(x)  ((((uint8_t*)(x))[1] << 8) | ((uint8_t*)(x))[0])
2271
#define LE_32(x)  ((((uint8_t*)(x))[3] << 24) | \
2272
                   (((uint8_t*)(x))[2] << 16) | \
2273
                   (((uint8_t*)(x))[1] << 8) | \
2274
                    ((uint8_t*)(x))[0])
2275 e96682e6 Michael Niedermayer
#endif
2276 3a278992 Mike Melanson
2277 02d697aa Zdenek Kabelac
#ifdef __cplusplus
2278
}
2279
#endif
2280
2281 a96b68b7 Fabrice Bellard
#endif /* AVCODEC_H */