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