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