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