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