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