avcodec.h 65.5 KB
Newer Older
F
Fabrice Bellard 已提交
1 2 3
#ifndef AVCODEC_H
#define AVCODEC_H

M
Michael Niedermayer 已提交
4 5
/**
 * @file avcodec.h
M
doxy  
Michael Niedermayer 已提交
6
 * external api header.
M
Michael Niedermayer 已提交
7 8 9
 */


10 11 12 13
#ifdef __cplusplus
extern "C" {
#endif

F
Fabrice Bellard 已提交
14
#include "common.h"
M
Michael Niedermayer 已提交
15
#include "rational.h"
Z
Zdenek Kabelac 已提交
16
#include <sys/types.h> /* size_t */
F
Fabrice Bellard 已提交
17

F
Fabrice Bellard 已提交
18 19
#define FFMPEG_VERSION_INT     0x000408
#define FFMPEG_VERSION         "0.4.8"
20
#define LIBAVCODEC_BUILD       4717
21

F
Fabrice Bellard 已提交
22 23 24 25 26 27
#define LIBAVCODEC_VERSION_INT FFMPEG_VERSION_INT
#define LIBAVCODEC_VERSION     FFMPEG_VERSION

#define AV_STRINGIFY(s)	AV_TOSTRING(s)
#define AV_TOSTRING(s) #s
#define LIBAVCODEC_IDENT	"FFmpeg" LIBAVCODEC_VERSION "b" AV_STRINGIFY(LIBAVCODEC_BUILD)
A
Alex Beregszaszi 已提交
28

29
#define AV_NOPTS_VALUE int64_t_C(0x8000000000000000)
30 31
#define AV_TIME_BASE 1000000

F
Fabrice Bellard 已提交
32 33 34
enum CodecID {
    CODEC_ID_NONE, 
    CODEC_ID_MPEG1VIDEO,
35
    CODEC_ID_MPEG2VIDEO, /* prefered ID for MPEG Video 1 or 2 decoding */
I
Ivan Kalvachev 已提交
36
    CODEC_ID_MPEG2VIDEO_XVMC,
37
    CODEC_ID_H261,
F
Fabrice Bellard 已提交
38 39
    CODEC_ID_H263,
    CODEC_ID_RV10,
M
Michael Niedermayer 已提交
40
    CODEC_ID_RV20,
F
Fabrice Bellard 已提交
41
    CODEC_ID_MP2,
42
    CODEC_ID_MP3, /* prefered ID for MPEG Audio layer 1, 2 or3 decoding */
43
    CODEC_ID_VORBIS,
F
Fabrice Bellard 已提交
44 45
    CODEC_ID_AC3,
    CODEC_ID_MJPEG,
46
    CODEC_ID_MJPEGB,
47
    CODEC_ID_LJPEG,
48
    CODEC_ID_SP5X,
F
Fabrice Bellard 已提交
49
    CODEC_ID_MPEG4,
F
Fabrice Bellard 已提交
50
    CODEC_ID_RAWVIDEO,
51 52 53
    CODEC_ID_MSMPEG4V1,
    CODEC_ID_MSMPEG4V2,
    CODEC_ID_MSMPEG4V3,
54
    CODEC_ID_WMV1,
M
Michael Niedermayer 已提交
55
    CODEC_ID_WMV2,
F
Fabrice Bellard 已提交
56 57
    CODEC_ID_H263P,
    CODEC_ID_H263I,
58
    CODEC_ID_FLV1,
N
Nick Kurshev 已提交
59
    CODEC_ID_SVQ1,
M
Michael Niedermayer 已提交
60
    CODEC_ID_SVQ3,
F
Fabrice Bellard 已提交
61 62
    CODEC_ID_DVVIDEO,
    CODEC_ID_DVAUDIO,
F
Fabrice Bellard 已提交
63 64
    CODEC_ID_WMAV1,
    CODEC_ID_WMAV2,
65 66
    CODEC_ID_MACE3,
    CODEC_ID_MACE6,
M
huffyuv  
Michael Niedermayer 已提交
67
    CODEC_ID_HUFFYUV,
68
    CODEC_ID_CYUV,
M
Michael Niedermayer 已提交
69
    CODEC_ID_H264,
70
    CODEC_ID_INDEO3,
71
    CODEC_ID_VP3,
72
    CODEC_ID_THEORA,
73 74
    CODEC_ID_AAC,
    CODEC_ID_MPEG4AAC,
M
Michael Niedermayer 已提交
75
    CODEC_ID_ASV1,
M
Michael Niedermayer 已提交
76
    CODEC_ID_ASV2,
77
    CODEC_ID_FFV1,
78
    CODEC_ID_4XM,
M
Michael Niedermayer 已提交
79
    CODEC_ID_VCR1,
A
Alex Beregszaszi 已提交
80
    CODEC_ID_CLJR,
81
    CODEC_ID_MDEC,
82 83
    CODEC_ID_ROQ,
    CODEC_ID_INTERPLAY_VIDEO,
84 85
    CODEC_ID_XAN_WC3,
    CODEC_ID_XAN_WC4,
86 87 88 89 90
    CODEC_ID_RPZA,
    CODEC_ID_CINEPAK,
    CODEC_ID_WS_VQA,
    CODEC_ID_MSRLE,
    CODEC_ID_MSVIDEO1,
91
    CODEC_ID_IDCIN,
R
Roberto Togni 已提交
92
    CODEC_ID_8BPS,
M
Mike Melanson 已提交
93
    CODEC_ID_SMC,
M
Mike Melanson 已提交
94
    CODEC_ID_FLIC,
95
    CODEC_ID_TRUEMOTION1,
96 97
    CODEC_ID_VMDVIDEO,
    CODEC_ID_VMDAUDIO,
R
Roberto Togni 已提交
98 99
    CODEC_ID_MSZH,
    CODEC_ID_ZLIB,
100
    CODEC_ID_QTRLE,
F
Fabrice Bellard 已提交
101 102 103 104 105 106 107 108 109 110

    /* various pcm "codecs" */
    CODEC_ID_PCM_S16LE,
    CODEC_ID_PCM_S16BE,
    CODEC_ID_PCM_U16LE,
    CODEC_ID_PCM_U16BE,
    CODEC_ID_PCM_S8,
    CODEC_ID_PCM_U8,
    CODEC_ID_PCM_MULAW,
    CODEC_ID_PCM_ALAW,
111 112 113 114

    /* various adpcm codecs */
    CODEC_ID_ADPCM_IMA_QT,
    CODEC_ID_ADPCM_IMA_WAV,
115 116
    CODEC_ID_ADPCM_IMA_DK3,
    CODEC_ID_ADPCM_IMA_DK4,
117
    CODEC_ID_ADPCM_IMA_WS,
118
    CODEC_ID_ADPCM_IMA_SMJPEG,
119
    CODEC_ID_ADPCM_MS,
120
    CODEC_ID_ADPCM_4XM,
121 122
    CODEC_ID_ADPCM_XA,
    CODEC_ID_ADPCM_ADX,
123
    CODEC_ID_ADPCM_EA,
124
    CODEC_ID_ADPCM_G726,
125 126 127

	/* AMR */
    CODEC_ID_AMR_NB,
128 129
    CODEC_ID_AMR_WB,

130 131 132
    /* RealAudio codecs*/
    CODEC_ID_RA_144,
    CODEC_ID_RA_288,
133 134 135 136

    /* various DPCM codecs */
    CODEC_ID_ROQ_DPCM,
    CODEC_ID_INTERPLAY_DPCM,
137
    CODEC_ID_XAN_DPCM,
138
    
M
Michael Niedermayer 已提交
139 140
    CODEC_ID_FLAC,
    
141 142
    CODEC_ID_MPEG2TS, /* _FAKE_ codec to indicate a raw MPEG2 transport
                         stream (only used by libavformat) */
F
Fabrice Bellard 已提交
143
};
144 145 146

/* CODEC_ID_MP3LAME is absolete */
#define CODEC_ID_MP3LAME CODEC_ID_MP3
F
Fabrice Bellard 已提交
147 148

enum CodecType {
149
    CODEC_TYPE_UNKNOWN = -1,
F
Fabrice Bellard 已提交
150 151
    CODEC_TYPE_VIDEO,
    CODEC_TYPE_AUDIO,
152
    CODEC_TYPE_DATA,
F
Fabrice Bellard 已提交
153 154
};

155
/**
M
Mike Melanson 已提交
156 157 158 159 160 161 162 163 164 165 166 167
 * Pixel format. Notes: 
 *
 * PIX_FMT_RGBA32 is handled in an endian-specific manner. A RGBA
 * color is put together as:
 *  (A << 24) | (R << 16) | (G << 8) | B
 * This is stored as BGRA on little endian CPU architectures and ARGB on
 * big endian CPUs.
 *
 * When the pixel format is palettized RGB (PIX_FMT_PAL8), the palettized
 * image data is stored in AVFrame.data[0]. The palette is transported in
 * AVFrame.data[1] and, is 1024 bytes long (256 4-byte entries) and is
 * formatted the same as in PIX_FMT_RGBA32 described above (i.e., it is
168 169 170 171
 * also endian-specific). Note also that the individual RGB palette
 * components stored in AVFrame.data[1] should be in the range 0..255.
 * This is important as many custom PAL8 video codecs that were designed
 * to run on the IBM VGA graphics adapter use 6-bit palette components.
172
 */
F
Fabrice Bellard 已提交
173
enum PixelFormat {
M
Michael Niedermayer 已提交
174 175 176 177 178 179
    PIX_FMT_YUV420P,   ///< Planar YUV 4:2:0 (1 Cr & Cb sample per 2x2 Y samples)
    PIX_FMT_YUV422,    
    PIX_FMT_RGB24,     ///< Packed pixel, 3 bytes per pixel, RGBRGB...
    PIX_FMT_BGR24,     ///< Packed pixel, 3 bytes per pixel, BGRBGR...
    PIX_FMT_YUV422P,   ///< Planar YUV 4:2:2 (1 Cr & Cb sample per 2x1 Y samples)
    PIX_FMT_YUV444P,   ///< Planar YUV 4:4:4 (1 Cr & Cb sample per 1x1 Y samples)
M
Mike Melanson 已提交
180
    PIX_FMT_RGBA32,    ///< Packed pixel, 4 bytes per pixel, BGRABGRA..., stored in cpu endianness
M
Michael Niedermayer 已提交
181 182
    PIX_FMT_YUV410P,   ///< Planar YUV 4:1:0 (1 Cr & Cb sample per 4x4 Y samples)
    PIX_FMT_YUV411P,   ///< Planar YUV 4:1:1 (1 Cr & Cb sample per 4x1 Y samples)
183 184
    PIX_FMT_RGB565,    ///< always stored in cpu endianness 
    PIX_FMT_RGB555,    ///< always stored in cpu endianness, most significant bit to 1 
185
    PIX_FMT_GRAY8,
186 187 188
    PIX_FMT_MONOWHITE, ///< 0 is white 
    PIX_FMT_MONOBLACK, ///< 0 is black 
    PIX_FMT_PAL8,      ///< 8 bit with RGBA palette 
M
Michael Niedermayer 已提交
189 190 191
    PIX_FMT_YUVJ420P,  ///< Planar YUV 4:2:0 full scale (jpeg)
    PIX_FMT_YUVJ422P,  ///< Planar YUV 4:2:2 full scale (jpeg)
    PIX_FMT_YUVJ444P,  ///< Planar YUV 4:4:4 full scale (jpeg)
I
Ivan Kalvachev 已提交
192 193
    PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing(xvmc_render.h)
    PIX_FMT_XVMC_MPEG2_IDCT,
194
    PIX_FMT_NB,
F
Fabrice Bellard 已提交
195 196
};

F
Fabrice Bellard 已提交
197 198
/* currently unused, may be used if 24/32 bits samples ever supported */
enum SampleFormat {
199
    SAMPLE_FMT_S16 = 0,         ///< signed 16 bits 
F
Fabrice Bellard 已提交
200 201
};

F
Fabrice Bellard 已提交
202
/* in bytes */
F
Fabrice Bellard 已提交
203
#define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
F
Fabrice Bellard 已提交
204

205
/**
206 207 208 209 210
 * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
 * this is mainly needed because some optimized bitstream readers read 
 * 32 or 64 bit at once and could read over the end<br>
 * Note, if the first 23 bits of the additional bytes are not 0 then damaged
 * MPEG bitstreams could cause overread and segfault
211 212 213
 */
#define FF_INPUT_BUFFER_PADDING_SIZE 8

214 215
/* motion estimation type, EPZS by default */
enum Motion_Est_ID {
216
    ME_ZERO = 1,
217 218 219 220 221 222 223
    ME_FULL,
    ME_LOG,
    ME_PHODS,
    ME_EPZS,
    ME_X1
};

M
Michael Niedermayer 已提交
224 225 226 227 228 229 230
typedef struct RcOverride{
    int start_frame;
    int end_frame;
    int qscale; // if this is 0 then quality_factor will be used instead
    float quality_factor;
} RcOverride;

231 232 233
/* only for ME compatiblity with old apps */
extern int motion_estimation_method;

M
Michael Niedermayer 已提交
234
#define FF_MAX_B_FRAMES 8
235

M
Michael Niedermayer 已提交
236 237 238 239
/* encoding support
   these flags can be passed in AVCodecContext.flags before initing 
   Note: note not everything is supported yet 
*/
F
Fabrice Bellard 已提交
240

241
#define CODEC_FLAG_QSCALE 0x0002  ///< use fixed qscale 
242
#define CODEC_FLAG_4MV    0x0004  ///< 4 MV per MB allowed / Advanced prediction for H263
243 244
#define CODEC_FLAG_QPEL   0x0010  ///< use qpel MC 
#define CODEC_FLAG_GMC    0x0020  ///< use GMC 
245
#define CODEC_FLAG_MV0    0x0040  ///< always try a MB with MV=<0,0> 
246
#define CODEC_FLAG_PART   0x0080  ///< use data partitioning 
247 248
/* parent program gurantees that the input for b-frame containing streams is not written to 
   for at least s->max_b_frames+1 frames, if this is not set than the input will be copied */
249
#define CODEC_FLAG_INPUT_PRESERVED 0x0100
250 251 252 253 254 255 256
#define CODEC_FLAG_PASS1 0x0200   ///< use internal 2pass ratecontrol in first  pass mode 
#define CODEC_FLAG_PASS2 0x0400   ///< use internal 2pass ratecontrol in second pass mode 
#define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< use external huffman table (for mjpeg) 
#define CODEC_FLAG_GRAY  0x2000   ///< only decode/encode grayscale 
#define CODEC_FLAG_EMU_EDGE 0x4000///< dont draw edges 
#define CODEC_FLAG_PSNR           0x8000 ///< error[?] variables will be set during encoding 
#define CODEC_FLAG_TRUNCATED  0x00010000 /** input bitstream might be truncated at a random location instead 
257
                                            of only at frame boundaries */
258 259
#define CODEC_FLAG_NORMALIZE_AQP  0x00020000 ///< normalize adaptive quantization 
#define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< use interlaced dct 
260
#define CODEC_FLAG_LOW_DELAY      0x00080000 ///< force low delay
261 262 263 264
#define CODEC_FLAG_ALT_SCAN       0x00100000 ///< use alternate scan 
#define CODEC_FLAG_TRELLIS_QUANT  0x00200000 ///< use trellis quantization 
#define CODEC_FLAG_GLOBAL_HEADER  0x00400000 ///< place global headers in extradata instead of every keyframe 
#define CODEC_FLAG_BITEXACT       0x00800000 ///< use only bitexact stuff (except (i)dct) 
265
/* Fx : Flag for h263+ extra options */
M
Michael Niedermayer 已提交
266 267
#define CODEC_FLAG_H263P_AIC      0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction (remove this)
#define CODEC_FLAG_AC_PRED        0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction
268
#define CODEC_FLAG_H263P_UMV      0x02000000 ///< Unlimited motion vector  
269
#define CODEC_FLAG_CBP_RD         0x04000000 ///< use rate distortion optimization for cbp
270
#define CODEC_FLAG_QP_RD          0x08000000 ///< use rate distortion optimization for qp selectioon
271
#define CODEC_FLAG_H263P_AIV      0x00000008 ///< H263 Alternative inter vlc
M
Michael Niedermayer 已提交
272 273
#define CODEC_FLAG_OBMC           0x00000001 ///< OBMC
#define CODEC_FLAG_LOOP_FILTER    0x00000800 ///< loop filter
M
Michael Niedermayer 已提交
274 275
#define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000
#define CODEC_FLAG_INTERLACED_ME  0x20000000 ///< interlaced motion estimation
M
Michael Niedermayer 已提交
276
#define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< will reserve space for SVCD scan offset user data
277
#define CODEC_FLAG_CLOSED_GOP     0x80000000
278 279 280
/* Unsupported options :
 * 		Syntax Arithmetic coding (SAC)
 * 		Reference Picture Selection
M
Michael Niedermayer 已提交
281
 * 		Independant Segment Decoding */
282
/* /Fx */
F
Fabrice Bellard 已提交
283 284
/* codec capabilities */

285
#define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< decoder can use draw_horiz_band callback 
M
Michael Niedermayer 已提交
286 287 288 289 290
/**
 * Codec uses get_buffer() for allocating buffers.
 * direct rendering method 1
 */
#define CODEC_CAP_DR1             0x0002
291 292 293
/* if 'parse_only' field is true, then avcodec_parse_frame() can be
   used */
#define CODEC_CAP_PARSE_ONLY      0x0004
294
#define CODEC_CAP_TRUNCATED       0x0008
295 296
/* codec can export data for HW decoding (XvMC) */
#define CODEC_CAP_HWACCEL         0x0010
297 298
/** codec has a non zero delay and needs to be feeded with NULL at the end to get the delayed data */
#define CODEC_CAP_DELAY           0x0020
F
Fabrice Bellard 已提交
299

300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323
//the following defines might change, so dont expect compatibility if u use them
#define MB_TYPE_INTRA4x4   0x0001
#define MB_TYPE_INTRA16x16 0x0002 //FIXME h264 specific
#define MB_TYPE_INTRA_PCM  0x0004 //FIXME h264 specific
#define MB_TYPE_16x16      0x0008
#define MB_TYPE_16x8       0x0010
#define MB_TYPE_8x16       0x0020
#define MB_TYPE_8x8        0x0040
#define MB_TYPE_INTERLACED 0x0080
#define MB_TYPE_DIRECT2     0x0100 //FIXME
#define MB_TYPE_ACPRED     0x0200
#define MB_TYPE_GMC        0x0400
#define MB_TYPE_SKIP       0x0800
#define MB_TYPE_P0L0       0x1000
#define MB_TYPE_P1L0       0x2000
#define MB_TYPE_P0L1       0x4000
#define MB_TYPE_P1L1       0x8000
#define MB_TYPE_L0         (MB_TYPE_P0L0 | MB_TYPE_P1L0)
#define MB_TYPE_L1         (MB_TYPE_P0L1 | MB_TYPE_P1L1)
#define MB_TYPE_L0L1       (MB_TYPE_L0   | MB_TYPE_L1)
#define MB_TYPE_QUANT      0x00010000
#define MB_TYPE_CBP        0x00020000
//Note bits 24-31 are reserved for codec specific use (h264 ref0, mpeg1 0mv, ...)

324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351
/**
 * Pan Scan area.
 * this specifies the area which should be displayed. Note there may be multiple such areas for one frame
 */
typedef struct AVPanScan{
    /**
     * id.
     * - encoding: set by user.
     * - decoding: set by lavc
     */
    int id;

    /**
     * width and height in 1/16 pel
     * - encoding: set by user.
     * - decoding: set by lavc
     */
    int width;
    int height;

    /**
     * position of the top left corner in 1/16 pel for up to 3 fields/frames.
     * - encoding: set by user.
     * - decoding: set by lavc
     */
    int16_t position[3][2];
}AVPanScan;

M
Michael Niedermayer 已提交
352
#define FF_COMMON_FRAME \
M
Michael Niedermayer 已提交
353 354 355 356 357 358
    /**\
     * pointer to the picture planes.\
     * this might be different from the first allocated byte\
     * - encoding: \
     * - decoding: \
     */\
M
cleanup  
Michael Niedermayer 已提交
359 360 361
    uint8_t *data[4];\
    int linesize[4];\
    /**\
M
Michael Niedermayer 已提交
362
     * pointer to the first allocated byte of the picture. can be used in get_buffer/release_buffer\
M
cleanup  
Michael Niedermayer 已提交
363
     * this isnt used by lavc unless the default get/release_buffer() is used\
364 365
     * - encoding: \
     * - decoding: \
M
cleanup  
Michael Niedermayer 已提交
366 367 368 369
     */\
    uint8_t *base[4];\
    /**\
     * 1 -> keyframe, 0-> not\
370 371
     * - encoding: set by lavc\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
372 373 374 375
     */\
    int key_frame;\
\
    /**\
M
Michael Niedermayer 已提交
376
     * picture type of the frame, see ?_TYPE below.\
377 378
     * - encoding: set by lavc for coded_picture (and set by user for input)\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
379 380 381 382
     */\
    int pict_type;\
\
    /**\
383 384
     * presentation timestamp in AV_TIME_BASE (=micro seconds currently) (time when frame should be shown to user)\
     * if AV_NOPTS_VALUE then the frame_rate will be used as reference\
385 386
     * - encoding: MUST be set by user\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
387
     */\
388
    int64_t pts;\
M
cleanup  
Michael Niedermayer 已提交
389 390 391
\
    /**\
     * picture number in bitstream order.\
392 393
     * - encoding: set by\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
394 395 396 397
     */\
    int coded_picture_number;\
    /**\
     * picture number in display order.\
398 399
     * - encoding: set by\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
400 401 402 403
     */\
    int display_picture_number;\
\
    /**\
404
     * quality (between 1 (good) and FF_LAMBDA_MAX (bad)) \
405 406
     * - encoding: set by lavc for coded_picture (and set by user for input)\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
407
     */\
408
    int quality; \
M
cleanup  
Michael Niedermayer 已提交
409 410 411
\
    /**\
     * buffer age (1->was last buffer and dint change, 2->..., ...).\
412
     * set to INT_MAX if the buffer has not been used yet \
413 414
     * - encoding: unused\
     * - decoding: MUST be set by get_buffer()\
M
cleanup  
Michael Niedermayer 已提交
415 416 417 418 419
     */\
    int age;\
\
    /**\
     * is this picture used as reference\
420 421
     * - encoding: unused\
     * - decoding: set by lavc (before get_buffer() call))\
M
cleanup  
Michael Niedermayer 已提交
422 423 424 425 426
     */\
    int reference;\
\
    /**\
     * QP table\
427 428
     * - encoding: unused\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
429 430 431 432
     */\
    int8_t *qscale_table;\
    /**\
     * QP store stride\
433 434
     * - encoding: unused\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
435 436 437 438 439 440
     */\
    int qstride;\
\
    /**\
     * mbskip_table[mb]>=1 if MB didnt change\
     * stride= mb_width = (width+15)>>4\
441 442
     * - encoding: unused\
     * - decoding: set by lavc\
M
cleanup  
Michael Niedermayer 已提交
443 444
     */\
    uint8_t *mbskip_table;\
445 446 447
\
    /**\
     * Motion vector table\
448
     * - encoding: set by user\
449 450 451 452 453 454 455
     * - decoding: set by lavc\
     */\
    int16_t (*motion_val[2])[2];\
\
    /**\
     * Macroblock type table\
     * mb_type_base + mb_width + 2\
456
     * - encoding: set by user\
457 458 459 460 461 462 463 464 465 466
     * - decoding: set by lavc\
     */\
    uint32_t *mb_type;\
\
    /**\
     * Macroblock size: (0->16x16, 1->8x8, 2-> 4x4, 3-> 2x2)\
     * - encoding: unused\
     * - decoding: set by lavc\
     */\
    uint8_t motion_subsample_log2;\
M
cleanup  
Michael Niedermayer 已提交
467 468 469
\
    /**\
     * for some private data of the user\
470 471
     * - encoding: unused\
     * - decoding: set by user\
M
cleanup  
Michael Niedermayer 已提交
472 473
     */\
    void *opaque;\
474 475 476
\
    /**\
     * error\
477 478
     * - encoding: set by lavc if flags&CODEC_FLAG_PSNR\
     * - decoding: unused\
479 480
     */\
    uint64_t error[4];\
M
Michael Niedermayer 已提交
481 482 483
\
    /**\
     * type of the buffer (to keep track of who has to dealloc data[*])\
484 485
     * - encoding: set by the one who allocs it\
     * - decoding: set by the one who allocs it\
F
Falk Hüffner 已提交
486
     * Note: user allocated (direct rendering) & internal buffers can not coexist currently\
M
Michael Niedermayer 已提交
487 488
     */\
    int type;\
489 490 491 492
    \
    /**\
     * when decoding, this signal how much the picture must be delayed.\
     * extra_delay = repeat_pict / (2*fps)\
493 494
     * - encoding: unused\
     * - decoding: set by lavc\
495
     */\
M
Michael Niedermayer 已提交
496 497 498 499 500 501
    int repeat_pict;\
    \
    /**\
     * \
     */\
    int qscale_type;\
502 503 504 505 506 507 508 509 510
    \
    /**\
     * The content of the picture is interlaced.\
     * - encoding: set by user\
     * - decoding: set by lavc (default 0)\
     */\
    int interlaced_frame;\
    \
    /**\
511
     * if the content is interlaced, is top field displayed first.\
512
     * - encoding: set by user\
513
     * - decoding: set by lavc\
514
     */\
515
    int top_field_first;\
516 517 518 519 520 521 522
    \
    /**\
     * Pan scan.\
     * - encoding: set by user\
     * - decoding: set by lavc\
     */\
    AVPanScan *pan_scan;\
523 524 525 526 527 528 529
    \
    /**\
     * tell user application that palette has changed from previous frame.\
     * - encoding: ??? (no palette-enabled encoder yet)\
     * - decoding: set by lavc (default 0)\
     */\
    int palette_has_changed;\
530 531 532 533 534 535 536
    \
    /**\
     * Codec suggestion on buffer type if != 0\
     * - encoding: unused\
     * - decoding: set by lavc (before get_buffer() call))\
     */\
    int buffer_hints;\
537 538 539 540 541 542 543
\
    /**\
     * DCT coeffitients\
     * - encoding: unused\
     * - decoding: set by lavc\
     */\
    short *dct_coeff;\
544 545 546 547 548 549 550
\
    /**\
     * Motion referece frame index\
     * - encoding: set by user\
     * - decoding: set by lavc\
     */\
    int8_t *ref_index[2];
551

M
Michael Niedermayer 已提交
552 553
#define FF_QSCALE_TYPE_MPEG1	0
#define FF_QSCALE_TYPE_MPEG2	1
M
Michael Niedermayer 已提交
554 555

#define FF_BUFFER_TYPE_INTERNAL 1
M
Michael Niedermayer 已提交
556
#define FF_BUFFER_TYPE_USER     2 ///< Direct rendering buffers (image is (de)allocated by user)
557
#define FF_BUFFER_TYPE_SHARED   4 ///< buffer from somewher else, dont dealloc image (data/base), all other tables are not shared
M
Michael Niedermayer 已提交
558
#define FF_BUFFER_TYPE_COPY     8 ///< just a (modified) copy of some other buffer, dont dealloc anything
M
Michael Niedermayer 已提交
559

M
cleanup  
Michael Niedermayer 已提交
560

561 562 563 564
#define FF_I_TYPE 1 // Intra
#define FF_P_TYPE 2 // Predicted
#define FF_B_TYPE 3 // Bi-dir predicted
#define FF_S_TYPE 4 // S(GMC)-VOP MPEG4
M
Michael Niedermayer 已提交
565 566
#define FF_SI_TYPE 5
#define FF_SP_TYPE 6
M
cleanup  
Michael Niedermayer 已提交
567

568 569 570 571 572
#define FF_BUFFER_HINTS_VALID    0x01 // Buffer hints value is meaningful (if 0 ignore)
#define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer
#define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content
#define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update)

M
Michael Niedermayer 已提交
573 574 575
/**
 * Audio Video Frame.
 */
M
Michael Niedermayer 已提交
576 577 578
typedef struct AVFrame {
    FF_COMMON_FRAME
} AVFrame;
M
cleanup  
Michael Niedermayer 已提交
579

580
#define DEFAULT_FRAME_RATE_BASE 1001000
M
doxy  
Michael Niedermayer 已提交
581

582 583 584 585 586 587 588 589 590 591 592 593
/**
 * Used by av_log
 */
typedef struct AVCLASS AVClass;
struct AVCLASS {
    const char* class_name;
    const char* (*item_name)(void*); /* actually passing a pointer to an AVCodecContext
					or AVFormatContext, which begin with an AVClass.
					Needed because av_log is in libavcodec and has no visibility
					of AVIn/OutputFormat */
};

M
doxy  
Michael Niedermayer 已提交
594 595 596
/**
 * main external api structure.
 */
F
Fabrice Bellard 已提交
597
typedef struct AVCodecContext {
598 599 600 601
    /**
     * Info on struct for av_log
     * - set by avcodec_alloc_context
     */
M
Michael Niedermayer 已提交
602
    AVClass *av_class;
603
    /**
604 605 606
     * the average bitrate.
     * - encoding: set by user. unused for constant quantizer encoding
     * - decoding: set by lavc. 0 or some bitrate if this info is available in the stream 
607
     */
F
Fabrice Bellard 已提交
608
    int bit_rate;
609 610

    /**
611
     * number of bits the bitstream is allowed to diverge from the reference.
612
     *           the reference can be CBR (for CBR pass1) or VBR (for pass2)
613 614
     * - encoding: set by user. unused for constant quantizer encoding
     * - decoding: unused
615 616 617 618
     */
    int bit_rate_tolerance; 

    /**
619 620 621
     * CODEC_FLAG_*.
     * - encoding: set by user.
     * - decoding: set by user.
622
     */
F
Fabrice Bellard 已提交
623
    int flags;
624 625 626

    /**
     * some codecs needs additionnal format info. It is stored here
627 628
     * - encoding: set by user. 
     * - decoding: set by lavc. (FIXME is this ok?)
629 630 631 632
     */
    int sub_id;

    /**
633 634 635
     * motion estimation algorithm used for video coding.
     * - encoding: MUST be set by user.
     * - decoding: unused
636 637 638 639
     */
    int me_method;

    /**
640
     * some codecs need / can use extra-data like huffman tables.
641 642
     * mjpeg: huffman tables
     * rv10: additional flags
643
     * mpeg4: global headers (they can be in the bitstream or here)
644 645
     * - encoding: set/allocated/freed by lavc.
     * - decoding: set/allocated/freed by user.
646
     */
647 648 649
    void *extradata;
    int extradata_size;
    
F
Fabrice Bellard 已提交
650
    /* video only */
651
    /**
652
     * frames per sec multiplied by frame_rate_base.
653
     * for variable fps this is the precission, so if the timestamps 
654
     * can be specified in msec precssion then this is 1000*frame_rate_base
655 656
     * - encoding: MUST be set by user
     * - decoding: set by lavc. 0 or the frame_rate if available
657 658
     */
    int frame_rate;
659
    
660
    /**
661 662
     * width / height.
     * - encoding: MUST be set by user. 
M
Michael Niedermayer 已提交
663
     * - decoding: set by user if known, codec should override / dynamically change if needed
664
     */
F
Fabrice Bellard 已提交
665
    int width, height;
666
    
667
#define FF_ASPECT_EXTENDED 15
668 669

    /**
670 671 672
     * the number of pictures in a group of pitures, or 0 for intra_only.
     * - encoding: set by user.
     * - decoding: unused
673 674 675 676
     */
    int gop_size;

    /**
677
     * pixel format, see PIX_FMT_xxx.
678 679 680 681
     * - encoding: FIXME: used by ffmpeg to decide whether an pix_fmt
     *                    conversion is in order. This only works for
     *                    codecs with one supported pix_fmt, we should
     *                    do something for a generic case as well.
682
     * - decoding: set by lavc.
683
     */
684
    enum PixelFormat pix_fmt;
685 686 687 688 689 690 691 692 693
 
    /**
     * Frame rate emulation. If not zero lower layer (i.e. format handler) 
     * has to read frames at native frame rate.
     * - encoding: set by user.
     * - decoding: unused.
     */
    int rate_emu;
       
694 695 696 697 698
    /**
     * if non NULL, 'draw_horiz_band' is called by the libavcodec
     * decoder to draw an horizontal band. It improve cache usage. Not
     * all codecs can do that. You must check the codec capabilities
     * before
699 700
     * - encoding: unused
     * - decoding: set by user.
701 702 703 704
     * @param height the height of the slice
     * @param y the y position of the slice
     * @param type 1->top field, 2->bottom field, 3->frame
     * @param offset offset into the AVFrame.data from which the slice should be read
705
     */
F
Fabrice Bellard 已提交
706
    void (*draw_horiz_band)(struct AVCodecContext *s,
707
                            const AVFrame *src, int offset[4],
708
                            int y, int type, int height);
F
Fabrice Bellard 已提交
709

F
Fabrice Bellard 已提交
710
    /* audio only */
711
    int sample_rate; ///< samples per sec 
F
Fabrice Bellard 已提交
712
    int channels;
713
    int sample_fmt;  ///< sample format, currenly unused 
F
Fabrice Bellard 已提交
714 715

    /* the following data should not be initialized */
716 717 718
    int frame_size;     ///< in samples, initialized when calling 'init' 
    int frame_number;   ///< audio or video frame number 
    int real_pict_num;  ///< returns the real picture number of previous encoded frame 
M
cleanup  
Michael Niedermayer 已提交
719
    
720 721
    /**
     * number of frames the decoded output will be delayed relative to 
722 723 724
     * the encoded input.
     * - encoding: set by lavc.
     * - decoding: unused
725 726
     */
    int delay;
M
Michael Niedermayer 已提交
727
    
728 729 730
    /* - encoding parameters */
    float qcompress;  ///< amount of qscale change between easy & hard scenes (0.0-1.0)
    float qblur;      ///< amount of qscale smoothing over time (0.0-1.0) 
731 732
    
    /**
733 734 735
     * minimum quantizer.
     * - encoding: set by user.
     * - decoding: unused
736 737 738 739
     */
    int qmin;

    /**
740 741 742
     * maximum quantizer.
     * - encoding: set by user.
     * - decoding: unused
743 744 745 746
     */
    int qmax;

    /**
747 748 749
     * maximum quantizer difference etween frames.
     * - encoding: set by user.
     * - decoding: unused
750 751 752 753
     */
    int max_qdiff;

    /**
754
     * maximum number of b frames between non b frames.
755
     * note: the output will be delayed by max_b_frames+1 relative to the input
756 757
     * - encoding: set by user.
     * - decoding: unused
758 759 760 761
     */
    int max_b_frames;

    /**
762 763 764
     * qscale factor between ip and b frames.
     * - encoding: set by user.
     * - decoding: unused
765 766 767 768 769
     */
    float b_quant_factor;
    
    /** obsolete FIXME remove */
    int rc_strategy;
770
    int b_frame_strategy;
771

772
    /**
773 774 775
     * hurry up amount.
     * - encoding: unused
     * - decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too, 5-> skip everything except header
776 777
     */
    int hurry_up;
778
    
F
Fabrice Bellard 已提交
779
    struct AVCodec *codec;
780
    
F
Fabrice Bellard 已提交
781 782
    void *priv_data;

M
Michael Niedermayer 已提交
783 784
    /* unused, FIXME remove*/
    int rtp_mode;
785 786 787 788 789 790 791
    
    int rtp_payload_size;   /* The size of the RTP payload, the coder will  */
                            /* do it's best to deliver a chunk with size    */
                            /* below rtp_payload_size, the chunk will start */
                            /* with a start code on some codecs like H.263  */
                            /* This doesn't take account of any particular  */
                            /* headers inside the transmited RTP payload    */
792 793 794 795 796 797

    
    /* The RTP callcack: This function is called  */
    /* every time the encoder as a packet to send */
    /* Depends on the encoder if the data starts  */
    /* with a Start Code (it should) H.263 does   */
798
    void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int packet_number); 
799

800 801 802 803 804 805 806 807
    /* statistics, used for 2-pass encoding */
    int mv_bits;
    int header_bits;
    int i_tex_bits;
    int p_tex_bits;
    int i_count;
    int p_count;
    int skip_count;
808 809 810
    int misc_bits;
    
    /**
811 812
     * number of bits used for the previously encoded frame.
     * - encoding: set by lavc
813
     * - decoding: unused
814
     */
815
    int frame_bits;
816

817
    /**
818 819 820
     * private data of the user, can be used to carry app specific stuff.
     * - encoding: set by user
     * - decoding: set by user
821 822 823
     */
    void *opaque;

F
Fabrice Bellard 已提交
824
    char codec_name[32];
825 826
    enum CodecType codec_type; /* see CODEC_TYPE_xxx */
    enum CodecID codec_id; /* see CODEC_ID_xxx */
827 828 829 830
    
    /**
     * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
     * this is used to workaround some encoder bugs
831
     * - encoding: set by user, if not then the default based on codec_id will be used
832 833 834
     * - decoding: set by user, will be converted to upper case by lavc during init
     */
    unsigned int codec_tag;
835
    
836
    /**
837 838 839
     * workaround bugs in encoders which sometimes cannot be detected automatically.
     * - encoding: unused
     * - decoding: set by user
840 841
     */
    int workaround_bugs;
842
#define FF_BUG_AUTODETECT       1  ///< autodetection
843 844 845 846
#define FF_BUG_OLD_MSMPEG4      2
#define FF_BUG_XVID_ILACE       4
#define FF_BUG_UMP4             8
#define FF_BUG_NO_PADDING       16
M
Michael Niedermayer 已提交
847
#define FF_BUG_AMV              32
848
#define FF_BUG_AC_VLC           0  ///< will be removed, libavcodec can now handle these non compliant files by default
M
Michael Niedermayer 已提交
849
#define FF_BUG_QPEL_CHROMA      64
M
Michael Niedermayer 已提交
850
#define FF_BUG_STD_QPEL         128
M
Michael Niedermayer 已提交
851
#define FF_BUG_QPEL_CHROMA2     256
852
#define FF_BUG_DIRECT_BLOCKSIZE 512
853
#define FF_BUG_EDGE             1024
854
#define FF_BUG_HPEL_CHROMA      2048
855
#define FF_BUG_DC_CLIP          4096
856 857
//#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
        
858
    /**
859 860 861
     * luma single coeff elimination threshold.
     * - encoding: set by user
     * - decoding: unused
862
     */
863
    int luma_elim_threshold;
864 865
    
    /**
866 867 868
     * chroma single coeff elimination threshold.
     * - encoding: set by user
     * - decoding: unused
869
     */
870
    int chroma_elim_threshold;
871 872
    
    /**
873 874 875
     * strictly follow the std (MPEG4, ...).
     * - encoding: set by user
     * - decoding: unused
876 877 878 879
     */
    int strict_std_compliance;
    
    /**
880
     * qscale offset between ip and b frames.
881 882
     * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
     * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
883 884
     * - encoding: set by user.
     * - decoding: unused
885 886 887 888
     */
    float b_quant_offset;
    
    /**
889
     * error resilience higher values will detect more errors but may missdetect
890 891 892
     * some more or less valid parts as errors.
     * - encoding: unused
     * - decoding: set by user
893
     */
894
    int error_resilience;
895 896 897 898
#define FF_ER_CAREFULL        1
#define FF_ER_COMPLIANT       2
#define FF_ER_AGGRESSIVE      3
#define FF_ER_VERY_AGGRESSIVE 4
899
    
900
    /**
M
cleanup  
Michael Niedermayer 已提交
901 902
     * called at the beginning of each frame to get a buffer for it.
     * if pic.reference is set then the frame will be read later by lavc
903 904
     * avcodec_align_dimensions() should be used to find the required width and
     * height, as they normally need to be rounded up to the next multiple of 16
905 906
     * - encoding: unused
     * - decoding: set by lavc, user can override
907
     */
M
Michael Niedermayer 已提交
908
    int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
909 910
    
    /**
M
cleanup  
Michael Niedermayer 已提交
911 912 913
     * called to release buffers which where allocated with get_buffer.
     * a released buffer can be reused in get_buffer()
     * pic.data[*] must be set to NULL
914 915
     * - encoding: unused
     * - decoding: set by lavc, user can override
916
     */
M
Michael Niedermayer 已提交
917
    void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
M
Michael Niedermayer 已提交
918

919
    /**
920 921
     * if 1 the stream has a 1 frame delay during decoding.
     * - encoding: set by lavc
922
     * - decoding: set by lavc
923 924 925
     */
    int has_b_frames;
    
926
    int block_align; ///< used by some WAV based audio codecs
M
Michael Niedermayer 已提交
927
    
928
    int parse_only; /* - decoding only: if true, only parsing is done
929 930
                       (function avcodec_parse_frame()). The frame
                       data is returned. Only MPEG codecs support this now. */
M
Michael Niedermayer 已提交
931
    
932
    /**
933
     * 0-> h263 quant 1-> mpeg quant.
934 935
     * - encoding: set by user.
     * - decoding: unused
936 937
     */
    int mpeg_quant;
M
Michael Niedermayer 已提交
938
    
939
    /**
940 941 942
     * pass1 encoding statistics output buffer.
     * - encoding: set by lavc
     * - decoding: unused
943
     */
944
    char *stats_out;
945 946 947 948
    
    /**
     * pass2 encoding statistics input buffer.
     * concatenated stuff from stats_out of pass1 should be placed here
949 950
     * - encoding: allocated/set/freed by user
     * - decoding: unused
951 952 953 954
     */
    char *stats_in;
    
    /**
955
     * ratecontrol qmin qmax limiting method.
956
     * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
957 958
     * - encoding: set by user.
     * - decoding: unused
959
     */
M
Michael Niedermayer 已提交
960
    float rc_qsquish;
961

M
Michael Niedermayer 已提交
962 963
    float rc_qmod_amp;
    int rc_qmod_freq;
964 965
    
    /**
966 967 968
     * ratecontrol override, see RcOverride.
     * - encoding: allocated/set/freed by user.
     * - decoding: unused
969
     */
M
Michael Niedermayer 已提交
970 971
    RcOverride *rc_override;
    int rc_override_count;
972 973
    
    /**
974 975 976
     * rate control equation.
     * - encoding: set by user
     * - decoding: unused
977
     */
M
Michael Niedermayer 已提交
978
    char *rc_eq;
979 980
    
    /**
981 982 983
     * maximum bitrate.
     * - encoding: set by user.
     * - decoding: unused
984
     */
M
Michael Niedermayer 已提交
985
    int rc_max_rate;
986 987
    
    /**
988 989 990
     * minimum bitrate.
     * - encoding: set by user.
     * - decoding: unused
991
     */
M
Michael Niedermayer 已提交
992
    int rc_min_rate;
993 994
    
    /**
995 996 997
     * decoder bitstream buffer size.
     * - encoding: set by user.
     * - decoding: unused
998
     */
M
Michael Niedermayer 已提交
999 1000
    int rc_buffer_size;
    float rc_buffer_aggressivity;
1001 1002

    /**
1003
     * qscale factor between p and i frames.
1004 1005
     * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
     * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
1006 1007
     * - encoding: set by user.
     * - decoding: unused
1008 1009 1010 1011
     */
    float i_quant_factor;
    
    /**
1012 1013 1014
     * qscale offset between p and i frames.
     * - encoding: set by user.
     * - decoding: unused
1015 1016 1017 1018
     */
    float i_quant_offset;
    
    /**
1019 1020 1021
     * initial complexity for pass1 ratecontrol.
     * - encoding: set by user.
     * - decoding: unused
1022
     */
M
Michael Niedermayer 已提交
1023
    float rc_initial_cplx;
1024

1025
    /**
1026 1027 1028
     * dct algorithm, see FF_DCT_* below.
     * - encoding: set by user
     * - decoding: unused
1029
     */
1030
    int dct_algo;
1031
#define FF_DCT_AUTO    0
1032
#define FF_DCT_FASTINT 1
1033 1034 1035
#define FF_DCT_INT     2
#define FF_DCT_MMX     3
#define FF_DCT_MLIB    4
1036
#define FF_DCT_ALTIVEC 5
M
Michael Niedermayer 已提交
1037
#define FF_DCT_FAAN    6
1038 1039
    
    /**
1040 1041 1042
     * luminance masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
1043 1044 1045 1046
     */
    float lumi_masking;
    
    /**
1047 1048 1049
     * temporary complexity masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
1050 1051 1052 1053
     */
    float temporal_cplx_masking;
    
    /**
1054 1055 1056
     * spatial complexity masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
1057 1058 1059 1060
     */
    float spatial_cplx_masking;
    
    /**
1061 1062 1063
     * p block masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
1064 1065
     */
    float p_masking;
1066

1067
    /**
1068 1069 1070
     * darkness masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
1071 1072
     */
    float dark_masking;
1073
    
1074 1075 1076 1077
    
    /* for binary compatibility */
    int unused;
    
1078
    /**
1079 1080 1081
     * idct algorithm, see FF_IDCT_* below.
     * - encoding: set by user
     * - decoding: set by user
1082 1083 1084 1085 1086 1087 1088 1089 1090 1091
     */
    int idct_algo;
#define FF_IDCT_AUTO         0
#define FF_IDCT_INT          1
#define FF_IDCT_SIMPLE       2
#define FF_IDCT_SIMPLEMMX    3
#define FF_IDCT_LIBMPEG2MMX  4
#define FF_IDCT_PS2          5
#define FF_IDCT_MLIB         6
#define FF_IDCT_ARM          7
1092
#define FF_IDCT_ALTIVEC      8
1093
#define FF_IDCT_SH4          9
1094
#define FF_IDCT_SIMPLEARM    10
1095

1096
    /**
1097 1098 1099
     * slice count.
     * - encoding: set by lavc
     * - decoding: set by user (or 0)
1100 1101 1102
     */
    int slice_count;
    /**
1103 1104 1105
     * slice offsets in the frame in bytes.
     * - encoding: set/allocated by lavc
     * - decoding: set/allocated by user (or NULL)
1106 1107 1108
     */
    int *slice_offset;

1109
    /**
1110 1111 1112
     * error concealment flags.
     * - encoding: unused
     * - decoding: set by user
1113 1114 1115 1116 1117
     */
    int error_concealment;
#define FF_EC_GUESS_MVS   1
#define FF_EC_DEBLOCK     2

Z
Zdenek Kabelac 已提交
1118
    /**
Z
Zdenek Kabelac 已提交
1119
     * dsp_mask could be add used to disable unwanted CPU features
Z
Zdenek Kabelac 已提交
1120
     * CPU features (i.e. MMX, SSE. ...)
Z
Zdenek Kabelac 已提交
1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135
     *
     * with FORCE flag you may instead enable given CPU features
     * (Dangerous: usable in case of misdetection, improper usage however will
     * result into program crash)
     */
    unsigned dsp_mask;
#define FF_MM_FORCE	0x80000000 /* force usage of selected flags (OR) */
    /* lower 16 bits - CPU features */
#ifdef HAVE_MMX
#define FF_MM_MMX	0x0001 /* standard MMX */
#define FF_MM_3DNOW	0x0004 /* AMD 3DNOW */
#define FF_MM_MMXEXT	0x0002 /* SSE integer functions or AMD MMX ext */
#define FF_MM_SSE	0x0008 /* SSE functions */
#define FF_MM_SSE2	0x0010 /* PIV SSE2 functions */
#endif /* HAVE_MMX */
M
huffyuv  
Michael Niedermayer 已提交
1136 1137

    /**
1138 1139 1140
     * bits per sample/pixel from the demuxer (needed for huffyuv).
     * - encoding: set by lavc
     * - decoding: set by user
M
huffyuv  
Michael Niedermayer 已提交
1141 1142 1143 1144
     */
     int bits_per_sample;
    
    /**
1145 1146 1147
     * prediction method (needed for huffyuv).
     * - encoding: set by user
     * - decoding: unused
M
huffyuv  
Michael Niedermayer 已提交
1148 1149 1150 1151 1152
     */
     int prediction_method;
#define FF_PRED_LEFT   0
#define FF_PRED_PLANE  1
#define FF_PRED_MEDIAN 2
M
Michael Niedermayer 已提交
1153 1154
    
    /**
M
Michael Niedermayer 已提交
1155
     * sample aspect ratio (0 if unknown).
1156
     * numerator and denominator must be relative prime and smaller then 256 for some video standards
1157 1158
     * - encoding: set by user.
     * - decoding: set by lavc.
M
Michael Niedermayer 已提交
1159
     */
M
Michael Niedermayer 已提交
1160
    AVRational sample_aspect_ratio;
M
cleanup  
Michael Niedermayer 已提交
1161 1162

    /**
1163 1164 1165
     * the picture in the bitstream.
     * - encoding: set by lavc
     * - decoding: set by lavc
M
cleanup  
Michael Niedermayer 已提交
1166
     */
M
Michael Niedermayer 已提交
1167
    AVFrame *coded_frame;
1168 1169

    /**
1170 1171 1172
     * debug.
     * - encoding: set by user.
     * - decoding: set by user.
1173 1174 1175 1176 1177 1178 1179 1180
     */
    int debug;
#define FF_DEBUG_PICT_INFO 1
#define FF_DEBUG_RC        2
#define FF_DEBUG_BITSTREAM 4
#define FF_DEBUG_MB_TYPE   8
#define FF_DEBUG_QP        16
#define FF_DEBUG_MV        32
1181
#define FF_DEBUG_DCT_COEFF 0x00000040
M
Michael Niedermayer 已提交
1182 1183 1184
#define FF_DEBUG_SKIP      0x00000080
#define FF_DEBUG_STARTCODE 0x00000100
#define FF_DEBUG_PTS       0x00000200
1185
#define FF_DEBUG_ER        0x00000400
M
Michael Niedermayer 已提交
1186
#define FF_DEBUG_MMCO      0x00000800
1187
#define FF_DEBUG_BUGS      0x00001000
M
Michael Niedermayer 已提交
1188 1189
#define FF_DEBUG_VIS_QP    0x00002000
#define FF_DEBUG_VIS_MB_TYPE 0x00004000
1190
    
1191 1192 1193 1194 1195 1196 1197 1198 1199 1200
    /**
     * debug.
     * - encoding: set by user.
     * - decoding: set by user.
     */
    int debug_mv;
#define FF_DEBUG_VIS_MV_P_FOR  0x00000001 //visualize forward predicted MVs of P frames
#define FF_DEBUG_VIS_MV_B_FOR  0x00000002 //visualize forward predicted MVs of B frames
#define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames

1201
    /**
1202 1203 1204
     * error.
     * - encoding: set by lavc if flags&CODEC_FLAG_PSNR
     * - decoding: unused
1205 1206
     */
    uint64_t error[4];
M
Michael Niedermayer 已提交
1207 1208
    
    /**
1209 1210 1211
     * minimum MB quantizer.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1212 1213 1214 1215
     */
    int mb_qmin;

    /**
1216 1217 1218
     * maximum MB quantizer.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1219 1220
     */
    int mb_qmax;
M
Michael Niedermayer 已提交
1221 1222
    
    /**
1223 1224 1225
     * motion estimation compare function.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1226 1227 1228
     */
    int me_cmp;
    /**
1229 1230 1231
     * subpixel motion estimation compare function.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1232 1233 1234
     */
    int me_sub_cmp;
    /**
1235 1236 1237
     * macroblock compare function (not supported yet).
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1238 1239
     */
    int mb_cmp;
1240 1241 1242 1243 1244 1245
    /**
     * interlaced dct compare function
     * - encoding: set by user.
     * - decoding: unused
     */
    int ildct_cmp;
M
Michael Niedermayer 已提交
1246 1247 1248 1249 1250 1251 1252 1253
#define FF_CMP_SAD  0
#define FF_CMP_SSE  1
#define FF_CMP_SATD 2
#define FF_CMP_DCT  3
#define FF_CMP_PSNR 4
#define FF_CMP_BIT  5
#define FF_CMP_RD   6
#define FF_CMP_ZERO 7
1254 1255
#define FF_CMP_VSAD 8
#define FF_CMP_VSSE 9
1256
#define FF_CMP_NSSE 10
M
Michael Niedermayer 已提交
1257 1258 1259
#define FF_CMP_CHROMA 256
    
    /**
1260 1261 1262
     * ME diamond size & shape.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1263 1264
     */
    int dia_size;
1265 1266

    /**
1267 1268 1269
     * amount of previous MV predictors (2a+1 x 2a+1 square).
     * - encoding: set by user.
     * - decoding: unused
1270 1271
     */
    int last_predictor_count;
1272

M
Michael Niedermayer 已提交
1273
    /**
1274 1275 1276
     * pre pass for motion estimation.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1277 1278
     */
    int pre_me;
1279

1280
    /**
1281 1282 1283
     * motion estimation pre pass compare function.
     * - encoding: set by user.
     * - decoding: unused
1284 1285
     */
    int me_pre_cmp;
M
Michael Niedermayer 已提交
1286

1287
    /**
1288 1289 1290
     * ME pre pass diamond size & shape.
     * - encoding: set by user.
     * - decoding: unused
1291 1292 1293
     */
    int pre_dia_size;

M
Michael Niedermayer 已提交
1294
    /**
1295 1296 1297
     * subpel ME quality.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1298 1299 1300
     */
    int me_subpel_quality;

M
Michael Niedermayer 已提交
1301
    /**
1302
     * callback to negotiate the pixelFormat.
M
Michael Niedermayer 已提交
1303 1304 1305 1306
     * @param fmt is the list of formats which are supported by the codec,
     * its terminated by -1 as 0 is a valid format, the formats are ordered by quality
     * the first is allways the native one
     * @return the choosen format
1307 1308
     * - encoding: unused
     * - decoding: set by user, if not set then the native format will always be choosen
M
Michael Niedermayer 已提交
1309
     */
I
Ivan Kalvachev 已提交
1310
    enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt);
1311 1312 1313 1314 1315 1316

    /**
     * DTG active format information (additionnal aspect ratio
     * information only used in DVB MPEG2 transport streams). 0 if
     * not set.
     * 
1317 1318
     * - encoding: unused.
     * - decoding: set by decoder 
1319 1320 1321 1322 1323 1324 1325 1326 1327 1328
     */
    int dtg_active_format;
#define FF_DTG_AFD_SAME         8
#define FF_DTG_AFD_4_3          9
#define FF_DTG_AFD_16_9         10
#define FF_DTG_AFD_14_9         11
#define FF_DTG_AFD_4_3_SP_14_9  13
#define FF_DTG_AFD_16_9_SP_14_9 14
#define FF_DTG_AFD_SP_4_3       15

1329 1330 1331 1332
    /**
     * Maximum motion estimation search range in subpel units.
     * if 0 then no limit
     * 
1333 1334
     * - encoding: set by user.
     * - decoding: unused.
1335
     */
Z
Zdenek Kabelac 已提交
1336
    int me_range;
1337

M
Michael Niedermayer 已提交
1338 1339 1340 1341 1342 1343 1344 1345
    /**
     * frame_rate_base.
     * for variable fps this is 1
     * - encoding: set by user.
     * - decoding: set by lavc.
     * @todo move this after frame_rate
     */

1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360
    int frame_rate_base;
    /**
     * intra quantizer bias.
     * - encoding: set by user.
     * - decoding: unused
     */
    int intra_quant_bias;
#define FF_DEFAULT_QUANT_BIAS 999999
    
    /**
     * inter quantizer bias.
     * - encoding: set by user.
     * - decoding: unused
     */
    int inter_quant_bias;
1361 1362 1363 1364 1365 1366 1367 1368

    /**
     * color table ID.
     * - encoding: unused.
     * - decoding: which clrtable should be used for 8bit RGB images
     *             table have to be stored somewhere FIXME
     */
    int color_table_id;
1369
    
1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380
    /**
     * internal_buffer count. 
     * Dont touch, used by lavc default_get_buffer()
     */
    int internal_buffer_count;
    
    /**
     * internal_buffers. 
     * Dont touch, used by lavc default_get_buffer()
     */
    void *internal_buffer;
1381 1382 1383 1384 1385 1386 1387

#define FF_LAMBDA_SHIFT 7
#define FF_LAMBDA_SCALE (1<<FF_LAMBDA_SHIFT)
#define FF_QP2LAMBDA 118 ///< factor to convert from H.263 QP to lambda
#define FF_LAMBDA_MAX (256*128-1)

#define FF_QUALITY_SCALE FF_LAMBDA_SCALE //FIXME maybe remove
M
Michael Niedermayer 已提交
1388 1389 1390 1391 1392 1393 1394
    /**
     * global quality for codecs which cannot change it per frame.
     * this should be proportional to MPEG1/2/4 qscale.
     * - encoding: set by user.
     * - decoding: unused
     */
    int global_quality;
M
Michael Niedermayer 已提交
1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410
    
#define FF_CODER_TYPE_VLC   0
#define FF_CODER_TYPE_AC    1
    /**
     * coder type
     * - encoding: set by user.
     * - decoding: unused
     */
    int coder_type;

    /**
     * context model
     * - encoding: set by user.
     * - decoding: unused
     */
    int context_model;
1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421
    
    /**
     * slice flags
     * - encoding: unused
     * - decoding: set by user.
     */
    int slice_flags;
#define SLICE_FLAG_CODED_ORDER    0x0001 ///< draw_horiz_band() is called in coded order instead of display
#define SLICE_FLAG_ALLOW_FIELD    0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics)
#define SLICE_FLAG_ALLOW_PLANE    0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)

I
Ivan Kalvachev 已提交
1422 1423 1424 1425 1426 1427
    /**
     * XVideo Motion Acceleration
     * - encoding: forbidden
     * - decoding: set by decoder
     */
    int xvmc_acceleration;
1428 1429 1430 1431 1432 1433 1434 1435 1436 1437
    
    /**
     * macroblock decision mode
     * - encoding: set by user.
     * - decoding: unused
     */
    int mb_decision;
#define FF_MB_DECISION_SIMPLE 0        ///< uses mb_cmp
#define FF_MB_DECISION_BITS   1        ///< chooses the one which needs the fewest bits
#define FF_MB_DECISION_RD     2        ///< rate distoration
1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451

    /**
     * custom intra quantization matrix
     * - encoding: set by user, can be NULL
     * - decoding: set by lavc
     */
    uint16_t *intra_matrix;

    /**
     * custom inter quantization matrix
     * - encoding: set by user, can be NULL
     * - decoding: set by lavc
     */
    uint16_t *inter_matrix;
1452
    
1453 1454 1455 1456 1457 1458 1459
    /**
     * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
     * this is used to workaround some encoder bugs
     * - encoding: unused
     * - decoding: set by user, will be converted to upper case by lavc during init
     */
    unsigned int stream_codec_tag;
M
Michael Niedermayer 已提交
1460 1461 1462 1463 1464 1465 1466 1467

    /**
     * scene change detection threshold.
     * 0 is default, larger means fewer detected scene changes
     * - encoding: set by user.
     * - decoding: unused
     */
    int scenechange_threshold;
1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481

    /**
     * minimum lagrange multipler
     * - encoding: set by user.
     * - decoding: unused
     */
    int lmin;

    /**
     * maximum lagrange multipler
     * - encoding: set by user.
     * - decoding: unused
     */
    int lmax;
1482 1483 1484 1485 1486 1487 1488

    /**
     * Palette control structure
     * - encoding: ??? (no palette-enabled encoder yet)
     * - decoding: set by user.
     */
    struct AVPaletteControl *palctrl;
1489 1490 1491 1492 1493 1494 1495

    /**
     * noise reduction strength
     * - encoding: set by user.
     * - decoding: unused
     */
    int noise_reduction;
1496
    
1497
    /**
1498 1499 1500 1501 1502
     * called at the beginning of a frame to get cr buffer for it.
     * buffer type (size, hints) must be the same. lavc won't check it.
     * lavc will pass previous buffer in pic, function should return
     * same buffer or new buffer with old frame "painted" into it.
     * if pic.data[0] == NULL must behave like get_buffer().
1503
     * - encoding: unused
1504
     * - decoding: set by lavc, user can override
1505
     */
1506
    int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic);
M
Michael Niedermayer 已提交
1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527

    /**
     * number of bits which should be loaded into the rc buffer before decoding starts
     * - encoding: set by user.
     * - decoding: unused
     */
    int rc_initial_buffer_occupancy;

    /**
     *
     * - encoding: set by user.
     * - decoding: unused
     */
    int inter_threshold;

    /**
     * CODEC_FLAG2_*.
     * - encoding: set by user.
     * - decoding: set by user.
     */
    int flags2;
1528 1529 1530 1531 1532 1533 1534

    /**
     * simulates errors in the bitstream to test error concealment.
     * - encoding: set by user.
     * - decoding: unused.
     */
    int error_rate;
1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545
    
    /**
     * MP3 antialias algorithm, see FF_AA_* below.
     * - encoding: unused
     * - decoding: set by user
     */
    int antialias_algo;
#define FF_AA_AUTO    0
#define FF_AA_FASTINT 1 //not implemented yet
#define FF_AA_INT     2
#define FF_AA_FLOAT   3
M
Michael Niedermayer 已提交
1546 1547 1548 1549 1550 1551
    /**
     * Quantizer noise shaping.
     * - encoding: set by user
     * - decoding: unused
     */
    int quantizer_noise_shaping;
1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564

    /**
     * Thread count.
     * is used to decide how many independant tasks should be passed to execute()
     * - encoding: set by user
     * - decoding: set by user
     */
    int thread_count;
    
    /**
     * the codec may call this to execute several independant things. it will return only after
     * finishing all tasks, the user may replace this with some multithreaded implementation, the
     * default implementation will execute the parts serially
1565
     * @param count the number of things to execute
1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577
     * - encoding: set by lavc, user can override
     * - decoding: set by lavc, user can override
     */
    int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void **arg2, int *ret, int count);
    
    /**
     * Thread opaque.
     * can be used by execute() to store some per AVCodecContext stuff.
     * - encoding: set by execute()
     * - decoding: set by execute()
     */
    void *thread_opaque;
1578 1579

    /**
1580 1581
     * Motion estimation threshold. under which no motion estimation is 
     * performed, but instead the user specified motion vectors are used
1582 1583
     * 
     * - encoding: set by user
1584
     * - decoding: unused
1585
     */
M
Michael Niedermayer 已提交
1586
     int me_threshold;
1587 1588 1589 1590 1591 1592 1593

    /**
     * Macroblock threshold. under which the user specified macroblock types will be used
     * - encoding: set by user
     * - decoding: unused
     */
     int mb_threshold;
1594 1595

    /**
M
Michael Niedermayer 已提交
1596
     * precision of the intra dc coefficient - 8.
1597 1598 1599 1600
     * - encoding: set by user
     * - decoding: unused
     */
     int intra_dc_precision;
M
Michael Niedermayer 已提交
1601 1602 1603 1604 1605 1606 1607

    /**
     * noise vs. sse weight for the nsse comparsion function.
     * - encoding: set by user
     * - decoding: unused
     */
     int nsse_weight;
1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621

    /**
     * number of macroblock rows at the top which are skiped.
     * - encoding: unused
     * - decoding: set by user
     */
     int skip_top;

    /**
     * number of macroblock rows at the bottom which are skiped.
     * - encoding: unused
     * - decoding: set by user
     */
     int skip_bottom;
F
Fabrice Bellard 已提交
1622 1623
} AVCodecContext;

1624

1625 1626 1627
/**
 * AVOption.
 */
1628 1629 1630
typedef struct AVOption {
    /** options' name */
    const char *name; /* if name is NULL, it indicates a link to next */
Z
Zdenek Kabelac 已提交
1631 1632
    /** short English text help or const struct AVOption* subpointer */
    const char *help; //	const struct AVOption* sub;
1633 1634 1635 1636
    /** offset to context structure where the parsed value should be stored */
    int offset;
    /** options' type */
    int type;
1637 1638 1639 1640 1641
#define FF_OPT_TYPE_BOOL 1      ///< boolean - true,1,on  (or simply presence)
#define FF_OPT_TYPE_DOUBLE 2    ///< double
#define FF_OPT_TYPE_INT 3       ///< integer
#define FF_OPT_TYPE_STRING 4    ///< string (finished with \0)
#define FF_OPT_TYPE_MASK 0x1f	///< mask for types - upper bits are various flags
1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659
//#define FF_OPT_TYPE_EXPERT 0x20 // flag for expert option
#define FF_OPT_TYPE_FLAG (FF_OPT_TYPE_BOOL | 0x40)
#define FF_OPT_TYPE_RCOVERRIDE (FF_OPT_TYPE_STRING | 0x80)
    /** min value  (min == max   ->  no limits) */
    double min;
    /** maximum value for double/int */
    double max;
    /** default boo [0,1]l/double/int value */
    double defval;
    /**
     * default string value (with optional semicolon delimited extra option-list
     * i.e.   option1;option2;option3
     * defval might select other then first argument as default
     */
    const char *defstr;
#define FF_OPT_MAX_DEPTH 10
} AVOption;

Z
Zdenek Kabelac 已提交
1660 1661 1662 1663 1664 1665 1666 1667 1668
/**
 * Parse option(s) and sets fields in passed structure
 * @param strct	structure where the parsed results will be written
 * @param list  list with AVOptions
 * @param opts	string with options for parsing
 */
int avoption_parse(void* strct, const AVOption* list, const char* opts);


1669 1670 1671
/**
 * AVCodec.
 */
F
Fabrice Bellard 已提交
1672
typedef struct AVCodec {
1673
    const char *name;
Z
Zdenek Kabelac 已提交
1674
    enum CodecType type;
F
Fabrice Bellard 已提交
1675 1676 1677
    int id;
    int priv_data_size;
    int (*init)(AVCodecContext *);
1678
    int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
F
Fabrice Bellard 已提交
1679
    int (*close)(AVCodecContext *);
M
Michael Niedermayer 已提交
1680
    int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
1681
                  uint8_t *buf, int buf_size);
F
Fabrice Bellard 已提交
1682
    int capabilities;
1683
    const AVOption *options;
F
Fabrice Bellard 已提交
1684
    struct AVCodec *next;
M
Michael Niedermayer 已提交
1685
    void (*flush)(AVCodecContext *);
Z
* const  
Zdenek Kabelac 已提交
1686
    const AVRational *supported_framerates; ///array of supported framerates, or NULL if any, array is terminated by {0,0}
1687
    const enum PixelFormat *pix_fmts;       ///array of supported pixel formats, or NULL if unknown, array is terminanted by -1
F
Fabrice Bellard 已提交
1688 1689
} AVCodec;

1690
/**
1691 1692 1693
 * four components are given, that's all.
 * the last component is alpha
 */
F
Fabrice Bellard 已提交
1694
typedef struct AVPicture {
1695
    uint8_t *data[4];
M
Michael Niedermayer 已提交
1696
    int linesize[4];       ///< number of bytes per line
F
Fabrice Bellard 已提交
1697 1698
} AVPicture;

M
Mike Melanson 已提交
1699 1700 1701 1702 1703
/**
 * AVPaletteControl
 * This structure defines a method for communicating palette changes
 * between and demuxer and a decoder.
 */
1704
#define AVPALETTE_SIZE 1024
M
10l ...  
Michael Niedermayer 已提交
1705
#define AVPALETTE_COUNT 256
M
Mike Melanson 已提交
1706 1707 1708 1709 1710 1711
typedef struct AVPaletteControl {

    /* demuxer sets this to 1 to indicate the palette has changed;
     * decoder resets to 0 */
    int palette_changed;

1712 1713 1714 1715
    /* 4-byte ARGB palette entries, stored in native byte order; note that
     * the individual palette components should be on a 8-bit scale; if
     * the palette data comes from a IBM VGA native format, the component
     * data is probably 6 bits in size and needs to be scaled */
1716
    unsigned int palette[AVPALETTE_COUNT];
M
Mike Melanson 已提交
1717 1718 1719

} AVPaletteControl;

F
Fabrice Bellard 已提交
1720 1721
extern AVCodec ac3_encoder;
extern AVCodec mp2_encoder;
1722
extern AVCodec mp3lame_encoder;
1723
extern AVCodec oggvorbis_encoder;
1724
extern AVCodec faac_encoder;
F
Fabrice Bellard 已提交
1725
extern AVCodec mpeg1video_encoder;
M
Michael Niedermayer 已提交
1726
extern AVCodec mpeg2video_encoder;
F
Fabrice Bellard 已提交
1727 1728
extern AVCodec h263_encoder;
extern AVCodec h263p_encoder;
1729
extern AVCodec flv_encoder;
F
Fabrice Bellard 已提交
1730
extern AVCodec rv10_encoder;
M
Michael Niedermayer 已提交
1731
extern AVCodec rv20_encoder;
1732
extern AVCodec dvvideo_encoder;
F
Fabrice Bellard 已提交
1733
extern AVCodec mjpeg_encoder;
1734
extern AVCodec ljpeg_encoder;
F
Fabrice Bellard 已提交
1735
extern AVCodec mpeg4_encoder;
1736 1737 1738
extern AVCodec msmpeg4v1_encoder;
extern AVCodec msmpeg4v2_encoder;
extern AVCodec msmpeg4v3_encoder;
M
Michael Niedermayer 已提交
1739 1740
extern AVCodec wmv1_encoder;
extern AVCodec wmv2_encoder;
M
huffyuv  
Michael Niedermayer 已提交
1741
extern AVCodec huffyuv_encoder;
M
Michael Niedermayer 已提交
1742
extern AVCodec h264_encoder;
M
Michael Niedermayer 已提交
1743
extern AVCodec asv1_encoder;
M
Michael Niedermayer 已提交
1744
extern AVCodec asv2_encoder;
M
Michael Niedermayer 已提交
1745
extern AVCodec vcr1_encoder;
1746
extern AVCodec ffv1_encoder;
1747
extern AVCodec mdec_encoder;
R
Roberto Togni 已提交
1748
extern AVCodec zlib_encoder;
1749
extern AVCodec svq1_encoder;
F
Fabrice Bellard 已提交
1750 1751

extern AVCodec h263_decoder;
1752
extern AVCodec h261_decoder;
F
Fabrice Bellard 已提交
1753
extern AVCodec mpeg4_decoder;
1754 1755 1756
extern AVCodec msmpeg4v1_decoder;
extern AVCodec msmpeg4v2_decoder;
extern AVCodec msmpeg4v3_decoder;
1757
extern AVCodec wmv1_decoder;
M
Michael Niedermayer 已提交
1758
extern AVCodec wmv2_decoder;
M
Michael Niedermayer 已提交
1759 1760
extern AVCodec mpeg1video_decoder;
extern AVCodec mpeg2video_decoder;
I
Ivan Kalvachev 已提交
1761
extern AVCodec mpegvideo_decoder;
I
Ivan Kalvachev 已提交
1762
extern AVCodec mpeg_xvmc_decoder;
F
Fabrice Bellard 已提交
1763
extern AVCodec h263i_decoder;
1764
extern AVCodec flv_decoder;
F
Fabrice Bellard 已提交
1765
extern AVCodec rv10_decoder;
M
Michael Niedermayer 已提交
1766
extern AVCodec rv20_decoder;
N
Nick Kurshev 已提交
1767
extern AVCodec svq1_decoder;
M
Michael Niedermayer 已提交
1768
extern AVCodec svq3_decoder;
F
Fabrice Bellard 已提交
1769
extern AVCodec dvvideo_decoder;
F
Fabrice Bellard 已提交
1770 1771
extern AVCodec wmav1_decoder;
extern AVCodec wmav2_decoder;
F
Fabrice Bellard 已提交
1772
extern AVCodec mjpeg_decoder;
1773
extern AVCodec mjpegb_decoder;
1774
extern AVCodec sp5x_decoder;
1775
extern AVCodec mp2_decoder;
F
Fabrice Bellard 已提交
1776
extern AVCodec mp3_decoder;
1777 1778
extern AVCodec mace3_decoder;
extern AVCodec mace6_decoder;
M
huffyuv  
Michael Niedermayer 已提交
1779
extern AVCodec huffyuv_decoder;
M
Mark Hills 已提交
1780
extern AVCodec oggvorbis_decoder;
1781
extern AVCodec cyuv_decoder;
M
Michael Niedermayer 已提交
1782
extern AVCodec h264_decoder;
1783
extern AVCodec indeo3_decoder;
1784
extern AVCodec vp3_decoder;
1785
extern AVCodec theora_decoder;
1786
extern AVCodec amr_nb_decoder;
Z
Zdenek Kabelac 已提交
1787
extern AVCodec amr_nb_encoder;
1788 1789
extern AVCodec amr_wb_encoder;
extern AVCodec amr_wb_decoder;
1790 1791
extern AVCodec aac_decoder;
extern AVCodec mpeg4aac_decoder;
M
Michael Niedermayer 已提交
1792
extern AVCodec asv1_decoder;
M
Michael Niedermayer 已提交
1793
extern AVCodec asv2_decoder;
M
Michael Niedermayer 已提交
1794
extern AVCodec vcr1_decoder;
A
Alex Beregszaszi 已提交
1795
extern AVCodec cljr_decoder;
1796
extern AVCodec ffv1_decoder;
M
Michael Niedermayer 已提交
1797
extern AVCodec fourxm_decoder;
1798
extern AVCodec mdec_decoder;
1799 1800
extern AVCodec roq_decoder;
extern AVCodec interplay_video_decoder;
1801
extern AVCodec xan_wc3_decoder;
1802 1803 1804 1805
extern AVCodec rpza_decoder;
extern AVCodec cinepak_decoder;
extern AVCodec msrle_decoder;
extern AVCodec msvideo1_decoder;
M
Mike Melanson 已提交
1806
extern AVCodec vqa_decoder;
1807
extern AVCodec idcin_decoder;
R
Roberto Togni 已提交
1808
extern AVCodec eightbps_decoder;
M
Mike Melanson 已提交
1809
extern AVCodec smc_decoder;
M
Mike Melanson 已提交
1810
extern AVCodec flic_decoder;
1811 1812
extern AVCodec vmdvideo_decoder;
extern AVCodec vmdaudio_decoder;
1813
extern AVCodec truemotion1_decoder;
R
Roberto Togni 已提交
1814 1815
extern AVCodec mszh_decoder;
extern AVCodec zlib_decoder;
1816 1817
extern AVCodec ra_144_decoder;
extern AVCodec ra_288_decoder;
1818 1819
extern AVCodec roq_dpcm_decoder;
extern AVCodec interplay_dpcm_decoder;
1820
extern AVCodec xan_dpcm_decoder;
1821
extern AVCodec qtrle_decoder;
M
Michael Niedermayer 已提交
1822
extern AVCodec flac_decoder;
F
Fabrice Bellard 已提交
1823

F
Fabrice Bellard 已提交
1824 1825 1826
/* pcm codecs */
#define PCM_CODEC(id, name) \
extern AVCodec name ## _decoder; \
1827
extern AVCodec name ## _encoder
F
Fabrice Bellard 已提交
1828 1829 1830 1831 1832 1833 1834 1835 1836 1837

PCM_CODEC(CODEC_ID_PCM_S16LE, pcm_s16le);
PCM_CODEC(CODEC_ID_PCM_S16BE, pcm_s16be);
PCM_CODEC(CODEC_ID_PCM_U16LE, pcm_u16le);
PCM_CODEC(CODEC_ID_PCM_U16BE, pcm_u16be);
PCM_CODEC(CODEC_ID_PCM_S8, pcm_s8);
PCM_CODEC(CODEC_ID_PCM_U8, pcm_u8);
PCM_CODEC(CODEC_ID_PCM_ALAW, pcm_alaw);
PCM_CODEC(CODEC_ID_PCM_MULAW, pcm_mulaw);

1838 1839 1840 1841
/* adpcm codecs */

PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
1842 1843
PCM_CODEC(CODEC_ID_ADPCM_IMA_DK3, adpcm_ima_dk3);
PCM_CODEC(CODEC_ID_ADPCM_IMA_DK4, adpcm_ima_dk4);
1844
PCM_CODEC(CODEC_ID_ADPCM_IMA_WS, adpcm_ima_ws);
1845
PCM_CODEC(CODEC_ID_ADPCM_SMJPEG, adpcm_ima_smjpeg);
1846
PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);
M
Michael Niedermayer 已提交
1847
PCM_CODEC(CODEC_ID_ADPCM_4XM, adpcm_4xm);
1848 1849
PCM_CODEC(CODEC_ID_ADPCM_XA, adpcm_xa);
PCM_CODEC(CODEC_ID_ADPCM_ADX, adpcm_adx);
1850
PCM_CODEC(CODEC_ID_ADPCM_EA, adpcm_ea);
1851
PCM_CODEC(CODEC_ID_ADPCM_G726, adpcm_g726);
1852

F
Fabrice Bellard 已提交
1853 1854 1855
#undef PCM_CODEC

/* dummy raw video codec */
1856 1857
extern AVCodec rawvideo_encoder;
extern AVCodec rawvideo_decoder;
F
Fabrice Bellard 已提交
1858 1859 1860 1861 1862 1863 1864

/* the following codecs use external GPL libs */
extern AVCodec ac3_decoder;

/* resample.c */

struct ReSampleContext;
1865
struct AVResampleContext;
F
Fabrice Bellard 已提交
1866 1867 1868 1869 1870 1871 1872 1873

typedef struct ReSampleContext ReSampleContext;

ReSampleContext *audio_resample_init(int output_channels, int input_channels, 
                                     int output_rate, int input_rate);
int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
void audio_resample_close(ReSampleContext *s);

1874 1875
struct AVResampleContext *av_resample_init(int out_rate, int in_rate);
int av_resample(struct AVResampleContext *c, short *dst, short *src, int *consumed, int src_size, int dst_size, int update_ctx);
M
Michael Niedermayer 已提交
1876
void av_resample_compensate(struct AVResampleContext *c, int sample_delta, int compensation_distance);
1877
void av_resample_close(struct AVResampleContext *c);
1878

F
Fabrice Bellard 已提交
1879 1880 1881 1882 1883 1884 1885 1886
/* YUV420 format is assumed ! */

struct ImgReSampleContext;

typedef struct ImgReSampleContext ImgReSampleContext;

ImgReSampleContext *img_resample_init(int output_width, int output_height,
                                      int input_width, int input_height);
1887 1888 1889 1890

ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
                                      int iwidth, int iheight,
                                      int topBand, int bottomBand,
1891 1892 1893 1894
                                      int leftBand, int rightBand,
                                      int padtop, int padbottom,
                                      int padleft, int padright);

1895

F
Fabrice Bellard 已提交
1896
void img_resample(ImgReSampleContext *s, 
1897
                  AVPicture *output, const AVPicture *input);
F
Fabrice Bellard 已提交
1898 1899 1900

void img_resample_close(ImgReSampleContext *s);

D
Drew Hess 已提交
1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914
/**
 * Allocate memory for a picture.  Call avpicture_free to free it.
 *
 * @param picture the picture to be filled in.
 * @param pix_fmt the format of the picture.
 * @param width the width of the picture.
 * @param height the height of the picture.
 * @return 0 if successful, -1 if not.
 */
int avpicture_alloc(AVPicture *picture, int pix_fmt, int width, int height);

/* Free a picture previously allocated by avpicture_alloc. */
void avpicture_free(AVPicture *picture);

1915
int avpicture_fill(AVPicture *picture, uint8_t *ptr,
1916
                   int pix_fmt, int width, int height);
1917
int avpicture_layout(const AVPicture* src, int pix_fmt, int width, int height,
1918
                     unsigned char *dest, int dest_size);
1919
int avpicture_get_size(int pix_fmt, int width, int height);
1920 1921
void avcodec_get_chroma_sub_sample(int pix_fmt, int *h_shift, int *v_shift);
const char *avcodec_get_pix_fmt_name(int pix_fmt);
1922
enum PixelFormat avcodec_get_pix_fmt(const char* name);
1923

1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935
#define FF_LOSS_RESOLUTION  0x0001 /* loss due to resolution change */
#define FF_LOSS_DEPTH       0x0002 /* loss due to color depth change */
#define FF_LOSS_COLORSPACE  0x0004 /* loss due to color space conversion */
#define FF_LOSS_ALPHA       0x0008 /* loss of alpha bits */
#define FF_LOSS_COLORQUANT  0x0010 /* loss due to color quantization */
#define FF_LOSS_CHROMA      0x0020 /* loss of chroma (e.g. rgb to gray conversion) */

int avcodec_get_pix_fmt_loss(int dst_pix_fmt, int src_pix_fmt,
                             int has_alpha);
int avcodec_find_best_pix_fmt(int pix_fmt_mask, int src_pix_fmt,
                              int has_alpha, int *loss_ptr);

F
Fabrice Bellard 已提交
1936 1937
#define FF_ALPHA_TRANSP       0x0001 /* image has some totally transparent pixels */
#define FF_ALPHA_SEMI_TRANSP  0x0002 /* image has some transparent pixels */
1938 1939
int img_get_alpha_info(const AVPicture *src,
		       int pix_fmt, int width, int height);
F
Fabrice Bellard 已提交
1940

1941 1942
/* convert among pixel formats */
int img_convert(AVPicture *dst, int dst_pix_fmt,
1943
                const AVPicture *src, int pix_fmt, 
1944 1945 1946
                int width, int height);

/* deinterlace a picture */
1947
int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
F
Fabrice Bellard 已提交
1948 1949 1950 1951 1952 1953
                          int pix_fmt, int width, int height);

/* external high level API */

extern AVCodec *first_avcodec;

N
Nick Kurshev 已提交
1954
/* returns LIBAVCODEC_VERSION_INT constant */
1955
unsigned avcodec_version(void);
N
Nick Kurshev 已提交
1956
/* returns LIBAVCODEC_BUILD constant */
1957
unsigned avcodec_build(void);
F
Fabrice Bellard 已提交
1958 1959 1960 1961
void avcodec_init(void);

void register_avcodec(AVCodec *format);
AVCodec *avcodec_find_encoder(enum CodecID id);
1962
AVCodec *avcodec_find_encoder_by_name(const char *name);
F
Fabrice Bellard 已提交
1963 1964 1965 1966
AVCodec *avcodec_find_decoder(enum CodecID id);
AVCodec *avcodec_find_decoder_by_name(const char *name);
void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);

M
cleanup  
Michael Niedermayer 已提交
1967
void avcodec_get_context_defaults(AVCodecContext *s);
F
Falk Hüffner 已提交
1968
AVCodecContext *avcodec_alloc_context(void);
F
Falk Hüffner 已提交
1969
void avcodec_get_frame_defaults(AVFrame *pic);
M
Michael Niedermayer 已提交
1970
AVFrame *avcodec_alloc_frame(void);
M
cleanup  
Michael Niedermayer 已提交
1971

M
Michael Niedermayer 已提交
1972 1973
int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
M
Michael Niedermayer 已提交
1974 1975 1976
int avcodec_default_reget_buffer(AVCodecContext *s, AVFrame *pic);
void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height);
enum PixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum PixelFormat * fmt);
M
cleanup  
Michael Niedermayer 已提交
1977

M
1l  
Michael Niedermayer 已提交
1978 1979 1980
int avcodec_thread_init(AVCodecContext *s, int thread_count);
void avcodec_thread_free(AVCodecContext *s);
int avcodec_thread_execute(AVCodecContext *s, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
M
Michael Niedermayer 已提交
1981
int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
1982 1983
//FIXME func typedef

M
Michael Niedermayer 已提交
1984 1985 1986 1987
/**
 * opens / inits the AVCodecContext.
 * not thread save!
 */
F
Fabrice Bellard 已提交
1988
int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
M
Michael Niedermayer 已提交
1989

1990
int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples, 
F
Fabrice Bellard 已提交
1991
                         int *frame_size_ptr,
1992
                         uint8_t *buf, int buf_size);
M
Michael Niedermayer 已提交
1993
int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture, 
F
Fabrice Bellard 已提交
1994
                         int *got_picture_ptr,
1995 1996
                         uint8_t *buf, int buf_size);
int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata, 
1997
                        int *data_size_ptr,
1998 1999
                        uint8_t *buf, int buf_size);
int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size, 
F
Fabrice Bellard 已提交
2000
                         const short *samples);
2001
int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size, 
M
Michael Niedermayer 已提交
2002
                         const AVFrame *pict);
F
Fabrice Bellard 已提交
2003 2004 2005 2006

int avcodec_close(AVCodecContext *avctx);

void avcodec_register_all(void);
F
Fabrice Bellard 已提交
2007

M
Michael Niedermayer 已提交
2008 2009
void avcodec_flush_buffers(AVCodecContext *avctx);

2010
/* misc usefull functions */
M
cleanup  
Michael Niedermayer 已提交
2011 2012 2013 2014 2015 2016

/**
 * returns a single letter to describe the picture type
 */
char av_get_pict_type_char(int pict_type);

2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028
/**
 * reduce a fraction.
 * this is usefull for framerate calculations
 * @param max the maximum allowed for dst_nom & dst_den
 * @return 1 if exact, 0 otherwise
 */
int av_reduce(int *dst_nom, int *dst_den, int64_t nom, int64_t den, int64_t max);

/**
 * rescale a 64bit integer.
 * a simple a*b/c isnt possible as it can overflow
 */
2029
int64_t av_rescale(int64_t a, int64_t b, int64_t c);
2030 2031


2032 2033 2034 2035 2036 2037 2038
/**
 * Interface for 0.5.0 version
 *
 * do not even think about it's usage for this moment
 */

typedef struct {
2039
    /// compressed size used from given memory buffer
2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107
    int size;
    /// I/P/B frame type
    int frame_type;
} avc_enc_result_t;

/**
 * Commands
 * order can't be changed - once it was defined
 */
typedef enum {
    // general commands
    AVC_OPEN_BY_NAME = 0xACA000,
    AVC_OPEN_BY_CODEC_ID,
    AVC_OPEN_BY_FOURCC,
    AVC_CLOSE,

    AVC_FLUSH,
    // pin - struct { uint8_t* src, uint_t src_size }
    // pout - struct { AVPicture* img, consumed_bytes,
    AVC_DECODE,
    // pin - struct { AVPicture* img, uint8_t* dest, uint_t dest_size }
    // pout - uint_t used_from_dest_size
    AVC_ENCODE, 

    // query/get video commands
    AVC_GET_VERSION = 0xACB000,
    AVC_GET_WIDTH,
    AVC_GET_HEIGHT,
    AVC_GET_DELAY,
    AVC_GET_QUANT_TABLE,
    // ...

    // query/get audio commands
    AVC_GET_FRAME_SIZE = 0xABC000,

    // maybe define some simple structure which
    // might be passed to the user - but they can't
    // contain any codec specific parts and these
    // calls are usualy necessary only few times

    // set video commands
    AVC_SET_WIDTH = 0xACD000,
    AVC_SET_HEIGHT,

    // set video encoding commands
    AVC_SET_FRAME_RATE = 0xACD800,
    AVC_SET_QUALITY,
    AVC_SET_HURRY_UP,

    // set audio commands
    AVC_SET_SAMPLE_RATE = 0xACE000,
    AVC_SET_CHANNELS,

} avc_cmd_t;

/**
 * \param handle  allocated private structure by libavcodec
 *                for initialization pass NULL - will be returned pout
 *                user is supposed to know nothing about its structure
 * \param cmd     type of operation to be performed
 * \param pint    input parameter
 * \param pout    output parameter
 *
 * \returns  command status - eventually for query command it might return
 * integer resulting value
 */
int avcodec(void* handle, avc_cmd_t cmd, void* pin, void* pout);

F
Fabrice Bellard 已提交
2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118
/* frame parsing */
typedef struct AVCodecParserContext {
    void *priv_data;
    struct AVCodecParser *parser;
    int64_t frame_offset; /* offset of the current frame */
    int64_t cur_offset; /* current offset 
                           (incremented by each av_parser_parse()) */
    int64_t last_frame_offset; /* offset of the last frame */
    /* video info */
    int pict_type; /* XXX: put it back in AVCodecContext */
    int repeat_pict; /* XXX: put it back in AVCodecContext */
2119 2120 2121 2122 2123 2124
    int64_t pts;     /* pts of the current frame */
    int64_t dts;     /* dts of the current frame */

    /* private data */
    int64_t last_pts;
    int64_t last_dts;
M
Michael Niedermayer 已提交
2125
    int fetch_timestamp;
2126 2127 2128 2129 2130 2131

#define AV_PARSER_PTS_NB 4
    int cur_frame_start_index;
    int64_t cur_frame_offset[AV_PARSER_PTS_NB];
    int64_t cur_frame_pts[AV_PARSER_PTS_NB];
    int64_t cur_frame_dts[AV_PARSER_PTS_NB];
F
Fabrice Bellard 已提交
2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152
} AVCodecParserContext;

typedef struct AVCodecParser {
    int codec_ids[3]; /* several codec IDs are permitted */
    int priv_data_size;
    int (*parser_init)(AVCodecParserContext *s);
    int (*parser_parse)(AVCodecParserContext *s, 
                        AVCodecContext *avctx,
                        uint8_t **poutbuf, int *poutbuf_size, 
                        const uint8_t *buf, int buf_size);
    void (*parser_close)(AVCodecParserContext *s);
    struct AVCodecParser *next;
} AVCodecParser;

extern AVCodecParser *av_first_parser;

void av_register_codec_parser(AVCodecParser *parser);
AVCodecParserContext *av_parser_init(int codec_id);
int av_parser_parse(AVCodecParserContext *s, 
                    AVCodecContext *avctx,
                    uint8_t **poutbuf, int *poutbuf_size, 
2153 2154
                    const uint8_t *buf, int buf_size,
                    int64_t pts, int64_t dts);
F
Fabrice Bellard 已提交
2155 2156 2157 2158
void av_parser_close(AVCodecParserContext *s);

extern AVCodecParser mpegvideo_parser;
extern AVCodecParser mpeg4video_parser;
2159
extern AVCodecParser h261_parser;
F
Fabrice Bellard 已提交
2160 2161 2162 2163 2164
extern AVCodecParser h263_parser;
extern AVCodecParser h264_parser;
extern AVCodecParser mpegaudio_parser;
extern AVCodecParser ac3_parser;

F
Fabrice Bellard 已提交
2165
/* memory */
2166
void *av_malloc(unsigned int size);
2167
void *av_mallocz(unsigned int size);
2168
void *av_realloc(void *ptr, unsigned int size);
F
Fabrice Bellard 已提交
2169
void av_free(void *ptr);
2170
char *av_strdup(const char *s);
M
Michael Niedermayer 已提交
2171
void av_freep(void *ptr);
2172
void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
2173 2174
/* for static data only */
/* call av_free_static to release all staticaly allocated tables */
2175
void av_free_static(void);
2176
void *av_mallocz_static(unsigned int size);
F
Fabrice Bellard 已提交
2177

2178 2179 2180
/* add by bero : in adx.c */
int is_adx(const unsigned char *buf,size_t bufsize);

2181 2182 2183
void img_copy(AVPicture *dst, const AVPicture *src,
              int pix_fmt, int width, int height);

2184 2185 2186 2187
/* av_log API */

#include <stdarg.h>

2188
#define AV_LOG_QUIET -1
2189 2190 2191 2192
#define AV_LOG_ERROR 0
#define AV_LOG_INFO 1
#define AV_LOG_DEBUG 2

2193
#ifdef __GNUC__
2194
extern void av_log(void*, int level, const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4)));
2195 2196 2197 2198
#else
extern void av_log(void*, int level, const char *fmt, ...);
#endif

2199
extern void av_vlog(void*, int level, const char *fmt, va_list);
2200 2201
extern int av_log_get_level(void);
extern void av_log_set_level(int);
2202
extern void av_log_set_callback(void (*)(void*, int, const char*, va_list));
2203

2204
/* endian macros */
2205
#if !defined(BE_16) || !defined(BE_32) || !defined(LE_16) || !defined(LE_32)
2206 2207 2208 2209 2210 2211 2212 2213 2214 2215
#define BE_16(x)  ((((uint8_t*)(x))[0] << 8) | ((uint8_t*)(x))[1])
#define BE_32(x)  ((((uint8_t*)(x))[0] << 24) | \
                   (((uint8_t*)(x))[1] << 16) | \
                   (((uint8_t*)(x))[2] << 8) | \
                    ((uint8_t*)(x))[3])
#define LE_16(x)  ((((uint8_t*)(x))[1] << 8) | ((uint8_t*)(x))[0])
#define LE_32(x)  ((((uint8_t*)(x))[3] << 24) | \
                   (((uint8_t*)(x))[2] << 16) | \
                   (((uint8_t*)(x))[1] << 8) | \
                    ((uint8_t*)(x))[0])
2216
#endif
2217

2218 2219 2220 2221
#ifdef __cplusplus
}
#endif

F
Fabrice Bellard 已提交
2222
#endif /* AVCODEC_H */