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