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