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