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