git.sesse.net Git - ffmpeg/blob - libavcodec/avcodec.h

   1 #ifndef AVCODEC_H
   2 #define AVCODEC_H
   3
   4 /**
   5  * @file avcodec.h
   6  * external api header.
   7  */
   8
   9
  10 #ifdef __cplusplus
  11 extern "C" {
  12 #endif
  13
  14 #include "common.h"
  15
  16 #define LIBAVCODEC_VERSION_INT 0x000406
  17 #define LIBAVCODEC_VERSION     "0.4.6"
  18 #define LIBAVCODEC_BUILD       4668
  19 #define LIBAVCODEC_BUILD_STR   "4668"
  20
  21 #define LIBAVCODEC_IDENT        "FFmpeg" LIBAVCODEC_VERSION "b" LIBAVCODEC_BUILD_STR
  22
  23 enum CodecID {
  24     CODEC_ID_NONE,
  25     CODEC_ID_MPEG1VIDEO,
  26     CODEC_ID_H263,
  27     CODEC_ID_RV10,
  28     CODEC_ID_MP2,
  29     CODEC_ID_MP3LAME,
  30     CODEC_ID_VORBIS,
  31     CODEC_ID_AC3,
  32     CODEC_ID_MJPEG,
  33     CODEC_ID_MJPEGB,
  34     CODEC_ID_MPEG4,
  35     CODEC_ID_RAWVIDEO,
  36     CODEC_ID_MSMPEG4V1,
  37     CODEC_ID_MSMPEG4V2,
  38     CODEC_ID_MSMPEG4V3,
  39     CODEC_ID_WMV1,
  40     CODEC_ID_WMV2,
  41     CODEC_ID_H263P,
  42     CODEC_ID_H263I,
  43     CODEC_ID_SVQ1,
  44     CODEC_ID_SVQ3,
  45     CODEC_ID_DVVIDEO,
  46     CODEC_ID_DVAUDIO,
  47     CODEC_ID_WMAV1,
  48     CODEC_ID_WMAV2,
  49     CODEC_ID_MACE3,
  50     CODEC_ID_MACE6,
  51     CODEC_ID_HUFFYUV,
  52     CODEC_ID_CYUV,
  53     CODEC_ID_H264,
  54     CODEC_ID_INDEO3,
  55     CODEC_ID_VP3,
  56     CODEC_ID_AAC,
  57     CODEC_ID_MPEG4AAC,
  58     CODEC_ID_ASV1,
  59
  60     /* various pcm "codecs" */
  61     CODEC_ID_PCM_S16LE,
  62     CODEC_ID_PCM_S16BE,
  63     CODEC_ID_PCM_U16LE,
  64     CODEC_ID_PCM_U16BE,
  65     CODEC_ID_PCM_S8,
  66     CODEC_ID_PCM_U8,
  67     CODEC_ID_PCM_MULAW,
  68     CODEC_ID_PCM_ALAW,
  69
  70     /* various adpcm codecs */
  71     CODEC_ID_ADPCM_IMA_QT,
  72     CODEC_ID_ADPCM_IMA_WAV,
  73     CODEC_ID_ADPCM_MS,
  74
  75         /* AMR */
  76     CODEC_ID_AMR_NB,
  77 };
  78
  79 enum CodecType {
  80     CODEC_TYPE_UNKNOWN = -1,
  81     CODEC_TYPE_VIDEO,
  82     CODEC_TYPE_AUDIO,
  83 };
  84
  85 /**
  86  * Pixel format.
  87  */
  88 enum PixelFormat {
  89     PIX_FMT_YUV420P,
  90     PIX_FMT_YUV422,
  91     PIX_FMT_RGB24,     ///< 3 bytes, R is first
  92     PIX_FMT_BGR24,     ///< 3 bytes, B is first
  93     PIX_FMT_YUV422P,
  94     PIX_FMT_YUV444P,
  95     PIX_FMT_RGBA32,    ///< always stored in cpu endianness
  96     PIX_FMT_YUV410P,
  97     PIX_FMT_YUV411P,
  98     PIX_FMT_RGB565,    ///< always stored in cpu endianness
  99     PIX_FMT_RGB555,    ///< always stored in cpu endianness, most significant bit to 1
 100     PIX_FMT_GRAY8,
 101     PIX_FMT_MONOWHITE, ///< 0 is white
 102     PIX_FMT_MONOBLACK, ///< 0 is black
 103     PIX_FMT_PAL8,      ///< 8 bit with RGBA palette
 104     PIX_FMT_YUVJ420P,  ///< YUV full scale (jpeg)
 105     PIX_FMT_YUVJ422P,  ///< YUV full scale (jpeg)
 106     PIX_FMT_YUVJ444P,  ///< YUV full scale (jpeg)
 107     PIX_FMT_NB,
 108 };
 109
 110 /* currently unused, may be used if 24/32 bits samples ever supported */
 111 enum SampleFormat {
 112     SAMPLE_FMT_S16 = 0,         ///< signed 16 bits
 113 };
 114
 115 /* in bytes */
 116 #define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
 117
 118 /**
 119  * Required number of zero bytes at the end of the input bitstream for decoding.
 120  * to avoid overreading (and possibly segfaulting)
 121  */
 122 #define FF_INPUT_BUFFER_PADDING_SIZE 8
 123
 124 /* motion estimation type, EPZS by default */
 125 enum Motion_Est_ID {
 126     ME_ZERO = 1,
 127     ME_FULL,
 128     ME_LOG,
 129     ME_PHODS,
 130     ME_EPZS,
 131     ME_X1
 132 };
 133
 134 typedef struct RcOverride{
 135     int start_frame;
 136     int end_frame;
 137     int qscale; // if this is 0 then quality_factor will be used instead
 138     float quality_factor;
 139 } RcOverride;
 140
 141 /* only for ME compatiblity with old apps */
 142 extern int motion_estimation_method;
 143
 144 /* ME algos sorted by quality */
 145 static const int Motion_Est_QTab[] = { ME_ZERO, ME_PHODS, ME_LOG,
 146                                        ME_X1, ME_EPZS, ME_FULL };
 147
 148
 149 #define FF_MAX_B_FRAMES 8
 150
 151 /* encoding support
 152    these flags can be passed in AVCodecContext.flags before initing
 153    Note: note not everything is supported yet
 154 */
 155
 156 #define CODEC_FLAG_HQ     0x0001  ///< brute force MB-type decission mode (slow)
 157 #define CODEC_FLAG_QSCALE 0x0002  ///< use fixed qscale
 158 #define CODEC_FLAG_4MV    0x0004  ///< 4 MV per MB allowed
 159 #define CODEC_FLAG_QPEL   0x0010  ///< use qpel MC
 160 #define CODEC_FLAG_GMC    0x0020  ///< use GMC
 161 #define CODEC_FLAG_PART   0x0080  ///< use data partitioning
 162 /* parent program gurantees that the input for b-frame containing streams is not written to
 163    for at least s->max_b_frames+1 frames, if this is not set than the input will be copied */
 164 #define CODEC_FLAG_INPUT_PRESERVED 0x0100
 165 #define CODEC_FLAG_PASS1 0x0200   ///< use internal 2pass ratecontrol in first  pass mode
 166 #define CODEC_FLAG_PASS2 0x0400   ///< use internal 2pass ratecontrol in second pass mode
 167 #define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< use external huffman table (for mjpeg)
 168 #define CODEC_FLAG_GRAY  0x2000   ///< only decode/encode grayscale
 169 #define CODEC_FLAG_EMU_EDGE 0x4000///< dont draw edges
 170 #define CODEC_FLAG_PSNR           0x8000 ///< error[?] variables will be set during encoding
 171 #define CODEC_FLAG_TRUNCATED  0x00010000 /** input bitstream might be truncated at a random location instead
 172                                             of only at frame boundaries */
 173 #define CODEC_FLAG_NORMALIZE_AQP  0x00020000 ///< normalize adaptive quantization
 174 #define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< use interlaced dct
 175 #define CODEC_FLAG_LOW_DELAY      0x00080000 ///< force low delay / will fail on b frames
 176 #define CODEC_FLAG_ALT_SCAN       0x00100000 ///< use alternate scan
 177 #define CODEC_FLAG_TRELLIS_QUANT  0x00200000 ///< use trellis quantization
 178 #define CODEC_FLAG_GLOBAL_HEADER  0x00400000 ///< place global headers in extradata instead of every keyframe
 179 #define CODEC_FLAG_BITEXACT       0x00800000 ///< use only bitexact stuff (except (i)dct)
 180 /* Fx : Flag for h263+ extra options */
 181 #define CODEC_FLAG_H263P_AIC      0x01000000 ///< Advanced intra coding
 182 #define CODEC_FLAG_H263P_UMV      0x02000000 ///< Unlimited motion vector
 183 /* For advanced prediction mode, we reuse the 4MV flag */
 184 /* Unsupported options :
 185  *              Syntax Arithmetic coding (SAC)
 186  *              Deblocking filter internal loop
 187  *              Slice structured
 188  *              Reference Picture Selection
 189  *              Independant Segment Decoding
 190  *              Alternative Inter *             VLC
 191  *              Modified Quantization */
 192 /* /Fx */
 193 /* codec capabilities */
 194
 195 #define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< decoder can use draw_horiz_band callback
 196 /**
 197  * Codec uses get_buffer() for allocating buffers.
 198  * direct rendering method 1
 199  */
 200 #define CODEC_CAP_DR1             0x0002
 201 /* if 'parse_only' field is true, then avcodec_parse_frame() can be
 202    used */
 203 #define CODEC_CAP_PARSE_ONLY      0x0004
 204 #define CODEC_CAP_TRUNCATED       0x0008
 205
 206 #define FF_COMMON_FRAME \
 207     /**\
 208      * pointer to the picture planes.\
 209      * this might be different from the first allocated byte\
 210      * - encoding: \
 211      * - decoding: \
 212      */\
 213     uint8_t *data[4];\
 214     int linesize[4];\
 215     /**\
 216      * pointer to the first allocated byte of the picture. can be used in get_buffer/release_buffer\
 217      * this isnt used by lavc unless the default get/release_buffer() is used\
 218      * - encoding: \
 219      * - decoding: \
 220      */\
 221     uint8_t *base[4];\
 222     /**\
 223      * 1 -> keyframe, 0-> not\
 224      * - encoding: set by lavc\
 225      * - decoding: set by lavc\
 226      */\
 227     int key_frame;\
 228 \
 229     /**\
 230      * picture type of the frame, see ?_TYPE below.\
 231      * - encoding: set by lavc for coded_picture (and set by user for input)\
 232      * - decoding: set by lavc\
 233      */\
 234     int pict_type;\
 235 \
 236     /**\
 237      * presentation timestamp in micro seconds (time when frame should be shown to user)\
 238      * if 0 then the frame_rate will be used as reference\
 239      * - encoding: MUST be set by user\
 240      * - decoding: set by lavc\
 241      */\
 242     int64_t pts;\
 243 \
 244     /**\
 245      * picture number in bitstream order.\
 246      * - encoding: set by\
 247      * - decoding: set by lavc\
 248      */\
 249     int coded_picture_number;\
 250     /**\
 251      * picture number in display order.\
 252      * - encoding: set by\
 253      * - decoding: set by lavc\
 254      */\
 255     int display_picture_number;\
 256 \
 257     /**\
 258      * quality (between 1 (good) and 31 (bad)) \
 259      * - encoding: set by lavc for coded_picture (and set by user for input)\
 260      * - decoding: set by lavc\
 261      */\
 262     float quality; \
 263 \
 264     /**\
 265      * buffer age (1->was last buffer and dint change, 2->..., ...).\
 266      * set to something large if the buffer has not been used yet \
 267      * - encoding: unused\
 268      * - decoding: MUST be set by get_buffer()\
 269      */\
 270     int age;\
 271 \
 272     /**\
 273      * is this picture used as reference\
 274      * - encoding: unused\
 275      * - decoding: set by lavc (before get_buffer() call))\
 276      */\
 277     int reference;\
 278 \
 279     /**\
 280      * QP table\
 281      * - encoding: unused\
 282      * - decoding: set by lavc\
 283      */\
 284     int8_t *qscale_table;\
 285     /**\
 286      * QP store stride\
 287      * - encoding: unused\
 288      * - decoding: set by lavc\
 289      */\
 290     int qstride;\
 291 \
 292     /**\
 293      * mbskip_table[mb]>=1 if MB didnt change\
 294      * stride= mb_width = (width+15)>>4\
 295      * - encoding: unused\
 296      * - decoding: set by lavc\
 297      */\
 298     uint8_t *mbskip_table;\
 299 \
 300     /**\
 301      * for some private data of the user\
 302      * - encoding: unused\
 303      * - decoding: set by user\
 304      */\
 305     void *opaque;\
 306 \
 307     /**\
 308      * error\
 309      * - encoding: set by lavc if flags&CODEC_FLAG_PSNR\
 310      * - decoding: unused\
 311      */\
 312     uint64_t error[4];\
 313 \
 314     /**\
 315      * type of the buffer (to keep track of who has to dealloc data[*])\
 316      * - encoding: set by the one who allocs it\
 317      * - decoding: set by the one who allocs it\
 318      * Note: user allocated (direct rendering) & internal buffers can not coexist currently\
 319      */\
 320     int type;\
 321     \
 322     /**\
 323      * when decoding, this signal how much the picture must be delayed.\
 324      * extra_delay = repeat_pict / (2*fps)\
 325      * - encoding: unused\
 326      * - decoding: set by lavc\
 327      */\
 328     int repeat_pict;\
 329     \
 330     /**\
 331      * \
 332      */\
 333     int qscale_type;\
 334
 335 #define FF_QSCALE_TYPE_MPEG1    0
 336 #define FF_QSCALE_TYPE_MPEG2    1
 337
 338 #define FF_BUFFER_TYPE_INTERNAL 1
 339 #define FF_BUFFER_TYPE_USER     2 ///< Direct rendering buffers
 340 #define FF_BUFFER_TYPE_SHARED   4 ///< buffer from somewher else, dont dealloc
 341
 342
 343 #define FF_I_TYPE 1 // Intra
 344 #define FF_P_TYPE 2 // Predicted
 345 #define FF_B_TYPE 3 // Bi-dir predicted
 346 #define FF_S_TYPE 4 // S(GMC)-VOP MPEG4
 347 #define FF_SI_TYPE 5
 348 #define FF_SP_TYPE 6
 349
 350 /**
 351  * Audio Video Frame.
 352  */
 353 typedef struct AVFrame {
 354     FF_COMMON_FRAME
 355 } AVFrame;
 356
 357 #define DEFAULT_FRAME_RATE_BASE 1001000
 358
 359 /**
 360  * main external api structure.
 361  */
 362 typedef struct AVCodecContext {
 363     /**
 364      * the average bitrate.
 365      * - encoding: set by user. unused for constant quantizer encoding
 366      * - decoding: set by lavc. 0 or some bitrate if this info is available in the stream
 367      */
 368     int bit_rate;
 369
 370     /**
 371      * number of bits the bitstream is allowed to diverge from the reference.
 372      *           the reference can be CBR (for CBR pass1) or VBR (for pass2)
 373      * - encoding: set by user. unused for constant quantizer encoding
 374      * - decoding: unused
 375      */
 376     int bit_rate_tolerance;
 377
 378     /**
 379      * CODEC_FLAG_*.
 380      * - encoding: set by user.
 381      * - decoding: set by user.
 382      */
 383     int flags;
 384
 385     /**
 386      * some codecs needs additionnal format info. It is stored here
 387      * - encoding: set by user.
 388      * - decoding: set by lavc. (FIXME is this ok?)
 389      */
 390     int sub_id;
 391
 392     /**
 393      * motion estimation algorithm used for video coding.
 394      * - encoding: MUST be set by user.
 395      * - decoding: unused
 396      */
 397     int me_method;
 398
 399     /**
 400      * some codecs need / can use extra-data like huffman tables.
 401      * mjpeg: huffman tables
 402      * rv10: additional flags
 403      * mpeg4: global headers (they can be in the bitstream or here)
 404      * - encoding: set/allocated/freed by lavc.
 405      * - decoding: set/allocated/freed by user.
 406      */
 407     void *extradata;
 408     int extradata_size;
 409
 410     /* video only */
 411     /**
 412      * frames per sec multiplied by frame_rate_base.
 413      * for variable fps this is the precission, so if the timestamps
 414      * can be specified in msec precssion then this is 1000*frame_rate_base
 415      * - encoding: MUST be set by user
 416      * - decoding: set by lavc. 0 or the frame_rate if available
 417      */
 418     int frame_rate;
 419
 420     /**
 421      * width / height.
 422      * - encoding: MUST be set by user.
 423      * - decoding: set by user, some codecs might override / change it during playback
 424      */
 425     int width, height;
 426
 427 #define FF_ASPECT_SQUARE 1
 428 #define FF_ASPECT_4_3_625 2
 429 #define FF_ASPECT_4_3_525 3
 430 #define FF_ASPECT_16_9_625 4
 431 #define FF_ASPECT_16_9_525 5
 432 #define FF_ASPECT_EXTENDED 15
 433
 434     /**
 435      * the number of pictures in a group of pitures, or 0 for intra_only.
 436      * - encoding: set by user.
 437      * - decoding: unused
 438      */
 439     int gop_size;
 440
 441     /**
 442      * pixel format, see PIX_FMT_xxx.
 443      * - encoding: unused
 444      * - decoding: set by lavc.
 445      */
 446     enum PixelFormat pix_fmt;
 447
 448     /**
 449      * Frame rate emulation. If not zero lower layer (i.e. format handler)
 450      * has to read frames at native frame rate.
 451      * - encoding: set by user.
 452      * - decoding: unused.
 453      */
 454     int rate_emu;
 455
 456     /**
 457      * if non NULL, 'draw_horiz_band' is called by the libavcodec
 458      * decoder to draw an horizontal band. It improve cache usage. Not
 459      * all codecs can do that. You must check the codec capabilities
 460      * before
 461      * - encoding: unused
 462      * - decoding: set by user.
 463      */
 464     void (*draw_horiz_band)(struct AVCodecContext *s,
 465                             uint8_t **src_ptr, int linesize,
 466                             int y, int width, int height);
 467
 468     /* audio only */
 469     int sample_rate; ///< samples per sec
 470     int channels;
 471     int sample_fmt;  ///< sample format, currenly unused
 472
 473     /* the following data should not be initialized */
 474     int frame_size;     ///< in samples, initialized when calling 'init'
 475     int frame_number;   ///< audio or video frame number
 476     int real_pict_num;  ///< returns the real picture number of previous encoded frame
 477
 478     /**
 479      * number of frames the decoded output will be delayed relative to
 480      * the encoded input.
 481      * - encoding: set by lavc.
 482      * - decoding: unused
 483      */
 484     int delay;
 485
 486     /* - encoding parameters */
 487     float qcompress;  ///< amount of qscale change between easy & hard scenes (0.0-1.0)
 488     float qblur;      ///< amount of qscale smoothing over time (0.0-1.0)
 489
 490     /**
 491      * minimum quantizer.
 492      * - encoding: set by user.
 493      * - decoding: unused
 494      */
 495     int qmin;
 496
 497     /**
 498      * maximum quantizer.
 499      * - encoding: set by user.
 500      * - decoding: unused
 501      */
 502     int qmax;
 503
 504     /**
 505      * maximum quantizer difference etween frames.
 506      * - encoding: set by user.
 507      * - decoding: unused
 508      */
 509     int max_qdiff;
 510
 511     /**
 512      * maximum number of b frames between non b frames.
 513      * note: the output will be delayed by max_b_frames+1 relative to the input
 514      * - encoding: set by user.
 515      * - decoding: unused
 516      */
 517     int max_b_frames;
 518
 519     /**
 520      * qscale factor between ip and b frames.
 521      * - encoding: set by user.
 522      * - decoding: unused
 523      */
 524     float b_quant_factor;
 525
 526     /** obsolete FIXME remove */
 527     int rc_strategy;
 528     int b_frame_strategy;
 529
 530     /**
 531      * hurry up amount.
 532      * - encoding: unused
 533      * - decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too, 5-> skip everything except header
 534      */
 535     int hurry_up;
 536
 537     struct AVCodec *codec;
 538
 539     void *priv_data;
 540
 541     /* The following data is for RTP friendly coding */
 542     /* By now only H.263/H.263+/MPEG4 coder honours this   */
 543     int rtp_mode;   /* 1 for activate RTP friendly-mode           */
 544                     /* highers numbers represent more error-prone */
 545                     /* enviroments, by now just "1" exist         */
 546
 547     int rtp_payload_size;   /* The size of the RTP payload, the coder will  */
 548                             /* do it's best to deliver a chunk with size    */
 549                             /* below rtp_payload_size, the chunk will start */
 550                             /* with a start code on some codecs like H.263  */
 551                             /* This doesn't take account of any particular  */
 552                             /* headers inside the transmited RTP payload    */
 553
 554
 555     /* The RTP callcack: This function is called  */
 556     /* every time the encoder as a packet to send */
 557     /* Depends on the encoder if the data starts  */
 558     /* with a Start Code (it should) H.263 does   */
 559     void (*rtp_callback)(void *data, int size, int packet_number);
 560
 561     /* statistics, used for 2-pass encoding */
 562     int mv_bits;
 563     int header_bits;
 564     int i_tex_bits;
 565     int p_tex_bits;
 566     int i_count;
 567     int p_count;
 568     int skip_count;
 569     int misc_bits;
 570
 571     /**
 572      * number of bits used for the previously encoded frame.
 573      * - encoding: set by lavc
 574      * - decoding: unused
 575      */
 576     int frame_bits;
 577
 578     /**
 579      * private data of the user, can be used to carry app specific stuff.
 580      * - encoding: set by user
 581      * - decoding: set by user
 582      */
 583     void *opaque;
 584
 585     char codec_name[32];
 586     enum CodecType codec_type; /* see CODEC_TYPE_xxx */
 587     enum CodecID codec_id; /* see CODEC_ID_xxx */
 588
 589     /**
 590      * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
 591      * this is used to workaround some encoder bugs
 592      * - encoding: unused
 593      * - decoding: set by user, will be converted to upper case by lavc during init
 594      */
 595     unsigned int codec_tag;
 596
 597     /**
 598      * workaround bugs in encoders which sometimes cannot be detected automatically.
 599      * - encoding: unused
 600      * - decoding: set by user
 601      */
 602     int workaround_bugs;
 603 #define FF_BUG_AUTODETECT       1  ///< autodetection
 604 #define FF_BUG_OLD_MSMPEG4      2
 605 #define FF_BUG_XVID_ILACE       4
 606 #define FF_BUG_UMP4             8
 607 #define FF_BUG_NO_PADDING       16
 608 #define FF_BUG_AC_VLC           32
 609 #define FF_BUG_QPEL_CHROMA      64
 610 #define FF_BUG_STD_QPEL         128
 611 #define FF_BUG_QPEL_CHROMA2     256
 612 #define FF_BUG_DIRECT_BLOCKSIZE 512
 613 #define FF_BUG_EDGE             1024
 614 //#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
 615
 616     /**
 617      * luma single coeff elimination threshold.
 618      * - encoding: set by user
 619      * - decoding: unused
 620      */
 621     int luma_elim_threshold;
 622
 623     /**
 624      * chroma single coeff elimination threshold.
 625      * - encoding: set by user
 626      * - decoding: unused
 627      */
 628     int chroma_elim_threshold;
 629
 630     /**
 631      * strictly follow the std (MPEG4, ...).
 632      * - encoding: set by user
 633      * - decoding: unused
 634      */
 635     int strict_std_compliance;
 636
 637     /**
 638      * qscale offset between ip and b frames.
 639      * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
 640      * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
 641      * - encoding: set by user.
 642      * - decoding: unused
 643      */
 644     float b_quant_offset;
 645
 646     /**
 647      * error resilience higher values will detect more errors but may missdetect
 648      * some more or less valid parts as errors.
 649      * - encoding: unused
 650      * - decoding: set by user
 651      */
 652     int error_resilience;
 653 #define FF_ER_CAREFULL        1
 654 #define FF_ER_COMPLIANT       2
 655 #define FF_ER_AGGRESSIVE      3
 656 #define FF_ER_VERY_AGGRESSIVE 4
 657
 658     /**
 659      * called at the beginning of each frame to get a buffer for it.
 660      * if pic.reference is set then the frame will be read later by lavc
 661      * - encoding: unused
 662      * - decoding: set by lavc, user can override
 663      */
 664     int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
 665
 666     /**
 667      * called to release buffers which where allocated with get_buffer.
 668      * a released buffer can be reused in get_buffer()
 669      * pic.data[*] must be set to NULL
 670      * - encoding: unused
 671      * - decoding: set by lavc, user can override
 672      */
 673     void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
 674
 675     /**
 676      * is 1 if the decoded stream contains b frames, 0 otherwise.
 677      * - encoding: unused
 678      * - decoding: set by lavc
 679      */
 680     int has_b_frames;
 681
 682     int block_align; ///< used by some WAV based audio codecs
 683
 684     int parse_only; /* - decoding only: if true, only parsing is done
 685                        (function avcodec_parse_frame()). The frame
 686                        data is returned. Only MPEG codecs support this now. */
 687
 688     /**
 689      * 0-> h263 quant 1-> mpeg quant.
 690      * - encoding: set by user.
 691      * - decoding: unused
 692      */
 693     int mpeg_quant;
 694
 695     /**
 696      * pass1 encoding statistics output buffer.
 697      * - encoding: set by lavc
 698      * - decoding: unused
 699      */
 700     char *stats_out;
 701
 702     /**
 703      * pass2 encoding statistics input buffer.
 704      * concatenated stuff from stats_out of pass1 should be placed here
 705      * - encoding: allocated/set/freed by user
 706      * - decoding: unused
 707      */
 708     char *stats_in;
 709
 710     /**
 711      * ratecontrol qmin qmax limiting method.
 712      * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
 713      * - encoding: set by user.
 714      * - decoding: unused
 715      */
 716     float rc_qsquish;
 717
 718     float rc_qmod_amp;
 719     int rc_qmod_freq;
 720
 721     /**
 722      * ratecontrol override, see RcOverride.
 723      * - encoding: allocated/set/freed by user.
 724      * - decoding: unused
 725      */
 726     RcOverride *rc_override;
 727     int rc_override_count;
 728
 729     /**
 730      * rate control equation.
 731      * - encoding: set by user
 732      * - decoding: unused
 733      */
 734     char *rc_eq;
 735
 736     /**
 737      * maximum bitrate.
 738      * - encoding: set by user.
 739      * - decoding: unused
 740      */
 741     int rc_max_rate;
 742
 743     /**
 744      * minimum bitrate.
 745      * - encoding: set by user.
 746      * - decoding: unused
 747      */
 748     int rc_min_rate;
 749
 750     /**
 751      * decoder bitstream buffer size.
 752      * - encoding: set by user.
 753      * - decoding: unused
 754      */
 755     int rc_buffer_size;
 756     float rc_buffer_aggressivity;
 757
 758     /**
 759      * qscale factor between p and i frames.
 760      * - encoding: set by user.
 761      * - decoding: unused
 762      */
 763     float i_quant_factor;
 764
 765     /**
 766      * qscale offset between p and i frames.
 767      * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
 768      * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
 769      * - encoding: set by user.
 770      * - decoding: unused
 771      */
 772     float i_quant_offset;
 773
 774     /**
 775      * initial complexity for pass1 ratecontrol.
 776      * - encoding: set by user.
 777      * - decoding: unused
 778      */
 779     float rc_initial_cplx;
 780
 781     /**
 782      * dct algorithm, see FF_DCT_* below.
 783      * - encoding: set by user
 784      * - decoding: unused
 785      */
 786     int dct_algo;
 787 #define FF_DCT_AUTO    0
 788 #define FF_DCT_FASTINT 1
 789 #define FF_DCT_INT     2
 790 #define FF_DCT_MMX     3
 791 #define FF_DCT_MLIB    4
 792 #define FF_DCT_ALTIVEC 5
 793
 794     /**
 795      * luminance masking (0-> disabled).
 796      * - encoding: set by user
 797      * - decoding: unused
 798      */
 799     float lumi_masking;
 800
 801     /**
 802      * temporary complexity masking (0-> disabled).
 803      * - encoding: set by user
 804      * - decoding: unused
 805      */
 806     float temporal_cplx_masking;
 807
 808     /**
 809      * spatial complexity masking (0-> disabled).
 810      * - encoding: set by user
 811      * - decoding: unused
 812      */
 813     float spatial_cplx_masking;
 814
 815     /**
 816      * p block masking (0-> disabled).
 817      * - encoding: set by user
 818      * - decoding: unused
 819      */
 820     float p_masking;
 821
 822     /**
 823      * darkness masking (0-> disabled).
 824      * - encoding: set by user
 825      * - decoding: unused
 826      */
 827     float dark_masking;
 828
 829
 830     /* for binary compatibility */
 831     int unused;
 832
 833     /**
 834      * idct algorithm, see FF_IDCT_* below.
 835      * - encoding: set by user
 836      * - decoding: set by user
 837      */
 838     int idct_algo;
 839 #define FF_IDCT_AUTO         0
 840 #define FF_IDCT_INT          1
 841 #define FF_IDCT_SIMPLE       2
 842 #define FF_IDCT_SIMPLEMMX    3
 843 #define FF_IDCT_LIBMPEG2MMX  4
 844 #define FF_IDCT_PS2          5
 845 #define FF_IDCT_MLIB         6
 846 #define FF_IDCT_ARM          7
 847 #define FF_IDCT_ALTIVEC      8
 848 #define FF_IDCT_SH4          9
 849
 850     /**
 851      * slice count.
 852      * - encoding: set by lavc
 853      * - decoding: set by user (or 0)
 854      */
 855     int slice_count;
 856     /**
 857      * slice offsets in the frame in bytes.
 858      * - encoding: set/allocated by lavc
 859      * - decoding: set/allocated by user (or NULL)
 860      */
 861     int *slice_offset;
 862
 863     /**
 864      * error concealment flags.
 865      * - encoding: unused
 866      * - decoding: set by user
 867      */
 868     int error_concealment;
 869 #define FF_EC_GUESS_MVS   1
 870 #define FF_EC_DEBLOCK     2
 871
 872     /**
 873      * dsp_mask could be add used to disable unwanted CPU features
 874      * CPU features (i.e. MMX, SSE. ...)
 875      *
 876      * with FORCE flag you may instead enable given CPU features
 877      * (Dangerous: usable in case of misdetection, improper usage however will
 878      * result into program crash)
 879      */
 880     unsigned dsp_mask;
 881 #define FF_MM_FORCE     0x80000000 /* force usage of selected flags (OR) */
 882     /* lower 16 bits - CPU features */
 883 #ifdef HAVE_MMX
 884 #define FF_MM_MMX       0x0001 /* standard MMX */
 885 #define FF_MM_3DNOW     0x0004 /* AMD 3DNOW */
 886 #define FF_MM_MMXEXT    0x0002 /* SSE integer functions or AMD MMX ext */
 887 #define FF_MM_SSE       0x0008 /* SSE functions */
 888 #define FF_MM_SSE2      0x0010 /* PIV SSE2 functions */
 889 #endif /* HAVE_MMX */
 890
 891     /**
 892      * bits per sample/pixel from the demuxer (needed for huffyuv).
 893      * - encoding: set by lavc
 894      * - decoding: set by user
 895      */
 896      int bits_per_sample;
 897
 898     /**
 899      * prediction method (needed for huffyuv).
 900      * - encoding: set by user
 901      * - decoding: unused
 902      */
 903      int prediction_method;
 904 #define FF_PRED_LEFT   0
 905 #define FF_PRED_PLANE  1
 906 #define FF_PRED_MEDIAN 2
 907
 908     /**
 909      * aspect ratio (0 if unknown).
 910      * - encoding: set by user.
 911      * - decoding: set by lavc.
 912      */
 913     float aspect_ratio;
 914
 915     /**
 916      * the picture in the bitstream.
 917      * - encoding: set by lavc
 918      * - decoding: set by lavc
 919      */
 920     AVFrame *coded_frame;
 921
 922     /**
 923      * debug.
 924      * - encoding: set by user.
 925      * - decoding: set by user.
 926      */
 927     int debug;
 928 #define FF_DEBUG_PICT_INFO 1
 929 #define FF_DEBUG_RC        2
 930 #define FF_DEBUG_BITSTREAM 4
 931 #define FF_DEBUG_MB_TYPE   8
 932 #define FF_DEBUG_QP        16
 933 #define FF_DEBUG_MV        32
 934 #define FF_DEBUG_VIS_MV    0x00000040
 935 #define FF_DEBUG_SKIP      0x00000080
 936 #define FF_DEBUG_STARTCODE 0x00000100
 937 #define FF_DEBUG_PTS       0x00000200
 938 #define FF_DEBUG_ER        0x00000400
 939 #define FF_DEBUG_MMCO      0x00000800
 940
 941     /**
 942      * error.
 943      * - encoding: set by lavc if flags&CODEC_FLAG_PSNR
 944      * - decoding: unused
 945      */
 946     uint64_t error[4];
 947
 948     /**
 949      * minimum MB quantizer.
 950      * - encoding: set by user.
 951      * - decoding: unused
 952      */
 953     int mb_qmin;
 954
 955     /**
 956      * maximum MB quantizer.
 957      * - encoding: set by user.
 958      * - decoding: unused
 959      */
 960     int mb_qmax;
 961
 962     /**
 963      * motion estimation compare function.
 964      * - encoding: set by user.
 965      * - decoding: unused
 966      */
 967     int me_cmp;
 968     /**
 969      * subpixel motion estimation compare function.
 970      * - encoding: set by user.
 971      * - decoding: unused
 972      */
 973     int me_sub_cmp;
 974     /**
 975      * macroblock compare function (not supported yet).
 976      * - encoding: set by user.
 977      * - decoding: unused
 978      */
 979     int mb_cmp;
 980 #define FF_CMP_SAD  0
 981 #define FF_CMP_SSE  1
 982 #define FF_CMP_SATD 2
 983 #define FF_CMP_DCT  3
 984 #define FF_CMP_PSNR 4
 985 #define FF_CMP_BIT  5
 986 #define FF_CMP_RD   6
 987 #define FF_CMP_ZERO 7
 988 #define FF_CMP_CHROMA 256
 989
 990     /**
 991      * ME diamond size & shape.
 992      * - encoding: set by user.
 993      * - decoding: unused
 994      */
 995     int dia_size;
 996
 997     /**
 998      * amount of previous MV predictors (2a+1 x 2a+1 square).
 999      * - encoding: set by user.
1000      * - decoding: unused
1001      */
1002     int last_predictor_count;
1003
1004     /**
1005      * pre pass for motion estimation.
1006      * - encoding: set by user.
1007      * - decoding: unused
1008      */
1009     int pre_me;
1010
1011     /**
1012      * motion estimation pre pass compare function.
1013      * - encoding: set by user.
1014      * - decoding: unused
1015      */
1016     int me_pre_cmp;
1017
1018     /**
1019      * ME pre pass diamond size & shape.
1020      * - encoding: set by user.
1021      * - decoding: unused
1022      */
1023     int pre_dia_size;
1024
1025     /**
1026      * subpel ME quality.
1027      * - encoding: set by user.
1028      * - decoding: unused
1029      */
1030     int me_subpel_quality;
1031
1032     /**
1033      * callback to negotiate the pixelFormat.
1034      * @param fmt is the list of formats which are supported by the codec,
1035      * its terminated by -1 as 0 is a valid format, the formats are ordered by quality
1036      * the first is allways the native one
1037      * @return the choosen format
1038      * - encoding: unused
1039      * - decoding: set by user, if not set then the native format will always be choosen
1040      */
1041     enum PixelFormat (*get_format)(struct AVCodecContext *s, enum PixelFormat * fmt);
1042
1043     /**
1044      * DTG active format information (additionnal aspect ratio
1045      * information only used in DVB MPEG2 transport streams). 0 if
1046      * not set.
1047      *
1048      * - encoding: unused.
1049      * - decoding: set by decoder
1050      */
1051     int dtg_active_format;
1052 #define FF_DTG_AFD_SAME         8
1053 #define FF_DTG_AFD_4_3          9
1054 #define FF_DTG_AFD_16_9         10
1055 #define FF_DTG_AFD_14_9         11
1056 #define FF_DTG_AFD_4_3_SP_14_9  13
1057 #define FF_DTG_AFD_16_9_SP_14_9 14
1058 #define FF_DTG_AFD_SP_4_3       15
1059
1060     /**
1061      * Maximum motion estimation search range in subpel units.
1062      * if 0 then no limit
1063      *
1064      * - encoding: set by user.
1065      * - decoding: unused.
1066      */
1067     int me_range;
1068
1069     /**
1070      * frame_rate_base.
1071      * for variable fps this is 1
1072      * - encoding: set by user.
1073      * - decoding: set by lavc.
1074      * @todo move this after frame_rate
1075      */
1076
1077     int frame_rate_base;
1078     /**
1079      * intra quantizer bias.
1080      * - encoding: set by user.
1081      * - decoding: unused
1082      */
1083     int intra_quant_bias;
1084 #define FF_DEFAULT_QUANT_BIAS 999999
1085
1086     /**
1087      * inter quantizer bias.
1088      * - encoding: set by user.
1089      * - decoding: unused
1090      */
1091     int inter_quant_bias;
1092
1093     /**
1094      * color table ID.
1095      * - encoding: unused.
1096      * - decoding: which clrtable should be used for 8bit RGB images
1097      *             table have to be stored somewhere FIXME
1098      */
1099     int color_table_id;
1100
1101     /**
1102      * internal_buffer count.
1103      * Dont touch, used by lavc default_get_buffer()
1104      */
1105     int internal_buffer_count;
1106
1107     /**
1108      * internal_buffers.
1109      * Dont touch, used by lavc default_get_buffer()
1110      */
1111     void *internal_buffer;
1112
1113 #define FF_QUALITY_SCALE 256
1114     /**
1115      * global quality for codecs which cannot change it per frame.
1116      * this should be proportional to MPEG1/2/4 qscale.
1117      * - encoding: set by user.
1118      * - decoding: unused
1119      */
1120     int global_quality;
1121 } AVCodecContext;
1122
1123
1124 /**
1125  * AVOption.
1126  */
1127 typedef struct AVOption {
1128     /** options' name */
1129     const char *name; /* if name is NULL, it indicates a link to next */
1130     /** short English text help or const struct AVOption* subpointer */
1131     const char *help; //        const struct AVOption* sub;
1132     /** offset to context structure where the parsed value should be stored */
1133     int offset;
1134     /** options' type */
1135     int type;
1136 #define FF_OPT_TYPE_BOOL 1      ///< boolean - true,1,on  (or simply presence)
1137 #define FF_OPT_TYPE_DOUBLE 2    ///< double
1138 #define FF_OPT_TYPE_INT 3       ///< integer
1139 #define FF_OPT_TYPE_STRING 4    ///< string (finished with \0)
1140 #define FF_OPT_TYPE_MASK 0x1f   ///< mask for types - upper bits are various flags
1141 //#define FF_OPT_TYPE_EXPERT 0x20 // flag for expert option
1142 #define FF_OPT_TYPE_FLAG (FF_OPT_TYPE_BOOL | 0x40)
1143 #define FF_OPT_TYPE_RCOVERRIDE (FF_OPT_TYPE_STRING | 0x80)
1144     /** min value  (min == max   ->  no limits) */
1145     double min;
1146     /** maximum value for double/int */
1147     double max;
1148     /** default boo [0,1]l/double/int value */
1149     double defval;
1150     /**
1151      * default string value (with optional semicolon delimited extra option-list
1152      * i.e.   option1;option2;option3
1153      * defval might select other then first argument as default
1154      */
1155     const char *defstr;
1156 #define FF_OPT_MAX_DEPTH 10
1157 } AVOption;
1158
1159 /**
1160  * Parse option(s) and sets fields in passed structure
1161  * @param strct structure where the parsed results will be written
1162  * @param list  list with AVOptions
1163  * @param opts  string with options for parsing
1164  */
1165 int avoption_parse(void* strct, const AVOption* list, const char* opts);
1166
1167
1168 /**
1169  * AVCodec.
1170  */
1171 typedef struct AVCodec {
1172     const char *name;
1173     enum CodecType type;
1174     int id;
1175     int priv_data_size;
1176     int (*init)(AVCodecContext *);
1177     int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
1178     int (*close)(AVCodecContext *);
1179     int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
1180                   uint8_t *buf, int buf_size);
1181     int capabilities;
1182     const AVOption *options;
1183     struct AVCodec *next;
1184 } AVCodec;
1185
1186 /**
1187  * four components are given, that's all.
1188  * the last component is alpha
1189  */
1190 typedef struct AVPicture {
1191     uint8_t *data[4];
1192     int linesize[4];
1193 } AVPicture;
1194
1195 extern AVCodec ac3_encoder;
1196 extern AVCodec mp2_encoder;
1197 extern AVCodec mp3lame_encoder;
1198 extern AVCodec oggvorbis_encoder;
1199 extern AVCodec mpeg1video_encoder;
1200 extern AVCodec h263_encoder;
1201 extern AVCodec h263p_encoder;
1202 extern AVCodec rv10_encoder;
1203 extern AVCodec mjpeg_encoder;
1204 extern AVCodec mpeg4_encoder;
1205 extern AVCodec msmpeg4v1_encoder;
1206 extern AVCodec msmpeg4v2_encoder;
1207 extern AVCodec msmpeg4v3_encoder;
1208 extern AVCodec wmv1_encoder;
1209 extern AVCodec wmv2_encoder;
1210 extern AVCodec huffyuv_encoder;
1211 extern AVCodec h264_encoder;
1212 extern AVCodec asv1_encoder;
1213
1214 extern AVCodec h263_decoder;
1215 extern AVCodec mpeg4_decoder;
1216 extern AVCodec msmpeg4v1_decoder;
1217 extern AVCodec msmpeg4v2_decoder;
1218 extern AVCodec msmpeg4v3_decoder;
1219 extern AVCodec wmv1_decoder;
1220 extern AVCodec wmv2_decoder;
1221 extern AVCodec mpeg_decoder;
1222 extern AVCodec h263i_decoder;
1223 extern AVCodec rv10_decoder;
1224 extern AVCodec svq1_decoder;
1225 extern AVCodec svq3_decoder;
1226 extern AVCodec dvvideo_decoder;
1227 extern AVCodec dvaudio_decoder;
1228 extern AVCodec wmav1_decoder;
1229 extern AVCodec wmav2_decoder;
1230 extern AVCodec mjpeg_decoder;
1231 extern AVCodec mjpegb_decoder;
1232 extern AVCodec mp2_decoder;
1233 extern AVCodec mp3_decoder;
1234 extern AVCodec mace3_decoder;
1235 extern AVCodec mace6_decoder;
1236 extern AVCodec huffyuv_decoder;
1237 extern AVCodec oggvorbis_decoder;
1238 extern AVCodec cyuv_decoder;
1239 extern AVCodec h264_decoder;
1240 extern AVCodec indeo3_decoder;
1241 extern AVCodec vp3_decoder;
1242 extern AVCodec amr_nb_decoder;
1243 extern AVCodec aac_decoder;
1244 extern AVCodec mpeg4aac_decoder;
1245 extern AVCodec asv1_decoder;
1246
1247 /* pcm codecs */
1248 #define PCM_CODEC(id, name) \
1249 extern AVCodec name ## _decoder; \
1250 extern AVCodec name ## _encoder
1251
1252 PCM_CODEC(CODEC_ID_PCM_S16LE, pcm_s16le);
1253 PCM_CODEC(CODEC_ID_PCM_S16BE, pcm_s16be);
1254 PCM_CODEC(CODEC_ID_PCM_U16LE, pcm_u16le);
1255 PCM_CODEC(CODEC_ID_PCM_U16BE, pcm_u16be);
1256 PCM_CODEC(CODEC_ID_PCM_S8, pcm_s8);
1257 PCM_CODEC(CODEC_ID_PCM_U8, pcm_u8);
1258 PCM_CODEC(CODEC_ID_PCM_ALAW, pcm_alaw);
1259 PCM_CODEC(CODEC_ID_PCM_MULAW, pcm_mulaw);
1260
1261 /* adpcm codecs */
1262
1263 PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
1264 PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
1265 PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);
1266
1267 #undef PCM_CODEC
1268
1269 /* dummy raw video codec */
1270 extern AVCodec rawvideo_encoder;
1271 extern AVCodec rawvideo_decoder;
1272
1273 /* the following codecs use external GPL libs */
1274 extern AVCodec ac3_decoder;
1275
1276 /* resample.c */
1277
1278 struct ReSampleContext;
1279
1280 typedef struct ReSampleContext ReSampleContext;
1281
1282 ReSampleContext *audio_resample_init(int output_channels, int input_channels,
1283                                      int output_rate, int input_rate);
1284 int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
1285 void audio_resample_close(ReSampleContext *s);
1286
1287 /* YUV420 format is assumed ! */
1288
1289 struct ImgReSampleContext;
1290
1291 typedef struct ImgReSampleContext ImgReSampleContext;
1292
1293 ImgReSampleContext *img_resample_init(int output_width, int output_height,
1294                                       int input_width, int input_height);
1295
1296 ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
1297                                       int iwidth, int iheight,
1298                                       int topBand, int bottomBand,
1299                                       int leftBand, int rightBand);
1300
1301 void img_resample(ImgReSampleContext *s,
1302                   AVPicture *output, AVPicture *input);
1303
1304 void img_resample_close(ImgReSampleContext *s);
1305
1306 int avpicture_fill(AVPicture *picture, uint8_t *ptr,
1307                    int pix_fmt, int width, int height);
1308 int avpicture_layout(AVPicture* src, int pix_fmt, int width, int height,
1309                      unsigned char *dest, int dest_size);
1310 int avpicture_get_size(int pix_fmt, int width, int height);
1311 void avcodec_get_chroma_sub_sample(int pix_fmt, int *h_shift, int *v_shift);
1312 const char *avcodec_get_pix_fmt_name(int pix_fmt);
1313 enum PixelFormat avcodec_get_pix_fmt(const char* name);
1314
1315 #define FF_LOSS_RESOLUTION  0x0001 /* loss due to resolution change */
1316 #define FF_LOSS_DEPTH       0x0002 /* loss due to color depth change */
1317 #define FF_LOSS_COLORSPACE  0x0004 /* loss due to color space conversion */
1318 #define FF_LOSS_ALPHA       0x0008 /* loss of alpha bits */
1319 #define FF_LOSS_COLORQUANT  0x0010 /* loss due to color quantization */
1320 #define FF_LOSS_CHROMA      0x0020 /* loss of chroma (e.g. rgb to gray conversion) */
1321
1322 int avcodec_get_pix_fmt_loss(int dst_pix_fmt, int src_pix_fmt,
1323                              int has_alpha);
1324 int avcodec_find_best_pix_fmt(int pix_fmt_mask, int src_pix_fmt,
1325                               int has_alpha, int *loss_ptr);
1326
1327 #define FF_ALPHA_TRANSP       0x0001 /* image has some totally transparent pixels */
1328 #define FF_ALPHA_SEMI_TRANSP  0x0002 /* image has some transparent pixels */
1329 int img_get_alpha_info(AVPicture *src, int pix_fmt, int width, int height);
1330
1331 /* convert among pixel formats */
1332 int img_convert(AVPicture *dst, int dst_pix_fmt,
1333                 AVPicture *src, int pix_fmt,
1334                 int width, int height);
1335
1336 /* deinterlace a picture */
1337 int avpicture_deinterlace(AVPicture *dst, AVPicture *src,
1338                           int pix_fmt, int width, int height);
1339
1340 /* external high level API */
1341
1342 extern AVCodec *first_avcodec;
1343
1344 /* returns LIBAVCODEC_VERSION_INT constant */
1345 unsigned avcodec_version(void);
1346 /* returns LIBAVCODEC_BUILD constant */
1347 unsigned avcodec_build(void);
1348 void avcodec_init(void);
1349
1350 void register_avcodec(AVCodec *format);
1351 AVCodec *avcodec_find_encoder(enum CodecID id);
1352 AVCodec *avcodec_find_encoder_by_name(const char *name);
1353 AVCodec *avcodec_find_decoder(enum CodecID id);
1354 AVCodec *avcodec_find_decoder_by_name(const char *name);
1355 void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
1356
1357 void avcodec_get_context_defaults(AVCodecContext *s);
1358 AVCodecContext *avcodec_alloc_context(void);
1359 AVFrame *avcodec_alloc_frame(void);
1360
1361 int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
1362 void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
1363 void avcodec_default_free_buffers(AVCodecContext *s);
1364
1365 int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
1366 int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples,
1367                          int *frame_size_ptr,
1368                          uint8_t *buf, int buf_size);
1369 int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture,
1370                          int *got_picture_ptr,
1371                          uint8_t *buf, int buf_size);
1372 int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata,
1373                         int *data_size_ptr,
1374                         uint8_t *buf, int buf_size);
1375 int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size,
1376                          const short *samples);
1377 int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size,
1378                          const AVFrame *pict);
1379
1380 int avcodec_close(AVCodecContext *avctx);
1381
1382 void avcodec_register_all(void);
1383
1384 void avcodec_flush_buffers(AVCodecContext *avctx);
1385
1386 /* misc usefull functions */
1387
1388 /**
1389  * returns a single letter to describe the picture type
1390  */
1391 char av_get_pict_type_char(int pict_type);
1392
1393 /**
1394  * reduce a fraction.
1395  * this is usefull for framerate calculations
1396  * @param max the maximum allowed for dst_nom & dst_den
1397  * @return 1 if exact, 0 otherwise
1398  */
1399 int av_reduce(int *dst_nom, int *dst_den, int64_t nom, int64_t den, int64_t max);
1400
1401 /**
1402  * rescale a 64bit integer.
1403  * a simple a*b/c isnt possible as it can overflow
1404  */
1405 int64_t av_rescale(int64_t a, int b, int c);
1406
1407
1408 /**
1409  * Interface for 0.5.0 version
1410  *
1411  * do not even think about it's usage for this moment
1412  */
1413
1414 typedef struct {
1415     /// compressed size used from given memory buffer
1416     int size;
1417     /// I/P/B frame type
1418     int frame_type;
1419 } avc_enc_result_t;
1420
1421 /**
1422  * Commands
1423  * order can't be changed - once it was defined
1424  */
1425 typedef enum {
1426     // general commands
1427     AVC_OPEN_BY_NAME = 0xACA000,
1428     AVC_OPEN_BY_CODEC_ID,
1429     AVC_OPEN_BY_FOURCC,
1430     AVC_CLOSE,
1431
1432     AVC_FLUSH,
1433     // pin - struct { uint8_t* src, uint_t src_size }
1434     // pout - struct { AVPicture* img, consumed_bytes,
1435     AVC_DECODE,
1436     // pin - struct { AVPicture* img, uint8_t* dest, uint_t dest_size }
1437     // pout - uint_t used_from_dest_size
1438     AVC_ENCODE,
1439
1440     // query/get video commands
1441     AVC_GET_VERSION = 0xACB000,
1442     AVC_GET_WIDTH,
1443     AVC_GET_HEIGHT,
1444     AVC_GET_DELAY,
1445     AVC_GET_QUANT_TABLE,
1446     // ...
1447
1448     // query/get audio commands
1449     AVC_GET_FRAME_SIZE = 0xABC000,
1450
1451     // maybe define some simple structure which
1452     // might be passed to the user - but they can't
1453     // contain any codec specific parts and these
1454     // calls are usualy necessary only few times
1455
1456     // set video commands
1457     AVC_SET_WIDTH = 0xACD000,
1458     AVC_SET_HEIGHT,
1459
1460     // set video encoding commands
1461     AVC_SET_FRAME_RATE = 0xACD800,
1462     AVC_SET_QUALITY,
1463     AVC_SET_HURRY_UP,
1464
1465     // set audio commands
1466     AVC_SET_SAMPLE_RATE = 0xACE000,
1467     AVC_SET_CHANNELS,
1468
1469 } avc_cmd_t;
1470
1471 /**
1472  * \param handle  allocated private structure by libavcodec
1473  *                for initialization pass NULL - will be returned pout
1474  *                user is supposed to know nothing about its structure
1475  * \param cmd     type of operation to be performed
1476  * \param pint    input parameter
1477  * \param pout    output parameter
1478  *
1479  * \returns  command status - eventually for query command it might return
1480  * integer resulting value
1481  */
1482 int avcodec(void* handle, avc_cmd_t cmd, void* pin, void* pout);
1483
1484 /* memory */
1485 void *av_malloc(unsigned int size);
1486 void *av_mallocz(unsigned int size);
1487 void *av_realloc(void *ptr, unsigned int size);
1488 void av_free(void *ptr);
1489 char *av_strdup(const char *s);
1490 void __av_freep(void **ptr);
1491 #define av_freep(p) __av_freep((void **)(p))
1492 void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
1493 /* for static data only */
1494 /* call av_free_static to release all staticaly allocated tables */
1495 void av_free_static(void);
1496 void *__av_mallocz_static(void** location, unsigned int size);
1497 #define av_mallocz_static(p, s) __av_mallocz_static((void **)(p), s)
1498
1499 #ifdef __cplusplus
1500 }
1501 #endif
1502
1503 #endif /* AVCODEC_H */