avcodec.h 35.7 KB
Newer Older
Fabrice Bellard's avatar
Fabrice Bellard committed
1 2 3
#ifndef AVCODEC_H
#define AVCODEC_H

Michael Niedermayer's avatar
Michael Niedermayer committed
4 5 6 7 8 9 10
/**
 * @file avcodec.h
 * @brief 
 *     external api header
 */


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

Fabrice Bellard's avatar
Fabrice Bellard committed
15 16
#include "common.h"

17 18
#define LIBAVCODEC_VERSION_INT 0x000406
#define LIBAVCODEC_VERSION     "0.4.6"
19 20
#define LIBAVCODEC_BUILD       4659
#define LIBAVCODEC_BUILD_STR   "4659"
21

Fabrice Bellard's avatar
Fabrice Bellard committed
22 23 24 25 26 27
enum CodecID {
    CODEC_ID_NONE, 
    CODEC_ID_MPEG1VIDEO,
    CODEC_ID_H263,
    CODEC_ID_RV10,
    CODEC_ID_MP2,
28
    CODEC_ID_MP3LAME,
29
    CODEC_ID_VORBIS,
Fabrice Bellard's avatar
Fabrice Bellard committed
30 31
    CODEC_ID_AC3,
    CODEC_ID_MJPEG,
32
    CODEC_ID_MJPEGB,
Fabrice Bellard's avatar
Fabrice Bellard committed
33
    CODEC_ID_MPEG4,
Fabrice Bellard's avatar
Fabrice Bellard committed
34
    CODEC_ID_RAWVIDEO,
35 36 37
    CODEC_ID_MSMPEG4V1,
    CODEC_ID_MSMPEG4V2,
    CODEC_ID_MSMPEG4V3,
38
    CODEC_ID_WMV1,
Michael Niedermayer's avatar
Michael Niedermayer committed
39
    CODEC_ID_WMV2,
Fabrice Bellard's avatar
Fabrice Bellard committed
40 41
    CODEC_ID_H263P,
    CODEC_ID_H263I,
Nick Kurshev's avatar
Nick Kurshev committed
42
    CODEC_ID_SVQ1,
Fabrice Bellard's avatar
Fabrice Bellard committed
43 44
    CODEC_ID_DVVIDEO,
    CODEC_ID_DVAUDIO,
Fabrice Bellard's avatar
Fabrice Bellard committed
45 46
    CODEC_ID_WMAV1,
    CODEC_ID_WMAV2,
47 48
    CODEC_ID_MACE3,
    CODEC_ID_MACE6,
Michael Niedermayer's avatar
huffyuv  
Michael Niedermayer committed
49
    CODEC_ID_HUFFYUV,
50
    CODEC_ID_CYUV,
Fabrice Bellard's avatar
Fabrice Bellard committed
51 52 53 54 55 56 57 58 59 60

    /* 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,
61 62 63 64 65

    /* various adpcm codecs */
    CODEC_ID_ADPCM_IMA_QT,
    CODEC_ID_ADPCM_IMA_WAV,
    CODEC_ID_ADPCM_MS,
Fabrice Bellard's avatar
Fabrice Bellard committed
66 67 68
};

enum CodecType {
69
    CODEC_TYPE_UNKNOWN = -1,
Fabrice Bellard's avatar
Fabrice Bellard committed
70 71 72 73 74 75 76
    CODEC_TYPE_VIDEO,
    CODEC_TYPE_AUDIO,
};

enum PixelFormat {
    PIX_FMT_YUV420P,
    PIX_FMT_YUV422,
77 78
    PIX_FMT_RGB24,     /* 3 bytes, R is first */
    PIX_FMT_BGR24,     /* 3 bytes, B is first */
79 80
    PIX_FMT_YUV422P,
    PIX_FMT_YUV444P,
81
    PIX_FMT_RGBA32,    /* always stored in cpu endianness */
Arpi's avatar
Arpi committed
82
    PIX_FMT_YUV410P,
83
    PIX_FMT_YUV411P,
84 85 86 87 88
    PIX_FMT_RGB565,    /* always stored in cpu endianness */
    PIX_FMT_RGB555,    /* always stored in cpu endianness, most significant bit to 1 */
    PIX_FMT_GRAY8,
    PIX_FMT_MONOWHITE, /* 0 is white */
    PIX_FMT_MONOBLACK, /* 0 is black */
89
    PIX_FMT_PAL8,      /* 8 bit with RGBA palette */
90
    PIX_FMT_NB,
Fabrice Bellard's avatar
Fabrice Bellard committed
91 92
};

Fabrice Bellard's avatar
Fabrice Bellard committed
93 94 95 96 97
/* currently unused, may be used if 24/32 bits samples ever supported */
enum SampleFormat {
    SAMPLE_FMT_S16 = 0,         /* signed 16 bits */
};

Fabrice Bellard's avatar
Fabrice Bellard committed
98
/* in bytes */
Fabrice Bellard's avatar
Fabrice Bellard committed
99
#define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
Fabrice Bellard's avatar
Fabrice Bellard committed
100

101 102 103 104 105 106
/**
 * Required number of zero bytes at the end of the input bitstream for decoding.
 * to avoid overreading (and possibly segfaulting)
 */
#define FF_INPUT_BUFFER_PADDING_SIZE 8

107 108
/* motion estimation type, EPZS by default */
enum Motion_Est_ID {
109
    ME_ZERO = 1,
110 111 112 113 114 115 116
    ME_FULL,
    ME_LOG,
    ME_PHODS,
    ME_EPZS,
    ME_X1
};

Michael Niedermayer's avatar
Michael Niedermayer committed
117 118 119 120 121 122 123
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;

124 125 126
/* only for ME compatiblity with old apps */
extern int motion_estimation_method;

127
/* ME algos sorted by quality */
128 129
static const int Motion_Est_QTab[] = { ME_ZERO, ME_PHODS, ME_LOG, 
                                       ME_X1, ME_EPZS, ME_FULL };
Fabrice Bellard's avatar
Fabrice Bellard committed
130

131

Michael Niedermayer's avatar
Michael Niedermayer committed
132
#define FF_MAX_B_FRAMES 8
133

Michael Niedermayer's avatar
Michael Niedermayer committed
134 135 136 137
/* encoding support
   these flags can be passed in AVCodecContext.flags before initing 
   Note: note not everything is supported yet 
*/
Fabrice Bellard's avatar
Fabrice Bellard committed
138

139 140 141 142 143 144
#define CODEC_FLAG_HQ     0x0001  /* brute force MB-type decission mode (slow) */
#define CODEC_FLAG_QSCALE 0x0002  /* use fixed qscale */
#define CODEC_FLAG_4MV    0x0004  /* 4 MV per MB allowed */
#define CODEC_FLAG_QPEL   0x0010  /* use qpel MC */
#define CODEC_FLAG_GMC    0x0020  /* use GMC */
#define CODEC_FLAG_PART   0x0080  /* use data partitioning */
145 146
/* 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 */
147
#define CODEC_FLAG_INPUT_PRESERVED 0x0100
148 149
#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 */
150
#define CODEC_FLAG_EXTERN_HUFF 0x1000 /* use external huffman table (for mjpeg) */
151
#define CODEC_FLAG_GRAY  0x2000   /* only decode/encode grayscale */
152
#define CODEC_FLAG_EMU_EDGE 0x4000/* dont draw edges */
153
#define CODEC_FLAG_PSNR           0x8000 /* error[?] variables will be set during encoding */
154 155
#define CODEC_FLAG_TRUNCATED  0x00010000 /* input bitstream might be truncated at a random location instead 
                                            of only at frame boundaries */
156
#define CODEC_FLAG_NORMALIZE_AQP  0x00020000 /* normalize adaptive quantization */
157
#define CODEC_FLAG_INTERLACED_DCT 0x00040000 /* use interlaced dct */
158
#define CODEC_FLAG_LOW_DELAY      0x00080000 /* force low delay / will fail on b frames */
Michael Niedermayer's avatar
Michael Niedermayer committed
159
#define CODEC_FLAG_ALT_SCAN       0x00100000 /* use alternate scan */
Michael Niedermayer's avatar
Michael Niedermayer committed
160
#define CODEC_FLAG_TRELLIS_QUANT  0x00200000 /* use trellis quantization */
161
#define CODEC_FLAG_GLOBAL_HEADER  0x00400000 /* place global headers in extradata instead of every keyframe */
162

Fabrice Bellard's avatar
Fabrice Bellard committed
163 164
/* codec capabilities */

165
#define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 /* decoder can use draw_horiz_band callback */
166
#define CODEC_CAP_DR1             0x0002 /* direct rendering method 1 */
167 168 169
/* if 'parse_only' field is true, then avcodec_parse_frame() can be
   used */
#define CODEC_CAP_PARSE_ONLY      0x0004
170
#define CODEC_CAP_TRUNCATED       0x0008
Fabrice Bellard's avatar
Fabrice Bellard committed
171

172
#define FRAME_RATE_BASE 10010
Fabrice Bellard's avatar
Fabrice Bellard committed
173

Michael Niedermayer's avatar
Michael Niedermayer committed
174
#define FF_COMMON_FRAME \
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
175 176 177
    uint8_t *data[4];\
    int linesize[4];\
    /**\
178
     * pointer to the first allocated byte of the picture. can be used in get_buffer/release_buffer\
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267
     * this isnt used by lavc unless the default get/release_buffer() is used\
     * encoding: \
     * decoding: \
     */\
    uint8_t *base[4];\
    /**\
     * 1 -> keyframe, 0-> not\
     * encoding: set by lavc\
     * decoding: set by lavc\
     */\
    int key_frame;\
\
    /**\
     * picture type of the frame, see ?_TYPE below\
     * encoding: set by lavc for coded_picture (and set by user for input)\
     * decoding: set by lavc\
     */\
    int pict_type;\
\
    /**\
     * presentation timestamp in micro seconds (time when frame should be shown to user)\
     * if 0 then the frame_rate will be used as reference\
     * encoding: MUST be set by user\
     * decoding: set by lavc\
     */\
    long long int pts;\
\
    /**\
     * picture number in bitstream order.\
     * encoding: set by\
     * decoding: set by lavc\
     */\
    int coded_picture_number;\
    /**\
     * encoding: set by\
     * decoding: set by lavc\
     * picture number in display order.\
     */\
    int display_picture_number;\
\
    /**\
     * quality (between 1 (good) and 31 (bad)) \
     * encoding: set by lavc for coded_picture (and set by user for input)\
     * decoding: set by lavc\
     */\
    float quality; \
\
    /**\
     * buffer age (1->was last buffer and dint change, 2->..., ...).\
     * set to something large if the buffer has not been used yet \
     * encoding: unused\
     * decoding: MUST be set by get_buffer()\
     */\
    int age;\
\
    /**\
     * is this picture used as reference\
     * encoding: unused\
     * decoding: set by lavc (before get_buffer() call))\
     */\
    int reference;\
\
    /**\
     * QP table\
     * encoding: unused\
     * decoding: set by lavc\
     */\
    int8_t *qscale_table;\
    /**\
     * QP store stride\
     * encoding: unused\
     * decoding: set by lavc\
     */\
    int qstride;\
\
    /**\
     * mbskip_table[mb]>=1 if MB didnt change\
     * stride= mb_width = (width+15)>>4\
     * encoding: unused\
     * decoding: set by lavc\
     */\
    uint8_t *mbskip_table;\
\
    /**\
     * for some private data of the user\
     * encoding: unused\
     * decoding: set by user\
     */\
    void *opaque;\
268 269 270 271 272 273 274
\
    /**\
     * error\
     * encoding: set by lavc if flags&CODEC_FLAG_PSNR\
     * decoding: unused\
     */\
    uint64_t error[4];\
Michael Niedermayer's avatar
Michael Niedermayer committed
275 276 277 278 279 280 281 282
\
    /**\
     * type of the buffer (to keep track of who has to dealloc data[*])\
     * encoding: set by the one who allocs it\
     * decoding: set by the one who allocs it\
     * Note: user allocated (direct rendering) & internal buffers can not coexist currently\ 
     */\
    int type;\
283 284 285 286 287 288 289 290 291
    \
    /**\
     * when decoding, this signal how much the picture must be delayed.\
     * extra_delay = repeat_pict / (2*fps)\
     * encoding: unused\
     * decoding: set by lavc\
     */\
    int repeat_pict;

Michael Niedermayer's avatar
Michael Niedermayer committed
292 293 294 295 296

#define FF_BUFFER_TYPE_INTERNAL 1
#define FF_BUFFER_TYPE_USER     2 // Direct rendering buffers
#define FF_BUFFER_TYPE_SHARED   4 // input frame for encoding(wont be dealloced)

Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
297

298 299 300 301
#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
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
302

Michael Niedermayer's avatar
Michael Niedermayer committed
303 304 305
typedef struct AVFrame {
    FF_COMMON_FRAME
} AVFrame;
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
306

Fabrice Bellard's avatar
Fabrice Bellard committed
307
typedef struct AVCodecContext {
308 309 310 311 312
    /**
     * 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 
     */
Fabrice Bellard's avatar
Fabrice Bellard committed
313
    int bit_rate;
314 315 316 317 318 319 320 321 322 323 324 325 326 327

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

    /**
     * CODEC_FLAG_*
     * encoding: set by user.
     * decoding: set by user.
     */
Fabrice Bellard's avatar
Fabrice Bellard committed
328
    int flags;
329 330 331 332 333 334 335 336 337 338

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

    /**
     * motion estimation algorithm used for video coding
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
339
     * encoding: MUST be set by user.
340 341 342 343 344 345 346 347
     * decoding: unused
     */
    int me_method;

    /**
     * some codecs need / can use extra-data like huffman tables
     * mjpeg: huffman tables
     * rv10: additional flags
348
     * mpeg4: global headers (they can be in the bitstream or here)
349 350
     * encoding: set/allocated/freed by lavc.
     * decoding: set/allocated/freed by user.
351
     */
352 353 354
    void *extradata;
    int extradata_size;
    
Fabrice Bellard's avatar
Fabrice Bellard committed
355
    /* video only */
356 357 358 359
    /**
     * frames per sec multiplied by FRAME_RATE_BASE
     * for variable fps this is the precission, so if the timestamps 
     * can be specified in msec precssion then this is 1000*FRAME_RATE_BASE
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
360
     * encoding: MUST be set by user
361 362 363 364 365
     * decoding: set by lavc. 0 or the frame_rate if available
     */
    int frame_rate;

    /**
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
366
     * encoding: MUST be set by user. 
367 368
     * decoding: set by user, some codecs might override / change it during playback
     */
Fabrice Bellard's avatar
Fabrice Bellard committed
369
    int width, height;
370
    
Michael Niedermayer's avatar
Michael Niedermayer committed
371 372 373 374 375
#define FF_ASPECT_SQUARE 1
#define FF_ASPECT_4_3_625 2
#define FF_ASPECT_4_3_525 3
#define FF_ASPECT_16_9_625 4
#define FF_ASPECT_16_9_525 5
376
#define FF_ASPECT_EXTENDED 15
377 378 379 380 381 382 383 384 385 386 387 388 389 390

    /**
     * the number of pictures in a group of pitures, or 0 for intra_only
     * encoding: set by user.
     * decoding: unused
     */
    int gop_size;

    /**
     * pixel format, see PIX_FMT_xxx
     * encoding: unused
     * decoding: set by lavc.
     */
    enum PixelFormat pix_fmt;
391
        
392 393 394 395 396 397 398 399
    /**
     * 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
     * encoding: unused
     * decoding: set by user.
     */
Fabrice Bellard's avatar
Fabrice Bellard committed
400
    void (*draw_horiz_band)(struct AVCodecContext *s,
401
                            uint8_t **src_ptr, int linesize,
Fabrice Bellard's avatar
Fabrice Bellard committed
402 403
                            int y, int width, int height);

Fabrice Bellard's avatar
Fabrice Bellard committed
404 405 406
    /* audio only */
    int sample_rate; /* samples per sec */
    int channels;
Fabrice Bellard's avatar
Fabrice Bellard committed
407
    int sample_fmt;  /* sample format, currenly unused */
Fabrice Bellard's avatar
Fabrice Bellard committed
408 409

    /* the following data should not be initialized */
410 411 412 413
    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 */
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
414
    
415 416 417 418 419 420 421
    /**
     * number of frames the decoded output will be delayed relative to 
     * the encoded input
     * encoding: set by lavc.
     * decoding: unused
     */
    int delay;
Michael Niedermayer's avatar
Michael Niedermayer committed
422 423
    
    /* encoding parameters */
424 425
    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) */
426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464
    
    /**
     * minimum quantizer
     * encoding: set by user.
     * decoding: unused
     */
    int qmin;

    /**
     * maximum quantizer
     * encoding: set by user.
     * decoding: unused
     */
    int qmax;

    /**
     * maximum quantizer difference etween frames
     * encoding: set by user.
     * decoding: unused
     */
    int max_qdiff;

    /**
     * maximum number of b frames between non b frames
     * note: the output will be delayed by max_b_frames+1 relative to the input
     * encoding: set by user.
     * decoding: unused
     */
    int max_b_frames;

    /**
     * qscale factor between ip and b frames
     * encoding: set by user.
     * decoding: unused
     */
    float b_quant_factor;
    
    /** obsolete FIXME remove */
    int rc_strategy;
465
    int b_frame_strategy;
466

467 468
    /**
     * encoding: unused
469
     * decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too, 5-> skip everything except header
470 471
     */
    int hurry_up;
472
    
Fabrice Bellard's avatar
Fabrice Bellard committed
473
    struct AVCodec *codec;
474
    
Fabrice Bellard's avatar
Fabrice Bellard committed
475 476
    void *priv_data;

477
    /* The following data is for RTP friendly coding */
478
    /* By now only H.263/H.263+/MPEG4 coder honours this   */
479 480 481 482 483 484 485 486 487 488
    int rtp_mode;   /* 1 for activate RTP friendly-mode           */
                    /* highers numbers represent more error-prone */
                    /* enviroments, by now just "1" exist         */
    
    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    */
489 490 491 492 493 494 495 496

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

497 498 499 500 501 502 503 504
    /* 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;
505 506 507 508 509
    int misc_bits;
    
    /**
     * number of bits used for the previously encoded frame
     * encoding: set by lavc
Zdenek Kabelac's avatar
Zdenek Kabelac committed
510
     * decoding: - for audio - bits_per_sample
511
     */
512
    int frame_bits;
513
                 
514 515 516 517 518 519 520
    /**
     * private data of the user, can be used to carry app specific stuff
     * encoding: set by user
     * decoding: set by user
     */
    void *opaque;

Fabrice Bellard's avatar
Fabrice Bellard committed
521
    char codec_name[32];
522 523
    enum CodecType codec_type; /* see CODEC_TYPE_xxx */
    enum CodecID codec_id; /* see CODEC_ID_xxx */
Fabrice Bellard's avatar
Fabrice Bellard committed
524
    unsigned int codec_tag;  /* codec tag, only used if unknown codec */
525
    
526
    /**
527
     * workaround bugs in encoders which sometimes cannot be detected automatically
528 529 530 531
     * encoding: unused
     * decoding: set by user
     */
    int workaround_bugs;
532 533 534 535 536 537
#define FF_BUG_AUTODETECT       1  //autodetection
#define FF_BUG_OLD_MSMPEG4      2
#define FF_BUG_XVID_ILACE       4
#define FF_BUG_UMP4             8
#define FF_BUG_NO_PADDING       16
#define FF_BUG_AC_VLC           32
Michael Niedermayer's avatar
Michael Niedermayer committed
538
#define FF_BUG_QPEL_CHROMA      64
Michael Niedermayer's avatar
Michael Niedermayer committed
539
#define FF_BUG_STD_QPEL         128
Michael Niedermayer's avatar
Michael Niedermayer committed
540
#define FF_BUG_QPEL_CHROMA2     256
541
#define FF_BUG_DIRECT_BLOCKSIZE 512
542 543
//#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
        
544 545 546 547
    /**
     * encoding: set by user
     * decoding: unused
     */
548
    int luma_elim_threshold;
549 550 551 552 553
    
    /**
     * encoding: set by user
     * decoding: unused
     */
554
    int chroma_elim_threshold;
555 556 557 558 559 560 561 562 563 564
    
    /**
     * strictly follow the std (MPEG4, ...)
     * encoding: set by user
     * decoding: unused
     */
    int strict_std_compliance;
    
    /**
     * qscale offset between ip and b frames
565 566
     * 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)
567 568 569 570 571 572
     * encoding: set by user.
     * decoding: unused
     */
    float b_quant_offset;
    
    /**
573
     * error resilience higher values will detect more errors but may missdetect
574 575 576 577
     * some more or less valid parts as errors
     * encoding: unused
     * decoding: set by user
     */
578
    int error_resilience;
579 580 581 582
#define FF_ER_CAREFULL        1
#define FF_ER_COMPLIANT       2
#define FF_ER_AGGRESSIVE      3
#define FF_ER_VERY_AGGRESSIVE 4
583
    
584
    /**
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
585 586
     * 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
587
     * encoding: unused
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
588
     * decoding: set by lavc, user can override
589
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
590
    int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
591 592
    
    /**
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
593 594 595
     * 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
596
     * encoding: unused
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
597
     * decoding: set by lavc, user can override
598
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
599
    void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
Michael Niedermayer's avatar
Michael Niedermayer committed
600

601 602 603 604 605 606 607
    /**
     * is 1 if the decoded stream contains b frames, 0 otherwise
     * encoding: unused
     * decoding: set by lavc
     */
    int has_b_frames;
    
Fabrice Bellard's avatar
Fabrice Bellard committed
608
    int block_align; /* used by some WAV based audio codecs */
Michael Niedermayer's avatar
Michael Niedermayer committed
609
    
610 611 612
    int parse_only; /* decoding only: if true, only parsing is done
                       (function avcodec_parse_frame()). The frame
                       data is returned. Only MPEG codecs support this now. */
Michael Niedermayer's avatar
Michael Niedermayer committed
613
    
614 615 616 617 618 619
    /**
     * 0-> h263 quant 1-> mpeg quant
     * encoding: set by user.
     * decoding: unused
     */
    int mpeg_quant;
Michael Niedermayer's avatar
Michael Niedermayer committed
620
    
621 622 623 624 625
    /**
     * pass1 encoding statistics output buffer
     * encoding: set by lavc
     * decoding: unused
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
626
    char *stats_out; /* encoding statistics output buffer */
627 628 629 630 631 632 633 634 635 636 637 638 639 640 641
    
    /**
     * pass2 encoding statistics input buffer.
     * concatenated stuff from stats_out of pass1 should be placed here
     * encoding: allocated/set/freed by user
     * decoding: unused
     */
    char *stats_in;
    
    /**
     * ratecontrol qmin qmax limiting method
     * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
     * encoding: set by user.
     * decoding: unused
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
642
    float rc_qsquish;
643

Michael Niedermayer's avatar
Michael Niedermayer committed
644 645
    float rc_qmod_amp;
    int rc_qmod_freq;
646 647 648 649 650 651
    
    /**
     * ratecontrol override, see RcOverride
     * encoding: allocated/set/freed by user.
     * decoding: unused
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
652 653
    RcOverride *rc_override;
    int rc_override_count;
654 655 656 657 658 659
    
    /**
     * rate control equation
     * encoding: set by user
     * decoding: unused
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
660
    char *rc_eq;
661 662 663 664 665 666
    
    /**
     * maximum bitrate
     * encoding: set by user.
     * decoding: unused
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
667
    int rc_max_rate;
668 669 670 671 672 673
    
    /**
     * minimum bitrate
     * encoding: set by user.
     * decoding: unused
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
674
    int rc_min_rate;
675 676 677 678 679 680
    
    /**
     * decoder bitstream buffer size
     * encoding: set by user.
     * decoding: unused
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
681 682
    int rc_buffer_size;
    float rc_buffer_aggressivity;
683 684 685 686 687 688 689 690 691 692

    /**
     * qscale factor between p and i frames
     * encoding: set by user.
     * decoding: unused
     */
    float i_quant_factor;
    
    /**
     * qscale offset between p and i frames
693 694
     * 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)
695 696 697 698 699 700 701 702 703 704
     * encoding: set by user.
     * decoding: unused
     */
    float i_quant_offset;
    
    /**
     * initial complexity for pass1 ratecontrol
     * encoding: set by user.
     * decoding: unused
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
705
    float rc_initial_cplx;
706

707 708 709 710 711
    /**
     * dct algorithm, see FF_DCT_* below
     * encoding: set by user
     * decoding: unused
     */
712
    int dct_algo;
713
#define FF_DCT_AUTO    0
714
#define FF_DCT_FASTINT 1
715 716 717
#define FF_DCT_INT     2
#define FF_DCT_MMX     3
#define FF_DCT_MLIB    4
718
#define FF_DCT_ALTIVEC 5
719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746
    
    /**
     * luminance masking (0-> disabled)
     * encoding: set by user
     * decoding: unused
     */
    float lumi_masking;
    
    /**
     * temporary complexity masking (0-> disabled)
     * encoding: set by user
     * decoding: unused
     */
    float temporal_cplx_masking;
    
    /**
     * spatial complexity masking (0-> disabled)
     * encoding: set by user
     * decoding: unused
     */
    float spatial_cplx_masking;
    
    /**
     * p block masking (0-> disabled)
     * encoding: set by user
     * decoding: unused
     */
    float p_masking;
747

748 749 750 751 752 753
    /**
     * darkness masking (0-> disabled)
     * encoding: set by user
     * decoding: unused
     */
    float dark_masking;
754 755 756 757 758
    
    /**
     * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A')
     * this is used to workaround some encoder bugs
     * encoding: unused
759
     * decoding: set by user, will be converted to upper case by lavc during init
760 761
     */
    int fourcc;
762

763 764 765 766 767 768 769 770 771 772 773 774 775 776
    /**
     * idct algorithm, see FF_IDCT_* below
     * encoding: set by user
     * decoding: set by user
     */
    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
777
#define FF_IDCT_ALTIVEC      8
778

779 780 781 782 783 784 785 786 787 788 789 790 791
    /**
     * slice count
     * encoding: set by lavc
     * decoding: set by user (or 0)
     */
    int slice_count;
    /**
     * slice offsets in the frame in bytes
     * encoding: set/allocated by lavc
     * decoding: set/allocated by user (or NULL)
     */
    int *slice_offset;

792 793 794 795 796 797 798 799 800
    /**
     * error concealment flags
     * encoding: unused
     * decoding: set by user
     */
    int error_concealment;
#define FF_EC_GUESS_MVS   1
#define FF_EC_DEBLOCK     2

Zdenek Kabelac's avatar
Zdenek Kabelac committed
801 802 803 804 805
    /**
     * dsp_mask could be used to disable unwanted
     * CPU features (i.e. MMX, SSE. ...)
     */
     unsigned dsp_mask;
Michael Niedermayer's avatar
huffyuv  
Michael Niedermayer committed
806 807 808

    /**
     * bits per sample/pixel from the demuxer (needed for huffyuv)
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
809
     * encoding: set by lavc
Michael Niedermayer's avatar
huffyuv  
Michael Niedermayer committed
810 811 812 813 814 815
     * decoding: set by user
     */
     int bits_per_sample;
    
    /**
     * prediction method (needed for huffyuv)
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
816
     * encoding: set by user
Michael Niedermayer's avatar
huffyuv  
Michael Niedermayer committed
817 818 819 820 821 822
     * decoding: unused
     */
     int prediction_method;
#define FF_PRED_LEFT   0
#define FF_PRED_PLANE  1
#define FF_PRED_MEDIAN 2
Michael Niedermayer's avatar
Michael Niedermayer committed
823 824 825 826 827 828 829
    
    /**
     * aspect ratio. (0 if unknown)
     * encoding: set by user.
     * decoding: set by lavc.
     */
    float aspect_ratio;
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
830 831 832 833 834 835

    /**
     * the picture in the bitstream
     * encoding: set by lavc
     * decoding: set by lavc
     */
Michael Niedermayer's avatar
Michael Niedermayer committed
836
    AVFrame *coded_frame;
837 838 839 840 841 842 843 844 845 846 847 848 849

    /**
     * debug 
     * encoding: set by user.
     * decoding: set by user.
     */
    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
Michael Niedermayer's avatar
Michael Niedermayer committed
850 851 852 853
#define FF_DEBUG_VIS_MV    0x00000040
#define FF_DEBUG_SKIP      0x00000080
#define FF_DEBUG_STARTCODE 0x00000100
#define FF_DEBUG_PTS       0x00000200
854 855 856 857 858 859 860
    
    /**
     * error
     * encoding: set by lavc if flags&CODEC_FLAG_PSNR
     * decoding: unused
     */
    uint64_t error[4];
Michael Niedermayer's avatar
Michael Niedermayer committed
861 862 863 864 865 866 867 868 869 870 871 872 873 874
    
    /**
     * minimum MB quantizer
     * encoding: set by user.
     * decoding: unused
     */
    int mb_qmin;

    /**
     * maximum MB quantizer
     * encoding: set by user.
     * decoding: unused
     */
    int mb_qmax;
Michael Niedermayer's avatar
Michael Niedermayer committed
875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904
    
    /**
     * motion estimation compare function
     * encoding: set by user.
     * decoding: unused
     */
    int me_cmp;
    /**
     * subpixel motion estimation compare function
     * encoding: set by user.
     * decoding: unused
     */
    int me_sub_cmp;
    /**
     * macroblock compare function (not supported yet)
     * encoding: set by user.
     * decoding: unused
     */
    int mb_cmp;
#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
#define FF_CMP_CHROMA 256
    
    /**
905
     * ME diamond size & shape
Michael Niedermayer's avatar
Michael Niedermayer committed
906 907 908 909
     * encoding: set by user.
     * decoding: unused
     */
    int dia_size;
910 911 912 913 914 915 916

    /**
     * amount of previous MV predictors (2a+1 x 2a+1 square)
     * encoding: set by user.
     * decoding: unused
     */
    int last_predictor_count;
917

918 919 920 921 922 923
    /**
     * pre pass for motion estimation
     * encoding: set by user.
     * decoding: unused
     */
    int pre_me;
924

925 926 927 928 929 930
    /**
     * motion estimation pre pass compare function
     * encoding: set by user.
     * decoding: unused
     */
    int me_pre_cmp;
Michael Niedermayer's avatar
Michael Niedermayer committed
931

932 933 934 935 936 937 938
    /**
     * ME pre pass diamond size & shape
     * encoding: set by user.
     * decoding: unused
     */
    int pre_dia_size;

Michael Niedermayer's avatar
Michael Niedermayer committed
939 940 941 942 943 944 945
    /**
     * subpel ME quality
     * encoding: set by user.
     * decoding: unused
     */
    int me_subpel_quality;

Michael Niedermayer's avatar
Michael Niedermayer committed
946 947 948 949 950 951 952 953 954 955
    /**
     * callback to negotiate the pixelFormat
     * @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
     * encoding: unused
     * decoding: set by user, if not set then the native format will always be choosen
     */
    enum PixelFormat (*get_format)(struct AVCodecContext *s, enum PixelFormat * fmt);
956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973

    /**
     * DTG active format information (additionnal aspect ratio
     * information only used in DVB MPEG2 transport streams). 0 if
     * not set.
     * 
     * encoding: unused.
     * decoding: set by decoder 
     */
    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

974 975 976 977 978 979 980 981 982
    int me_range;
    /**
     * Maximum motion estimation search range in subpel units.
     * if 0 then no limit
     * 
     * encoding: set by user.
     * decoding: unused.
     */

Fabrice Bellard's avatar
Fabrice Bellard committed
983 984
} AVCodecContext;

985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020
//void avcodec_getopt(AVCodecContext* avctx, const char* str, avc_config_t** config);

typedef struct AVOption {
    /** options' name */
    const char *name; /* if name is NULL, it indicates a link to next */
    /** short English text help */
    const char *help;
    /** offset to context structure where the parsed value should be stored */
    int offset;
    /** options' type */
    int type;
#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
//#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;
    const struct AVOption *sub; /* used when name is NULL */
    /* when it's NULL return to previous level (or finish reading) */
#define FF_OPT_MAX_DEPTH 10
} AVOption;

Fabrice Bellard's avatar
Fabrice Bellard committed
1021
typedef struct AVCodec {
1022
    const char *name;
Fabrice Bellard's avatar
Fabrice Bellard committed
1023 1024 1025 1026
    int type;
    int id;
    int priv_data_size;
    int (*init)(AVCodecContext *);
1027
    int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
Fabrice Bellard's avatar
Fabrice Bellard committed
1028
    int (*close)(AVCodecContext *);
Michael Niedermayer's avatar
Michael Niedermayer committed
1029
    int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
1030
                  uint8_t *buf, int buf_size);
Fabrice Bellard's avatar
Fabrice Bellard committed
1031
    int capabilities;
1032
    const AVOption *options;
Fabrice Bellard's avatar
Fabrice Bellard committed
1033 1034 1035
    struct AVCodec *next;
} AVCodec;

1036
/**
1037 1038 1039
 * four components are given, that's all.
 * the last component is alpha
 */
Fabrice Bellard's avatar
Fabrice Bellard committed
1040
typedef struct AVPicture {
1041
    uint8_t *data[4];
1042
    int linesize[4];
Fabrice Bellard's avatar
Fabrice Bellard committed
1043 1044 1045 1046
} AVPicture;

extern AVCodec ac3_encoder;
extern AVCodec mp2_encoder;
1047
extern AVCodec mp3lame_encoder;
1048
extern AVCodec oggvorbis_encoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1049 1050 1051 1052 1053
extern AVCodec mpeg1video_encoder;
extern AVCodec h263_encoder;
extern AVCodec h263p_encoder;
extern AVCodec rv10_encoder;
extern AVCodec mjpeg_encoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1054
extern AVCodec mpeg4_encoder;
1055 1056 1057
extern AVCodec msmpeg4v1_encoder;
extern AVCodec msmpeg4v2_encoder;
extern AVCodec msmpeg4v3_encoder;
Michael Niedermayer's avatar
Michael Niedermayer committed
1058 1059
extern AVCodec wmv1_encoder;
extern AVCodec wmv2_encoder;
Michael Niedermayer's avatar
huffyuv  
Michael Niedermayer committed
1060
extern AVCodec huffyuv_encoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1061 1062

extern AVCodec h263_decoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1063
extern AVCodec mpeg4_decoder;
1064 1065 1066
extern AVCodec msmpeg4v1_decoder;
extern AVCodec msmpeg4v2_decoder;
extern AVCodec msmpeg4v3_decoder;
1067
extern AVCodec wmv1_decoder;
Michael Niedermayer's avatar
Michael Niedermayer committed
1068
extern AVCodec wmv2_decoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1069 1070 1071
extern AVCodec mpeg_decoder;
extern AVCodec h263i_decoder;
extern AVCodec rv10_decoder;
Nick Kurshev's avatar
Nick Kurshev committed
1072
extern AVCodec svq1_decoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1073 1074
extern AVCodec dvvideo_decoder;
extern AVCodec dvaudio_decoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1075 1076
extern AVCodec wmav1_decoder;
extern AVCodec wmav2_decoder;
1077
extern AVCodec mjpeg_decoder;
1078
extern AVCodec mjpegb_decoder;
1079
extern AVCodec mp2_decoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1080
extern AVCodec mp3_decoder;
1081 1082
extern AVCodec mace3_decoder;
extern AVCodec mace6_decoder;
Michael Niedermayer's avatar
huffyuv  
Michael Niedermayer committed
1083
extern AVCodec huffyuv_decoder;
Mark Hills's avatar
Mark Hills committed
1084
extern AVCodec oggvorbis_decoder;
1085
extern AVCodec cyuv_decoder;
Fabrice Bellard's avatar
Fabrice Bellard committed
1086

Fabrice Bellard's avatar
Fabrice Bellard committed
1087 1088 1089
/* pcm codecs */
#define PCM_CODEC(id, name) \
extern AVCodec name ## _decoder; \
1090
extern AVCodec name ## _encoder
Fabrice Bellard's avatar
Fabrice Bellard committed
1091 1092 1093 1094 1095 1096 1097 1098 1099 1100

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

1101 1102 1103 1104 1105 1106
/* adpcm codecs */

PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);

Fabrice Bellard's avatar
Fabrice Bellard committed
1107 1108 1109
#undef PCM_CODEC

/* dummy raw video codec */
Fabrice Bellard's avatar
Fabrice Bellard committed
1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133
extern AVCodec rawvideo_codec;

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

/* resample.c */

struct ReSampleContext;

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

/* 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);
1134 1135 1136 1137 1138 1139

ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
                                      int iwidth, int iheight,
                                      int topBand, int bottomBand,
                                      int leftBand, int rightBand);

Fabrice Bellard's avatar
Fabrice Bellard committed
1140 1141 1142 1143 1144
void img_resample(ImgReSampleContext *s, 
                  AVPicture *output, AVPicture *input);

void img_resample_close(ImgReSampleContext *s);

1145
int avpicture_fill(AVPicture *picture, uint8_t *ptr,
1146
                   int pix_fmt, int width, int height);
1147
int avpicture_get_size(int pix_fmt, int width, int height);
1148 1149
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);
1150 1151 1152 1153 1154 1155 1156 1157

/* convert among pixel formats */
int img_convert(AVPicture *dst, int dst_pix_fmt,
                AVPicture *src, int pix_fmt, 
                int width, int height);

/* deinterlace a picture */
int avpicture_deinterlace(AVPicture *dst, AVPicture *src,
Fabrice Bellard's avatar
Fabrice Bellard committed
1158 1159 1160 1161 1162 1163
                          int pix_fmt, int width, int height);

/* external high level API */

extern AVCodec *first_avcodec;

Nick Kurshev's avatar
Nick Kurshev committed
1164
/* returns LIBAVCODEC_VERSION_INT constant */
1165
unsigned avcodec_version(void);
Nick Kurshev's avatar
Nick Kurshev committed
1166
/* returns LIBAVCODEC_BUILD constant */
1167
unsigned avcodec_build(void);
Fabrice Bellard's avatar
Fabrice Bellard committed
1168 1169
void avcodec_init(void);

1170 1171
void avcodec_set_bit_exact(void);

Fabrice Bellard's avatar
Fabrice Bellard committed
1172 1173
void register_avcodec(AVCodec *format);
AVCodec *avcodec_find_encoder(enum CodecID id);
1174
AVCodec *avcodec_find_encoder_by_name(const char *name);
Fabrice Bellard's avatar
Fabrice Bellard committed
1175 1176 1177 1178
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);

Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
1179
void avcodec_get_context_defaults(AVCodecContext *s);
Falk Hüffner's avatar
Falk Hüffner committed
1180
AVCodecContext *avcodec_alloc_context(void);
Michael Niedermayer's avatar
Michael Niedermayer committed
1181
AVFrame *avcodec_alloc_frame(void);
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
1182

Michael Niedermayer's avatar
Michael Niedermayer committed
1183 1184
int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
Michael Niedermayer's avatar
cleanup  
Michael Niedermayer committed
1185

Fabrice Bellard's avatar
Fabrice Bellard committed