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

18 19 20
#define FFMPEG_VERSION_INT     0x000409
#define FFMPEG_VERSION         "0.4.9-pre1"
#define LIBAVCODEC_BUILD       4718
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) */
143 144

    CODEC_ID_DTS,
145
    CODEC_ID_XVID,
F
Fabrice Bellard 已提交
146
};
147 148 149

/* CODEC_ID_MP3LAME is absolete */
#define CODEC_ID_MP3LAME CODEC_ID_MP3
F
Fabrice Bellard 已提交
150 151

enum CodecType {
152
    CODEC_TYPE_UNKNOWN = -1,
F
Fabrice Bellard 已提交
153 154
    CODEC_TYPE_VIDEO,
    CODEC_TYPE_AUDIO,
155
    CODEC_TYPE_DATA,
F
Fabrice Bellard 已提交
156 157
};

158
/**
M
Mike Melanson 已提交
159 160 161 162 163 164 165 166 167 168 169 170
 * 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
171 172 173 174
 * 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.
175
 */
F
Fabrice Bellard 已提交
176
enum PixelFormat {
M
Michael Niedermayer 已提交
177 178 179 180 181 182
    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 已提交
183
    PIX_FMT_RGBA32,    ///< Packed pixel, 4 bytes per pixel, BGRABGRA..., stored in cpu endianness
M
Michael Niedermayer 已提交
184 185
    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)
186 187
    PIX_FMT_RGB565,    ///< always stored in cpu endianness 
    PIX_FMT_RGB555,    ///< always stored in cpu endianness, most significant bit to 1 
188
    PIX_FMT_GRAY8,
189 190 191
    PIX_FMT_MONOWHITE, ///< 0 is white 
    PIX_FMT_MONOBLACK, ///< 0 is black 
    PIX_FMT_PAL8,      ///< 8 bit with RGBA palette 
M
Michael Niedermayer 已提交
192 193 194
    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 已提交
195 196
    PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing(xvmc_render.h)
    PIX_FMT_XVMC_MPEG2_IDCT,
197
    PIX_FMT_NB,
F
Fabrice Bellard 已提交
198 199
};

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

F
Fabrice Bellard 已提交
205
/* in bytes */
F
Fabrice Bellard 已提交
206
#define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
F
Fabrice Bellard 已提交
207

208
/**
209 210 211 212 213
 * 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
214 215 216
 */
#define FF_INPUT_BUFFER_PADDING_SIZE 8

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

M
Michael Niedermayer 已提交
227 228 229 230 231 232 233
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;

234 235 236
/* only for ME compatiblity with old apps */
extern int motion_estimation_method;

M
Michael Niedermayer 已提交
237
#define FF_MAX_B_FRAMES 8
238

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

244
#define CODEC_FLAG_QSCALE 0x0002  ///< use fixed qscale 
245
#define CODEC_FLAG_4MV    0x0004  ///< 4 MV per MB allowed / Advanced prediction for H263
246 247
#define CODEC_FLAG_QPEL   0x0010  ///< use qpel MC 
#define CODEC_FLAG_GMC    0x0020  ///< use GMC 
248
#define CODEC_FLAG_MV0    0x0040  ///< always try a MB with MV=<0,0> 
249
#define CODEC_FLAG_PART   0x0080  ///< use data partitioning 
250 251
/* 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 */
252
#define CODEC_FLAG_INPUT_PRESERVED 0x0100
253 254 255 256 257 258 259
#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 
260
                                            of only at frame boundaries */
261 262
#define CODEC_FLAG_NORMALIZE_AQP  0x00020000 ///< normalize adaptive quantization 
#define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< use interlaced dct 
263
#define CODEC_FLAG_LOW_DELAY      0x00080000 ///< force low delay
264 265 266 267
#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) 
268
/* Fx : Flag for h263+ extra options */
M
Michael Niedermayer 已提交
269 270
#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
271
#define CODEC_FLAG_H263P_UMV      0x02000000 ///< Unlimited motion vector  
272
#define CODEC_FLAG_CBP_RD         0x04000000 ///< use rate distortion optimization for cbp
273
#define CODEC_FLAG_QP_RD          0x08000000 ///< use rate distortion optimization for qp selectioon
274
#define CODEC_FLAG_H263P_AIV      0x00000008 ///< H263 Alternative inter vlc
M
Michael Niedermayer 已提交
275 276
#define CODEC_FLAG_OBMC           0x00000001 ///< OBMC
#define CODEC_FLAG_LOOP_FILTER    0x00000800 ///< loop filter
M
Michael Niedermayer 已提交
277 278
#define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000
#define CODEC_FLAG_INTERLACED_ME  0x20000000 ///< interlaced motion estimation
M
Michael Niedermayer 已提交
279
#define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< will reserve space for SVCD scan offset user data
280
#define CODEC_FLAG_CLOSED_GOP     0x80000000
281 282 283
/* Unsupported options :
 * 		Syntax Arithmetic coding (SAC)
 * 		Reference Picture Selection
M
Michael Niedermayer 已提交
284
 * 		Independant Segment Decoding */
285
/* /Fx */
F
Fabrice Bellard 已提交
286 287
/* codec capabilities */

288
#define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< decoder can use draw_horiz_band callback 
M
Michael Niedermayer 已提交
289 290 291 292 293
/**
 * Codec uses get_buffer() for allocating buffers.
 * direct rendering method 1
 */
#define CODEC_CAP_DR1             0x0002
294 295 296
/* if 'parse_only' field is true, then avcodec_parse_frame() can be
   used */
#define CODEC_CAP_PARSE_ONLY      0x0004
297
#define CODEC_CAP_TRUNCATED       0x0008
298 299
/* codec can export data for HW decoding (XvMC) */
#define CODEC_CAP_HWACCEL         0x0010
300 301
/** 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 已提交
302

303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326
//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, ...)

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

M
Michael Niedermayer 已提交
555 556
#define FF_QSCALE_TYPE_MPEG1	0
#define FF_QSCALE_TYPE_MPEG2	1
M
Michael Niedermayer 已提交
557 558

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

M
cleanup  
Michael Niedermayer 已提交
563

564 565 566 567
#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 已提交
568 569
#define FF_SI_TYPE 5
#define FF_SP_TYPE 6
M
cleanup  
Michael Niedermayer 已提交
570

571 572 573 574 575
#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 已提交
576 577 578
/**
 * Audio Video Frame.
 */
M
Michael Niedermayer 已提交
579 580 581
typedef struct AVFrame {
    FF_COMMON_FRAME
} AVFrame;
M
cleanup  
Michael Niedermayer 已提交
582

583
#define DEFAULT_FRAME_RATE_BASE 1001000
M
doxy  
Michael Niedermayer 已提交
584

585 586 587 588 589 590 591 592 593 594 595 596
/**
 * 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 已提交
597 598 599
/**
 * main external api structure.
 */
F
Fabrice Bellard 已提交
600
typedef struct AVCodecContext {
601 602 603 604
    /**
     * Info on struct for av_log
     * - set by avcodec_alloc_context
     */
M
Michael Niedermayer 已提交
605
    AVClass *av_class;
606
    /**
607 608 609
     * 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 
610
     */
F
Fabrice Bellard 已提交
611
    int bit_rate;
612 613

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

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

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

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

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

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

    /**
680
     * pixel format, see PIX_FMT_xxx.
681 682 683 684
     * - 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.
685
     * - decoding: set by lavc.
686
     */
687
    enum PixelFormat pix_fmt;
688 689 690 691 692 693 694 695 696
 
    /**
     * 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;
       
697 698 699 700 701
    /**
     * 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
702 703
     * - encoding: unused
     * - decoding: set by user.
704 705 706 707
     * @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
708
     */
F
Fabrice Bellard 已提交
709
    void (*draw_horiz_band)(struct AVCodecContext *s,
710
                            const AVFrame *src, int offset[4],
711
                            int y, int type, int height);
F
Fabrice Bellard 已提交
712

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

    /* the following data should not be initialized */
719 720 721
    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 已提交
722
    
723 724
    /**
     * number of frames the decoded output will be delayed relative to 
725 726 727
     * the encoded input.
     * - encoding: set by lavc.
     * - decoding: unused
728 729
     */
    int delay;
M
Michael Niedermayer 已提交
730
    
731 732 733
    /* - 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) 
734 735
    
    /**
736 737 738
     * minimum quantizer.
     * - encoding: set by user.
     * - decoding: unused
739 740 741 742
     */
    int qmin;

    /**
743 744 745
     * maximum quantizer.
     * - encoding: set by user.
     * - decoding: unused
746 747 748 749
     */
    int qmax;

    /**
750 751 752
     * maximum quantizer difference etween frames.
     * - encoding: set by user.
     * - decoding: unused
753 754 755 756
     */
    int max_qdiff;

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

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

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

M
Michael Niedermayer 已提交
786 787
    /* unused, FIXME remove*/
    int rtp_mode;
788 789 790 791 792 793 794
    
    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    */
795 796 797 798 799 800

    
    /* 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   */
801
    void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int packet_number); 
802

803 804 805 806 807 808 809 810
    /* 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;
811 812 813
    int misc_bits;
    
    /**
814 815
     * number of bits used for the previously encoded frame.
     * - encoding: set by lavc
816
     * - decoding: unused
817
     */
818
    int frame_bits;
819

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

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

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

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

    /**
1006
     * qscale factor between p and i frames.
1007 1008
     * 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)
1009 1010
     * - encoding: set by user.
     * - decoding: unused
1011 1012 1013 1014
     */
    float i_quant_factor;
    
    /**
1015 1016 1017
     * qscale offset between p and i frames.
     * - encoding: set by user.
     * - decoding: unused
1018 1019 1020 1021
     */
    float i_quant_offset;
    
    /**
1022 1023 1024
     * initial complexity for pass1 ratecontrol.
     * - encoding: set by user.
     * - decoding: unused
1025
     */
M
Michael Niedermayer 已提交
1026
    float rc_initial_cplx;
1027

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

1070
    /**
1071 1072 1073
     * darkness masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
1074 1075
     */
    float dark_masking;
1076
    
1077 1078 1079 1080
    
    /* for binary compatibility */
    int unused;
    
1081
    /**
1082 1083 1084
     * idct algorithm, see FF_IDCT_* below.
     * - encoding: set by user
     * - decoding: set by user
1085 1086 1087 1088 1089 1090 1091 1092 1093 1094
     */
    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
1095
#define FF_IDCT_ALTIVEC      8
1096
#define FF_IDCT_SH4          9
1097
#define FF_IDCT_SIMPLEARM    10
1098

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

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

Z
Zdenek Kabelac 已提交
1121
    /**
Z
Zdenek Kabelac 已提交
1122
     * dsp_mask could be add used to disable unwanted CPU features
Z
Zdenek Kabelac 已提交
1123
     * CPU features (i.e. MMX, SSE. ...)
Z
Zdenek Kabelac 已提交
1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138
     *
     * 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 已提交
1139 1140

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

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

    /**
1173 1174 1175
     * debug.
     * - encoding: set by user.
     * - decoding: set by user.
1176 1177 1178 1179 1180 1181 1182 1183
     */
    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
1184
#define FF_DEBUG_DCT_COEFF 0x00000040
M
Michael Niedermayer 已提交
1185 1186 1187
#define FF_DEBUG_SKIP      0x00000080
#define FF_DEBUG_STARTCODE 0x00000100
#define FF_DEBUG_PTS       0x00000200
1188
#define FF_DEBUG_ER        0x00000400
M
Michael Niedermayer 已提交
1189
#define FF_DEBUG_MMCO      0x00000800
1190
#define FF_DEBUG_BUGS      0x00001000
M
Michael Niedermayer 已提交
1191 1192
#define FF_DEBUG_VIS_QP    0x00002000
#define FF_DEBUG_VIS_MB_TYPE 0x00004000
1193
    
1194 1195 1196 1197 1198 1199 1200 1201 1202 1203
    /**
     * 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

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

    /**
1219 1220 1221
     * maximum MB quantizer.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1222 1223
     */
    int mb_qmax;
M
Michael Niedermayer 已提交
1224 1225
    
    /**
1226 1227 1228
     * motion estimation compare function.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1229 1230 1231
     */
    int me_cmp;
    /**
1232 1233 1234
     * subpixel motion estimation compare function.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1235 1236 1237
     */
    int me_sub_cmp;
    /**
1238 1239 1240
     * macroblock compare function (not supported yet).
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1241 1242
     */
    int mb_cmp;
1243 1244 1245 1246 1247 1248
    /**
     * interlaced dct compare function
     * - encoding: set by user.
     * - decoding: unused
     */
    int ildct_cmp;
M
Michael Niedermayer 已提交
1249 1250 1251 1252 1253 1254 1255 1256
#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
1257 1258
#define FF_CMP_VSAD 8
#define FF_CMP_VSSE 9
1259
#define FF_CMP_NSSE 10
M
Michael Niedermayer 已提交
1260 1261 1262
#define FF_CMP_CHROMA 256
    
    /**
1263 1264 1265
     * ME diamond size & shape.
     * - encoding: set by user.
     * - decoding: unused
M
Michael Niedermayer 已提交
1266 1267
     */
    int dia_size;
1268 1269

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

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

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

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

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

M
Michael Niedermayer 已提交
1304
    /**
1305
     * callback to negotiate the pixelFormat.
M
Michael Niedermayer 已提交
1306 1307 1308 1309
     * @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
1310 1311
     * - encoding: unused
     * - decoding: set by user, if not set then the native format will always be choosen
M
Michael Niedermayer 已提交
1312
     */
I
Ivan Kalvachev 已提交
1313
    enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt);
1314 1315 1316 1317 1318 1319

    /**
     * DTG active format information (additionnal aspect ratio
     * information only used in DVB MPEG2 transport streams). 0 if
     * not set.
     * 
1320 1321
     * - encoding: unused.
     * - decoding: set by decoder 
1322 1323 1324 1325 1326 1327 1328 1329 1330 1331
     */
    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

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

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

1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363
    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;
1364 1365 1366 1367 1368 1369 1370 1371

    /**
     * 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;
1372
    
1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383
    /**
     * 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;
1384 1385 1386 1387 1388 1389 1390

#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 已提交
1391 1392 1393 1394 1395 1396 1397
    /**
     * 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 已提交
1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413
    
#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;
1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424
    
    /**
     * 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 已提交
1425 1426 1427 1428 1429 1430
    /**
     * XVideo Motion Acceleration
     * - encoding: forbidden
     * - decoding: set by decoder
     */
    int xvmc_acceleration;
1431 1432 1433 1434 1435 1436 1437 1438 1439 1440
    
    /**
     * 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
1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454

    /**
     * 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;
1455
    
1456 1457 1458 1459 1460 1461 1462
    /**
     * 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 已提交
1463 1464 1465 1466 1467 1468 1469 1470

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

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

    /**
     * maximum lagrange multipler
     * - encoding: set by user.
     * - decoding: unused
     */
    int lmax;
1485 1486 1487 1488 1489 1490 1491

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

    /**
     * noise reduction strength
     * - encoding: set by user.
     * - decoding: unused
     */
    int noise_reduction;
1499
    
1500
    /**
1501 1502 1503 1504 1505
     * 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().
1506
     * - encoding: unused
1507
     * - decoding: set by lavc, user can override
1508
     */
1509
    int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic);
M
Michael Niedermayer 已提交
1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530

    /**
     * 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;
1531 1532 1533 1534 1535 1536 1537

    /**
     * simulates errors in the bitstream to test error concealment.
     * - encoding: set by user.
     * - decoding: unused.
     */
    int error_rate;
1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548
    
    /**
     * 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 已提交
1549 1550 1551 1552 1553 1554
    /**
     * Quantizer noise shaping.
     * - encoding: set by user
     * - decoding: unused
     */
    int quantizer_noise_shaping;
1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567

    /**
     * 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
1568
     * @param count the number of things to execute
1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580
     * - 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;
1581 1582

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

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

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

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

    /**
     * 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 已提交
1625 1626
} AVCodecContext;

1627

1628 1629 1630
/**
 * AVOption.
 */
1631 1632 1633
typedef struct AVOption {
    /** options' name */
    const char *name; /* if name is NULL, it indicates a link to next */
Z
Zdenek Kabelac 已提交
1634 1635
    /** short English text help or const struct AVOption* subpointer */
    const char *help; //	const struct AVOption* sub;
1636 1637 1638 1639
    /** offset to context structure where the parsed value should be stored */
    int offset;
    /** options' type */
    int type;
1640 1641 1642 1643 1644
#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
1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662
//#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 已提交
1663 1664 1665 1666 1667 1668 1669 1670 1671
/**
 * 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);


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

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

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

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

1715 1716 1717 1718
    /* 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 */
1719
    unsigned int palette[AVPALETTE_COUNT];
M
Mike Melanson 已提交
1720 1721 1722

} AVPaletteControl;

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

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

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

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);

1842 1843 1844 1845
/* adpcm codecs */

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

F
Fabrice Bellard 已提交
1857 1858 1859
#undef PCM_CODEC

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

/* the following codecs use external GPL libs */
extern AVCodec ac3_decoder;
1865
extern AVCodec dts_decoder;
F
Fabrice Bellard 已提交
1866 1867 1868 1869

/* resample.c */

struct ReSampleContext;
1870
struct AVResampleContext;
F
Fabrice Bellard 已提交
1871 1872 1873 1874 1875 1876 1877 1878

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);

1879 1880
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 已提交
1881
void av_resample_compensate(struct AVResampleContext *c, int sample_delta, int compensation_distance);
1882
void av_resample_close(struct AVResampleContext *c);
1883

F
Fabrice Bellard 已提交
1884 1885 1886 1887 1888 1889 1890 1891
/* 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);
1892 1893 1894 1895

ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
                                      int iwidth, int iheight,
                                      int topBand, int bottomBand,
1896 1897 1898 1899
                                      int leftBand, int rightBand,
                                      int padtop, int padbottom,
                                      int padleft, int padright);

1900

F
Fabrice Bellard 已提交
1901
void img_resample(ImgReSampleContext *s, 
1902
                  AVPicture *output, const AVPicture *input);
F
Fabrice Bellard 已提交
1903 1904 1905

void img_resample_close(ImgReSampleContext *s);

D
Drew Hess 已提交
1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919
/**
 * 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);

1920
int avpicture_fill(AVPicture *picture, uint8_t *ptr,
1921
                   int pix_fmt, int width, int height);
1922
int avpicture_layout(const AVPicture* src, int pix_fmt, int width, int height,
1923
                     unsigned char *dest, int dest_size);
1924
int avpicture_get_size(int pix_fmt, int width, int height);
1925 1926
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);
1927
enum PixelFormat avcodec_get_pix_fmt(const char* name);
1928

1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940
#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 已提交
1941 1942
#define FF_ALPHA_TRANSP       0x0001 /* image has some totally transparent pixels */
#define FF_ALPHA_SEMI_TRANSP  0x0002 /* image has some transparent pixels */
1943 1944
int img_get_alpha_info(const AVPicture *src,
		       int pix_fmt, int width, int height);
F
Fabrice Bellard 已提交
1945

1946 1947
/* convert among pixel formats */
int img_convert(AVPicture *dst, int dst_pix_fmt,
1948
                const AVPicture *src, int pix_fmt, 
1949 1950 1951
                int width, int height);

/* deinterlace a picture */
1952
int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
F
Fabrice Bellard 已提交
1953 1954 1955 1956 1957 1958
                          int pix_fmt, int width, int height);

/* external high level API */

extern AVCodec *first_avcodec;

N
Nick Kurshev 已提交
1959
/* returns LIBAVCODEC_VERSION_INT constant */
1960
unsigned avcodec_version(void);
N
Nick Kurshev 已提交
1961
/* returns LIBAVCODEC_BUILD constant */
1962
unsigned avcodec_build(void);
F
Fabrice Bellard 已提交
1963 1964 1965 1966
void avcodec_init(void);

void register_avcodec(AVCodec *format);
AVCodec *avcodec_find_encoder(enum CodecID id);
1967
AVCodec *avcodec_find_encoder_by_name(const char *name);
F
Fabrice Bellard 已提交
1968 1969 1970 1971
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 已提交
1972
void avcodec_get_context_defaults(AVCodecContext *s);
F
Falk Hüffner 已提交
1973
AVCodecContext *avcodec_alloc_context(void);
F
Falk Hüffner 已提交
1974
void avcodec_get_frame_defaults(AVFrame *pic);
M
Michael Niedermayer 已提交
1975
AVFrame *avcodec_alloc_frame(void);
M
cleanup  
Michael Niedermayer 已提交
1976

M
Michael Niedermayer 已提交
1977 1978
int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
M
Michael Niedermayer 已提交
1979 1980 1981
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 已提交
1982

M
1l  
Michael Niedermayer 已提交
1983 1984 1985
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 已提交
1986
int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
1987 1988
//FIXME func typedef

M
Michael Niedermayer 已提交
1989 1990 1991 1992
/**
 * opens / inits the AVCodecContext.
 * not thread save!
 */
F
Fabrice Bellard 已提交
1993
int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
M
Michael Niedermayer 已提交
1994

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

int avcodec_close(AVCodecContext *avctx);

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

M
Michael Niedermayer 已提交
2013 2014
void avcodec_flush_buffers(AVCodecContext *avctx);

2015
/* misc usefull functions */
M
cleanup  
Michael Niedermayer 已提交
2016 2017 2018 2019 2020 2021

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

2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033
/**
 * 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
 */
2034
int64_t av_rescale(int64_t a, int64_t b, int64_t c);
2035 2036


2037 2038 2039 2040 2041 2042 2043
/**
 * Interface for 0.5.0 version
 *
 * do not even think about it's usage for this moment
 */

typedef struct {
2044
    /// compressed size used from given memory buffer
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 2108 2109 2110 2111 2112
    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 已提交
2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123
/* 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 */
2124 2125 2126 2127 2128 2129
    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 已提交
2130
    int fetch_timestamp;
2131 2132 2133 2134 2135 2136

#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 已提交
2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157
} 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, 
2158 2159
                    const uint8_t *buf, int buf_size,
                    int64_t pts, int64_t dts);
F
Fabrice Bellard 已提交
2160 2161 2162 2163
void av_parser_close(AVCodecParserContext *s);

extern AVCodecParser mpegvideo_parser;
extern AVCodecParser mpeg4video_parser;
2164
extern AVCodecParser h261_parser;
F
Fabrice Bellard 已提交
2165 2166 2167 2168 2169
extern AVCodecParser h263_parser;
extern AVCodecParser h264_parser;
extern AVCodecParser mpegaudio_parser;
extern AVCodecParser ac3_parser;

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

2183 2184 2185
/* add by bero : in adx.c */
int is_adx(const unsigned char *buf,size_t bufsize);

2186 2187 2188
void img_copy(AVPicture *dst, const AVPicture *src,
              int pix_fmt, int width, int height);

2189 2190 2191 2192
/* av_log API */

#include <stdarg.h>

2193
#define AV_LOG_QUIET -1
2194 2195 2196 2197
#define AV_LOG_ERROR 0
#define AV_LOG_INFO 1
#define AV_LOG_DEBUG 2

2198
#ifdef __GNUC__
2199
extern void av_log(void*, int level, const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4)));
2200 2201 2202 2203
#else
extern void av_log(void*, int level, const char *fmt, ...);
#endif

2204
extern void av_vlog(void*, int level, const char *fmt, va_list);
2205 2206
extern int av_log_get_level(void);
extern void av_log_set_level(int);
2207
extern void av_log_set_callback(void (*)(void*, int, const char*, va_list));
2208

2209
/* endian macros */
2210
#if !defined(BE_16) || !defined(BE_32) || !defined(LE_16) || !defined(LE_32)
2211 2212 2213 2214 2215 2216 2217 2218 2219 2220
#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])
2221
#endif
2222

2223 2224 2225 2226
#ifdef __cplusplus
}
#endif

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