avcodec.h 54 KB
Newer Older
glantau's avatar
glantau committed
1 2 3
#ifndef AVCODEC_H
#define AVCODEC_H

michaelni's avatar
michaelni committed
4 5
/**
 * @file avcodec.h
michaelni's avatar
doxy  
michaelni committed
6
 * external api header.
michaelni's avatar
michaelni committed
7 8 9
 */


kabi's avatar
kabi committed
10 11 12 13
#ifdef __cplusplus
extern "C" {
#endif

glantau's avatar
glantau committed
14
#include "common.h"
michael's avatar
michael committed
15
#include "rational.h"
glantau's avatar
glantau committed
16

bellard's avatar
bellard committed
17 18
#define FFMPEG_VERSION_INT     0x000408
#define FFMPEG_VERSION         "0.4.8"
19
#define LIBAVCODEC_BUILD       4691
20

bellard's avatar
bellard committed
21 22 23 24 25 26
#define LIBAVCODEC_VERSION_INT FFMPEG_VERSION_INT
#define LIBAVCODEC_VERSION     FFMPEG_VERSION

#define AV_STRINGIFY(s)	AV_TOSTRING(s)
#define AV_TOSTRING(s) #s
#define LIBAVCODEC_IDENT	"FFmpeg" LIBAVCODEC_VERSION "b" AV_STRINGIFY(LIBAVCODEC_BUILD)
al3x's avatar
al3x committed
27

glantau's avatar
glantau committed
28 29 30
enum CodecID {
    CODEC_ID_NONE, 
    CODEC_ID_MPEG1VIDEO,
31
    CODEC_ID_MPEG2VIDEO, /* prefered ID for MPEG Video 1 or 2 decoding */
iive's avatar
iive committed
32
    CODEC_ID_MPEG2VIDEO_XVMC,
glantau's avatar
glantau committed
33 34 35
    CODEC_ID_H263,
    CODEC_ID_RV10,
    CODEC_ID_MP2,
36
    CODEC_ID_MP3, /* prefered ID for MPEG Audio layer 1, 2 or3 decoding */
michaelni's avatar
 
michaelni committed
37
    CODEC_ID_VORBIS,
glantau's avatar
glantau committed
38 39
    CODEC_ID_AC3,
    CODEC_ID_MJPEG,
al3x's avatar
al3x committed
40
    CODEC_ID_MJPEGB,
41
    CODEC_ID_LJPEG,
alex's avatar
alex committed
42
    CODEC_ID_SP5X,
glantau's avatar
glantau committed
43
    CODEC_ID_MPEG4,
glantau's avatar
glantau committed
44
    CODEC_ID_RAWVIDEO,
45 46 47
    CODEC_ID_MSMPEG4V1,
    CODEC_ID_MSMPEG4V2,
    CODEC_ID_MSMPEG4V3,
michaelni's avatar
michaelni committed
48
    CODEC_ID_WMV1,
michaelni's avatar
 
michaelni committed
49
    CODEC_ID_WMV2,
glantau's avatar
glantau committed
50 51
    CODEC_ID_H263P,
    CODEC_ID_H263I,
52
    CODEC_ID_FLV1,
nickols_k's avatar
nickols_k committed
53
    CODEC_ID_SVQ1,
michaelni's avatar
michaelni committed
54
    CODEC_ID_SVQ3,
bellard's avatar
bellard committed
55 56
    CODEC_ID_DVVIDEO,
    CODEC_ID_DVAUDIO,
bellard's avatar
bellard committed
57 58
    CODEC_ID_WMAV1,
    CODEC_ID_WMAV2,
59 60
    CODEC_ID_MACE3,
    CODEC_ID_MACE6,
michaelni's avatar
michaelni committed
61
    CODEC_ID_HUFFYUV,
62
    CODEC_ID_CYUV,
michaelni's avatar
michaelni committed
63
    CODEC_ID_H264,
tmmm's avatar
tmmm committed
64
    CODEC_ID_INDEO3,
tmmm's avatar
tmmm committed
65
    CODEC_ID_VP3,
66
    CODEC_ID_THEORA,
67 68
    CODEC_ID_AAC,
    CODEC_ID_MPEG4AAC,
michaelni's avatar
michaelni committed
69
    CODEC_ID_ASV1,
michaelni's avatar
michaelni committed
70
    CODEC_ID_ASV2,
71
    CODEC_ID_FFV1,
tmmm's avatar
tmmm committed
72
    CODEC_ID_4XM,
michaelni's avatar
michaelni committed
73
    CODEC_ID_VCR1,
al3x's avatar
al3x committed
74
    CODEC_ID_CLJR,
75
    CODEC_ID_MDEC,
76 77
    CODEC_ID_ROQ,
    CODEC_ID_INTERPLAY_VIDEO,
78 79
    CODEC_ID_XAN_WC3,
    CODEC_ID_XAN_WC4,
80 81 82 83 84
    CODEC_ID_RPZA,
    CODEC_ID_CINEPAK,
    CODEC_ID_WS_VQA,
    CODEC_ID_MSRLE,
    CODEC_ID_MSVIDEO1,
tmmm's avatar
tmmm committed
85
    CODEC_ID_IDCIN,
glantau's avatar
glantau committed
86 87 88 89 90 91 92 93 94 95

    /* 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,
96 97 98 99

    /* various adpcm codecs */
    CODEC_ID_ADPCM_IMA_QT,
    CODEC_ID_ADPCM_IMA_WAV,
100 101
    CODEC_ID_ADPCM_IMA_DK3,
    CODEC_ID_ADPCM_IMA_DK4,
102
    CODEC_ID_ADPCM_IMA_WS,
103
    CODEC_ID_ADPCM_MS,
tmmm's avatar
tmmm committed
104
    CODEC_ID_ADPCM_4XM,
105 106
    CODEC_ID_ADPCM_XA,
    CODEC_ID_ADPCM_ADX,
107 108 109

	/* AMR */
    CODEC_ID_AMR_NB,
110 111
    CODEC_ID_AMR_WB,

112 113 114
    /* RealAudio codecs*/
    CODEC_ID_RA_144,
    CODEC_ID_RA_288,
115 116 117 118

    /* various DPCM codecs */
    CODEC_ID_ROQ_DPCM,
    CODEC_ID_INTERPLAY_DPCM,
119
    CODEC_ID_XAN_DPCM,
120 121 122
    
    CODEC_ID_MPEG2TS, /* _FAKE_ codec to indicate a raw MPEG2 transport
                         stream (only used by libavformat) */
glantau's avatar
glantau committed
123
};
124 125 126

/* CODEC_ID_MP3LAME is absolete */
#define CODEC_ID_MP3LAME CODEC_ID_MP3
glantau's avatar
glantau committed
127 128

enum CodecType {
129
    CODEC_TYPE_UNKNOWN = -1,
glantau's avatar
glantau committed
130 131
    CODEC_TYPE_VIDEO,
    CODEC_TYPE_AUDIO,
132
    CODEC_TYPE_DATA,
glantau's avatar
glantau committed
133 134
};

135
/**
tmmm's avatar
tmmm committed
136 137 138 139 140 141 142 143 144 145 146 147
 * Pixel format. Notes: 
 *
 * PIX_FMT_RGBA32 is handled in an endian-specific manner. A RGBA
 * color is put together as:
 *  (A << 24) | (R << 16) | (G << 8) | B
 * This is stored as BGRA on little endian CPU architectures and ARGB on
 * big endian CPUs.
 *
 * When the pixel format is palettized RGB (PIX_FMT_PAL8), the palettized
 * image data is stored in AVFrame.data[0]. The palette is transported in
 * AVFrame.data[1] and, is 1024 bytes long (256 4-byte entries) and is
 * formatted the same as in PIX_FMT_RGBA32 described above (i.e., it is
148 149 150 151
 * also endian-specific). Note also that the individual RGB palette
 * components stored in AVFrame.data[1] should be in the range 0..255.
 * This is important as many custom PAL8 video codecs that were designed
 * to run on the IBM VGA graphics adapter use 6-bit palette components.
152
 */
glantau's avatar
glantau committed
153
enum PixelFormat {
michaelni's avatar
michaelni committed
154 155 156 157 158 159
    PIX_FMT_YUV420P,   ///< Planar YUV 4:2:0 (1 Cr & Cb sample per 2x2 Y samples)
    PIX_FMT_YUV422,    
    PIX_FMT_RGB24,     ///< Packed pixel, 3 bytes per pixel, RGBRGB...
    PIX_FMT_BGR24,     ///< Packed pixel, 3 bytes per pixel, BGRBGR...
    PIX_FMT_YUV422P,   ///< Planar YUV 4:2:2 (1 Cr & Cb sample per 2x1 Y samples)
    PIX_FMT_YUV444P,   ///< Planar YUV 4:4:4 (1 Cr & Cb sample per 1x1 Y samples)
tmmm's avatar
tmmm committed
160
    PIX_FMT_RGBA32,    ///< Packed pixel, 4 bytes per pixel, BGRABGRA..., stored in cpu endianness
michaelni's avatar
michaelni committed
161 162
    PIX_FMT_YUV410P,   ///< Planar YUV 4:1:0 (1 Cr & Cb sample per 4x4 Y samples)
    PIX_FMT_YUV411P,   ///< Planar YUV 4:1:1 (1 Cr & Cb sample per 4x1 Y samples)
163 164
    PIX_FMT_RGB565,    ///< always stored in cpu endianness 
    PIX_FMT_RGB555,    ///< always stored in cpu endianness, most significant bit to 1 
165
    PIX_FMT_GRAY8,
166 167 168
    PIX_FMT_MONOWHITE, ///< 0 is white 
    PIX_FMT_MONOBLACK, ///< 0 is black 
    PIX_FMT_PAL8,      ///< 8 bit with RGBA palette 
michaelni's avatar
michaelni committed
169 170 171
    PIX_FMT_YUVJ420P,  ///< Planar YUV 4:2:0 full scale (jpeg)
    PIX_FMT_YUVJ422P,  ///< Planar YUV 4:2:2 full scale (jpeg)
    PIX_FMT_YUVJ444P,  ///< Planar YUV 4:4:4 full scale (jpeg)
iive's avatar
iive committed
172 173
    PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing(xvmc_render.h)
    PIX_FMT_XVMC_MPEG2_IDCT,
174
    PIX_FMT_NB,
glantau's avatar
glantau committed
175 176
};

glantau's avatar
glantau committed
177 178
/* currently unused, may be used if 24/32 bits samples ever supported */
enum SampleFormat {
179
    SAMPLE_FMT_S16 = 0,         ///< signed 16 bits 
glantau's avatar
glantau committed
180 181
};

glantau's avatar
glantau committed
182
/* in bytes */
bellard's avatar
bellard committed
183
#define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
glantau's avatar
glantau committed
184

185
/**
186 187 188 189 190
 * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
 * this is mainly needed because some optimized bitstream readers read 
 * 32 or 64 bit at once and could read over the end<br>
 * Note, if the first 23 bits of the additional bytes are not 0 then damaged
 * MPEG bitstreams could cause overread and segfault
191 192 193
 */
#define FF_INPUT_BUFFER_PADDING_SIZE 8

194 195
/* motion estimation type, EPZS by default */
enum Motion_Est_ID {
196
    ME_ZERO = 1,
197 198 199 200 201 202 203
    ME_FULL,
    ME_LOG,
    ME_PHODS,
    ME_EPZS,
    ME_X1
};

michaelni's avatar
michaelni committed
204 205 206 207 208 209 210
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;

211 212 213
/* only for ME compatiblity with old apps */
extern int motion_estimation_method;

214
/* ME algos sorted by quality */
michaelni's avatar
michaelni committed
215
//FIXME remove IMHO
216 217
static const __attribute__((unused)) int Motion_Est_QTab[] =
 { ME_ZERO, ME_PHODS, ME_LOG, ME_X1, ME_EPZS, ME_FULL };
glantau's avatar
glantau committed
218

219

michaelni's avatar
michaelni committed
220
#define FF_MAX_B_FRAMES 8
221

michaelni's avatar
michaelni committed
222 223 224 225
/* encoding support
   these flags can be passed in AVCodecContext.flags before initing 
   Note: note not everything is supported yet 
*/
glantau's avatar
glantau committed
226

227 228 229 230
#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 
231
#define CODEC_FLAG_MV0    0x0040  ///< always try a MB with MV=<0,0> 
232
#define CODEC_FLAG_PART   0x0080  ///< use data partitioning 
233 234
/* 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 */
michaelni's avatar
michaelni committed
235
#define CODEC_FLAG_INPUT_PRESERVED 0x0100
236 237 238 239 240 241 242
#define CODEC_FLAG_PASS1 0x0200   ///< use internal 2pass ratecontrol in first  pass mode 
#define CODEC_FLAG_PASS2 0x0400   ///< use internal 2pass ratecontrol in second pass mode 
#define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< use external huffman table (for mjpeg) 
#define CODEC_FLAG_GRAY  0x2000   ///< only decode/encode grayscale 
#define CODEC_FLAG_EMU_EDGE 0x4000///< dont draw edges 
#define CODEC_FLAG_PSNR           0x8000 ///< error[?] variables will be set during encoding 
#define CODEC_FLAG_TRUNCATED  0x00010000 /** input bitstream might be truncated at a random location instead 
243
                                            of only at frame boundaries */
244 245
#define CODEC_FLAG_NORMALIZE_AQP  0x00020000 ///< normalize adaptive quantization 
#define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< use interlaced dct 
246
#define CODEC_FLAG_LOW_DELAY      0x00080000 ///< force low delay
247 248 249 250
#define CODEC_FLAG_ALT_SCAN       0x00100000 ///< use alternate scan 
#define CODEC_FLAG_TRELLIS_QUANT  0x00200000 ///< use trellis quantization 
#define CODEC_FLAG_GLOBAL_HEADER  0x00400000 ///< place global headers in extradata instead of every keyframe 
#define CODEC_FLAG_BITEXACT       0x00800000 ///< use only bitexact stuff (except (i)dct) 
251
/* Fx : Flag for h263+ extra options */
michaelni's avatar
michaelni committed
252 253
#define CODEC_FLAG_H263P_AIC      0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction (remove this)
#define CODEC_FLAG_AC_PRED        0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction
254
#define CODEC_FLAG_H263P_UMV      0x02000000 ///< Unlimited motion vector  
255
#define CODEC_FLAG_CBP_RD         0x04000000 ///< use rate distortion optimization for cbp
256 257 258 259 260 261 262 263 264 265
/* For advanced prediction mode, we reuse the 4MV flag */
/* Unsupported options :
 * 		Syntax Arithmetic coding (SAC)
 * 		Deblocking filter internal loop
 * 		Slice structured
 * 		Reference Picture Selection
 * 		Independant Segment Decoding
 * 		Alternative Inter * 		VLC
 * 		Modified Quantization */
/* /Fx */
glantau's avatar
glantau committed
266 267
/* codec capabilities */

268
#define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< decoder can use draw_horiz_band callback 
michaelni's avatar
michaelni committed
269 270 271 272 273
/**
 * Codec uses get_buffer() for allocating buffers.
 * direct rendering method 1
 */
#define CODEC_CAP_DR1             0x0002
274 275 276
/* if 'parse_only' field is true, then avcodec_parse_frame() can be
   used */
#define CODEC_CAP_PARSE_ONLY      0x0004
277
#define CODEC_CAP_TRUNCATED       0x0008
278 279 280 281
/*
 * Codec can use conditional replenishment if available.
 */
#define CODEC_CAP_CR              0x0010
glantau's avatar
glantau committed
282

283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310
/**
 * Pan Scan area.
 * this specifies the area which should be displayed. Note there may be multiple such areas for one frame
 */
typedef struct AVPanScan{
    /**
     * id.
     * - encoding: set by user.
     * - decoding: set by lavc
     */
    int id;

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

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

michaelni's avatar
michaelni committed
311
#define FF_COMMON_FRAME \
michaelni's avatar
michaelni committed
312 313 314 315 316 317
    /**\
     * pointer to the picture planes.\
     * this might be different from the first allocated byte\
     * - encoding: \
     * - decoding: \
     */\
michaelni's avatar
michaelni committed
318 319 320
    uint8_t *data[4];\
    int linesize[4];\
    /**\
michaelni's avatar
michaelni committed
321
     * pointer to the first allocated byte of the picture. can be used in get_buffer/release_buffer\
michaelni's avatar
michaelni committed
322
     * this isnt used by lavc unless the default get/release_buffer() is used\
323 324
     * - encoding: \
     * - decoding: \
michaelni's avatar
michaelni committed
325 326 327 328
     */\
    uint8_t *base[4];\
    /**\
     * 1 -> keyframe, 0-> not\
329 330
     * - encoding: set by lavc\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
331 332 333 334
     */\
    int key_frame;\
\
    /**\
michaelni's avatar
michaelni committed
335
     * picture type of the frame, see ?_TYPE below.\
336 337
     * - encoding: set by lavc for coded_picture (and set by user for input)\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
338 339 340 341 342 343
     */\
    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\
344 345
     * - encoding: MUST be set by user\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
346
     */\
347
    int64_t pts;\
michaelni's avatar
michaelni committed
348 349 350
\
    /**\
     * picture number in bitstream order.\
351 352
     * - encoding: set by\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
353 354 355 356
     */\
    int coded_picture_number;\
    /**\
     * picture number in display order.\
357 358
     * - encoding: set by\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
359 360 361 362
     */\
    int display_picture_number;\
\
    /**\
363
     * quality (between 1 (good) and FF_LAMBDA_MAX (bad)) \
364 365
     * - encoding: set by lavc for coded_picture (and set by user for input)\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
366
     */\
367
    int quality; \
michaelni's avatar
michaelni committed
368 369 370
\
    /**\
     * buffer age (1->was last buffer and dint change, 2->..., ...).\
371
     * set to INT_MAX if the buffer has not been used yet \
372 373
     * - encoding: unused\
     * - decoding: MUST be set by get_buffer()\
michaelni's avatar
michaelni committed
374 375 376 377 378
     */\
    int age;\
\
    /**\
     * is this picture used as reference\
379 380
     * - encoding: unused\
     * - decoding: set by lavc (before get_buffer() call))\
michaelni's avatar
michaelni committed
381 382 383 384 385
     */\
    int reference;\
\
    /**\
     * QP table\
386 387
     * - encoding: unused\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
388 389 390 391
     */\
    int8_t *qscale_table;\
    /**\
     * QP store stride\
392 393
     * - encoding: unused\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
394 395 396 397 398 399
     */\
    int qstride;\
\
    /**\
     * mbskip_table[mb]>=1 if MB didnt change\
     * stride= mb_width = (width+15)>>4\
400 401
     * - encoding: unused\
     * - decoding: set by lavc\
michaelni's avatar
michaelni committed
402 403 404 405 406
     */\
    uint8_t *mbskip_table;\
\
    /**\
     * for some private data of the user\
407 408
     * - encoding: unused\
     * - decoding: set by user\
michaelni's avatar
michaelni committed
409 410
     */\
    void *opaque;\
411 412 413
\
    /**\
     * error\
414 415
     * - encoding: set by lavc if flags&CODEC_FLAG_PSNR\
     * - decoding: unused\
416 417
     */\
    uint64_t error[4];\
michaelni's avatar
michaelni committed
418 419 420
\
    /**\
     * type of the buffer (to keep track of who has to dealloc data[*])\
421 422
     * - encoding: set by the one who allocs it\
     * - decoding: set by the one who allocs it\
mellum's avatar
mellum committed
423
     * Note: user allocated (direct rendering) & internal buffers can not coexist currently\
michaelni's avatar
michaelni committed
424 425
     */\
    int type;\
426 427 428 429
    \
    /**\
     * when decoding, this signal how much the picture must be delayed.\
     * extra_delay = repeat_pict / (2*fps)\
430 431
     * - encoding: unused\
     * - decoding: set by lavc\
432
     */\
michaelni's avatar
michaelni committed
433 434 435 436 437 438
    int repeat_pict;\
    \
    /**\
     * \
     */\
    int qscale_type;\
romansh's avatar
 
romansh committed
439 440 441 442 443 444 445 446 447
    \
    /**\
     * The content of the picture is interlaced.\
     * - encoding: set by user\
     * - decoding: set by lavc (default 0)\
     */\
    int interlaced_frame;\
    \
    /**\
448
     * if the content is interlaced, is top field displayed first.\
romansh's avatar
 
romansh committed
449
     * - encoding: set by user\
450
     * - decoding: set by lavc\
romansh's avatar
 
romansh committed
451
     */\
452
    int top_field_first;\
453 454 455 456 457 458 459
    \
    /**\
     * Pan scan.\
     * - encoding: set by user\
     * - decoding: set by lavc\
     */\
    AVPanScan *pan_scan;\
460 461 462 463 464 465 466
    \
    /**\
     * tell user application that palette has changed from previous frame.\
     * - encoding: ??? (no palette-enabled encoder yet)\
     * - decoding: set by lavc (default 0)\
     */\
    int palette_has_changed;\
467 468 469 470 471 472 473
    \
    /**\
     * Codec suggestion on buffer type if != 0\
     * - encoding: unused\
     * - decoding: set by lavc (before get_buffer() call))\
     */\
    int buffer_hints;\
474

michaelni's avatar
michaelni committed
475 476
#define FF_QSCALE_TYPE_MPEG1	0
#define FF_QSCALE_TYPE_MPEG2	1
michaelni's avatar
michaelni committed
477 478

#define FF_BUFFER_TYPE_INTERNAL 1
michaelni's avatar
michaelni committed
479 480 481
#define FF_BUFFER_TYPE_USER     2 ///< Direct rendering buffers (image is (de)allocated by user)
#define FF_BUFFER_TYPE_SHARED   4 ///< buffer from somewher else, dont dealloc image (data/base)
#define FF_BUFFER_TYPE_COPY     8 ///< just a (modified) copy of some other buffer, dont dealloc anything
michaelni's avatar
michaelni committed
482

michaelni's avatar
michaelni committed
483

484 485 486 487
#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
michaelni's avatar
michaelni committed
488 489
#define FF_SI_TYPE 5
#define FF_SP_TYPE 6
michaelni's avatar
michaelni committed
490

491 492 493 494 495
#define FF_BUFFER_HINTS_VALID    0x01 // Buffer hints value is meaningful (if 0 ignore)
#define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer
#define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content
#define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update)

michaelni's avatar
michaelni committed
496 497 498
/**
 * Audio Video Frame.
 */
michaelni's avatar
michaelni committed
499 500 501
typedef struct AVFrame {
    FF_COMMON_FRAME
} AVFrame;
michaelni's avatar
michaelni committed
502

503
#define DEFAULT_FRAME_RATE_BASE 1001000
michaelni's avatar
doxy  
michaelni committed
504 505 506 507

/**
 * main external api structure.
 */
glantau's avatar
glantau committed
508
typedef struct AVCodecContext {
509
    /**
510 511 512
     * 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 
513
     */
glantau's avatar
glantau committed
514
    int bit_rate;
515 516

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

    /**
525 526 527
     * CODEC_FLAG_*.
     * - encoding: set by user.
     * - decoding: set by user.
528
     */
glantau's avatar
glantau committed
529
    int flags;
530 531 532

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

    /**
539 540 541
     * motion estimation algorithm used for video coding.
     * - encoding: MUST be set by user.
     * - decoding: unused
542 543 544 545
     */
    int me_method;

    /**
546
     * some codecs need / can use extra-data like huffman tables.
547 548
     * mjpeg: huffman tables
     * rv10: additional flags
549
     * mpeg4: global headers (they can be in the bitstream or here)
550 551
     * - encoding: set/allocated/freed by lavc.
     * - decoding: set/allocated/freed by user.
552
     */
553 554 555
    void *extradata;
    int extradata_size;
    
glantau's avatar
glantau committed
556
    /* video only */
557
    /**
558
     * frames per sec multiplied by frame_rate_base.
559
     * for variable fps this is the precission, so if the timestamps 
560
     * can be specified in msec precssion then this is 1000*frame_rate_base
561 562
     * - encoding: MUST be set by user
     * - decoding: set by lavc. 0 or the frame_rate if available
563 564
     */
    int frame_rate;
565
    
566
    /**
567 568
     * width / height.
     * - encoding: MUST be set by user. 
michael's avatar
michael committed
569
     * - decoding: set by user if known, codec should override / dynamically change if needed
570
     */
glantau's avatar
glantau committed
571
    int width, height;
572
    
michaelni's avatar
michaelni committed
573 574 575 576 577
#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
578
#define FF_ASPECT_EXTENDED 15
579 580

    /**
581 582 583
     * the number of pictures in a group of pitures, or 0 for intra_only.
     * - encoding: set by user.
     * - decoding: unused
584 585 586 587
     */
    int gop_size;

    /**
588
     * pixel format, see PIX_FMT_xxx.
romansh's avatar
 
romansh committed
589 590 591 592
     * - encoding: FIXME: used by ffmpeg to decide whether an pix_fmt
     *                    conversion is in order. This only works for
     *                    codecs with one supported pix_fmt, we should
     *                    do something for a generic case as well.
593
     * - decoding: set by lavc.
594
     */
595
    enum PixelFormat pix_fmt;
596 597 598 599 600 601 602 603 604
 
    /**
     * Frame rate emulation. If not zero lower layer (i.e. format handler) 
     * has to read frames at native frame rate.
     * - encoding: set by user.
     * - decoding: unused.
     */
    int rate_emu;
       
605 606 607 608 609
    /**
     * 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
610 611
     * - encoding: unused
     * - decoding: set by user.
612 613 614 615
     * @param height the height of the slice
     * @param y the y position of the slice
     * @param type 1->top field, 2->bottom field, 3->frame
     * @param offset offset into the AVFrame.data from which the slice should be read
616
     */
glantau's avatar
glantau committed
617
    void (*draw_horiz_band)(struct AVCodecContext *s,
618
                            const AVFrame *src, int offset[4],
619
                            int y, int type, int height);
glantau's avatar
glantau committed
620

glantau's avatar
glantau committed
621
    /* audio only */
622
    int sample_rate; ///< samples per sec 
glantau's avatar
glantau committed
623
    int channels;
624
    int sample_fmt;  ///< sample format, currenly unused 
glantau's avatar
glantau committed
625 626

    /* the following data should not be initialized */
627 628 629
    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 
michaelni's avatar
michaelni committed
630
    
631 632
    /**
     * number of frames the decoded output will be delayed relative to 
633 634 635
     * the encoded input.
     * - encoding: set by lavc.
     * - decoding: unused
636 637
     */
    int delay;
michaelni's avatar
michaelni committed
638
    
639 640 641
    /* - encoding parameters */
    float qcompress;  ///< amount of qscale change between easy & hard scenes (0.0-1.0)
    float qblur;      ///< amount of qscale smoothing over time (0.0-1.0) 
642 643
    
    /**
644 645 646
     * minimum quantizer.
     * - encoding: set by user.
     * - decoding: unused
647 648 649 650
     */
    int qmin;

    /**
651 652 653
     * maximum quantizer.
     * - encoding: set by user.
     * - decoding: unused
654 655 656 657
     */
    int qmax;

    /**
658 659 660
     * maximum quantizer difference etween frames.
     * - encoding: set by user.
     * - decoding: unused
661 662 663 664
     */
    int max_qdiff;

    /**
665
     * maximum number of b frames between non b frames.
666
     * note: the output will be delayed by max_b_frames+1 relative to the input
667 668
     * - encoding: set by user.
     * - decoding: unused
669 670 671 672
     */
    int max_b_frames;

    /**
673 674 675
     * qscale factor between ip and b frames.
     * - encoding: set by user.
     * - decoding: unused
676 677 678 679 680
     */
    float b_quant_factor;
    
    /** obsolete FIXME remove */
    int rc_strategy;
michaelni's avatar
michaelni committed
681
    int b_frame_strategy;
682

683
    /**
684 685 686
     * hurry up amount.
     * - encoding: unused
     * - decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too, 5-> skip everything except header
687 688
     */
    int hurry_up;
689
    
glantau's avatar
glantau committed
690
    struct AVCodec *codec;
691
    
glantau's avatar
glantau committed
692 693
    void *priv_data;

694
    /* The following data is for RTP friendly coding */
michaelni's avatar
 
michaelni committed
695
    /* By now only H.263/H.263+/MPEG4 coder honours this   */
696 697 698 699 700 701 702 703 704 705
    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    */
706 707 708 709 710 711 712 713

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

michaelni's avatar
michaelni committed
714 715 716 717 718 719 720 721
    /* 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;
722 723 724
    int misc_bits;
    
    /**
725 726
     * number of bits used for the previously encoded frame.
     * - encoding: set by lavc
michaelni's avatar
michaelni committed
727
     * - decoding: unused
728
     */
michaelni's avatar
michaelni committed
729
    int frame_bits;
michaelni's avatar
michaelni committed
730

731
    /**
732 733 734
     * private data of the user, can be used to carry app specific stuff.
     * - encoding: set by user
     * - decoding: set by user
735 736 737
     */
    void *opaque;

glantau's avatar
glantau committed
738
    char codec_name[32];
739 740
    enum CodecType codec_type; /* see CODEC_TYPE_xxx */
    enum CodecID codec_id; /* see CODEC_ID_xxx */
michaelni's avatar
michaelni committed
741 742 743 744
    
    /**
     * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
     * this is used to workaround some encoder bugs
michaelni's avatar
michaelni committed
745
     * - encoding: set by user, if not then the default based on codec_id will be used
michaelni's avatar
michaelni committed
746 747 748
     * - decoding: set by user, will be converted to upper case by lavc during init
     */
    unsigned int codec_tag;
michaelni's avatar
 
michaelni committed
749
    
750
    /**
751 752 753
     * workaround bugs in encoders which sometimes cannot be detected automatically.
     * - encoding: unused
     * - decoding: set by user
754 755
     */
    int workaround_bugs;
756
#define FF_BUG_AUTODETECT       1  ///< autodetection
757 758 759 760
#define FF_BUG_OLD_MSMPEG4      2
#define FF_BUG_XVID_ILACE       4
#define FF_BUG_UMP4             8
#define FF_BUG_NO_PADDING       16
761
#define FF_BUG_AC_VLC           0  ///< will be removed, libavcodec can now handle these non compliant files by default
michaelni's avatar
michaelni committed
762
#define FF_BUG_QPEL_CHROMA      64
michaelni's avatar
michaelni committed
763
#define FF_BUG_STD_QPEL         128
michaelni's avatar
michaelni committed
764
#define FF_BUG_QPEL_CHROMA2     256
765
#define FF_BUG_DIRECT_BLOCKSIZE 512
766
#define FF_BUG_EDGE             1024
767 768
//#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
        
769
    /**
770 771 772
     * luma single coeff elimination threshold.
     * - encoding: set by user
     * - decoding: unused
773
     */
michaelni's avatar
 
michaelni committed
774
    int luma_elim_threshold;
775 776
    
    /**
777 778 779
     * chroma single coeff elimination threshold.
     * - encoding: set by user
     * - decoding: unused
780
     */
michaelni's avatar
 
michaelni committed
781
    int chroma_elim_threshold;
782 783
    
    /**
784 785 786
     * strictly follow the std (MPEG4, ...).
     * - encoding: set by user
     * - decoding: unused
787 788 789 790
     */
    int strict_std_compliance;
    
    /**
791
     * qscale offset between ip and b frames.
792 793
     * 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)
794 795
     * - encoding: set by user.
     * - decoding: unused
796 797 798 799
     */
    float b_quant_offset;
    
    /**
800
     * error resilience higher values will detect more errors but may missdetect
801 802 803
     * some more or less valid parts as errors.
     * - encoding: unused
     * - decoding: set by user
804
     */
michaelni's avatar
 
michaelni committed
805
    int error_resilience;
806 807 808 809
#define FF_ER_CAREFULL        1
#define FF_ER_COMPLIANT       2
#define FF_ER_AGGRESSIVE      3
#define FF_ER_VERY_AGGRESSIVE 4
810
    
811
    /**
michaelni's avatar
michaelni committed
812 813
     * 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
814
     * width and height should be rounded up to the next multiple of 16
815 816
     * - encoding: unused
     * - decoding: set by lavc, user can override
817
     */
michaelni's avatar
michaelni committed
818
    int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
819 820
    
    /**
michaelni's avatar
michaelni committed
821 822 823
     * 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
824 825
     * - encoding: unused
     * - decoding: set by lavc, user can override
826
     */
michaelni's avatar
michaelni committed
827
    void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
michaelni's avatar
michaelni committed
828

829
    /**
830 831 832
     * is 1 if the decoded stream contains b frames, 0 otherwise.
     * - encoding: unused
     * - decoding: set by lavc
833 834 835
     */
    int has_b_frames;
    
836
    int block_align; ///< used by some WAV based audio codecs
michaelni's avatar
michaelni committed
837
    
838
    int parse_only; /* - decoding only: if true, only parsing is done
839 840
                       (function avcodec_parse_frame()). The frame
                       data is returned. Only MPEG codecs support this now. */
michaelni's avatar
michaelni committed
841
    
842
    /**
843
     * 0-> h263 quant 1-> mpeg quant.
844 845
     * - encoding: set by user.
     * - decoding: unused
846 847
     */
    int mpeg_quant;
michaelni's avatar
michaelni committed
848
    
849
    /**
850 851 852
     * pass1 encoding statistics output buffer.
     * - encoding: set by lavc
     * - decoding: unused
853
     */
854
    char *stats_out;
855 856 857 858
    
    /**
     * pass2 encoding statistics input buffer.
     * concatenated stuff from stats_out of pass1 should be placed here
859 860
     * - encoding: allocated/set/freed by user
     * - decoding: unused
861 862 863 864
     */
    char *stats_in;
    
    /**
865
     * ratecontrol qmin qmax limiting method.
866
     * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
867 868
     * - encoding: set by user.
     * - decoding: unused
869
     */
michaelni's avatar
michaelni committed
870
    float rc_qsquish;
871

michaelni's avatar
michaelni committed
872 873
    float rc_qmod_amp;
    int rc_qmod_freq;
874 875
    
    /**
876 877 878
     * ratecontrol override, see RcOverride.
     * - encoding: allocated/set/freed by user.
     * - decoding: unused
879
     */
michaelni's avatar
michaelni committed
880 881
    RcOverride *rc_override;
    int rc_override_count;
882 883
    
    /**
884 885 886
     * rate control equation.
     * - encoding: set by user
     * - decoding: unused
887
     */
michaelni's avatar
michaelni committed
888
    char *rc_eq;
889 890
    
    /**
891 892 893
     * maximum bitrate.
     * - encoding: set by user.
     * - decoding: unused
894
     */
michaelni's avatar
michaelni committed
895
    int rc_max_rate;
896 897
    
    /**
898 899 900
     * minimum bitrate.
     * - encoding: set by user.
     * - decoding: unused
901
     */
michaelni's avatar
michaelni committed
902
    int rc_min_rate;
903 904
    
    /**
905 906 907
     * decoder bitstream buffer size.
     * - encoding: set by user.
     * - decoding: unused
908
     */
michaelni's avatar
michaelni committed
909 910
    int rc_buffer_size;
    float rc_buffer_aggressivity;
911 912

    /**
913 914 915
     * qscale factor between p and i frames.
     * - encoding: set by user.
     * - decoding: unused
916 917 918 919
     */
    float i_quant_factor;
    
    /**
920
     * qscale offset between p and i frames.
921 922
     * 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)
923 924
     * - encoding: set by user.
     * - decoding: unused
925 926 927 928
     */
    float i_quant_offset;
    
    /**
929 930 931
     * initial complexity for pass1 ratecontrol.
     * - encoding: set by user.
     * - decoding: unused
932
     */
michaelni's avatar
michaelni committed
933
    float rc_initial_cplx;
934

935
    /**
936 937 938
     * dct algorithm, see FF_DCT_* below.
     * - encoding: set by user
     * - decoding: unused
939
     */
940
    int dct_algo;
941
#define FF_DCT_AUTO    0
942
#define FF_DCT_FASTINT 1
943 944 945
#define FF_DCT_INT     2
#define FF_DCT_MMX     3
#define FF_DCT_MLIB    4
946
#define FF_DCT_ALTIVEC 5
michael's avatar
michael committed
947
#define FF_DCT_FAAN    6
948 949
    
    /**
950 951 952
     * luminance masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
953 954 955 956
     */
    float lumi_masking;
    
    /**
957 958 959
     * temporary complexity masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
960 961 962 963
     */
    float temporal_cplx_masking;
    
    /**
964 965 966
     * spatial complexity masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
967 968 969 970
     */
    float spatial_cplx_masking;
    
    /**
971 972 973
     * p block masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
974 975
     */
    float p_masking;
976

977
    /**
978 979 980
     * darkness masking (0-> disabled).
     * - encoding: set by user
     * - decoding: unused
981 982
     */
    float dark_masking;
983
    
984 985 986 987
    
    /* for binary compatibility */
    int unused;
    
988
    /**
989 990 991
     * idct algorithm, see FF_IDCT_* below.
     * - encoding: set by user
     * - decoding: set by user
992 993 994 995 996 997 998 999 1000 1001
     */
    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
1002
#define FF_IDCT_ALTIVEC      8
1003
#define FF_IDCT_SH4          9
1004
#define FF_IDCT_SIMPLEARM    10
1005

1006
    /**
1007 1008 1009
     * slice count.
     * - encoding: set by lavc
     * - decoding: set by user (or 0)
1010 1011 1012
     */
    int slice_count;
    /**
1013 1014 1015
     * slice offsets in the frame in bytes.
     * - encoding: set/allocated by lavc
     * - decoding: set/allocated by user (or NULL)
1016 1017 1018
     */
    int *slice_offset;

1019
    /**
1020 1021 1022
     * error concealment flags.
     * - encoding: unused
     * - decoding: set by user
1023 1024 1025 1026 1027
     */
    int error_concealment;
#define FF_EC_GUESS_MVS   1
#define FF_EC_DEBLOCK     2

kabi's avatar
kabi committed
1028
    /**
kabi's avatar
kabi committed
1029
     * dsp_mask could be add used to disable unwanted CPU features
kabi's avatar
kabi committed
1030
     * CPU features (i.e. MMX, SSE. ...)
kabi's avatar
kabi committed
1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045
     *
     * with FORCE flag you may instead enable given CPU features
     * (Dangerous: usable in case of misdetection, improper usage however will
     * result into program crash)
     */
    unsigned dsp_mask;
#define FF_MM_FORCE	0x80000000 /* force usage of selected flags (OR) */
    /* lower 16 bits - CPU features */
#ifdef HAVE_MMX
#define FF_MM_MMX	0x0001 /* standard MMX */
#define FF_MM_3DNOW	0x0004 /* AMD 3DNOW */
#define FF_MM_MMXEXT	0x0002 /* SSE integer functions or AMD MMX ext */
#define FF_MM_SSE	0x0008 /* SSE functions */
#define FF_MM_SSE2	0x0010 /* PIV SSE2 functions */
#endif /* HAVE_MMX */
michaelni's avatar
michaelni committed
1046 1047

    /**
1048 1049 1050
     * bits per sample/pixel from the demuxer (needed for huffyuv).
     * - encoding: set by lavc
     * - decoding: set by user
michaelni's avatar
michaelni committed
1051 1052 1053 1054
     */
     int bits_per_sample;
    
    /**
1055 1056 1057
     * prediction method (needed for huffyuv).
     * - encoding: set by user
     * - decoding: unused
michaelni's avatar
michaelni committed
1058 1059 1060 1061 1062
     */
     int prediction_method;
#define FF_PRED_LEFT   0
#define FF_PRED_PLANE  1
#define FF_PRED_MEDIAN 2
michaelni's avatar
michaelni committed
1063 1064
    
    /**
michael's avatar
michael committed
1065
     * sample aspect ratio (0 if unknown).
1066 1067
     * - encoding: set by user.
     * - decoding: set by lavc.
michaelni's avatar
michaelni committed
1068
     */
michael's avatar
michael committed
1069
    AVRational sample_aspect_ratio;
michaelni's avatar
michaelni committed
1070 1071

    /**
1072 1073 1074
     * the picture in the bitstream.
     * - encoding: set by lavc
     * - decoding: set by lavc
michaelni's avatar
michaelni committed
1075
     */
michaelni's avatar
michaelni committed
1076
    AVFrame *coded_frame;
michaelni's avatar
michaelni committed
1077 1078

    /**
1079 1080 1081
     * debug.
     * - encoding: set by user.
     * - decoding: set by user.
michaelni's avatar
michaelni committed
1082 1083 1084 1085 1086 1087 1088 1089
     */
    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
michaelni's avatar
michaelni committed
1090 1091 1092 1093
#define FF_DEBUG_VIS_MV    0x00000040
#define FF_DEBUG_SKIP      0x00000080
#define FF_DEBUG_STARTCODE 0x00000100
#define FF_DEBUG_PTS       0x00000200
1094
#define FF_DEBUG_ER        0x00000400
michaelni's avatar
michaelni committed
1095
#define FF_DEBUG_MMCO      0x00000800
michaelni's avatar
michaelni committed
1096
#define FF_DEBUG_BUGS      0x00001000
1097 1098
    
    /**
1099 1100 1101
     * error.
     * - encoding: set by lavc if flags&CODEC_FLAG_PSNR
     * - decoding: unused
1102 1103
     */
    uint64_t error[4];
michaelni's avatar
michaelni committed
1104 1105
    
    /**
1106 1107 1108
     * minimum MB quantizer.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1109 1110 1111 1112
     */
    int mb_qmin;

    /**
1113 1114 1115
     * maximum MB quantizer.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1116 1117
     */
    int mb_qmax;
michaelni's avatar
michaelni committed
1118 1119
    
    /**
1120 1121 1122
     * motion estimation compare function.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1123 1124 1125
     */
    int me_cmp;
    /**
1126 1127 1128
     * subpixel motion estimation compare function.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1129 1130 1131
     */
    int me_sub_cmp;
    /**
1132 1133 1134
     * macroblock compare function (not supported yet).
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147
     */
    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
    
    /**
1148 1149 1150
     * ME diamond size & shape.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1151 1152
     */
    int dia_size;
michaelni's avatar
michaelni committed
1153 1154

    /**
1155 1156 1157
     * amount of previous MV predictors (2a+1 x 2a+1 square).
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1158 1159
     */
    int last_predictor_count;
michaelni's avatar
michaelni committed
1160

michaelni's avatar
michaelni committed
1161
    /**
1162 1163 1164
     * pre pass for motion estimation.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1165 1166
     */
    int pre_me;
michaelni's avatar
michaelni committed
1167

michaelni's avatar
michaelni committed
1168
    /**
1169 1170 1171
     * motion estimation pre pass compare function.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1172 1173
     */
    int me_pre_cmp;
michaelni's avatar
michaelni committed
1174

michaelni's avatar
michaelni committed
1175
    /**
1176 1177 1178
     * ME pre pass diamond size & shape.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1179 1180 1181
     */
    int pre_dia_size;

michaelni's avatar
michaelni committed
1182
    /**
1183 1184 1185
     * subpel ME quality.
     * - encoding: set by user.
     * - decoding: unused
michaelni's avatar
michaelni committed
1186 1187 1188
     */
    int me_subpel_quality;

michaelni's avatar
michaelni committed
1189
    /**
1190
     * callback to negotiate the pixelFormat.
michaelni's avatar
michaelni committed
1191 1192 1193 1194
     * @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
1195 1196
     * - encoding: unused
     * - decoding: set by user, if not set then the native format will always be choosen
michaelni's avatar
michaelni committed
1197 1198
     */
    enum PixelFormat (*get_format)(struct AVCodecContext *s, enum PixelFormat * fmt);
1199 1200 1201 1202 1203 1204

    /**
     * DTG active format information (additionnal aspect ratio
     * information only used in DVB MPEG2 transport streams). 0 if
     * not set.
     * 
1205 1206
     * - encoding: unused.
     * - decoding: set by decoder 
1207 1208 1209 1210 1211 1212 1213 1214 1215 1216
     */
    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

1217 1218 1219 1220
    /**
     * Maximum motion estimation search range in subpel units.
     * if 0 then no limit
     * 
1221 1222
     * - encoding: set by user.
     * - decoding: unused.
1223
     */
kabi's avatar
kabi committed
1224
    int me_range;
1225

michaelni's avatar
michaelni committed
1226 1227 1228 1229 1230 1231 1232 1233
    /**
     * frame_rate_base.
     * for variable fps this is 1
     * - encoding: set by user.
     * - decoding: set by lavc.
     * @todo move this after frame_rate
     */

michaelni's avatar
michaelni committed
1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248
    int frame_rate_base;
    /**
     * intra quantizer bias.
     * - encoding: set by user.
     * - decoding: unused
     */
    int intra_quant_bias;
#define FF_DEFAULT_QUANT_BIAS 999999
    
    /**
     * inter quantizer bias.
     * - encoding: set by user.
     * - decoding: unused
     */
    int inter_quant_bias;
1249 1250 1251 1252 1253 1254 1255 1256

    /**
     * color table ID.
     * - encoding: unused.
     * - decoding: which clrtable should be used for 8bit RGB images
     *             table have to be stored somewhere FIXME
     */
    int color_table_id;
michaelni's avatar
michaelni committed
1257
    
1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268
    /**
     * internal_buffer count. 
     * Dont touch, used by lavc default_get_buffer()
     */
    int internal_buffer_count;
    
    /**
     * internal_buffers. 
     * Dont touch, used by lavc default_get_buffer()
     */
    void *internal_buffer;
1269 1270 1271 1272 1273 1274 1275

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

#define FF_QUALITY_SCALE FF_LAMBDA_SCALE //FIXME maybe remove
michaelni's avatar
michaelni committed
1276 1277 1278 1279 1280 1281 1282
    /**
     * global quality for codecs which cannot change it per frame.
     * this should be proportional to MPEG1/2/4 qscale.
     * - encoding: set by user.
     * - decoding: unused
     */
    int global_quality;
michaelni's avatar
michaelni committed
1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298
    
#define FF_CODER_TYPE_VLC   0
#define FF_CODER_TYPE_AC    1
    /**
     * coder type
     * - encoding: set by user.
     * - decoding: unused
     */
    int coder_type;

    /**
     * context model
     * - encoding: set by user.
     * - decoding: unused
     */
    int context_model;
1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309
    
    /**
     * slice flags
     * - encoding: unused
     * - decoding: set by user.
     */
    int slice_flags;
#define SLICE_FLAG_CODED_ORDER    0x0001 ///< draw_horiz_band() is called in coded order instead of display
#define SLICE_FLAG_ALLOW_FIELD    0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics)
#define SLICE_FLAG_ALLOW_PLANE    0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)

iive's avatar
iive committed
1310 1311 1312 1313 1314 1315
    /**
     * XVideo Motion Acceleration
     * - encoding: forbidden
     * - decoding: set by decoder
     */
    int xvmc_acceleration;
1316 1317 1318 1319 1320 1321 1322 1323 1324 1325
    
    /**
     * macroblock decision mode
     * - encoding: set by user.
     * - decoding: unused
     */
    int mb_decision;
#define FF_MB_DECISION_SIMPLE 0        ///< uses mb_cmp
#define FF_MB_DECISION_BITS   1        ///< chooses the one which needs the fewest bits
#define FF_MB_DECISION_RD     2        ///< rate distoration
1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339

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

    /**
     * custom inter quantization matrix
     * - encoding: set by user, can be NULL
     * - decoding: set by lavc
     */
    uint16_t *inter_matrix;
1340
    
1341 1342 1343 1344 1345 1346 1347
    /**
     * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
     * this is used to workaround some encoder bugs
     * - encoding: unused
     * - decoding: set by user, will be converted to upper case by lavc during init
     */
    unsigned int stream_codec_tag;
michaelni's avatar
michaelni committed
1348 1349 1350 1351 1352 1353 1354 1355

    /**
     * scene change detection threshold.
     * 0 is default, larger means fewer detected scene changes
     * - encoding: set by user.
     * - decoding: unused
     */
    int scenechange_threshold;
1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369

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

    /**
     * maximum lagrange multipler
     * - encoding: set by user.
     * - decoding: unused
     */
    int lmax;
1370 1371 1372 1373 1374 1375 1376

    /**
     * Palette control structure
     * - encoding: ??? (no palette-enabled encoder yet)
     * - decoding: set by user.
     */
    struct AVPaletteControl *palctrl;
1377 1378 1379 1380 1381 1382 1383

    /**
     * noise reduction strength
     * - encoding: set by user.
     * - decoding: unused
     */
    int noise_reduction;
1384
    
1385 1386 1387 1388 1389 1390 1391
    /**
     * Conditional replenishment support
     * - encoding: unused
     * - decoding: set by user, if 1 user can allocate reusable buffers
     */
    int cr_available;
    
glantau's avatar
glantau committed
1392 1393
} AVCodecContext;

kabi's avatar
kabi committed
1394

1395 1396 1397
/**
 * AVOption.
 */
kabi's avatar
kabi committed
1398 1399 1400
typedef struct AVOption {
    /** options' name */
    const char *name; /* if name is NULL, it indicates a link to next */
kabi's avatar
kabi committed
1401 1402
    /** short English text help or const struct AVOption* subpointer */
    const char *help; //	const struct AVOption* sub;
kabi's avatar
kabi committed
1403 1404 1405 1406
    /** offset to context structure where the parsed value should be stored */
    int offset;
    /** options' type */
    int type;
1407 1408 1409 1410 1411
#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
kabi's avatar
kabi committed
1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429
//#define FF_OPT_TYPE_EXPERT 0x20 // flag for expert option
#define FF_OPT_TYPE_FLAG (FF_OPT_TYPE_BOOL | 0x40)
#define FF_OPT_TYPE_RCOVERRIDE (FF_OPT_TYPE_STRING | 0x80)
    /** min value  (min == max   ->  no limits) */
    double min;
    /** maximum value for double/int */
    double max;
    /** default boo [0,1]l/double/int value */
    double defval;
    /**
     * default string value (with optional semicolon delimited extra option-list
     * i.e.   option1;option2;option3
     * defval might select other then first argument as default
     */
    const char *defstr;
#define FF_OPT_MAX_DEPTH 10
} AVOption;

kabi's avatar
kabi committed
1430 1431 1432 1433 1434 1435 1436 1437 1438
/**
 * Parse option(s) and sets fields in passed structure
 * @param strct	structure where the parsed results will be written
 * @param list  list with AVOptions
 * @param opts	string with options for parsing
 */
int avoption_parse(void* strct, const AVOption* list, const char* opts);


1439 1440 1441
/**
 * AVCodec.
 */
glantau's avatar
glantau committed
1442
typedef struct AVCodec {
kabi's avatar
kabi committed
1443
    const char *name;
kabi's avatar
kabi committed
1444
    enum CodecType type;
glantau's avatar
glantau committed
1445 1446 1447
    int id;
    int priv_data_size;
    int (*init)(AVCodecContext *);
kabi's avatar
kabi committed
1448
    int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
glantau's avatar
glantau committed
1449
    int (*close)(AVCodecContext *);
michaelni's avatar
michaelni committed
1450
    int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
kabi's avatar
kabi committed
1451
                  uint8_t *buf, int buf_size);
glantau's avatar
glantau committed
1452
    int capabilities;
kabi's avatar
kabi committed
1453
    const AVOption *options;
glantau's avatar
glantau committed
1454
    struct AVCodec *next;
michaelni's avatar
michaelni committed
1455
    void (*flush)(AVCodecContext *);
glantau's avatar
glantau committed
1456 1457
} AVCodec;

kabi's avatar
kabi committed
1458
/**
1459 1460 1461
 * four components are given, that's all.
 * the last component is alpha
 */
glantau's avatar
glantau committed
1462
typedef struct AVPicture {
kabi's avatar
kabi committed
1463
    uint8_t *data[4];
michaelni's avatar
michaelni committed
1464
    int linesize[4];       ///< number of bytes per line
glantau's avatar
glantau committed
1465 1466
} AVPicture;

tmmm's avatar
tmmm committed
1467 1468 1469 1470 1471
/**
 * AVPaletteControl
 * This structure defines a method for communicating palette changes
 * between and demuxer and a decoder.
 */
1472
#define AVPALETTE_SIZE 1024
michael's avatar
michael committed
1473
#define AVPALETTE_COUNT 256
tmmm's avatar
tmmm committed
1474 1475 1476 1477 1478 1479
typedef struct AVPaletteControl {

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

1480 1481 1482 1483
    /* 4-byte ARGB palette entries, stored in native byte order; note that
     * the individual palette components should be on a 8-bit scale; if
     * the palette data comes from a IBM VGA native format, the component
     * data is probably 6 bits in size and needs to be scaled */
1484
    unsigned int palette[AVPALETTE_COUNT];
tmmm's avatar
tmmm committed
1485 1486 1487

} AVPaletteControl;

glantau's avatar
glantau committed
1488 1489
extern AVCodec ac3_encoder;
extern AVCodec mp2_encoder;
1490
extern AVCodec mp3lame_encoder;
michaelni's avatar
 
michaelni committed
1491
extern AVCodec oggvorbis_encoder;
1492
extern AVCodec faac_encoder;
glantau's avatar
glantau committed
1493
extern AVCodec mpeg1video_encoder;
michaelni's avatar
michaelni committed
1494
extern AVCodec mpeg2video_encoder;
glantau's avatar
glantau committed
1495 1496
extern AVCodec h263_encoder;
extern AVCodec h263p_encoder;
1497
extern AVCodec flv_encoder;
glantau's avatar
glantau committed
1498 1499
extern AVCodec rv10_encoder;
extern AVCodec mjpeg_encoder;
1500
extern AVCodec ljpeg_encoder;
glantau's avatar
glantau committed
1501
extern AVCodec mpeg4_encoder;
1502 1503 1504
extern AVCodec msmpeg4v1_encoder;
extern AVCodec msmpeg4v2_encoder;
extern AVCodec msmpeg4v3_encoder;
michaelni's avatar
 
michaelni committed
1505 1506
extern AVCodec wmv1_encoder;
extern AVCodec wmv2_encoder;
michaelni's avatar
michaelni committed
1507
extern AVCodec huffyuv_encoder;
michaelni's avatar
michaelni committed
1508
extern AVCodec h264_encoder;
michaelni's avatar
michaelni committed
1509
extern AVCodec asv1_encoder;
michaelni's avatar
michaelni committed
1510
extern AVCodec asv2_encoder;
michaelni's avatar
michaelni committed
1511
extern AVCodec vcr1_encoder;
1512
extern AVCodec ffv1_encoder;
1513
extern AVCodec mdec_encoder;
glantau's avatar
glantau committed
1514 1515

extern AVCodec h263_decoder;
glantau's avatar
glantau committed
1516
extern AVCodec mpeg4_decoder;
1517 1518 1519
extern AVCodec msmpeg4v1_decoder;
extern AVCodec msmpeg4v2_decoder;
extern AVCodec msmpeg4v3_decoder;
michaelni's avatar
michaelni committed
1520
extern AVCodec wmv1_decoder;
michaelni's avatar
 
michaelni committed
1521
extern AVCodec wmv2_decoder;
michaelni's avatar
michaelni committed
1522 1523
extern AVCodec mpeg1video_decoder;
extern AVCodec mpeg2video_decoder;
iive's avatar
iive committed
1524
extern AVCodec mpeg_xvmc_decoder;
glantau's avatar
glantau committed
1525
extern AVCodec h263i_decoder;
1526
extern AVCodec flv_decoder;
glantau's avatar
glantau committed
1527
extern AVCodec rv10_decoder;
nickols_k's avatar
nickols_k committed
1528
extern AVCodec svq1_decoder;
michaelni's avatar
michaelni committed
1529
extern AVCodec svq3_decoder;
bellard's avatar
bellard committed
1530
extern AVCodec dvvideo_decoder;
bellard's avatar
bellard committed
1531 1532
extern AVCodec wmav1_decoder;
extern AVCodec wmav2_decoder;
glantau's avatar
glantau committed
1533
extern AVCodec mjpeg_decoder;
al3x's avatar
al3x committed
1534
extern AVCodec mjpegb_decoder;
alex's avatar
alex committed
1535
extern AVCodec sp5x_decoder;
1536
extern AVCodec mp2_decoder;
glantau's avatar
glantau committed
1537
extern AVCodec mp3_decoder;
1538 1539
extern AVCodec mace3_decoder;
extern AVCodec mace6_decoder;
michaelni's avatar
michaelni committed
1540
extern AVCodec huffyuv_decoder;
kabi's avatar
kabi committed
1541
extern AVCodec oggvorbis_decoder;
1542
extern AVCodec cyuv_decoder;
michaelni's avatar
michaelni committed
1543
extern AVCodec h264_decoder;
tmmm's avatar
tmmm committed
1544
extern AVCodec indeo3_decoder;
tmmm's avatar
tmmm committed
1545
extern AVCodec vp3_decoder;
1546
extern AVCodec theora_decoder;
1547
extern AVCodec amr_nb_decoder;
kabi's avatar
kabi committed
1548
extern AVCodec amr_nb_encoder;
1549 1550
extern AVCodec amr_wb_encoder;
extern AVCodec amr_wb_decoder;
1551 1552
extern AVCodec aac_decoder;
extern AVCodec mpeg4aac_decoder;
michaelni's avatar
michaelni committed
1553
extern AVCodec asv1_decoder;
michaelni's avatar
michaelni committed
1554
extern AVCodec asv2_decoder;
michaelni's avatar
michaelni committed
1555
extern AVCodec vcr1_decoder;
al3x's avatar
al3x committed
1556
extern AVCodec cljr_decoder;
1557
extern AVCodec ffv1_decoder;
michaelni's avatar
michaelni committed
1558
extern AVCodec fourxm_decoder;
1559
extern AVCodec mdec_decoder;
1560 1561
extern AVCodec roq_decoder;
extern AVCodec interplay_video_decoder;
1562
extern AVCodec xan_wc3_decoder;
1563 1564 1565 1566
extern AVCodec rpza_decoder;
extern AVCodec cinepak_decoder;
extern AVCodec msrle_decoder;
extern AVCodec msvideo1_decoder;
tmmm's avatar
tmmm committed
1567
extern AVCodec vqa_decoder;
tmmm's avatar
tmmm committed
1568
extern AVCodec idcin_decoder;
1569 1570
extern AVCodec ra_144_decoder;
extern AVCodec ra_288_decoder;
1571 1572
extern AVCodec roq_dpcm_decoder;
extern AVCodec interplay_dpcm_decoder;
1573
extern AVCodec xan_dpcm_decoder;
glantau's avatar
glantau committed
1574

glantau's avatar
glantau committed
1575 1576 1577
/* pcm codecs */
#define PCM_CODEC(id, name) \
extern AVCodec name ## _decoder; \
1578
extern AVCodec name ## _encoder
glantau's avatar
glantau committed
1579 1580 1581 1582 1583 1584 1585 1586 1587 1588

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

1589 1590 1591 1592
/* adpcm codecs */

PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
1593 1594
PCM_CODEC(CODEC_ID_ADPCM_IMA_DK3, adpcm_ima_dk3);
PCM_CODEC(CODEC_ID_ADPCM_IMA_DK4, adpcm_ima_dk4);
1595
PCM_CODEC(CODEC_ID_ADPCM_IMA_WS, adpcm_ima_ws);
1596
PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);
michaelni's avatar
michaelni committed
1597
PCM_CODEC(CODEC_ID_ADPCM_4XM, adpcm_4xm);
1598 1599
PCM_CODEC(CODEC_ID_ADPCM_XA, adpcm_xa);
PCM_CODEC(CODEC_ID_ADPCM_ADX, adpcm_adx);
1600

glantau's avatar
glantau committed
1601 1602 1603
#undef PCM_CODEC

/* dummy raw video codec */
romansh's avatar
 
romansh committed
1604 1605
extern AVCodec rawvideo_encoder;
extern AVCodec rawvideo_decoder;
glantau's avatar
glantau committed
1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628

/* 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);
1629 1630 1631 1632 1633 1634

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

glantau's avatar
glantau committed
1635
void img_resample(ImgReSampleContext *s, 
1636
                  AVPicture *output, const AVPicture *input);
glantau's avatar
glantau committed
1637 1638 1639

void img_resample_close(ImgReSampleContext *s);

michael's avatar
michael committed
1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653
/**
 * Allocate memory for a picture.  Call avpicture_free to free it.
 *
 * @param picture the picture to be filled in.
 * @param pix_fmt the format of the picture.
 * @param width the width of the picture.
 * @param height the height of the picture.
 * @return 0 if successful, -1 if not.
 */
int avpicture_alloc(AVPicture *picture, int pix_fmt, int width, int height);

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

kabi's avatar
kabi committed
1654
int avpicture_fill(AVPicture *picture, uint8_t *ptr,
1655
                   int pix_fmt, int width, int height);
1656
int avpicture_layout(const AVPicture* src, int pix_fmt, int width, int height,
romansh's avatar
 
romansh committed
1657
                     unsigned char *dest, int dest_size);
1658
int avpicture_get_size(int pix_fmt, int width, int height);
1659 1660
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);
romansh's avatar
 
romansh committed
1661
enum PixelFormat avcodec_get_pix_fmt(const char* name);
1662

1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674
#define FF_LOSS_RESOLUTION  0x0001 /* loss due to resolution change */
#define FF_LOSS_DEPTH       0x0002 /* loss due to color depth change */
#define FF_LOSS_COLORSPACE  0x0004 /* loss due to color space conversion */
#define FF_LOSS_ALPHA       0x0008 /* loss of alpha bits */
#define FF_LOSS_COLORQUANT  0x0010 /* loss due to color quantization */
#define FF_LOSS_CHROMA      0x0020 /* loss of chroma (e.g. rgb to gray conversion) */

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

bellard's avatar
bellard committed
1675 1676
#define FF_ALPHA_TRANSP       0x0001 /* image has some totally transparent pixels */
#define FF_ALPHA_SEMI_TRANSP  0x0002 /* image has some transparent pixels */
1677 1678
int img_get_alpha_info(const AVPicture *src,
		       int pix_fmt, int width, int height);
bellard's avatar
bellard committed
1679

1680 1681
/* convert among pixel formats */
int img_convert(AVPicture *dst, int dst_pix_fmt,
1682
                const AVPicture *src, int pix_fmt, 
1683 1684 1685
                int width, int height);

/* deinterlace a picture */
1686
int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
glantau's avatar
glantau committed
1687 1688 1689 1690 1691 1692
                          int pix_fmt, int width, int height);

/* external high level API */

extern AVCodec *first_avcodec;

nickols_k's avatar
nickols_k committed
1693
/* returns LIBAVCODEC_VERSION_INT constant */
1694
unsigned avcodec_version(void);
nickols_k's avatar
nickols_k committed
1695
/* returns LIBAVCODEC_BUILD constant */
1696
unsigned avcodec_build(void);
glantau's avatar
glantau committed
1697 1698 1699 1700
void avcodec_init(void);

void register_avcodec(AVCodec *format);
AVCodec *avcodec_find_encoder(enum CodecID id);
1701
AVCodec *avcodec_find_encoder_by_name(const char *name);
glantau's avatar
glantau committed
1702 1703 1704 1705
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);

michaelni's avatar
michaelni committed
1706
void avcodec_get_context_defaults(AVCodecContext *s);
mellum's avatar
mellum committed
1707
AVCodecContext *avcodec_alloc_context(void);
michaelni's avatar
michaelni committed
1708
AVFrame *avcodec_alloc_frame(void);
michaelni's avatar
michaelni committed
1709

michaelni's avatar
michaelni committed
1710 1711
int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
1712
void avcodec_default_free_buffers(AVCodecContext *s);
michaelni's avatar
michaelni committed
1713

michaelni's avatar
michaelni committed
1714 1715 1716 1717
/**
 * opens / inits the AVCodecContext.
 * not thread save!
 */
glantau's avatar
glantau committed
1718
int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
michaelni's avatar
michaelni committed
1719

kabi's avatar
kabi committed
1720
int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples, 
glantau's avatar
glantau committed
1721
                         int *frame_size_ptr,
kabi's avatar
kabi committed
1722
                         uint8_t *buf, int buf_size);
michaelni's avatar
michaelni committed
1723
int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture, 
glantau's avatar
glantau committed
1724
                         int *got_picture_ptr,
kabi's avatar
kabi committed
1725 1726
                         uint8_t *buf, int buf_size);
int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata, 
1727
                        int *data_size_ptr,
kabi's avatar
kabi committed
1728 1729
                        uint8_t *buf, int buf_size);
int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size, 
glantau's avatar
glantau committed
1730
                         const short *samples);
kabi's avatar
kabi committed
1731
int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size, 
michaelni's avatar
michaelni committed
1732
                         const AVFrame *pict);
glantau's avatar
glantau committed
1733 1734 1735 1736

int avcodec_close(AVCodecContext *avctx);

void avcodec_register_all(void);
glantau's avatar
glantau committed
1737

michaelni's avatar
michaelni committed
1738 1739
void avcodec_flush_buffers(AVCodecContext *avctx);

1740
/* misc usefull functions */
michaelni's avatar
michaelni committed
1741 1742 1743 1744 1745 1746

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

1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759
/**
 * reduce a fraction.
 * this is usefull for framerate calculations
 * @param max the maximum allowed for dst_nom & dst_den
 * @return 1 if exact, 0 otherwise
 */
int av_reduce(int *dst_nom, int *dst_den, int64_t nom, int64_t den, int64_t max);

/**
 * rescale a 64bit integer.
 * a simple a*b/c isnt possible as it can overflow
 */
int64_t av_rescale(int64_t a, int b, int c);
1760 1761


kabi's avatar
kabi committed
1762 1763 1764 1765 1766 1767 1768
/**
 * Interface for 0.5.0 version
 *
 * do not even think about it's usage for this moment
 */

typedef struct {
1769
    /// compressed size used from given memory buffer
kabi's avatar
kabi committed
1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837
    int size;
    /// I/P/B frame type
    int frame_type;
} avc_enc_result_t;

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

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

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

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

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

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

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

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

} avc_cmd_t;

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

bellard's avatar
bellard committed
1838
/* memory */
1839
void *av_malloc(unsigned int size);
kabi's avatar
kabi committed
1840
void *av_mallocz(unsigned int size);
1841
void *av_realloc(void *ptr, unsigned int size);
bellard's avatar
bellard committed
1842
void av_free(void *ptr);
1843
char *av_strdup(const char *s);
bellard's avatar
bellard committed
1844 1845
void __av_freep(void **ptr);
#define av_freep(p) __av_freep((void **)(p))
kabi's avatar
kabi committed
1846
void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
1847 1848
/* for static data only */
/* call av_free_static to release all staticaly allocated tables */
1849
void av_free_static(void);
1850 1851
void *__av_mallocz_static(void** location, unsigned int size);
#define av_mallocz_static(p, s) __av_mallocz_static((void **)(p), s)
bellard's avatar
bellard committed
1852

1853 1854 1855
/* add by bero : in adx.c */
int is_adx(const unsigned char *buf,size_t bufsize);

1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877
/* av_log API */

#include <stdarg.h>

#define AV_LOG_ERROR 0
#define AV_LOG_INFO 1
#define AV_LOG_DEBUG 2

extern void av_log(AVCodecContext*, int level, const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4)));
extern void av_vlog(AVCodecContext*, int level, const char *fmt, va_list);
extern int av_log_get_level(void);
extern void av_log_set_level(int);
extern void av_log_set_callback(void (*)(AVCodecContext*, int, const char*, va_list));

#undef  AV_LOG_TRAP_PRINTF
#ifdef AV_LOG_TRAP_PRINTF
#define printf DO NOT USE
#define fprintf DO NOT USE
#undef stderr
#define stderr DO NOT USE
#endif

kabi's avatar
kabi committed
1878 1879 1880 1881
#ifdef __cplusplus
}
#endif

glantau's avatar
glantau committed
1882
#endif /* AVCODEC_H */