Statistics
| Branch: | Revision:

ffmpeg / libavcodec / avcodec.h @ 2e8f2c20

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