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