simplify
[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
c11c2bc2 14#include "avutil.h"
4b813d5c 15#include <sys/types.h> /* size_t */
de6d9b64 16
bb270c08 17#define AV_STRINGIFY(s) AV_TOSTRING(s)
7b7d86f1 18#define AV_TOSTRING(s) #s
5aa083ee 19
fd7b1991
KS
20#define LIBAVCODEC_VERSION_INT ((51<<16)+(9<<8)+0)
21#define LIBAVCODEC_VERSION 51.9.0
bb270c08 22#define LIBAVCODEC_BUILD LIBAVCODEC_VERSION_INT
5aa083ee 23
bb270c08 24#define LIBAVCODEC_IDENT "Lavc" AV_STRINGIFY(LIBAVCODEC_VERSION)
ce2749d2 25
bb270c08
DB
26#define AV_NOPTS_VALUE int64_t_C(0x8000000000000000)
27#define AV_TIME_BASE 1000000
28#define AV_TIME_BASE_Q (AVRational){1, AV_TIME_BASE}
9740beff 29
de6d9b64 30enum CodecID {
115329f1 31 CODEC_ID_NONE,
de6d9b64 32 CODEC_ID_MPEG1VIDEO,
dcedf586 33 CODEC_ID_MPEG2VIDEO, /* prefered ID for MPEG Video 1 or 2 decoding */
fb364ada 34 CODEC_ID_MPEG2VIDEO_XVMC,
c6148de2 35 CODEC_ID_H261,
de6d9b64
FB
36 CODEC_ID_H263,
37 CODEC_ID_RV10,
68b94c35 38 CODEC_ID_RV20,
de6d9b64 39 CODEC_ID_MJPEG,
b135d9fb 40 CODEC_ID_MJPEGB,
b1e6b355 41 CODEC_ID_LJPEG,
5e83dec4 42 CODEC_ID_SP5X,
5639729b 43 CODEC_ID_JPEGLS,
bf89e6b1 44 CODEC_ID_MPEG4,
de6d9b64 45 CODEC_ID_RAWVIDEO,
84afee34
MN
46 CODEC_ID_MSMPEG4V1,
47 CODEC_ID_MSMPEG4V2,
48 CODEC_ID_MSMPEG4V3,
e1a9dbff 49 CODEC_ID_WMV1,
b50eef3a 50 CODEC_ID_WMV2,
de6d9b64
FB
51 CODEC_ID_H263P,
52 CODEC_ID_H263I,
d4f5d74a 53 CODEC_ID_FLV1,
be8ffec9 54 CODEC_ID_SVQ1,
8b82a956 55 CODEC_ID_SVQ3,
020fcc94 56 CODEC_ID_DVVIDEO,
11f18faf 57 CODEC_ID_HUFFYUV,
f70f7c6d 58 CODEC_ID_CYUV,
0da71265 59 CODEC_ID_H264,
deabd4fd 60 CODEC_ID_INDEO3,
d86053a4 61 CODEC_ID_VP3,
f44ee2c3 62 CODEC_ID_THEORA,
3d2e8cce 63 CODEC_ID_ASV1,
9b56edf5 64 CODEC_ID_ASV2,
5e20f836 65 CODEC_ID_FFV1,
e2a7bb28 66 CODEC_ID_4XM,
be3564ed 67 CODEC_ID_VCR1,
3aff069b 68 CODEC_ID_CLJR,
c3bf0288 69 CODEC_ID_MDEC,
3ef8be2b
MM
70 CODEC_ID_ROQ,
71 CODEC_ID_INTERPLAY_VIDEO,
9937e686
MM
72 CODEC_ID_XAN_WC3,
73 CODEC_ID_XAN_WC4,
2fdf638b
MM
74 CODEC_ID_RPZA,
75 CODEC_ID_CINEPAK,
76 CODEC_ID_WS_VQA,
77 CODEC_ID_MSRLE,
78 CODEC_ID_MSVIDEO1,
4120a53a 79 CODEC_ID_IDCIN,
1dc1ed99 80 CODEC_ID_8BPS,
11e29a41 81 CODEC_ID_SMC,
42cad81a 82 CODEC_ID_FLIC,
9a4117d5 83 CODEC_ID_TRUEMOTION1,
fafa0b75 84 CODEC_ID_VMDVIDEO,
a273bbfb
RT
85 CODEC_ID_MSZH,
86 CODEC_ID_ZLIB,
070ed1bc 87 CODEC_ID_QTRLE,
791e7b83 88 CODEC_ID_SNOW,
9d53d58e 89 CODEC_ID_TSCC,
d0a0bbd2 90 CODEC_ID_ULTI,
d08d7142 91 CODEC_ID_QDRAW,
ab711b3c 92 CODEC_ID_VIXL,
acfd8f0f 93 CODEC_ID_QPEG,
17179d2d
MN
94 CODEC_ID_XVID,
95 CODEC_ID_PNG,
96 CODEC_ID_PPM,
97 CODEC_ID_PBM,
98 CODEC_ID_PGM,
99 CODEC_ID_PGMYUV,
100 CODEC_ID_PAM,
f37b9768 101 CODEC_ID_FFVHUFF,
3f05305d
MN
102 CODEC_ID_RV30,
103 CODEC_ID_RV40,
10b9c374 104 CODEC_ID_VC1,
21aa398f 105 CODEC_ID_WMV3,
9c7fb608 106 CODEC_ID_LOCO,
a8a15e9d 107 CODEC_ID_WNV1,
589f8220 108 CODEC_ID_AASC,
856dbbff 109 CODEC_ID_INDEO2,
b81f8949 110 CODEC_ID_FRAPS,
64af6168 111 CODEC_ID_TRUEMOTION2,
9fa62f2a 112 CODEC_ID_BMP,
e0f80bd7 113 CODEC_ID_CSCD,
4e114829 114 CODEC_ID_MMVIDEO,
9c8d8e84 115 CODEC_ID_ZMBV,
26376701 116 CODEC_ID_AVS,
348efc18 117 CODEC_ID_SMACKVIDEO,
dfca23e3 118 CODEC_ID_NUV,
fd7b1991 119 CODEC_ID_KMVC,
0919e788 120 CODEC_ID_FLASHSV,
a96b68b7
FB
121
122 /* various pcm "codecs" */
17179d2d 123 CODEC_ID_PCM_S16LE= 0x10000,
a96b68b7
FB
124 CODEC_ID_PCM_S16BE,
125 CODEC_ID_PCM_U16LE,
126 CODEC_ID_PCM_U16BE,
127 CODEC_ID_PCM_S8,
128 CODEC_ID_PCM_U8,
129 CODEC_ID_PCM_MULAW,
130 CODEC_ID_PCM_ALAW,
b461b3bc
RD
131 CODEC_ID_PCM_S32LE,
132 CODEC_ID_PCM_S32BE,
133 CODEC_ID_PCM_U32LE,
134 CODEC_ID_PCM_U32BE,
135 CODEC_ID_PCM_S24LE,
136 CODEC_ID_PCM_S24BE,
137 CODEC_ID_PCM_U24LE,
138 CODEC_ID_PCM_U24BE,
139 CODEC_ID_PCM_S24DAUD,
0147f198
FR
140
141 /* various adpcm codecs */
17179d2d 142 CODEC_ID_ADPCM_IMA_QT= 0x11000,
0147f198 143 CODEC_ID_ADPCM_IMA_WAV,
9937e686
MM
144 CODEC_ID_ADPCM_IMA_DK3,
145 CODEC_ID_ADPCM_IMA_DK4,
2fdf638b 146 CODEC_ID_ADPCM_IMA_WS,
7d8379f2 147 CODEC_ID_ADPCM_IMA_SMJPEG,
0147f198 148 CODEC_ID_ADPCM_MS,
e2a7bb28 149 CODEC_ID_ADPCM_4XM,
fc384777
MM
150 CODEC_ID_ADPCM_XA,
151 CODEC_ID_ADPCM_ADX,
7d8379f2 152 CODEC_ID_ADPCM_EA,
e5966052 153 CODEC_ID_ADPCM_G726,
b3bfb299 154 CODEC_ID_ADPCM_CT,
659c3692 155 CODEC_ID_ADPCM_SWF,
2ff4524e 156 CODEC_ID_ADPCM_YAMAHA,
2433f24f
AJ
157 CODEC_ID_ADPCM_SBPRO_4,
158 CODEC_ID_ADPCM_SBPRO_3,
159 CODEC_ID_ADPCM_SBPRO_2,
891f64b3 160
17179d2d
MN
161 /* AMR */
162 CODEC_ID_AMR_NB= 0x12000,
d663a1fd
MN
163 CODEC_ID_AMR_WB,
164
b8414bbd 165 /* RealAudio codecs*/
17179d2d 166 CODEC_ID_RA_144= 0x13000,
b8414bbd 167 CODEC_ID_RA_288,
3ef8be2b
MM
168
169 /* various DPCM codecs */
17179d2d 170 CODEC_ID_ROQ_DPCM= 0x14000,
3ef8be2b 171 CODEC_ID_INTERPLAY_DPCM,
9937e686 172 CODEC_ID_XAN_DPCM,
d08d7142 173 CODEC_ID_SOL_DPCM,
115329f1 174
17179d2d
MN
175 CODEC_ID_MP2= 0x15000,
176 CODEC_ID_MP3, /* prefered ID for MPEG Audio layer 1, 2 or3 decoding */
177 CODEC_ID_AAC,
178 CODEC_ID_MPEG4AAC,
179 CODEC_ID_AC3,
180 CODEC_ID_DTS,
181 CODEC_ID_VORBIS,
182 CODEC_ID_DVAUDIO,
183 CODEC_ID_WMAV1,
184 CODEC_ID_WMAV2,
185 CODEC_ID_MACE3,
186 CODEC_ID_MACE6,
187 CODEC_ID_VMDAUDIO,
188 CODEC_ID_SONIC,
189 CODEC_ID_SONIC_LS,
ac2570a8 190 CODEC_ID_FLAC,
1ede228a 191 CODEC_ID_MP3ADU,
d2a7718d 192 CODEC_ID_MP3ON4,
85ad5695 193 CODEC_ID_SHORTEN,
5df8a0c6 194 CODEC_ID_ALAC,
034eeaa1 195 CODEC_ID_WESTWOOD_SND1,
115329f1 196 CODEC_ID_GSM,
d9b1c197 197 CODEC_ID_QDM2,
e0f7e329 198 CODEC_ID_COOK,
bf3027c8 199 CODEC_ID_TRUESPEECH,
a24c4a2a 200 CODEC_ID_TTA,
348efc18 201 CODEC_ID_SMACKAUDIO,
115329f1
DB
202
203 CODEC_ID_OGGTHEORA= 0x16000,
240c1657
FB
204
205 /* subtitle codecs */
115329f1
DB
206 CODEC_ID_DVD_SUBTITLE= 0x17000,
207 CODEC_ID_DVB_SUBTITLE,
208
17179d2d 209 CODEC_ID_MPEG2TS= 0x20000, /* _FAKE_ codec to indicate a raw MPEG2 transport
985180a1 210 stream (only used by libavformat) */
de6d9b64 211};
dcedf586
FB
212
213/* CODEC_ID_MP3LAME is absolete */
214#define CODEC_ID_MP3LAME CODEC_ID_MP3
de6d9b64
FB
215
216enum CodecType {
4a663d80 217 CODEC_TYPE_UNKNOWN = -1,
de6d9b64
FB
218 CODEC_TYPE_VIDEO,
219 CODEC_TYPE_AUDIO,
985180a1 220 CODEC_TYPE_DATA,
240c1657 221 CODEC_TYPE_SUBTITLE,
de6d9b64
FB
222};
223
a96b68b7 224/* currently unused, may be used if 24/32 bits samples ever supported */
1319a77b 225/* all in native endian */
a96b68b7 226enum SampleFormat {
9076fee4 227 SAMPLE_FMT_NONE = -1,
1319a77b
AB
228 SAMPLE_FMT_U8, ///< unsigned 8 bits
229 SAMPLE_FMT_S16, ///< signed 16 bits
230 SAMPLE_FMT_S24, ///< signed 24 bits
115329f1 231 SAMPLE_FMT_S32, ///< signed 32 bits
a3a5f4d6 232 SAMPLE_FMT_FLT, ///< float
a96b68b7
FB
233};
234
de6d9b64 235/* in bytes */
8170e5fb 236#define AVCODEC_MAX_AUDIO_FRAME_SIZE 192000 // 1 second of 48khz 32bit audio
de6d9b64 237
d7425f59 238/**
cf713bb8 239 * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
115329f1 240 * this is mainly needed because some optimized bitstream readers read
cf713bb8
MN
241 * 32 or 64 bit at once and could read over the end<br>
242 * Note, if the first 23 bits of the additional bytes are not 0 then damaged
243 * MPEG bitstreams could cause overread and segfault
d7425f59
MN
244 */
245#define FF_INPUT_BUFFER_PADDING_SIZE 8
246
0ecca7a4
MN
247/**
248 * minimum encoding buffer size.
249 * used to avoid some checks during header writing
250 */
251#define FF_MIN_BUFFER_SIZE 16384
252
e4986da9
J
253/* motion estimation type, EPZS by default */
254enum Motion_Est_ID {
101bea5f 255 ME_ZERO = 1,
e4986da9
J
256 ME_FULL,
257 ME_LOG,
258 ME_PHODS,
259 ME_EPZS,
51d6a3cf
MN
260 ME_X1,
261 ME_HEX,
262 ME_UMH,
263 ME_ITER,
e4986da9
J
264};
265
8c3eba7c
MN
266enum AVDiscard{
267//we leave some space between them for extensions (drop some keyframes for intra only or drop just some bidir frames)
268 AVDISCARD_NONE =-16, ///< discard nothing
269 AVDISCARD_DEFAULT= 0, ///< discard useless packets like 0 size packets in avi
270 AVDISCARD_NONREF = 8, ///< discard all non reference
271 AVDISCARD_BIDIR = 16, ///< discard all bidirectional frames
272 AVDISCARD_NONKEY = 32, ///< discard all frames except keyframes
273 AVDISCARD_ALL = 48, ///< discard all
274};
275
ce980a95
MN
276typedef struct RcOverride{
277 int start_frame;
278 int end_frame;
279 int qscale; // if this is 0 then quality_factor will be used instead
280 float quality_factor;
281} RcOverride;
282
b0ec9efd 283#define FF_MAX_B_FRAMES 16
9dbcbd92 284
a949d72e 285/* encoding support
115329f1 286 these flags can be passed in AVCodecContext.flags before initing
bb628dae 287 Note: not everything is supported yet.
a949d72e 288*/
de6d9b64 289
115329f1 290#define CODEC_FLAG_QSCALE 0x0002 ///< use fixed qscale
dba019da 291#define CODEC_FLAG_4MV 0x0004 ///< 4 MV per MB allowed / Advanced prediction for H263
115329f1
DB
292#define CODEC_FLAG_QPEL 0x0010 ///< use qpel MC
293#define CODEC_FLAG_GMC 0x0020 ///< use GMC
294#define CODEC_FLAG_MV0 0x0040 ///< always try a MB with MV=<0,0>
295#define CODEC_FLAG_PART 0x0080 ///< use data partitioning
296/* parent program gurantees that the input for b-frame containing streams is not written to
9dbcbd92 297 for at least s->max_b_frames+1 frames, if this is not set than the input will be copied */
8b4c7dbc 298#define CODEC_FLAG_INPUT_PRESERVED 0x0100
115329f1
DB
299#define CODEC_FLAG_PASS1 0x0200 ///< use internal 2pass ratecontrol in first pass mode
300#define CODEC_FLAG_PASS2 0x0400 ///< use internal 2pass ratecontrol in second pass mode
301#define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< use external huffman table (for mjpeg)
302#define CODEC_FLAG_GRAY 0x2000 ///< only decode/encode grayscale
bb628dae 303#define CODEC_FLAG_EMU_EDGE 0x4000///< don't draw edges
115329f1
DB
304#define CODEC_FLAG_PSNR 0x8000 ///< error[?] variables will be set during encoding
305#define CODEC_FLAG_TRUNCATED 0x00010000 /** input bitstream might be truncated at a random location instead
d7425f59 306 of only at frame boundaries */
115329f1
DB
307#define CODEC_FLAG_NORMALIZE_AQP 0x00020000 ///< normalize adaptive quantization
308#define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< use interlaced dct
3bb07d61 309#define CODEC_FLAG_LOW_DELAY 0x00080000 ///< force low delay
115329f1
DB
310#define CODEC_FLAG_ALT_SCAN 0x00100000 ///< use alternate scan
311#define CODEC_FLAG_TRELLIS_QUANT 0x00200000 ///< use trellis quantization
312#define CODEC_FLAG_GLOBAL_HEADER 0x00400000 ///< place global headers in extradata instead of every keyframe
313#define CODEC_FLAG_BITEXACT 0x00800000 ///< use only bitexact stuff (except (i)dct)
21e59552 314/* Fx : Flag for h263+ extra options */
8d8c0294
MN
315#define CODEC_FLAG_H263P_AIC 0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction (remove this)
316#define CODEC_FLAG_AC_PRED 0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction
115329f1 317#define CODEC_FLAG_H263P_UMV 0x02000000 ///< Unlimited motion vector
f2f6134b 318#define CODEC_FLAG_CBP_RD 0x04000000 ///< use rate distortion optimization for cbp
1f26c6f3 319#define CODEC_FLAG_QP_RD 0x08000000 ///< use rate distortion optimization for qp selectioon
dba019da 320#define CODEC_FLAG_H263P_AIV 0x00000008 ///< H263 Alternative inter vlc
332f9ac4
MN
321#define CODEC_FLAG_OBMC 0x00000001 ///< OBMC
322#define CODEC_FLAG_LOOP_FILTER 0x00000800 ///< loop filter
bb198e19
MN
323#define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000
324#define CODEC_FLAG_INTERLACED_ME 0x20000000 ///< interlaced motion estimation
baaf3f46 325#define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< will reserve space for SVCD scan offset user data
f2cf4a6b 326#define CODEC_FLAG_CLOSED_GOP ((int)0x80000000)
6fc5b059 327#define CODEC_FLAG2_FAST 0x00000001 ///< allow non spec compliant speedup tricks
03581772 328#define CODEC_FLAG2_STRICT_GOP 0x00000002 ///< strictly enforce GOP size
09b0499f 329#define CODEC_FLAG2_NO_OUTPUT 0x00000004 ///< skip bitstream encoding
90ad92b3 330#define CODEC_FLAG2_LOCAL_HEADER 0x00000008 ///< place global headers at every keyframe instead of in extradata
58f7833e
RS
331#define CODEC_FLAG2_BPYRAMID 0x00000010 ///< H.264 allow b-frames to be used as references
332#define CODEC_FLAG2_WPRED 0x00000020 ///< H.264 weighted biprediction for b-frames
333#define CODEC_FLAG2_MIXED_REFS 0x00000040 ///< H.264 multiple references per partition
334#define CODEC_FLAG2_8X8DCT 0x00000080 ///< H.264 high profile 8x8 transform
335#define CODEC_FLAG2_FASTPSKIP 0x00000100 ///< H.264 fast pskip
336#define CODEC_FLAG2_AUD 0x00000200 ///< H.264 access unit delimiters
337#define CODEC_FLAG2_BRDO 0x00000400 ///< b-frame rate-distortion optimization
307eb248 338#define CODEC_FLAG2_INTRA_VLC 0x00000800 ///< use MPEG-2 intra VLC table
086bfd25 339#define CODEC_FLAG2_MEMC_ONLY 0x00001000 ///< only do ME/MC (I frames -> ref, P frame -> ME+MC)
6fc5b059 340
21e59552 341/* Unsupported options :
bb270c08
DB
342 * Syntax Arithmetic coding (SAC)
343 * Reference Picture Selection
344 * Independant Segment Decoding */
21e59552 345/* /Fx */
bf89e6b1
FB
346/* codec capabilities */
347
115329f1 348#define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< decoder can use draw_horiz_band callback
6814a25c
MN
349/**
350 * Codec uses get_buffer() for allocating buffers.
351 * direct rendering method 1
352 */
353#define CODEC_CAP_DR1 0x0002
917e06c8
FB
354/* if 'parse_only' field is true, then avcodec_parse_frame() can be
355 used */
356#define CODEC_CAP_PARSE_ONLY 0x0004
d7425f59 357#define CODEC_CAP_TRUNCATED 0x0008
5e5c247a
IK
358/* codec can export data for HW decoding (XvMC) */
359#define CODEC_CAP_HWACCEL 0x0010
115329f1 360/**
934982c4
MN
361 * codec has a non zero delay and needs to be feeded with NULL at the end to get the delayed data.
362 * if this is not set, the codec is guranteed to never be feeded with NULL data
363 */
6f824977 364#define CODEC_CAP_DELAY 0x0020
cef7cc72
JR
365/**
366 * Codec can be fed a final frame with a smaller size.
367 * This can be used to prevent truncation of the last audio samples.
368 */
369#define CODEC_CAP_SMALL_LAST_FRAME 0x0040
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
bb270c08
DB
631#define FF_QSCALE_TYPE_MPEG1 0
632#define FF_QSCALE_TYPE_MPEG2 1
633#define FF_QSCALE_TYPE_H264 2
4e00e76b
MN
634
635#define FF_BUFFER_TYPE_INTERNAL 1
9b56edf5 636#define FF_BUFFER_TYPE_USER 2 ///< Direct rendering buffers (image is (de)allocated by user)
bb628dae
DB
637#define FF_BUFFER_TYPE_SHARED 4 ///< buffer from somewhere else, don't dealloc image (data/base), all other tables are not shared
638#define FF_BUFFER_TYPE_COPY 8 ///< just a (modified) copy of some other buffer, don't dealloc anything
4e00e76b 639
1e491e29 640
140cb663
MN
641#define FF_I_TYPE 1 // Intra
642#define FF_P_TYPE 2 // Predicted
643#define FF_B_TYPE 3 // Bi-dir predicted
644#define FF_S_TYPE 4 // S(GMC)-VOP MPEG4
0da71265
MN
645#define FF_SI_TYPE 5
646#define FF_SP_TYPE 6
1e491e29 647
074c4ca7
RT
648#define FF_BUFFER_HINTS_VALID 0x01 // Buffer hints value is meaningful (if 0 ignore)
649#define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer
650#define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content
651#define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update)
652
0da71265
MN
653/**
654 * Audio Video Frame.
655 */
492cd3a9
MN
656typedef struct AVFrame {
657 FF_COMMON_FRAME
658} AVFrame;
1e491e29 659
14bea432 660#define DEFAULT_FRAME_RATE_BASE 1001000
d33c949c
MN
661
662/**
bc874dae
MB
663 * Used by av_log
664 */
665typedef struct AVCLASS AVClass;
666struct AVCLASS {
667 const char* class_name;
668 const char* (*item_name)(void*); /* actually passing a pointer to an AVCodecContext
bb270c08
DB
669 or AVFormatContext, which begin with an AVClass.
670 Needed because av_log is in libavcodec and has no visibility
671 of AVIn/OutputFormat */
6fd46414 672 struct AVOption *option;
bc874dae
MB
673};
674
675/**
d33c949c
MN
676 * main external api structure.
677 */
de6d9b64 678typedef struct AVCodecContext {
b71901e6 679 /**
bc874dae
MB
680 * Info on struct for av_log
681 * - set by avcodec_alloc_context
682 */
43465395 683 AVClass *av_class;
bc874dae 684 /**
64863965
MN
685 * the average bitrate.
686 * - encoding: set by user. unused for constant quantizer encoding
115329f1 687 * - decoding: set by lavc. 0 or some bitrate if this info is available in the stream
b71901e6 688 */
de6d9b64 689 int bit_rate;
b71901e6
MN
690
691 /**
64863965 692 * number of bits the bitstream is allowed to diverge from the reference.
b71901e6 693 * the reference can be CBR (for CBR pass1) or VBR (for pass2)
64863965
MN
694 * - encoding: set by user. unused for constant quantizer encoding
695 * - decoding: unused
b71901e6 696 */
115329f1 697 int bit_rate_tolerance;
b71901e6
MN
698
699 /**
64863965
MN
700 * CODEC_FLAG_*.
701 * - encoding: set by user.
702 * - decoding: set by user.
b71901e6 703 */
de6d9b64 704 int flags;
b71901e6
MN
705
706 /**
707 * some codecs needs additionnal format info. It is stored here
115329f1 708 * - encoding: set by user.
64863965 709 * - decoding: set by lavc. (FIXME is this ok?)
b71901e6
MN
710 */
711 int sub_id;
712
713 /**
64863965 714 * motion estimation algorithm used for video coding.
58f7833e
RS
715 * 1 (zero), 2 (full), 3 (log), 4 (phods), 5 (epzs), 6 (x1), 7 (hex),
716 * 8 (umh), 9 (iter) [7, 8 are x264 specific, 9 is snow specific]
64863965
MN
717 * - encoding: MUST be set by user.
718 * - decoding: unused
b71901e6
MN
719 */
720 int me_method;
721
722 /**
64863965 723 * some codecs need / can use extra-data like huffman tables.
b71901e6
MN
724 * mjpeg: huffman tables
725 * rv10: additional flags
b704e742 726 * mpeg4: global headers (they can be in the bitstream or here)
dffcdbb5
MN
727 * the allocated memory should be FF_INPUT_BUFFER_PADDING_SIZE bytes larger
728 * then extradata_size to avoid prolems if its read with the bitstream reader
ed57bb79 729 * the bytewise contents of extradata must not depend on the architecture or cpu endianness
64863965
MN
730 * - encoding: set/allocated/freed by lavc.
731 * - decoding: set/allocated/freed by user.
b71901e6 732 */
e84c31dc
A
733 void *extradata;
734 int extradata_size;
115329f1 735
b71901e6 736 /**
5b28c8c3
MN
737 * this is the fundamental unit of time (in seconds) in terms
738 * of which frame timestamps are represented. for fixed-fps content,
739 * timebase should be 1/framerate and timestamp increments should be
740 * identically 1.
64863965 741 * - encoding: MUST be set by user
c0df9d75 742 * - decoding: set by lavc.
b71901e6 743 */
c0df9d75 744 AVRational time_base;
115329f1 745
5b28c8c3 746 /* video only */
14bea432 747 /**
21adafec 748 * picture width / height.
115329f1 749 * - encoding: MUST be set by user.
21adafec 750 * - decoding: set by lavc.
115329f1 751 * Note, for compatibility its possible to set this instead of
21adafec 752 * coded_width/height before decoding
b71901e6 753 */
de6d9b64 754 int width, height;
115329f1 755
e769f053 756#define FF_ASPECT_EXTENDED 15
b71901e6
MN
757
758 /**
64863965
MN
759 * the number of pictures in a group of pitures, or 0 for intra_only.
760 * - encoding: set by user.
761 * - decoding: unused
b71901e6
MN
762 */
763 int gop_size;
764
765 /**
64863965 766 * pixel format, see PIX_FMT_xxx.
a3a5f4d6 767 * - encoding: set by user.
64863965 768 * - decoding: set by lavc.
b71901e6 769 */
e4eadb4b 770 enum PixelFormat pix_fmt;
115329f1 771
bdfcbbed 772 /**
115329f1 773 * Frame rate emulation. If not zero lower layer (i.e. format handler)
bdfcbbed
MK
774 * has to read frames at native frame rate.
775 * - encoding: set by user.
776 * - decoding: unused.
777 */
778 int rate_emu;
115329f1 779
b71901e6
MN
780 /**
781 * if non NULL, 'draw_horiz_band' is called by the libavcodec
782 * decoder to draw an horizontal band. It improve cache usage. Not
783 * all codecs can do that. You must check the codec capabilities
784 * before
64863965
MN
785 * - encoding: unused
786 * - decoding: set by user.
3bb07d61
MN
787 * @param height the height of the slice
788 * @param y the y position of the slice
789 * @param type 1->top field, 2->bottom field, 3->frame
790 * @param offset offset into the AVFrame.data from which the slice should be read
b71901e6 791 */
bf89e6b1 792 void (*draw_horiz_band)(struct AVCodecContext *s,
da64ecc3 793 const AVFrame *src, int offset[4],
3bb07d61 794 int y, int type, int height);
bf89e6b1 795
de6d9b64 796 /* audio only */
115329f1 797 int sample_rate; ///< samples per sec
de6d9b64 798 int channels;
a3a5f4d6
MN
799
800 /**
801 * audio sample format.
802 * - encoding: set by user.
803 * - decoding: set by lavc.
804 */
115329f1 805 enum SampleFormat sample_fmt; ///< sample format, currenly unused
de6d9b64
FB
806
807 /* the following data should not be initialized */
718b27a7 808 /**
115329f1 809 * samples per packet. initialized when calling 'init'
718b27a7
MN
810 */
811 int frame_size;
115329f1
DB
812 int frame_number; ///< audio or video frame number
813 int real_pict_num; ///< returns the real picture number of previous encoded frame
814
b71901e6 815 /**
115329f1 816 * number of frames the decoded output will be delayed relative to
64863965
MN
817 * the encoded input.
818 * - encoding: set by lavc.
819 * - decoding: unused
b71901e6
MN
820 */
821 int delay;
115329f1 822
64863965
MN
823 /* - encoding parameters */
824 float qcompress; ///< amount of qscale change between easy & hard scenes (0.0-1.0)
115329f1
DB
825 float qblur; ///< amount of qscale smoothing over time (0.0-1.0)
826
b71901e6 827 /**
64863965
MN
828 * minimum quantizer.
829 * - encoding: set by user.
830 * - decoding: unused
b71901e6
MN
831 */
832 int qmin;
833
834 /**
64863965
MN
835 * maximum quantizer.
836 * - encoding: set by user.
837 * - decoding: unused
b71901e6
MN
838 */
839 int qmax;
840
841 /**
64863965
MN
842 * maximum quantizer difference etween frames.
843 * - encoding: set by user.
844 * - decoding: unused
b71901e6
MN
845 */
846 int max_qdiff;
847
848 /**
64863965 849 * maximum number of b frames between non b frames.
b71901e6 850 * note: the output will be delayed by max_b_frames+1 relative to the input
64863965
MN
851 * - encoding: set by user.
852 * - decoding: unused
b71901e6
MN
853 */
854 int max_b_frames;
855
856 /**
64863965
MN
857 * qscale factor between ip and b frames.
858 * - encoding: set by user.
859 * - decoding: unused
b71901e6
MN
860 */
861 float b_quant_factor;
115329f1 862
b71901e6
MN
863 /** obsolete FIXME remove */
864 int rc_strategy;
64b7c5b6
MN
865#define FF_RC_STRATEGY_XVID 1
866
8b4c7dbc 867 int b_frame_strategy;
9dbcbd92 868
b71901e6 869 /**
64863965 870 * hurry up amount.
8c3eba7c 871 * deprecated in favor of skip_idct and skip_frame
64863965
MN
872 * - encoding: unused
873 * - decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too, 5-> skip everything except header
b71901e6
MN
874 */
875 int hurry_up;
115329f1 876
de6d9b64 877 struct AVCodec *codec;
115329f1 878
de6d9b64
FB
879 void *priv_data;
880
ba58dabc
MN
881 /* unused, FIXME remove*/
882 int rtp_mode;
115329f1 883
bb628dae 884 int rtp_payload_size; /* The size of the RTP payload: the coder will */
644d98a4
J
885 /* do it's best to deliver a chunk with size */
886 /* below rtp_payload_size, the chunk will start */
887 /* with a start code on some codecs like H.263 */
888 /* This doesn't take account of any particular */
889 /* headers inside the transmited RTP payload */
81401c1f 890
115329f1 891
bb628dae
DB
892 /* The RTP callback: This function is called */
893 /* every time the encoder has a packet to send */
894 /* Depends on the encoder if the data starts */
895 /* with a Start Code (it should) H.263 does. */
896 /* mb_nb contains the number of macroblocks */
897 /* encoded in the RTP payload */
115329f1 898 void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb);
81401c1f 899
098eefe1
MN
900 /* statistics, used for 2-pass encoding */
901 int mv_bits;
902 int header_bits;
903 int i_tex_bits;
904 int p_tex_bits;
905 int i_count;
906 int p_count;
907 int skip_count;
b71901e6 908 int misc_bits;
115329f1 909
b71901e6 910 /**
64863965
MN
911 * number of bits used for the previously encoded frame.
912 * - encoding: set by lavc
7004ffb3 913 * - decoding: unused
b71901e6 914 */
098eefe1 915 int frame_bits;
7004ffb3 916
b71901e6 917 /**
64863965
MN
918 * private data of the user, can be used to carry app specific stuff.
919 * - encoding: set by user
920 * - decoding: set by user
b71901e6
MN
921 */
922 void *opaque;
923
de6d9b64 924 char codec_name[32];
4a663d80
PG
925 enum CodecType codec_type; /* see CODEC_TYPE_xxx */
926 enum CodecID codec_id; /* see CODEC_ID_xxx */
115329f1 927
7004ffb3
MN
928 /**
929 * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
930 * this is used to workaround some encoder bugs
bd5a6020 931 * - encoding: set by user, if not then the default based on codec_id will be used
7004ffb3
MN
932 * - decoding: set by user, will be converted to upper case by lavc during init
933 */
934 unsigned int codec_tag;
115329f1 935
b71901e6 936 /**
64863965 937 * workaround bugs in encoders which sometimes cannot be detected automatically.
59fa3f96 938 * - encoding: set by user
64863965 939 * - decoding: set by user
b71901e6
MN
940 */
941 int workaround_bugs;
64863965 942#define FF_BUG_AUTODETECT 1 ///< autodetection
4d2858de
MN
943#define FF_BUG_OLD_MSMPEG4 2
944#define FF_BUG_XVID_ILACE 4
945#define FF_BUG_UMP4 8
946#define FF_BUG_NO_PADDING 16
3116cb14 947#define FF_BUG_AMV 32
ac0c6638 948#define FF_BUG_AC_VLC 0 ///< will be removed, libavcodec can now handle these non compliant files by default
03e93d35 949#define FF_BUG_QPEL_CHROMA 64
db794953 950#define FF_BUG_STD_QPEL 128
36df8805 951#define FF_BUG_QPEL_CHROMA2 256
c40c3482 952#define FF_BUG_DIRECT_BLOCKSIZE 512
1c6dcb0f 953#define FF_BUG_EDGE 1024
b44bdf7e 954#define FF_BUG_HPEL_CHROMA 2048
4ccde216 955#define FF_BUG_DC_CLIP 4096
59fa3f96 956#define FF_BUG_MS 8192 ///< workaround various bugs in microsofts broken decoders
4d2858de 957//#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
115329f1 958
b71901e6 959 /**
64863965
MN
960 * luma single coeff elimination threshold.
961 * - encoding: set by user
962 * - decoding: unused
b71901e6 963 */
1f6b6e50 964 int luma_elim_threshold;
115329f1 965
b71901e6 966 /**
64863965
MN
967 * chroma single coeff elimination threshold.
968 * - encoding: set by user
969 * - decoding: unused
b71901e6 970 */
1f6b6e50 971 int chroma_elim_threshold;
115329f1 972
b71901e6 973 /**
64863965
MN
974 * strictly follow the std (MPEG4, ...).
975 * - encoding: set by user
976 * - decoding: unused
b71901e6
MN
977 */
978 int strict_std_compliance;
9cd81798
MN
979#define FF_COMPLIANCE_VERY_STRICT 2 ///< strictly conform to a older more strict version of the spec or reference software
980#define FF_COMPLIANCE_STRICT 1 ///< strictly conform to all the things in the spec no matter what consequences
981#define FF_COMPLIANCE_NORMAL 0
982#define FF_COMPLIANCE_INOFFICIAL -1 ///< allow inofficial extensions
983#define FF_COMPLIANCE_EXPERIMENTAL -2 ///< allow non standarized experimental things
984
b71901e6 985 /**
64863965 986 * qscale offset between ip and b frames.
b3a391e8
MN
987 * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
988 * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
64863965
MN
989 * - encoding: set by user.
990 * - decoding: unused
b71901e6
MN
991 */
992 float b_quant_offset;
115329f1 993
b71901e6 994 /**
ce3bcaed 995 * error resilience higher values will detect more errors but may missdetect
64863965
MN
996 * some more or less valid parts as errors.
997 * - encoding: unused
998 * - decoding: set by user
b71901e6 999 */
1f6b6e50 1000 int error_resilience;
1471c6c2 1001#define FF_ER_CAREFUL 1
ce3bcaed
MN
1002#define FF_ER_COMPLIANT 2
1003#define FF_ER_AGGRESSIVE 3
1004#define FF_ER_VERY_AGGRESSIVE 4
115329f1 1005
6b72ac63 1006 /**
1e491e29
MN
1007 * called at the beginning of each frame to get a buffer for it.
1008 * if pic.reference is set then the frame will be read later by lavc
2b5296d2
MN
1009 * avcodec_align_dimensions() should be used to find the required width and
1010 * height, as they normally need to be rounded up to the next multiple of 16
64863965
MN
1011 * - encoding: unused
1012 * - decoding: set by lavc, user can override
b71901e6 1013 */
492cd3a9 1014 int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
115329f1 1015
b71901e6 1016 /**
1e491e29
MN
1017 * called to release buffers which where allocated with get_buffer.
1018 * a released buffer can be reused in get_buffer()
1019 * pic.data[*] must be set to NULL
64863965
MN
1020 * - encoding: unused
1021 * - decoding: set by lavc, user can override
b71901e6 1022 */
492cd3a9 1023 void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
0fd90455 1024
b71901e6 1025 /**
e6a2ac34
MN
1026 * if 1 the stream has a 1 frame delay during decoding.
1027 * - encoding: set by lavc
64863965 1028 * - decoding: set by lavc
b71901e6
MN
1029 */
1030 int has_b_frames;
718b27a7
MN
1031
1032 /**
1033 * number of bytes per packet if constant and known or 0
1034 * used by some WAV based audio codecs
1035 */
1036 int block_align;
115329f1 1037
64863965 1038 int parse_only; /* - decoding only: if true, only parsing is done
917e06c8
FB
1039 (function avcodec_parse_frame()). The frame
1040 data is returned. Only MPEG codecs support this now. */
115329f1 1041
b71901e6 1042 /**
e4eadb4b 1043 * 0-> h263 quant 1-> mpeg quant.
64863965
MN
1044 * - encoding: set by user.
1045 * - decoding: unused
b71901e6
MN
1046 */
1047 int mpeg_quant;
115329f1 1048
b71901e6 1049 /**
64863965
MN
1050 * pass1 encoding statistics output buffer.
1051 * - encoding: set by lavc
1052 * - decoding: unused
b71901e6 1053 */
64863965 1054 char *stats_out;
115329f1 1055
b71901e6
MN
1056 /**
1057 * pass2 encoding statistics input buffer.
1058 * concatenated stuff from stats_out of pass1 should be placed here
64863965
MN
1059 * - encoding: allocated/set/freed by user
1060 * - decoding: unused
b71901e6
MN
1061 */
1062 char *stats_in;
115329f1 1063
b71901e6 1064 /**
64863965 1065 * ratecontrol qmin qmax limiting method.
b71901e6 1066 * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
64863965
MN
1067 * - encoding: set by user.
1068 * - decoding: unused
b71901e6 1069 */
ce980a95 1070 float rc_qsquish;
b71901e6 1071
ce980a95
MN
1072 float rc_qmod_amp;
1073 int rc_qmod_freq;
115329f1 1074
b71901e6 1075 /**
64863965
MN
1076 * ratecontrol override, see RcOverride.
1077 * - encoding: allocated/set/freed by user.
1078 * - decoding: unused
b71901e6 1079 */
ce980a95
MN
1080 RcOverride *rc_override;
1081 int rc_override_count;
115329f1 1082
b71901e6 1083 /**
64863965
MN
1084 * rate control equation.
1085 * - encoding: set by user
1086 * - decoding: unused
b71901e6 1087 */
ce980a95 1088 char *rc_eq;
115329f1 1089
b71901e6 1090 /**
64863965
MN
1091 * maximum bitrate.
1092 * - encoding: set by user.
1093 * - decoding: unused
b71901e6 1094 */
ce980a95 1095 int rc_max_rate;
115329f1 1096
b71901e6 1097 /**
64863965
MN
1098 * minimum bitrate.
1099 * - encoding: set by user.
1100 * - decoding: unused
b71901e6 1101 */
ce980a95 1102 int rc_min_rate;
115329f1 1103
b71901e6 1104 /**
64863965
MN
1105 * decoder bitstream buffer size.
1106 * - encoding: set by user.
1107 * - decoding: unused
b71901e6 1108 */
ce980a95
MN
1109 int rc_buffer_size;
1110 float rc_buffer_aggressivity;
b71901e6
MN
1111
1112 /**
64863965 1113 * qscale factor between p and i frames.
a1e257b2
MN
1114 * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
1115 * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
64863965
MN
1116 * - encoding: set by user.
1117 * - decoding: unused
b71901e6
MN
1118 */
1119 float i_quant_factor;
115329f1 1120
b71901e6 1121 /**
64863965 1122 * qscale offset between p and i frames.
64863965
MN
1123 * - encoding: set by user.
1124 * - decoding: unused
b71901e6
MN
1125 */
1126 float i_quant_offset;
115329f1 1127
b71901e6 1128 /**
64863965
MN
1129 * initial complexity for pass1 ratecontrol.
1130 * - encoding: set by user.
1131 * - decoding: unused
b71901e6 1132 */
ce980a95 1133 float rc_initial_cplx;
917e06c8 1134
b71901e6 1135 /**
64863965
MN
1136 * dct algorithm, see FF_DCT_* below.
1137 * - encoding: set by user
1138 * - decoding: unused
b71901e6 1139 */
28db7fce 1140 int dct_algo;
c7e07931 1141#define FF_DCT_AUTO 0
28db7fce 1142#define FF_DCT_FASTINT 1
c7e07931
MO
1143#define FF_DCT_INT 2
1144#define FF_DCT_MMX 3
1145#define FF_DCT_MLIB 4
05c4072b 1146#define FF_DCT_ALTIVEC 5
65e4c8c9 1147#define FF_DCT_FAAN 6
115329f1 1148
c5d309f2 1149 /**
64863965
MN
1150 * luminance masking (0-> disabled).
1151 * - encoding: set by user
1152 * - decoding: unused
c5d309f2
MN
1153 */
1154 float lumi_masking;
115329f1 1155
c5d309f2 1156 /**
64863965
MN
1157 * temporary complexity masking (0-> disabled).
1158 * - encoding: set by user
1159 * - decoding: unused
c5d309f2
MN
1160 */
1161 float temporal_cplx_masking;
115329f1 1162
c5d309f2 1163 /**
64863965
MN
1164 * spatial complexity masking (0-> disabled).
1165 * - encoding: set by user
1166 * - decoding: unused
c5d309f2
MN
1167 */
1168 float spatial_cplx_masking;
115329f1 1169
c5d309f2 1170 /**
64863965
MN
1171 * p block masking (0-> disabled).
1172 * - encoding: set by user
1173 * - decoding: unused
c5d309f2
MN
1174 */
1175 float p_masking;
15415af4 1176
5e746b99 1177 /**
64863965
MN
1178 * darkness masking (0-> disabled).
1179 * - encoding: set by user
1180 * - decoding: unused
5e746b99
MN
1181 */
1182 float dark_masking;
115329f1
DB
1183
1184
3a694b04
NK
1185 /* for binary compatibility */
1186 int unused;
115329f1 1187
0c2dd16e 1188 /**
64863965
MN
1189 * idct algorithm, see FF_IDCT_* below.
1190 * - encoding: set by user
1191 * - decoding: set by user
2ad1516a
MN
1192 */
1193 int idct_algo;
1194#define FF_IDCT_AUTO 0
1195#define FF_IDCT_INT 1
1196#define FF_IDCT_SIMPLE 2
1197#define FF_IDCT_SIMPLEMMX 3
1198#define FF_IDCT_LIBMPEG2MMX 4
1199#define FF_IDCT_PS2 5
1200#define FF_IDCT_MLIB 6
1201#define FF_IDCT_ARM 7
05c4072b 1202#define FF_IDCT_ALTIVEC 8
b82cdc72 1203#define FF_IDCT_SH4 9
bd7d1ea7 1204#define FF_IDCT_SIMPLEARM 10
0fa8158d 1205#define FF_IDCT_H264 11
8b6103da 1206#define FF_IDCT_VP3 12
eba9ae3c 1207#define FF_IDCT_IPP 13
84740d59 1208#define FF_IDCT_XVIDMMX 14
2ad1516a 1209
144f0625 1210 /**
64863965
MN
1211 * slice count.
1212 * - encoding: set by lavc
1213 * - decoding: set by user (or 0)
144f0625
MN
1214 */
1215 int slice_count;
1216 /**
64863965
MN
1217 * slice offsets in the frame in bytes.
1218 * - encoding: set/allocated by lavc
1219 * - decoding: set/allocated by user (or NULL)
144f0625
MN
1220 */
1221 int *slice_offset;
1222
4d2858de 1223 /**
64863965
MN
1224 * error concealment flags.
1225 * - encoding: unused
1226 * - decoding: set by user
4d2858de
MN
1227 */
1228 int error_concealment;
1229#define FF_EC_GUESS_MVS 1
1230#define FF_EC_DEBLOCK 2
1231
6b72ac63 1232 /**
bec89a84 1233 * dsp_mask could be add used to disable unwanted CPU features
8350df97 1234 * CPU features (i.e. MMX, SSE. ...)
bec89a84
ZK
1235 *
1236 * with FORCE flag you may instead enable given CPU features
1237 * (Dangerous: usable in case of misdetection, improper usage however will
1238 * result into program crash)
1239 */
1240 unsigned dsp_mask;
bb270c08 1241#define FF_MM_FORCE 0x80000000 /* force usage of selected flags (OR) */
bec89a84
ZK
1242 /* lower 16 bits - CPU features */
1243#ifdef HAVE_MMX
bb270c08
DB
1244#define FF_MM_MMX 0x0001 /* standard MMX */
1245#define FF_MM_3DNOW 0x0004 /* AMD 3DNOW */
1246#define FF_MM_MMXEXT 0x0002 /* SSE integer functions or AMD MMX ext */
1247#define FF_MM_SSE 0x0008 /* SSE functions */
1248#define FF_MM_SSE2 0x0010 /* PIV SSE2 functions */
1249#define FF_MM_3DNOWEXT 0x0020 /* AMD 3DNowExt */
bec89a84 1250#endif /* HAVE_MMX */
eba9ae3c 1251#ifdef HAVE_IWMMXT
bb270c08 1252#define FF_MM_IWMMXT 0x0100 /* XScale IWMMXT */
eba9ae3c 1253#endif /* HAVE_IWMMXT */
11f18faf
MN
1254
1255 /**
64863965
MN
1256 * bits per sample/pixel from the demuxer (needed for huffyuv).
1257 * - encoding: set by lavc
1258 * - decoding: set by user
11f18faf
MN
1259 */
1260 int bits_per_sample;
115329f1 1261
11f18faf 1262 /**
64863965
MN
1263 * prediction method (needed for huffyuv).
1264 * - encoding: set by user
1265 * - decoding: unused
11f18faf
MN
1266 */
1267 int prediction_method;
1268#define FF_PRED_LEFT 0
1269#define FF_PRED_PLANE 1
1270#define FF_PRED_MEDIAN 2
115329f1 1271
5d3cea3a 1272 /**
5ff85f1d 1273 * sample aspect ratio (0 if unknown).
1f26c6f3 1274 * numerator and denominator must be relative prime and smaller then 256 for some video standards
64863965
MN
1275 * - encoding: set by user.
1276 * - decoding: set by lavc.
5d3cea3a 1277 */
5ff85f1d 1278 AVRational sample_aspect_ratio;
1e491e29
MN
1279
1280 /**
64863965
MN
1281 * the picture in the bitstream.
1282 * - encoding: set by lavc
1283 * - decoding: set by lavc
1e491e29 1284 */
492cd3a9 1285 AVFrame *coded_frame;
c8c437bc
MN
1286
1287 /**
64863965
MN
1288 * debug.
1289 * - encoding: set by user.
1290 * - decoding: set by user.
c8c437bc
MN
1291 */
1292 int debug;
1293#define FF_DEBUG_PICT_INFO 1
1294#define FF_DEBUG_RC 2
1295#define FF_DEBUG_BITSTREAM 4
1296#define FF_DEBUG_MB_TYPE 8
1297#define FF_DEBUG_QP 16
1298#define FF_DEBUG_MV 32
8289c6fa 1299#define FF_DEBUG_DCT_COEFF 0x00000040
41773b73
MN
1300#define FF_DEBUG_SKIP 0x00000080
1301#define FF_DEBUG_STARTCODE 0x00000100
1302#define FF_DEBUG_PTS 0x00000200
46b4feec 1303#define FF_DEBUG_ER 0x00000400
0da71265 1304#define FF_DEBUG_MMCO 0x00000800
8fc6c2b5 1305#define FF_DEBUG_BUGS 0x00001000
864119b6
MN
1306#define FF_DEBUG_VIS_QP 0x00002000
1307#define FF_DEBUG_VIS_MB_TYPE 0x00004000
115329f1 1308
140cb663 1309 /**
0c9bbaec
WH
1310 * debug.
1311 * - encoding: set by user.
1312 * - decoding: set by user.
1313 */
1314 int debug_mv;
1315#define FF_DEBUG_VIS_MV_P_FOR 0x00000001 //visualize forward predicted MVs of P frames
1316#define FF_DEBUG_VIS_MV_B_FOR 0x00000002 //visualize forward predicted MVs of B frames
1317#define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames
1318
1319 /**
64863965
MN
1320 * error.
1321 * - encoding: set by lavc if flags&CODEC_FLAG_PSNR
1322 * - decoding: unused
140cb663
MN
1323 */
1324 uint64_t error[4];
115329f1 1325
17a70fde 1326 /**
64863965 1327 * minimum MB quantizer.
6e0d8c06 1328 * - encoding: unused
64863965 1329 * - decoding: unused
17a70fde
MN
1330 */
1331 int mb_qmin;
1332
1333 /**
64863965 1334 * maximum MB quantizer.
6e0d8c06 1335 * - encoding: unused
64863965 1336 * - decoding: unused
17a70fde
MN
1337 */
1338 int mb_qmax;
115329f1 1339
1457ab52 1340 /**
64863965
MN
1341 * motion estimation compare function.
1342 * - encoding: set by user.
1343 * - decoding: unused
1457ab52
MN
1344 */
1345 int me_cmp;
1346 /**
64863965
MN
1347 * subpixel motion estimation compare function.
1348 * - encoding: set by user.
1349 * - decoding: unused
1457ab52
MN
1350 */
1351 int me_sub_cmp;
1352 /**
64863965
MN
1353 * macroblock compare function (not supported yet).
1354 * - encoding: set by user.
1355 * - decoding: unused
1457ab52
MN
1356 */
1357 int mb_cmp;
622348f9
MN
1358 /**
1359 * interlaced dct compare function
1360 * - encoding: set by user.
1361 * - decoding: unused
1362 */
1363 int ildct_cmp;
1457ab52
MN
1364#define FF_CMP_SAD 0
1365#define FF_CMP_SSE 1
1366#define FF_CMP_SATD 2
1367#define FF_CMP_DCT 3
1368#define FF_CMP_PSNR 4
1369#define FF_CMP_BIT 5
1370#define FF_CMP_RD 6
1371#define FF_CMP_ZERO 7
622348f9
MN
1372#define FF_CMP_VSAD 8
1373#define FF_CMP_VSSE 9
e6a2ac34 1374#define FF_CMP_NSSE 10
26efc54e
MN
1375#define FF_CMP_W53 11
1376#define FF_CMP_W97 12
0fd6aea1 1377#define FF_CMP_DCTMAX 13
27c61ac5 1378#define FF_CMP_DCT264 14
1457ab52 1379#define FF_CMP_CHROMA 256
115329f1 1380
1457ab52 1381 /**
64863965
MN
1382 * ME diamond size & shape.
1383 * - encoding: set by user.
1384 * - decoding: unused
1457ab52
MN
1385 */
1386 int dia_size;
b07a5980
MN
1387
1388 /**
64863965
MN
1389 * amount of previous MV predictors (2a+1 x 2a+1 square).
1390 * - encoding: set by user.
1391 * - decoding: unused
b07a5980
MN
1392 */
1393 int last_predictor_count;
70ac76c0 1394
f5fb6b34 1395 /**
64863965
MN
1396 * pre pass for motion estimation.
1397 * - encoding: set by user.
1398 * - decoding: unused
f5fb6b34
MN
1399 */
1400 int pre_me;
b07a5980 1401
70ac76c0 1402 /**
64863965
MN
1403 * motion estimation pre pass compare function.
1404 * - encoding: set by user.
1405 * - decoding: unused
70ac76c0
MN
1406 */
1407 int me_pre_cmp;
826f429a 1408
70ac76c0 1409 /**
64863965
MN
1410 * ME pre pass diamond size & shape.
1411 * - encoding: set by user.
1412 * - decoding: unused
70ac76c0
MN
1413 */
1414 int pre_dia_size;
1415
826f429a 1416 /**
64863965
MN
1417 * subpel ME quality.
1418 * - encoding: set by user.
1419 * - decoding: unused
826f429a
MN
1420 */
1421 int me_subpel_quality;
1422
a33c7159 1423 /**
64863965 1424 * callback to negotiate the pixelFormat.
a33c7159
MN
1425 * @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
64863965
MN
1429 * - encoding: unused
1430 * - decoding: set by user, if not set then the native format will always be choosen
a33c7159 1431 */
494c56d3 1432 enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt);
e2f9490e
FB
1433
1434 /**
1435 * DTG active format information (additionnal aspect ratio
1436 * information only used in DVB MPEG2 transport streams). 0 if
1437 * not set.
115329f1 1438 *
64863965 1439 * - encoding: unused.
115329f1 1440 * - decoding: set by decoder
e2f9490e
FB
1441 */
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
ebbcdc9a
MN
1451 /**
1452 * Maximum motion estimation search range in subpel units.
1453 * if 0 then no limit
115329f1 1454 *
64863965
MN
1455 * - encoding: set by user.
1456 * - decoding: unused.
ebbcdc9a 1457 */
59e0ac8e 1458 int me_range;
ebbcdc9a 1459
65f7062d 1460 /**
1984f635
MN
1461 * intra quantizer bias.
1462 * - encoding: set by user.
1463 * - decoding: unused
1464 */
1465 int intra_quant_bias;
1466#define FF_DEFAULT_QUANT_BIAS 999999
115329f1 1467
1984f635
MN
1468 /**
1469 * inter quantizer bias.
1470 * - encoding: set by user.
1471 * - decoding: unused
1472 */
1473 int inter_quant_bias;
5cd62665
ZK
1474
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;
115329f1 1482
d90cf87b 1483 /**
115329f1 1484 * internal_buffer count.
bb628dae 1485 * Don't touch, used by lavc default_get_buffer()
d90cf87b
MN
1486 */
1487 int internal_buffer_count;
115329f1 1488
d90cf87b 1489 /**
115329f1 1490 * internal_buffers.
bb628dae 1491 * Don't touch, used by lavc default_get_buffer()
d90cf87b
MN
1492 */
1493 void *internal_buffer;
158c7f05
MN
1494
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
3d2e8cce
MN
1501 /**
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;
115329f1 1508
11e659c2
MN
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;
5639729b
MN
1524#if 0
1525 /**
1526 *
1527 * - encoding: unused
1528 * - decoding: set by user.
1529 */
1530 uint8_t * (*realloc)(struct AVCodecContext *s, uint8_t *buf, int buf_size);
1531#endif
115329f1 1532
3bb07d61
MN
1533 /**
1534 * slice flags
1535 * - encoding: unused
1536 * - decoding: set by user.
1537 */
1538 int slice_flags;
1539#define SLICE_FLAG_CODED_ORDER 0x0001 ///< draw_horiz_band() is called in coded order instead of display
1540#define SLICE_FLAG_ALLOW_FIELD 0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics)
1541#define SLICE_FLAG_ALLOW_PLANE 0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)
1542
fb364ada
IK
1543 /**
1544 * XVideo Motion Acceleration
1545 * - encoding: forbidden
1546 * - decoding: set by decoder
1547 */
1548 int xvmc_acceleration;
115329f1 1549
7d1c3fc1
MN
1550 /**
1551 * macroblock decision mode
1552 * - encoding: set by user.
1553 * - decoding: unused
1554 */
1555 int mb_decision;
1556#define FF_MB_DECISION_SIMPLE 0 ///< uses mb_cmp
1557#define FF_MB_DECISION_BITS 1 ///< chooses the one which needs the fewest bits
1558#define FF_MB_DECISION_RD 2 ///< rate distoration
d6eb3c50
MN
1559
1560 /**
1561 * custom intra quantization matrix
1562 * - encoding: set by user, can be NULL
1563 * - decoding: set by lavc
1564 */
1565 uint16_t *intra_matrix;
1566
1567 /**
1568 * custom inter quantization matrix
1569 * - encoding: set by user, can be NULL
1570 * - decoding: set by lavc
1571 */
1572 uint16_t *inter_matrix;
115329f1 1573
541ae140
MN
1574 /**
1575 * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
1576 * this is used to workaround some encoder bugs
1577 * - encoding: unused
1578 * - decoding: set by user, will be converted to upper case by lavc during init
1579 */
1580 unsigned int stream_codec_tag;
05fbd0a2
MN
1581
1582 /**
1583 * scene change detection threshold.
1584 * 0 is default, larger means fewer detected scene changes
1585 * - encoding: set by user.
1586 * - decoding: unused
1587 */
1588 int scenechange_threshold;
158c7f05
MN
1589
1590 /**
1591 * minimum lagrange multipler
1592 * - encoding: set by user.
1593 * - decoding: unused
1594 */
1595 int lmin;
1596
1597 /**
1598 * maximum lagrange multipler
1599 * - encoding: set by user.
1600 * - decoding: unused
1601 */
1602 int lmax;
2a2bbcb0
MM
1603
1604 /**
1605 * Palette control structure
1606 * - encoding: ??? (no palette-enabled encoder yet)
1607 * - decoding: set by user.
1608 */
1609 struct AVPaletteControl *palctrl;
821cb11f
MN
1610
1611 /**
1612 * noise reduction strength
1613 * - encoding: set by user.
1614 * - decoding: unused
1615 */
1616 int noise_reduction;
115329f1 1617
074c4ca7 1618 /**
e1c2a5a0
RT
1619 * called at the beginning of a frame to get cr buffer for it.
1620 * buffer type (size, hints) must be the same. lavc won't check it.
1621 * lavc will pass previous buffer in pic, function should return
1622 * same buffer or new buffer with old frame "painted" into it.
1623 * if pic.data[0] == NULL must behave like get_buffer().
074c4ca7 1624 * - encoding: unused
e1c2a5a0 1625 * - decoding: set by lavc, user can override
074c4ca7 1626 */
e1c2a5a0 1627 int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic);
ba58dabc
MN
1628
1629 /**
1630 * number of bits which should be loaded into the rc buffer before decoding starts
1631 * - encoding: set by user.
1632 * - decoding: unused
1633 */
1634 int rc_initial_buffer_occupancy;
1635
1636 /**
1637 *
1638 * - encoding: set by user.
1639 * - decoding: unused
1640 */
1641 int inter_threshold;
1642
1643 /**
1644 * CODEC_FLAG2_*.
1645 * - encoding: set by user.
1646 * - decoding: set by user.
1647 */
1648 int flags2;
7ebfc0ea
MN
1649
1650 /**
1651 * simulates errors in the bitstream to test error concealment.
1652 * - encoding: set by user.
1653 * - decoding: unused.
1654 */
1655 int error_rate;
115329f1 1656
a1e257b2
MN
1657 /**
1658 * MP3 antialias algorithm, see FF_AA_* below.
1659 * - encoding: unused
1660 * - decoding: set by user
1661 */
1662 int antialias_algo;
1663#define FF_AA_AUTO 0
1664#define FF_AA_FASTINT 1 //not implemented yet
1665#define FF_AA_INT 2
1666#define FF_AA_FLOAT 3
77ea0d4b
MN
1667 /**
1668 * Quantizer noise shaping.
1669 * - encoding: set by user
1670 * - decoding: unused
1671 */
1672 int quantizer_noise_shaping;
9c3d33d6
MN
1673
1674 /**
1675 * Thread count.
1676 * is used to decide how many independant tasks should be passed to execute()
1677 * - encoding: set by user
1678 * - decoding: set by user
1679 */
1680 int thread_count;
115329f1 1681
9c3d33d6
MN
1682 /**
1683 * the codec may call this to execute several independant things. it will return only after
1684 * finishing all tasks, the user may replace this with some multithreaded implementation, the
1685 * default implementation will execute the parts serially
399cec2f 1686 * @param count the number of things to execute
9c3d33d6
MN
1687 * - encoding: set by lavc, user can override
1688 * - decoding: set by lavc, user can override
1689 */
1690 int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void **arg2, int *ret, int count);
115329f1 1691
9c3d33d6
MN
1692 /**
1693 * Thread opaque.
1694 * can be used by execute() to store some per AVCodecContext stuff.
1695 * - encoding: set by execute()
1696 * - decoding: set by execute()
1697 */
1698 void *thread_opaque;
a4d36c11
MN
1699
1700 /**
115329f1 1701 * Motion estimation threshold. under which no motion estimation is
f20f8a8b 1702 * performed, but instead the user specified motion vectors are used
115329f1 1703 *
a4d36c11 1704 * - encoding: set by user
f20f8a8b 1705 * - decoding: unused
a4d36c11 1706 */
2750b827 1707 int me_threshold;
f20f8a8b
MN
1708
1709 /**
1710 * Macroblock threshold. under which the user specified macroblock types will be used
1711 * - encoding: set by user
1712 * - decoding: unused
1713 */
1714 int mb_threshold;
bf266e19
MN
1715
1716 /**
d4c5d2ad 1717 * precision of the intra dc coefficient - 8.
bf266e19
MN
1718 * - encoding: set by user
1719 * - decoding: unused
1720 */
1721 int intra_dc_precision;
d4c5d2ad
MN
1722
1723 /**
1724 * noise vs. sse weight for the nsse comparsion function.
1725 * - encoding: set by user
1726 * - decoding: unused
1727 */
1728 int nsse_weight;
0dfd33c3
MN
1729
1730 /**
160d679c 1731 * number of macroblock rows at the top which are skipped.
0dfd33c3
MN
1732 * - encoding: unused
1733 * - decoding: set by user
1734 */
1735 int skip_top;
1736
1737 /**
160d679c 1738 * number of macroblock rows at the bottom which are skipped.
0dfd33c3
MN
1739 * - encoding: unused
1740 * - decoding: set by user
1741 */
1742 int skip_bottom;
baced9f5
MN
1743
1744 /**
1745 * profile
1746 * - encoding: set by user
1747 * - decoding: set by lavc
1748 */
1749 int profile;
1750#define FF_PROFILE_UNKNOWN -99
1751
1752 /**
1753 * level
1754 * - encoding: set by user
1755 * - decoding: set by lavc
1756 */
1757 int level;
1758#define FF_LEVEL_UNKNOWN -99
178fcca8
MN
1759
1760 /**
1761 * low resolution decoding. 1-> 1/2 size, 2->1/4 size
1762 * - encoding: unused
1763 * - decoding: set by user
1764 */
1765 int lowres;
21adafec
MN
1766
1767 /**
bbf18b21 1768 * bitsream width / height. may be different from width/height if lowres
21adafec
MN
1769 * or other things are used
1770 * - encoding: unused
1771 * - decoding: set by user before init if known, codec should override / dynamically change if needed
1772 */
1773 int coded_width, coded_height;
bbf18b21
MN
1774
1775 /**
1776 * frame skip threshold
1777 * - encoding: set by user
1778 * - decoding: unused
1779 */
1780 int frame_skip_threshold;
1781
1782 /**
1783 * frame skip factor
1784 * - encoding: set by user
1785 * - decoding: unused
1786 */
1787 int frame_skip_factor;
0fd6aea1
MN
1788
1789 /**
1790 * frame skip exponent
1791 * - encoding: set by user
1792 * - decoding: unused
1793 */
1794 int frame_skip_exp;
1795
1796 /**
1797 * frame skip comparission function
1798 * - encoding: set by user.
1799 * - decoding: unused
1800 */
1801 int frame_skip_cmp;
957c743a
CM
1802
1803 /**
1804 * border processing masking. raises the quantizer for mbs on the borders
1805 * of the picture.
1806 * - encoding: set by user
1807 * - decoding: unused
1808 */
1809 float border_masking;
6e0d8c06
MN
1810
1811 /**
1812 * minimum MB lagrange multipler.
1813 * - encoding: set by user.
1814 * - decoding: unused
1815 */
1816 int mb_lmin;
1817
1818 /**
1819 * maximum MB lagrange multipler.
1820 * - encoding: set by user.
1821 * - decoding: unused
1822 */
1823 int mb_lmax;
09c3e44e
MN
1824
1825 /**
115329f1 1826 *
09c3e44e
MN
1827 * - encoding: set by user.
1828 * - decoding: unused
1829 */
1830 int me_penalty_compensation;
8c3eba7c
MN
1831
1832 /**
115329f1 1833 *
8c3eba7c
MN
1834 * - encoding: unused
1835 * - decoding: set by user.
1836 */
1837 enum AVDiscard skip_loop_filter;
1838
1839 /**
115329f1 1840 *
8c3eba7c
MN
1841 * - encoding: unused
1842 * - decoding: set by user.
1843 */
1844 enum AVDiscard skip_idct;
1845
1846 /**
115329f1 1847 *
8c3eba7c
MN
1848 * - encoding: unused
1849 * - decoding: set by user.
1850 */
1851 enum AVDiscard skip_frame;
316a2ec8
MN
1852
1853 /**
1854 *
1855 * - encoding: set by user.
1856 * - decoding: unused
1857 */
1858 int bidir_refine;
e8501c93
MN
1859
1860 /**
1861 *
1862 * - encoding: set by user.
1863 * - decoding: unused
1864 */
1865 int brd_scale;
58f7833e
RS
1866
1867 /**
1868 * constant rate factor - quality-based VBR - values ~correspond to qps
1869 * - encoding: set by user.
1870 * - decoding: unused
1871 */
1872 int crf;
1873
1874 /**
1875 * constant quantization parameter rate control method
1876 * - encoding: set by user.
1877 * - decoding: unused
1878 */
1879 int cqp;
1880
1881 /**
1882 * minimum gop size
1883 * - encoding: set by user.
1884 * - decoding: unused
1885 */
1886 int keyint_min;
1887
1888 /**
1889 * number of reference frames
1890 * - encoding: set by user.
1891 * - decoding: unused
1892 */
1893 int refs;
1894
1895 /**
1896 * chroma qp offset from luma
1897 * - encoding: set by user.
1898 * - decoding: unused
1899 */
1900 int chromaoffset;
1901
1902 /**
1903 * influences how often b-frames are used
1904 * - encoding: set by user.
1905 * - decoding: unused
1906 */
1907 int bframebias;
1908
1909 /**
1910 * trellis RD quantization
1911 * - encoding: set by user.
1912 * - decoding: unused
1913 */
1914 int trellis;
1915
1916 /**
1917 * reduce fluctuations in qp (before curve compression)
1918 * - encoding: set by user.
1919 * - decoding: unused
1920 */
1921 float complexityblur;
1922
1923 /**
1924 * in-loop deblocking filter alphac0 parameter
1925 * alpha is in the range -6...6
1926 * - encoding: set by user.
1927 * - decoding: unused
1928 */
1929 int deblockalpha;
1930
1931 /**
1932 * in-loop deblocking filter beta parameter
1933 * beta is in the range -6...6
1934 * - encoding: set by user.
1935 * - decoding: unused
1936 */
1937 int deblockbeta;
1938
1939 /**
1940 * macroblock subpartition sizes to consider - p8x8, p4x4, b8x8, i8x8, i4x4
1941 * - encoding: set by user.
1942 * - decoding: unused
1943 */
1944 int partitions;
1945#define X264_PART_I4X4 0x001 /* Analyse i4x4 */
1946#define X264_PART_I8X8 0x002 /* Analyse i8x8 (requires 8x8 transform) */
1947#define X264_PART_P8X8 0x010 /* Analyse p16x8, p8x16 and p8x8 */
1948#define X264_PART_P4X4 0x020 /* Analyse p8x4, p4x8, p4x4 */
1949#define X264_PART_B8X8 0x100 /* Analyse b16x8, b8x16 and b8x8 */
1950
1951 /**
1952 * direct mv prediction mode - 0 (none), 1 (spatial), 2 (temporal)
1953 * - encoding: set by user.
1954 * - decoding: unused
1955 */
1956 int directpred;
4f59b684 1957
14f0c8e2
LA
1958 /**
1959 * audio cutoff bandwidth (0 means "automatic") . Currently used only by FAAC
1960 * - encoding: set by user.
1961 * - decoding: unused
1962 */
1963 int cutoff;
39a64e30
CH
1964
1965 /**
1966 * multiplied by qscale for each frame and added to scene_change_score
1967 * - encoding: set by user.
1968 * - decoding: unused
1969 */
1970 int scenechange_factor;
1dd509b1
MN
1971
1972 /**
1973 *
1974 * note: value depends upon the compare functin used for fullpel ME
1975 * - encoding: set by user.
1976 * - decoding: unused
1977 */
1978 int mv0_threshold;
f9243d34
CH
1979
1980 /**
1981 * adjusts sensitivity of b_frame_strategy 1
1982 * - encoding: set by user.
1983 * - decoding: unused
1984 */
1985 int b_sensitivity;
de6d9b64
FB
1986} AVCodecContext;
1987
64863965
MN
1988/**
1989 * AVCodec.
1990 */
de6d9b64 1991typedef struct AVCodec {
18f77016 1992 const char *name;
5d234974 1993 enum CodecType type;
9297ddd3 1994 enum CodecID id;
de6d9b64
FB
1995 int priv_data_size;
1996 int (*init)(AVCodecContext *);
0c1a9eda 1997 int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
de6d9b64 1998 int (*close)(AVCodecContext *);
0fd90455 1999 int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
0c1a9eda 2000 uint8_t *buf, int buf_size);
bf89e6b1 2001 int capabilities;
a1043f9c 2002#if LIBAVCODEC_VERSION_INT < ((50<<16)+(0<<8)+0)
40c5fa26 2003 void *dummy; // FIXME remove next time we break binary compatibility
a1043f9c 2004#endif
de6d9b64 2005 struct AVCodec *next;
7a06ff14 2006 void (*flush)(AVCodecContext *);
b0df362b 2007 const AVRational *supported_framerates; ///array of supported framerates, or NULL if any, array is terminated by {0,0}
fcee0164 2008 const enum PixelFormat *pix_fmts; ///array of supported pixel formats, or NULL if unknown, array is terminanted by -1
de6d9b64
FB
2009} AVCodec;
2010
97d96aaa 2011/**
d7425f59
MN
2012 * four components are given, that's all.
2013 * the last component is alpha
2014 */
de6d9b64 2015typedef struct AVPicture {
0c1a9eda 2016 uint8_t *data[4];
cd394651 2017 int linesize[4]; ///< number of bytes per line
de6d9b64
FB
2018} AVPicture;
2019
ba118447
MM
2020/**
2021 * AVPaletteControl
2022 * This structure defines a method for communicating palette changes
2023 * between and demuxer and a decoder.
2024 */
2e99641b 2025#define AVPALETTE_SIZE 1024
432d84c3 2026#define AVPALETTE_COUNT 256
ba118447
MM
2027typedef struct AVPaletteControl {
2028
2029 /* demuxer sets this to 1 to indicate the palette has changed;
2030 * decoder resets to 0 */
2031 int palette_changed;
2032
2a2bbcb0
MM
2033 /* 4-byte ARGB palette entries, stored in native byte order; note that
2034 * the individual palette components should be on a 8-bit scale; if
2035 * the palette data comes from a IBM VGA native format, the component
2036 * data is probably 6 bits in size and needs to be scaled */
2e99641b 2037 unsigned int palette[AVPALETTE_COUNT];
ba118447
MM
2038
2039} AVPaletteControl;
2040
c6ec28b1 2041typedef struct AVSubtitleRect {
240c1657
FB
2042 uint16_t x;
2043 uint16_t y;
2044 uint16_t w;
2045 uint16_t h;
2046 uint16_t nb_colors;
240c1657
FB
2047 int linesize;
2048 uint32_t *rgba_palette;
2049 uint8_t *bitmap;
c6ec28b1
MN
2050} AVSubtitleRect;
2051
2052typedef struct AVSubtitle {
2053 uint16_t format; /* 0 = graphics */
2054 uint32_t start_display_time; /* relative to packet pts, in ms */
2055 uint32_t end_display_time; /* relative to packet pts, in ms */
2056 uint32_t num_rects;
2057 AVSubtitleRect *rects;
240c1657
FB
2058} AVSubtitle;
2059
de6d9b64
FB
2060extern AVCodec ac3_encoder;
2061extern AVCodec mp2_encoder;
9d36bdc9 2062extern AVCodec mp3lame_encoder;
81e0d0b4 2063extern AVCodec oggvorbis_encoder;
5c5dea3f 2064extern AVCodec oggtheora_encoder;
29d48296 2065extern AVCodec faac_encoder;
9e96ab03 2066extern AVCodec flac_encoder;
1ddadfa9 2067extern AVCodec xvid_encoder;
de6d9b64 2068extern AVCodec mpeg1video_encoder;
029911d1 2069extern AVCodec mpeg2video_encoder;
1c3990db 2070extern AVCodec h261_encoder;
de6d9b64
FB
2071extern AVCodec h263_encoder;
2072extern AVCodec h263p_encoder;
d4f5d74a 2073extern AVCodec flv_encoder;
de6d9b64 2074extern AVCodec rv10_encoder;
68b94c35 2075extern AVCodec rv20_encoder;
6faa4645 2076extern AVCodec dvvideo_encoder;
de6d9b64 2077extern AVCodec mjpeg_encoder;
b1e6b355 2078extern AVCodec ljpeg_encoder;
5639729b 2079extern AVCodec jpegls_encoder;
4eff7cf4 2080extern AVCodec png_encoder;
5b6d5596
MN
2081extern AVCodec ppm_encoder;
2082extern AVCodec pgm_encoder;
2083extern AVCodec pgmyuv_encoder;
2084extern AVCodec pbm_encoder;
2085extern AVCodec pam_encoder;
bf89e6b1 2086extern AVCodec mpeg4_encoder;
84afee34
MN
2087extern AVCodec msmpeg4v1_encoder;
2088extern AVCodec msmpeg4v2_encoder;
2089extern AVCodec msmpeg4v3_encoder;
0151a6f5
MN
2090extern AVCodec wmv1_encoder;
2091extern AVCodec wmv2_encoder;
11f18faf 2092extern AVCodec huffyuv_encoder;
f37b9768 2093extern AVCodec ffvhuff_encoder;
0da71265 2094extern AVCodec h264_encoder;
3d2e8cce 2095extern AVCodec asv1_encoder;
9b56edf5 2096extern AVCodec asv2_encoder;
be3564ed 2097extern AVCodec vcr1_encoder;
5e20f836 2098extern AVCodec ffv1_encoder;
791e7b83 2099extern AVCodec snow_encoder;
c3bf0288 2100extern AVCodec mdec_encoder;
a273bbfb 2101extern AVCodec zlib_encoder;
54f5fd22
AB
2102extern AVCodec sonic_encoder;
2103extern AVCodec sonic_ls_encoder;
3b64893d 2104extern AVCodec svq1_encoder;
6662ec29 2105extern AVCodec x264_encoder;
de6d9b64
FB
2106
2107extern AVCodec h263_decoder;
c6148de2 2108extern AVCodec h261_decoder;
bf89e6b1 2109extern AVCodec mpeg4_decoder;
84afee34
MN
2110extern AVCodec msmpeg4v1_decoder;
2111extern AVCodec msmpeg4v2_decoder;
2112extern AVCodec msmpeg4v3_decoder;
e1a9dbff 2113extern AVCodec wmv1_decoder;
0151a6f5 2114extern AVCodec wmv2_decoder;
10b9c374 2115extern AVCodec vc1_decoder;
21aa398f 2116extern AVCodec wmv3_decoder;
922bc38d
MN
2117extern AVCodec mpeg1video_decoder;
2118extern AVCodec mpeg2video_decoder;
c512b303 2119extern AVCodec mpegvideo_decoder;
fb364ada 2120extern AVCodec mpeg_xvmc_decoder;
de6d9b64 2121extern AVCodec h263i_decoder;
d4f5d74a 2122extern AVCodec flv_decoder;
de6d9b64 2123extern AVCodec rv10_decoder;
68b94c35 2124extern AVCodec rv20_decoder;
3f05305d
MN
2125extern AVCodec rv30_decoder;
2126extern AVCodec rv40_decoder;
be8ffec9 2127extern AVCodec svq1_decoder;
8b82a956 2128extern AVCodec svq3_decoder;
020fcc94 2129extern AVCodec dvvideo_decoder;
bc8d1857
FB
2130extern AVCodec wmav1_decoder;
2131extern AVCodec wmav2_decoder;
4e66ab3b 2132extern AVCodec mjpeg_decoder;
b135d9fb 2133extern AVCodec mjpegb_decoder;
5e83dec4 2134extern AVCodec sp5x_decoder;
4eff7cf4 2135extern AVCodec png_decoder;
4b1f4f23 2136extern AVCodec mp2_decoder;
a96b68b7 2137extern AVCodec mp3_decoder;
1ede228a 2138extern AVCodec mp3adu_decoder;
d2a7718d 2139extern AVCodec mp3on4_decoder;
d9b1c197 2140extern AVCodec qdm2_decoder;
e0f7e329 2141extern AVCodec cook_decoder;
bf3027c8 2142extern AVCodec truespeech_decoder;
a24c4a2a 2143extern AVCodec tta_decoder;
3f95e843
FR
2144extern AVCodec mace3_decoder;
2145extern AVCodec mace6_decoder;
11f18faf 2146extern AVCodec huffyuv_decoder;
f37b9768 2147extern AVCodec ffvhuff_decoder;
3aca208a 2148extern AVCodec oggvorbis_decoder;
5c5dea3f 2149extern AVCodec oggtheora_decoder;
f70f7c6d 2150extern AVCodec cyuv_decoder;
0da71265 2151extern AVCodec h264_decoder;
deabd4fd 2152extern AVCodec indeo3_decoder;
d86053a4 2153extern AVCodec vp3_decoder;
f44ee2c3 2154extern AVCodec theora_decoder;
891f64b3 2155extern AVCodec amr_nb_decoder;
bc634f6f 2156extern AVCodec amr_nb_encoder;
d663a1fd
MN
2157extern AVCodec amr_wb_encoder;
2158extern AVCodec amr_wb_decoder;
280bd7b7
ZK
2159extern AVCodec aac_decoder;
2160extern AVCodec mpeg4aac_decoder;
3d2e8cce 2161extern AVCodec asv1_decoder;
9b56edf5 2162extern AVCodec asv2_decoder;
be3564ed 2163extern AVCodec vcr1_decoder;
3aff069b 2164extern AVCodec cljr_decoder;
5e20f836 2165extern AVCodec ffv1_decoder;
791e7b83 2166extern AVCodec snow_decoder;
8809cfee 2167extern AVCodec fourxm_decoder;
c3bf0288 2168extern AVCodec mdec_decoder;
3ef8be2b
MM
2169extern AVCodec roq_decoder;
2170extern AVCodec interplay_video_decoder;
9937e686 2171extern AVCodec xan_wc3_decoder;
2fdf638b
MM
2172extern AVCodec rpza_decoder;
2173extern AVCodec cinepak_decoder;
2174extern AVCodec msrle_decoder;
2175extern AVCodec msvideo1_decoder;
6955a882 2176extern AVCodec vqa_decoder;
4120a53a 2177extern AVCodec idcin_decoder;
1dc1ed99 2178extern AVCodec eightbps_decoder;
11e29a41 2179extern AVCodec smc_decoder;
42cad81a 2180extern AVCodec flic_decoder;
fafa0b75
MM
2181extern AVCodec vmdvideo_decoder;
2182extern AVCodec vmdaudio_decoder;
9a4117d5 2183extern AVCodec truemotion1_decoder;
64af6168 2184extern AVCodec truemotion2_decoder;
a273bbfb
RT
2185extern AVCodec mszh_decoder;
2186extern AVCodec zlib_decoder;
b8414bbd
NK
2187extern AVCodec ra_144_decoder;
2188extern AVCodec ra_288_decoder;
3ef8be2b
MM
2189extern AVCodec roq_dpcm_decoder;
2190extern AVCodec interplay_dpcm_decoder;
9937e686 2191extern AVCodec xan_dpcm_decoder;
d08d7142 2192extern AVCodec sol_dpcm_decoder;
54f5fd22 2193extern AVCodec sonic_decoder;
070ed1bc 2194extern AVCodec qtrle_decoder;
ac2570a8 2195extern AVCodec flac_decoder;
9d53d58e 2196extern AVCodec tscc_decoder;
e0f80bd7 2197extern AVCodec cscd_decoder;
dfca23e3 2198extern AVCodec nuv_decoder;
d0a0bbd2 2199extern AVCodec ulti_decoder;
d08d7142 2200extern AVCodec qdraw_decoder;
ab711b3c 2201extern AVCodec xl_decoder;
acfd8f0f 2202extern AVCodec qpeg_decoder;
85ad5695 2203extern AVCodec shorten_decoder;
9c7fb608 2204extern AVCodec loco_decoder;
a8a15e9d 2205extern AVCodec wnv1_decoder;
589f8220 2206extern AVCodec aasc_decoder;
6d6d7970 2207extern AVCodec alac_decoder;
034eeaa1 2208extern AVCodec ws_snd1_decoder;
856dbbff 2209extern AVCodec indeo2_decoder;
0bde73d9 2210extern AVCodec vorbis_decoder;
b81f8949 2211extern AVCodec fraps_decoder;
bb4c2140
MN
2212extern AVCodec libgsm_encoder;
2213extern AVCodec libgsm_decoder;
9fa62f2a 2214extern AVCodec bmp_decoder;
4e114829 2215extern AVCodec mmvideo_decoder;
9c8d8e84 2216extern AVCodec zmbv_decoder;
26376701 2217extern AVCodec avs_decoder;
348efc18
KS
2218extern AVCodec smacker_decoder;
2219extern AVCodec smackaud_decoder;
0c35eb1c 2220extern AVCodec kmvc_decoder;
0919e788 2221extern AVCodec flashsv_decoder;
de6d9b64 2222
a96b68b7
FB
2223/* pcm codecs */
2224#define PCM_CODEC(id, name) \
2225extern AVCodec name ## _decoder; \
f11d3f23 2226extern AVCodec name ## _encoder
a96b68b7 2227
b461b3bc
RD
2228PCM_CODEC(CODEC_ID_PCM_S32LE, pcm_s32le);
2229PCM_CODEC(CODEC_ID_PCM_S32BE, pcm_s32be);
2230PCM_CODEC(CODEC_ID_PCM_U32LE, pcm_u32le);
2231PCM_CODEC(CODEC_ID_PCM_U32BE, pcm_u32be);
2232PCM_CODEC(CODEC_ID_PCM_S24LE, pcm_s24le);
2233PCM_CODEC(CODEC_ID_PCM_S24BE, pcm_s24be);
2234PCM_CODEC(CODEC_ID_PCM_U24LE, pcm_u24le);
2235PCM_CODEC(CODEC_ID_PCM_U24BE, pcm_u24be);
2236PCM_CODEC(CODEC_ID_PCM_S24DAUD, pcm_s24daud);
a96b68b7
FB
2237PCM_CODEC(CODEC_ID_PCM_S16LE, pcm_s16le);
2238PCM_CODEC(CODEC_ID_PCM_S16BE, pcm_s16be);
2239PCM_CODEC(CODEC_ID_PCM_U16LE, pcm_u16le);
2240PCM_CODEC(CODEC_ID_PCM_U16BE, pcm_u16be);
2241PCM_CODEC(CODEC_ID_PCM_S8, pcm_s8);
2242PCM_CODEC(CODEC_ID_PCM_U8, pcm_u8);
2243PCM_CODEC(CODEC_ID_PCM_ALAW, pcm_alaw);
2244PCM_CODEC(CODEC_ID_PCM_MULAW, pcm_mulaw);
2245
0147f198
FR
2246/* adpcm codecs */
2247
2248PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
2249PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
9937e686
MM
2250PCM_CODEC(CODEC_ID_ADPCM_IMA_DK3, adpcm_ima_dk3);
2251PCM_CODEC(CODEC_ID_ADPCM_IMA_DK4, adpcm_ima_dk4);
2fdf638b 2252PCM_CODEC(CODEC_ID_ADPCM_IMA_WS, adpcm_ima_ws);
7d8379f2 2253PCM_CODEC(CODEC_ID_ADPCM_SMJPEG, adpcm_ima_smjpeg);
0147f198 2254PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);
4b465299 2255PCM_CODEC(CODEC_ID_ADPCM_4XM, adpcm_4xm);
fc384777
MM
2256PCM_CODEC(CODEC_ID_ADPCM_XA, adpcm_xa);
2257PCM_CODEC(CODEC_ID_ADPCM_ADX, adpcm_adx);
7d8379f2 2258PCM_CODEC(CODEC_ID_ADPCM_EA, adpcm_ea);
e5966052 2259PCM_CODEC(CODEC_ID_ADPCM_G726, adpcm_g726);
b3bfb299 2260PCM_CODEC(CODEC_ID_ADPCM_CT, adpcm_ct);
659c3692 2261PCM_CODEC(CODEC_ID_ADPCM_SWF, adpcm_swf);
2ff4524e 2262PCM_CODEC(CODEC_ID_ADPCM_YAMAHA, adpcm_yamaha);
2433f24f
AJ
2263PCM_CODEC(CODEC_ID_ADPCM_SBPRO_4, adpcm_sbpro_4);
2264PCM_CODEC(CODEC_ID_ADPCM_SBPRO_3, adpcm_sbpro_3);
2265PCM_CODEC(CODEC_ID_ADPCM_SBPRO_2, adpcm_sbpro_2);
0147f198 2266
a96b68b7
FB
2267#undef PCM_CODEC
2268
2269/* dummy raw video codec */
63167088
RS
2270extern AVCodec rawvideo_encoder;
2271extern AVCodec rawvideo_decoder;
de6d9b64
FB
2272
2273/* the following codecs use external GPL libs */
de6d9b64 2274extern AVCodec ac3_decoder;
23c99253 2275extern AVCodec dts_decoder;
de6d9b64 2276
240c1657 2277/* subtitles */
689abe56 2278extern AVCodec dvdsub_encoder;
240c1657
FB
2279extern AVCodec dvdsub_decoder;
2280extern AVCodec dvbsub_encoder;
c6ec28b1 2281extern AVCodec dvbsub_decoder;
240c1657 2282
de6d9b64
FB
2283/* resample.c */
2284
2285struct ReSampleContext;
aaaf1635 2286struct AVResampleContext;
de6d9b64
FB
2287
2288typedef struct ReSampleContext ReSampleContext;
2289
115329f1 2290ReSampleContext *audio_resample_init(int output_channels, int input_channels,
de6d9b64
FB
2291 int output_rate, int input_rate);
2292int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
2293void audio_resample_close(ReSampleContext *s);
2294
6e225de2 2295struct AVResampleContext *av_resample_init(int out_rate, int in_rate, int filter_length, int log2_phase_count, int linear, double cutoff);
aaaf1635 2296int av_resample(struct AVResampleContext *c, short *dst, short *src, int *consumed, int src_size, int dst_size, int update_ctx);
2d48eddd 2297void av_resample_compensate(struct AVResampleContext *c, int sample_delta, int compensation_distance);
d88443ae 2298void av_resample_close(struct AVResampleContext *c);
aaaf1635 2299
de6d9b64
FB
2300/* YUV420 format is assumed ! */
2301
2302struct ImgReSampleContext;
2303
2304typedef struct ImgReSampleContext ImgReSampleContext;
2305
2306ImgReSampleContext *img_resample_init(int output_width, int output_height,
2307 int input_width, int input_height);
ab6d194a
MN
2308
2309ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
2310 int iwidth, int iheight,
2311 int topBand, int bottomBand,
1ff93ffc
TK
2312 int leftBand, int rightBand,
2313 int padtop, int padbottom,
2314 int padleft, int padright);
2315
ab6d194a 2316
115329f1 2317void img_resample(ImgReSampleContext *s,
da64ecc3 2318 AVPicture *output, const AVPicture *input);
de6d9b64
FB
2319
2320void img_resample_close(ImgReSampleContext *s);
2321
75917b88
DH
2322/**
2323 * Allocate memory for a picture. Call avpicture_free to free it.
2324 *
2325 * @param picture the picture to be filled in.
2326 * @param pix_fmt the format of the picture.
2327 * @param width the width of the picture.
2328 * @param height the height of the picture.
2329 * @return 0 if successful, -1 if not.
2330 */
2331int avpicture_alloc(AVPicture *picture, int pix_fmt, int width, int height);
2332
2333/* Free a picture previously allocated by avpicture_alloc. */
2334void avpicture_free(AVPicture *picture);
2335
0c1a9eda 2336int avpicture_fill(AVPicture *picture, uint8_t *ptr,
2d1a4094 2337 int pix_fmt, int width, int height);
da64ecc3 2338int avpicture_layout(const AVPicture* src, int pix_fmt, int width, int height,
63167088 2339 unsigned char *dest, int dest_size);
219b06c6 2340int avpicture_get_size(int pix_fmt, int width, int height);
dab64ebc
FB
2341void avcodec_get_chroma_sub_sample(int pix_fmt, int *h_shift, int *v_shift);
2342const char *avcodec_get_pix_fmt_name(int pix_fmt);
21adafec 2343void avcodec_set_dimensions(AVCodecContext *s, int width, int height);
63167088 2344enum PixelFormat avcodec_get_pix_fmt(const char* name);
d07730dd 2345unsigned int avcodec_pix_fmt_to_codec_tag(enum PixelFormat p);
219b06c6 2346
fab21997
FB
2347#define FF_LOSS_RESOLUTION 0x0001 /* loss due to resolution change */
2348#define FF_LOSS_DEPTH 0x0002 /* loss due to color depth change */
2349#define FF_LOSS_COLORSPACE 0x0004 /* loss due to color space conversion */
2350#define FF_LOSS_ALPHA 0x0008 /* loss of alpha bits */
2351#define FF_LOSS_COLORQUANT 0x0010 /* loss due to color quantization */
2352#define FF_LOSS_CHROMA 0x0020 /* loss of chroma (e.g. rgb to gray conversion) */
2353
2354int avcodec_get_pix_fmt_loss(int dst_pix_fmt, int src_pix_fmt,
2355 int has_alpha);
2356int avcodec_find_best_pix_fmt(int pix_fmt_mask, int src_pix_fmt,
2357 int has_alpha, int *loss_ptr);
2358
0469baf1
FB
2359#define FF_ALPHA_TRANSP 0x0001 /* image has some totally transparent pixels */
2360#define FF_ALPHA_SEMI_TRANSP 0x0002 /* image has some transparent pixels */
da64ecc3 2361int img_get_alpha_info(const AVPicture *src,
bb270c08 2362 int pix_fmt, int width, int height);
0469baf1 2363
219b06c6
FB
2364/* convert among pixel formats */
2365int img_convert(AVPicture *dst, int dst_pix_fmt,
115329f1 2366 const AVPicture *src, int pix_fmt,
219b06c6
FB
2367 int width, int height);
2368
2369/* deinterlace a picture */
da64ecc3 2370int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
de6d9b64
FB
2371 int pix_fmt, int width, int height);
2372
2373/* external high level API */
2374
2375extern AVCodec *first_avcodec;
2376
156e5023 2377/* returns LIBAVCODEC_VERSION_INT constant */
51a49663 2378unsigned avcodec_version(void);
8bceb6af 2379/* returns LIBAVCODEC_BUILD constant */
51a49663 2380unsigned avcodec_build(void);
de6d9b64
FB
2381void avcodec_init(void);
2382
2383void register_avcodec(AVCodec *format);
2384AVCodec *avcodec_find_encoder(enum CodecID id);
98f3b098 2385AVCodec *avcodec_find_encoder_by_name(const char *name);
de6d9b64
FB
2386AVCodec *avcodec_find_decoder(enum CodecID id);
2387AVCodec *avcodec_find_decoder_by_name(const char *name);
2388void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
2389
1e491e29 2390void avcodec_get_context_defaults(AVCodecContext *s);
7ffbb60e 2391AVCodecContext *avcodec_alloc_context(void);
7906085f 2392void avcodec_get_frame_defaults(AVFrame *pic);
492cd3a9 2393AVFrame *avcodec_alloc_frame(void);
1e491e29 2394
492cd3a9
MN
2395int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
2396void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
3a569751
MN
2397int avcodec_default_reget_buffer(AVCodecContext *s, AVFrame *pic);
2398void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height);
0ecca7a4 2399int avcodec_check_dimensions(void *av_log_ctx, unsigned int w, unsigned int h);
3a569751 2400enum PixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum PixelFormat * fmt);
1e491e29 2401
5a815088
MN
2402int avcodec_thread_init(AVCodecContext *s, int thread_count);
2403void avcodec_thread_free(AVCodecContext *s);
2404int avcodec_thread_execute(AVCodecContext *s, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
3a569751 2405int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
9c3d33d6
MN
2406//FIXME func typedef
2407
7a06ff14
MN
2408/**
2409 * opens / inits the AVCodecContext.
2410 * not thread save!
2411 */
de6d9b64 2412int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
7a06ff14 2413
115329f1 2414int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples,
de6d9b64 2415 int *frame_size_ptr,
0c1a9eda 2416 uint8_t *buf, int buf_size);
115329f1 2417int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture,
de6d9b64 2418 int *got_picture_ptr,
0c1a9eda 2419 uint8_t *buf, int buf_size);
240c1657
FB
2420int avcodec_decode_subtitle(AVCodecContext *avctx, AVSubtitle *sub,
2421 int *got_sub_ptr,
2422 const uint8_t *buf, int buf_size);
115329f1 2423int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata,
917e06c8 2424 int *data_size_ptr,
0c1a9eda 2425 uint8_t *buf, int buf_size);
115329f1 2426int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size,
de6d9b64 2427 const short *samples);
115329f1 2428int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size,
492cd3a9 2429 const AVFrame *pict);
115329f1 2430int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
240c1657 2431 const AVSubtitle *sub);
de6d9b64
FB
2432
2433int avcodec_close(AVCodecContext *avctx);
2434
2435void avcodec_register_all(void);
a96b68b7 2436
1c2a8c7f
MN
2437void avcodec_flush_buffers(AVCodecContext *avctx);
2438
88730be6
MR
2439void avcodec_default_free_buffers(AVCodecContext *s);
2440
14bea432 2441/* misc usefull functions */
d8085ea7
MN
2442
2443/**
2444 * returns a single letter to describe the picture type
2445 */
2446char av_get_pict_type_char(int pict_type);
2447
2e8f2c20 2448
8424cf50
FB
2449/* frame parsing */
2450typedef struct AVCodecParserContext {
2451 void *priv_data;
2452 struct AVCodecParser *parser;
2453 int64_t frame_offset; /* offset of the current frame */
115329f1 2454 int64_t cur_offset; /* current offset
8424cf50
FB
2455 (incremented by each av_parser_parse()) */
2456 int64_t last_frame_offset; /* offset of the last frame */
2457 /* video info */
2458 int pict_type; /* XXX: put it back in AVCodecContext */
2459 int repeat_pict; /* XXX: put it back in AVCodecContext */
b84f2a35
FB
2460 int64_t pts; /* pts of the current frame */
2461 int64_t dts; /* dts of the current frame */
2462
2463 /* private data */
2464 int64_t last_pts;
2465 int64_t last_dts;
a62aecce 2466 int fetch_timestamp;
b84f2a35
FB
2467
2468#define AV_PARSER_PTS_NB 4
2469 int cur_frame_start_index;
2470 int64_t cur_frame_offset[AV_PARSER_PTS_NB];
2471 int64_t cur_frame_pts[AV_PARSER_PTS_NB];
2472 int64_t cur_frame_dts[AV_PARSER_PTS_NB];
115329f1 2473
7cbaa7ba
MN
2474 int flags;
2475#define PARSER_FLAG_COMPLETE_FRAMES 0x0001
8424cf50
FB
2476} AVCodecParserContext;
2477
2478typedef struct AVCodecParser {
99f06236 2479 int codec_ids[5]; /* several codec IDs are permitted */
8424cf50
FB
2480 int priv_data_size;
2481 int (*parser_init)(AVCodecParserContext *s);
115329f1 2482 int (*parser_parse)(AVCodecParserContext *s,
8424cf50 2483 AVCodecContext *avctx,
115329f1 2484 uint8_t **poutbuf, int *poutbuf_size,
8424cf50
FB
2485 const uint8_t *buf, int buf_size);
2486 void (*parser_close)(AVCodecParserContext *s);
90ad92b3 2487 int (*split)(AVCodecContext *avctx, const uint8_t *buf, int buf_size);
8424cf50
FB
2488 struct AVCodecParser *next;
2489} AVCodecParser;
2490
2491extern AVCodecParser *av_first_parser;
2492
2493void av_register_codec_parser(AVCodecParser *parser);
2494AVCodecParserContext *av_parser_init(int codec_id);
115329f1 2495int av_parser_parse(AVCodecParserContext *s,
8424cf50 2496 AVCodecContext *avctx,
115329f1 2497 uint8_t **poutbuf, int *poutbuf_size,
b84f2a35
FB
2498 const uint8_t *buf, int buf_size,
2499 int64_t pts, int64_t dts);
90ad92b3
MN
2500int av_parser_change(AVCodecParserContext *s,
2501 AVCodecContext *avctx,
115329f1 2502 uint8_t **poutbuf, int *poutbuf_size,
90ad92b3 2503 const uint8_t *buf, int buf_size, int keyframe);
8424cf50
FB
2504void av_parser_close(AVCodecParserContext *s);
2505
2506extern AVCodecParser mpegvideo_parser;
2507extern AVCodecParser mpeg4video_parser;
c6148de2 2508extern AVCodecParser h261_parser;
8424cf50
FB
2509extern AVCodecParser h263_parser;
2510extern AVCodecParser h264_parser;
8e6325b9 2511extern AVCodecParser mjpeg_parser;
99f06236 2512extern AVCodecParser pnm_parser;
8424cf50
FB
2513extern AVCodecParser mpegaudio_parser;
2514extern AVCodecParser ac3_parser;
240c1657 2515extern AVCodecParser dvdsub_parser;
c6ec28b1 2516extern AVCodecParser dvbsub_parser;
da46276f 2517extern AVCodecParser aac_parser;
8424cf50 2518
544eb99c 2519/* memory */
e4eadb4b 2520void *av_malloc(unsigned int size);
18f77016 2521void *av_mallocz(unsigned int size);
8e1e6f31 2522void *av_realloc(void *ptr, unsigned int size);
544eb99c 2523void av_free(void *ptr);
8e1e6f31 2524char *av_strdup(const char *s);
81c5f887 2525void av_freep(void *ptr);
97d96aaa 2526void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
855ea723
ZK
2527/* for static data only */
2528/* call av_free_static to release all staticaly allocated tables */
628d601b 2529void av_free_static(void);
8d1f2ba5 2530void *av_mallocz_static(unsigned int size);
073c2593 2531void *av_realloc_static(void *ptr, unsigned int size);
544eb99c 2532
e1c2a5a0
RT
2533void img_copy(AVPicture *dst, const AVPicture *src,
2534 int pix_fmt, int width, int height);
2535
f2651e7a
BC
2536int img_crop(AVPicture *dst, const AVPicture *src,
2537 int pix_fmt, int top_band, int left_band);
2538
5341c209
LA
2539int img_pad(AVPicture *dst, const AVPicture *src, int height, int width, int pix_fmt,
2540 int padtop, int padbottom, int padleft, int padright, int *color);
2541
9b879566
MB
2542/* av_log API */
2543
2544#include <stdarg.h>
2545
d8019eb5 2546#define AV_LOG_QUIET -1
9b879566
MB
2547#define AV_LOG_ERROR 0
2548#define AV_LOG_INFO 1
2549#define AV_LOG_DEBUG 2
2550
f4bd8cf0 2551#ifdef __GNUC__
bc874dae 2552extern void av_log(void*, int level, const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4)));
f4bd8cf0
MN
2553#else
2554extern void av_log(void*, int level, const char *fmt, ...);
2555#endif
2556
bc874dae 2557extern void av_vlog(void*, int level, const char *fmt, va_list);
9b879566
MB
2558extern int av_log_get_level(void);
2559extern void av_log_set_level(int);
bc874dae 2560extern void av_log_set_callback(void (*)(void*, int, const char*, va_list));
9b879566 2561
3a278992 2562/* endian macros */
e96682e6 2563#if !defined(BE_16) || !defined(BE_32) || !defined(LE_16) || !defined(LE_32)
3a278992
MM
2564#define BE_16(x) ((((uint8_t*)(x))[0] << 8) | ((uint8_t*)(x))[1])
2565#define BE_32(x) ((((uint8_t*)(x))[0] << 24) | \
2566 (((uint8_t*)(x))[1] << 16) | \
2567 (((uint8_t*)(x))[2] << 8) | \
2568 ((uint8_t*)(x))[3])
2569#define LE_16(x) ((((uint8_t*)(x))[1] << 8) | ((uint8_t*)(x))[0])
2570#define LE_32(x) ((((uint8_t*)(x))[3] << 24) | \
2571 (((uint8_t*)(x))[2] << 16) | \
2572 (((uint8_t*)(x))[1] << 8) | \
2573 ((uint8_t*)(x))[0])
e96682e6 2574#endif
3a278992 2575
ad2b531d
MR
2576extern unsigned int av_xiphlacing(unsigned char *s, unsigned int v);
2577
02d697aa
ZK
2578#ifdef __cplusplus
2579}
2580#endif
2581
a96b68b7 2582#endif /* AVCODEC_H */