Statistics
| Branch: | Revision:

ffmpeg / libavcodec / avcodec.h @ 034eeaa1

History | View | Annotate | Download (69.4 KB)

1 a96b68b7 Fabrice Bellard
#ifndef AVCODEC_H
2
#define AVCODEC_H
3
4 36df8805 Michael Niedermayer
/**
5
 * @file avcodec.h
6 d33c949c Michael Niedermayer
 * external api header.
7 36df8805 Michael Niedermayer
 */
8
9
10 02d697aa Zdenek Kabelac
#ifdef __cplusplus
11
extern "C" {
12
#endif
13
14 de6d9b64 Fabrice Bellard
#include "common.h"
15 5ff85f1d Michael Niedermayer
#include "rational.h"
16 4b813d5c Zdenek Kabelac
#include <sys/types.h> /* size_t */
17 de6d9b64 Fabrice Bellard
18 c79b8011 Michael Niedermayer
#define FFMPEG_VERSION_INT     0x000409
19
#define FFMPEG_VERSION         "0.4.9-pre1"
20 034eeaa1 Mike Melanson
#define LIBAVCODEC_BUILD       4751
21 4b1f4f23 Juanjo
22 7b7d86f1 Fabrice Bellard
#define LIBAVCODEC_VERSION_INT FFMPEG_VERSION_INT
23
#define LIBAVCODEC_VERSION     FFMPEG_VERSION
24
25
#define AV_STRINGIFY(s)        AV_TOSTRING(s)
26
#define AV_TOSTRING(s) #s
27
#define LIBAVCODEC_IDENT        "FFmpeg" LIBAVCODEC_VERSION "b" AV_STRINGIFY(LIBAVCODEC_BUILD)
28 ce2749d2 Alex Beregszaszi
29 2a24fe4c Gael Chardon
#define AV_NOPTS_VALUE int64_t_C(0x8000000000000000)
30 9740beff Michael Niedermayer
#define AV_TIME_BASE 1000000
31
32 de6d9b64 Fabrice Bellard
enum CodecID {
33
    CODEC_ID_NONE, 
34
    CODEC_ID_MPEG1VIDEO,
35 dcedf586 Fabrice Bellard
    CODEC_ID_MPEG2VIDEO, /* prefered ID for MPEG Video 1 or 2 decoding */
36 fb364ada Ivan Kalvachev
    CODEC_ID_MPEG2VIDEO_XVMC,
37 c6148de2 Michael Niedermayer
    CODEC_ID_H261,
38 de6d9b64 Fabrice Bellard
    CODEC_ID_H263,
39
    CODEC_ID_RV10,
40 68b94c35 Michael Niedermayer
    CODEC_ID_RV20,
41 de6d9b64 Fabrice Bellard
    CODEC_ID_MJPEG,
42 b135d9fb Alex Beregszaszi
    CODEC_ID_MJPEGB,
43 b1e6b355 Michael Niedermayer
    CODEC_ID_LJPEG,
44 5e83dec4 Alex Beregszaszi
    CODEC_ID_SP5X,
45 bf89e6b1 Fabrice Bellard
    CODEC_ID_MPEG4,
46 de6d9b64 Fabrice Bellard
    CODEC_ID_RAWVIDEO,
47 84afee34 Michael Niedermayer
    CODEC_ID_MSMPEG4V1,
48
    CODEC_ID_MSMPEG4V2,
49
    CODEC_ID_MSMPEG4V3,
50 e1a9dbff Michael Niedermayer
    CODEC_ID_WMV1,
51 b50eef3a Michael Niedermayer
    CODEC_ID_WMV2,
52 de6d9b64 Fabrice Bellard
    CODEC_ID_H263P,
53
    CODEC_ID_H263I,
54 d4f5d74a Garrick Meeker
    CODEC_ID_FLV1,
55 be8ffec9 Nick Kurshev
    CODEC_ID_SVQ1,
56 8b82a956 Michael Niedermayer
    CODEC_ID_SVQ3,
57 020fcc94 Fabrice Bellard
    CODEC_ID_DVVIDEO,
58 11f18faf Michael Niedermayer
    CODEC_ID_HUFFYUV,
59 f70f7c6d Michael Niedermayer
    CODEC_ID_CYUV,
60 0da71265 Michael Niedermayer
    CODEC_ID_H264,
61 deabd4fd Mike Melanson
    CODEC_ID_INDEO3,
62 d86053a4 Mike Melanson
    CODEC_ID_VP3,
63 f44ee2c3 Alex Beregszaszi
    CODEC_ID_THEORA,
64 3d2e8cce Michael Niedermayer
    CODEC_ID_ASV1,
65 9b56edf5 Michael Niedermayer
    CODEC_ID_ASV2,
66 5e20f836 Michael Niedermayer
    CODEC_ID_FFV1,
67 e2a7bb28 Mike Melanson
    CODEC_ID_4XM,
68 be3564ed Michael Niedermayer
    CODEC_ID_VCR1,
69 3aff069b Alex Beregszaszi
    CODEC_ID_CLJR,
70 c3bf0288 Michael Niedermayer
    CODEC_ID_MDEC,
71 3ef8be2b Mike Melanson
    CODEC_ID_ROQ,
72
    CODEC_ID_INTERPLAY_VIDEO,
73 9937e686 Mike Melanson
    CODEC_ID_XAN_WC3,
74
    CODEC_ID_XAN_WC4,
75 2fdf638b Mike Melanson
    CODEC_ID_RPZA,
76
    CODEC_ID_CINEPAK,
77
    CODEC_ID_WS_VQA,
78
    CODEC_ID_MSRLE,
79
    CODEC_ID_MSVIDEO1,
80 4120a53a Mike Melanson
    CODEC_ID_IDCIN,
81 1dc1ed99 Roberto Togni
    CODEC_ID_8BPS,
82 11e29a41 Mike Melanson
    CODEC_ID_SMC,
83 42cad81a Mike Melanson
    CODEC_ID_FLIC,
84 9a4117d5 Mike Melanson
    CODEC_ID_TRUEMOTION1,
85 fafa0b75 Mike Melanson
    CODEC_ID_VMDVIDEO,
86 a273bbfb Roberto Togni
    CODEC_ID_MSZH,
87
    CODEC_ID_ZLIB,
88 070ed1bc Mike Melanson
    CODEC_ID_QTRLE,
89 791e7b83 Michael Niedermayer
    CODEC_ID_SNOW,
90 9d53d58e Mike Melanson
    CODEC_ID_TSCC,
91 d0a0bbd2 Mike Melanson
    CODEC_ID_ULTI,
92 d08d7142 Mike Melanson
    CODEC_ID_QDRAW,
93 ab711b3c Mike Melanson
    CODEC_ID_VIXL,
94 acfd8f0f Mike Melanson
    CODEC_ID_QPEG,
95 17179d2d Michael Niedermayer
    CODEC_ID_XVID,
96
    CODEC_ID_PNG,
97
    CODEC_ID_PPM,
98
    CODEC_ID_PBM,
99
    CODEC_ID_PGM,
100
    CODEC_ID_PGMYUV,
101
    CODEC_ID_PAM,
102 f37b9768 Loren Merritt
    CODEC_ID_FFVHUFF,
103 3f05305d Michael Niedermayer
    CODEC_ID_RV30,
104
    CODEC_ID_RV40,
105 21aa398f Alex Beregszaszi
    CODEC_ID_VC9,
106
    CODEC_ID_WMV3,
107 9c7fb608 Mike Melanson
    CODEC_ID_LOCO,
108 a8a15e9d Mike Melanson
    CODEC_ID_WNV1,
109 a96b68b7 Fabrice Bellard
110
    /* various pcm "codecs" */
111 17179d2d Michael Niedermayer
    CODEC_ID_PCM_S16LE= 0x10000,
112 a96b68b7 Fabrice Bellard
    CODEC_ID_PCM_S16BE,
113
    CODEC_ID_PCM_U16LE,
114
    CODEC_ID_PCM_U16BE,
115
    CODEC_ID_PCM_S8,
116
    CODEC_ID_PCM_U8,
117
    CODEC_ID_PCM_MULAW,
118
    CODEC_ID_PCM_ALAW,
119 0147f198 François Revol
120
    /* various adpcm codecs */
121 17179d2d Michael Niedermayer
    CODEC_ID_ADPCM_IMA_QT= 0x11000,
122 0147f198 François Revol
    CODEC_ID_ADPCM_IMA_WAV,
123 9937e686 Mike Melanson
    CODEC_ID_ADPCM_IMA_DK3,
124
    CODEC_ID_ADPCM_IMA_DK4,
125 2fdf638b Mike Melanson
    CODEC_ID_ADPCM_IMA_WS,
126 7d8379f2 Mike Melanson
    CODEC_ID_ADPCM_IMA_SMJPEG,
127 0147f198 François Revol
    CODEC_ID_ADPCM_MS,
128 e2a7bb28 Mike Melanson
    CODEC_ID_ADPCM_4XM,
129 fc384777 Mike Melanson
    CODEC_ID_ADPCM_XA,
130
    CODEC_ID_ADPCM_ADX,
131 7d8379f2 Mike Melanson
    CODEC_ID_ADPCM_EA,
132 e5966052 Roman Shaposhnik
    CODEC_ID_ADPCM_G726,
133 b3bfb299 Mike Melanson
    CODEC_ID_ADPCM_CT,
134 659c3692 Alex Beregszaszi
    CODEC_ID_ADPCM_SWF,
135 891f64b3 joca@rixmail.se
136 17179d2d Michael Niedermayer
    /* AMR */
137
    CODEC_ID_AMR_NB= 0x12000,
138 d663a1fd Michael Niedermayer
    CODEC_ID_AMR_WB,
139
140 b8414bbd Nick Kurshev
    /* RealAudio codecs*/
141 17179d2d Michael Niedermayer
    CODEC_ID_RA_144= 0x13000,
142 b8414bbd Nick Kurshev
    CODEC_ID_RA_288,
143 3ef8be2b Mike Melanson
144
    /* various DPCM codecs */
145 17179d2d Michael Niedermayer
    CODEC_ID_ROQ_DPCM= 0x14000,
146 3ef8be2b Mike Melanson
    CODEC_ID_INTERPLAY_DPCM,
147 9937e686 Mike Melanson
    CODEC_ID_XAN_DPCM,
148 d08d7142 Mike Melanson
    CODEC_ID_SOL_DPCM,
149 985180a1 Fabrice Bellard
    
150 17179d2d Michael Niedermayer
    CODEC_ID_MP2= 0x15000,
151
    CODEC_ID_MP3, /* prefered ID for MPEG Audio layer 1, 2 or3 decoding */
152
    CODEC_ID_AAC,
153
    CODEC_ID_MPEG4AAC,
154
    CODEC_ID_AC3,
155
    CODEC_ID_DTS,
156
    CODEC_ID_VORBIS,
157
    CODEC_ID_DVAUDIO,
158
    CODEC_ID_WMAV1,
159
    CODEC_ID_WMAV2,
160
    CODEC_ID_MACE3,
161
    CODEC_ID_MACE6,
162
    CODEC_ID_VMDAUDIO,
163
    CODEC_ID_SONIC,
164
    CODEC_ID_SONIC_LS,
165 ac2570a8 Michael Niedermayer
    CODEC_ID_FLAC,
166 1ede228a Roberto Togni
    CODEC_ID_MP3ADU,
167 d2a7718d Roberto Togni
    CODEC_ID_MP3ON4,
168 85ad5695 Michael Niedermayer
    CODEC_ID_SHORTEN,
169 5df8a0c6 Michael Niedermayer
    CODEC_ID_ALAC,
170 034eeaa1 Mike Melanson
    CODEC_ID_WESTWOOD_SND1,
171 ac2570a8 Michael Niedermayer
    
172 5c5dea3f Nilesh Bansal
    CODEC_ID_OGGTHEORA= 0x16000, 
173
    
174 17179d2d Michael Niedermayer
    CODEC_ID_MPEG2TS= 0x20000, /* _FAKE_ codec to indicate a raw MPEG2 transport
175 985180a1 Fabrice Bellard
                         stream (only used by libavformat) */
176 de6d9b64 Fabrice Bellard
};
177 dcedf586 Fabrice Bellard
178
/* CODEC_ID_MP3LAME is absolete */
179
#define CODEC_ID_MP3LAME CODEC_ID_MP3
180 de6d9b64 Fabrice Bellard
181
enum CodecType {
182 4a663d80 Philip Gladstone
    CODEC_TYPE_UNKNOWN = -1,
183 de6d9b64 Fabrice Bellard
    CODEC_TYPE_VIDEO,
184
    CODEC_TYPE_AUDIO,
185 985180a1 Fabrice Bellard
    CODEC_TYPE_DATA,
186 de6d9b64 Fabrice Bellard
};
187
188 64863965 Michael Niedermayer
/**
189 0f371e3e Mike Melanson
 * Pixel format. Notes: 
190
 *
191
 * PIX_FMT_RGBA32 is handled in an endian-specific manner. A RGBA
192
 * color is put together as:
193
 *  (A << 24) | (R << 16) | (G << 8) | B
194
 * This is stored as BGRA on little endian CPU architectures and ARGB on
195
 * big endian CPUs.
196
 *
197
 * When the pixel format is palettized RGB (PIX_FMT_PAL8), the palettized
198
 * image data is stored in AVFrame.data[0]. The palette is transported in
199
 * AVFrame.data[1] and, is 1024 bytes long (256 4-byte entries) and is
200
 * formatted the same as in PIX_FMT_RGBA32 described above (i.e., it is
201 fc384777 Mike Melanson
 * also endian-specific). Note also that the individual RGB palette
202
 * components stored in AVFrame.data[1] should be in the range 0..255.
203
 * This is important as many custom PAL8 video codecs that were designed
204
 * to run on the IBM VGA graphics adapter use 6-bit palette components.
205 64863965 Michael Niedermayer
 */
206 de6d9b64 Fabrice Bellard
enum PixelFormat {
207 cd394651 Michael Niedermayer
    PIX_FMT_YUV420P,   ///< Planar YUV 4:2:0 (1 Cr & Cb sample per 2x2 Y samples)
208 ebb177dd Todd Kirby
    PIX_FMT_YUV422,    ///< Packed pixel, Y0 Cb Y1 Cr 
209 cd394651 Michael Niedermayer
    PIX_FMT_RGB24,     ///< Packed pixel, 3 bytes per pixel, RGBRGB...
210
    PIX_FMT_BGR24,     ///< Packed pixel, 3 bytes per pixel, BGRBGR...
211
    PIX_FMT_YUV422P,   ///< Planar YUV 4:2:2 (1 Cr & Cb sample per 2x1 Y samples)
212
    PIX_FMT_YUV444P,   ///< Planar YUV 4:4:4 (1 Cr & Cb sample per 1x1 Y samples)
213 0f371e3e Mike Melanson
    PIX_FMT_RGBA32,    ///< Packed pixel, 4 bytes per pixel, BGRABGRA..., stored in cpu endianness
214 cd394651 Michael Niedermayer
    PIX_FMT_YUV410P,   ///< Planar YUV 4:1:0 (1 Cr & Cb sample per 4x4 Y samples)
215
    PIX_FMT_YUV411P,   ///< Planar YUV 4:1:1 (1 Cr & Cb sample per 4x1 Y samples)
216 64863965 Michael Niedermayer
    PIX_FMT_RGB565,    ///< always stored in cpu endianness 
217
    PIX_FMT_RGB555,    ///< always stored in cpu endianness, most significant bit to 1 
218 dab64ebc Fabrice Bellard
    PIX_FMT_GRAY8,
219 64863965 Michael Niedermayer
    PIX_FMT_MONOWHITE, ///< 0 is white 
220
    PIX_FMT_MONOBLACK, ///< 0 is black 
221
    PIX_FMT_PAL8,      ///< 8 bit with RGBA palette 
222 cd394651 Michael Niedermayer
    PIX_FMT_YUVJ420P,  ///< Planar YUV 4:2:0 full scale (jpeg)
223
    PIX_FMT_YUVJ422P,  ///< Planar YUV 4:2:2 full scale (jpeg)
224
    PIX_FMT_YUVJ444P,  ///< Planar YUV 4:4:4 full scale (jpeg)
225 fb364ada Ivan Kalvachev
    PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing(xvmc_render.h)
226
    PIX_FMT_XVMC_MPEG2_IDCT,
227 ebb177dd Todd Kirby
    PIX_FMT_UYVY422,   ///< Packed pixel, Cb Y0 Cr Y1 
228 f02be79d Roman Shaposhnik
    PIX_FMT_UYVY411,   ///< Packed pixel, Cb Y0 Y1 Cr Y2 Y3
229 dab64ebc Fabrice Bellard
    PIX_FMT_NB,
230 de6d9b64 Fabrice Bellard
};
231
232 a96b68b7 Fabrice Bellard
/* currently unused, may be used if 24/32 bits samples ever supported */
233
enum SampleFormat {
234 64863965 Michael Niedermayer
    SAMPLE_FMT_S16 = 0,         ///< signed 16 bits 
235 a3a5f4d6 Michael Niedermayer
    SAMPLE_FMT_S32,             ///< signed 32 bits 
236
    SAMPLE_FMT_FLT,             ///< float
237
    SAMPLE_FMT_DBL,             ///< double
238 a96b68b7 Fabrice Bellard
};
239
240 de6d9b64 Fabrice Bellard
/* in bytes */
241 bc8d1857 Fabrice Bellard
#define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
242 de6d9b64 Fabrice Bellard
243 d7425f59 Michael Niedermayer
/**
244 cf713bb8 Michael Niedermayer
 * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
245
 * this is mainly needed because some optimized bitstream readers read 
246
 * 32 or 64 bit at once and could read over the end<br>
247
 * Note, if the first 23 bits of the additional bytes are not 0 then damaged
248
 * MPEG bitstreams could cause overread and segfault
249 d7425f59 Michael Niedermayer
 */
250
#define FF_INPUT_BUFFER_PADDING_SIZE 8
251
252 0ecca7a4 Michael Niedermayer
/**
253
 * minimum encoding buffer size.
254
 * used to avoid some checks during header writing
255
 */
256
#define FF_MIN_BUFFER_SIZE 16384
257
258 e4986da9 Juanjo
/* motion estimation type, EPZS by default */
259
enum Motion_Est_ID {
260 101bea5f Juanjo
    ME_ZERO = 1,
261 e4986da9 Juanjo
    ME_FULL,
262
    ME_LOG,
263
    ME_PHODS,
264
    ME_EPZS,
265
    ME_X1
266
};
267
268 1f018225 Michael Niedermayer
enum AVRounding {
269
    AV_ROUND_ZERO     = 0, ///< round toward zero
270
    AV_ROUND_INF      = 1, ///< round away from zero
271
    AV_ROUND_DOWN     = 2, ///< round toward -infinity
272
    AV_ROUND_UP       = 3, ///< round toward +infinity
273
    AV_ROUND_NEAR_INF = 5, ///< round to nearest and halfway cases away from zero
274
};
275
276 ce980a95 Michael Niedermayer
typedef struct RcOverride{
277
    int start_frame;
278
    int end_frame;
279
    int qscale; // if this is 0 then quality_factor will be used instead
280
    float quality_factor;
281
} RcOverride;
282
283 101bea5f Juanjo
/* only for ME compatiblity with old apps */
284
extern int motion_estimation_method;
285
286 4e00e76b Michael Niedermayer
#define FF_MAX_B_FRAMES 8
287 9dbcbd92 Michael Niedermayer
288 a949d72e Michael Niedermayer
/* encoding support
289
   these flags can be passed in AVCodecContext.flags before initing 
290
   Note: note not everything is supported yet 
291
*/
292 de6d9b64 Fabrice Bellard
293 64863965 Michael Niedermayer
#define CODEC_FLAG_QSCALE 0x0002  ///< use fixed qscale 
294 dba019da Michael Niedermayer
#define CODEC_FLAG_4MV    0x0004  ///< 4 MV per MB allowed / Advanced prediction for H263
295 64863965 Michael Niedermayer
#define CODEC_FLAG_QPEL   0x0010  ///< use qpel MC 
296
#define CODEC_FLAG_GMC    0x0020  ///< use GMC 
297 ca7d05d5 Michael Niedermayer
#define CODEC_FLAG_MV0    0x0040  ///< always try a MB with MV=<0,0> 
298 64863965 Michael Niedermayer
#define CODEC_FLAG_PART   0x0080  ///< use data partitioning 
299 9dbcbd92 Michael Niedermayer
/* parent program gurantees that the input for b-frame containing streams is not written to 
300
   for at least s->max_b_frames+1 frames, if this is not set than the input will be copied */
301 8b4c7dbc Michael Niedermayer
#define CODEC_FLAG_INPUT_PRESERVED 0x0100
302 64863965 Michael Niedermayer
#define CODEC_FLAG_PASS1 0x0200   ///< use internal 2pass ratecontrol in first  pass mode 
303
#define CODEC_FLAG_PASS2 0x0400   ///< use internal 2pass ratecontrol in second pass mode 
304
#define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< use external huffman table (for mjpeg) 
305
#define CODEC_FLAG_GRAY  0x2000   ///< only decode/encode grayscale 
306
#define CODEC_FLAG_EMU_EDGE 0x4000///< dont draw edges 
307
#define CODEC_FLAG_PSNR           0x8000 ///< error[?] variables will be set during encoding 
308
#define CODEC_FLAG_TRUNCATED  0x00010000 /** input bitstream might be truncated at a random location instead 
309 d7425f59 Michael Niedermayer
                                            of only at frame boundaries */
310 64863965 Michael Niedermayer
#define CODEC_FLAG_NORMALIZE_AQP  0x00020000 ///< normalize adaptive quantization 
311
#define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< use interlaced dct 
312 3bb07d61 Michael Niedermayer
#define CODEC_FLAG_LOW_DELAY      0x00080000 ///< force low delay
313 64863965 Michael Niedermayer
#define CODEC_FLAG_ALT_SCAN       0x00100000 ///< use alternate scan 
314
#define CODEC_FLAG_TRELLIS_QUANT  0x00200000 ///< use trellis quantization 
315
#define CODEC_FLAG_GLOBAL_HEADER  0x00400000 ///< place global headers in extradata instead of every keyframe 
316
#define CODEC_FLAG_BITEXACT       0x00800000 ///< use only bitexact stuff (except (i)dct) 
317 21e59552 Michael Niedermayer
/* Fx : Flag for h263+ extra options */
318 8d8c0294 Michael Niedermayer
#define CODEC_FLAG_H263P_AIC      0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction (remove this)
319
#define CODEC_FLAG_AC_PRED        0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction
320 64863965 Michael Niedermayer
#define CODEC_FLAG_H263P_UMV      0x02000000 ///< Unlimited motion vector  
321 f2f6134b Michael Niedermayer
#define CODEC_FLAG_CBP_RD         0x04000000 ///< use rate distortion optimization for cbp
322 1f26c6f3 Michael Niedermayer
#define CODEC_FLAG_QP_RD          0x08000000 ///< use rate distortion optimization for qp selectioon
323 dba019da Michael Niedermayer
#define CODEC_FLAG_H263P_AIV      0x00000008 ///< H263 Alternative inter vlc
324 332f9ac4 Michael Niedermayer
#define CODEC_FLAG_OBMC           0x00000001 ///< OBMC
325
#define CODEC_FLAG_LOOP_FILTER    0x00000800 ///< loop filter
326 bb198e19 Michael Niedermayer
#define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000
327
#define CODEC_FLAG_INTERLACED_ME  0x20000000 ///< interlaced motion estimation
328 baaf3f46 Michael Niedermayer
#define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< will reserve space for SVCD scan offset user data
329 303e50e6 Michael Niedermayer
#define CODEC_FLAG_CLOSED_GOP     0x80000000
330 6fc5b059 Michael Niedermayer
#define CODEC_FLAG2_FAST          0x00000001 ///< allow non spec compliant speedup tricks
331 03581772 Michael Niedermayer
#define CODEC_FLAG2_STRICT_GOP    0x00000002 ///< strictly enforce GOP size
332 09b0499f Michael Niedermayer
#define CODEC_FLAG2_NO_OUTPUT     0x00000004 ///< skip bitstream encoding
333 6fc5b059 Michael Niedermayer
334 21e59552 Michael Niedermayer
/* Unsupported options :
335
 *                 Syntax Arithmetic coding (SAC)
336
 *                 Reference Picture Selection
337 ba58dabc Michael Niedermayer
 *                 Independant Segment Decoding */
338 21e59552 Michael Niedermayer
/* /Fx */
339 bf89e6b1 Fabrice Bellard
/* codec capabilities */
340
341 64863965 Michael Niedermayer
#define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< decoder can use draw_horiz_band callback 
342 6814a25c Michael Niedermayer
/**
343
 * Codec uses get_buffer() for allocating buffers.
344
 * direct rendering method 1
345
 */
346
#define CODEC_CAP_DR1             0x0002
347 917e06c8 Fabrice Bellard
/* if 'parse_only' field is true, then avcodec_parse_frame() can be
348
   used */
349
#define CODEC_CAP_PARSE_ONLY      0x0004
350 d7425f59 Michael Niedermayer
#define CODEC_CAP_TRUNCATED       0x0008
351 5e5c247a Ivan Kalvachev
/* codec can export data for HW decoding (XvMC) */
352
#define CODEC_CAP_HWACCEL         0x0010
353 934982c4 Michael Niedermayer
/** 
354
 * codec has a non zero delay and needs to be feeded with NULL at the end to get the delayed data.
355
 * if this is not set, the codec is guranteed to never be feeded with NULL data
356
 */
357 6f824977 Michael Niedermayer
#define CODEC_CAP_DELAY           0x0020
358 bf89e6b1 Fabrice Bellard
359 8d7ec294 Wolfgang Hesseler
//the following defines might change, so dont expect compatibility if u use them
360
#define MB_TYPE_INTRA4x4   0x0001
361
#define MB_TYPE_INTRA16x16 0x0002 //FIXME h264 specific
362
#define MB_TYPE_INTRA_PCM  0x0004 //FIXME h264 specific
363
#define MB_TYPE_16x16      0x0008
364
#define MB_TYPE_16x8       0x0010
365
#define MB_TYPE_8x16       0x0020
366
#define MB_TYPE_8x8        0x0040
367
#define MB_TYPE_INTERLACED 0x0080
368
#define MB_TYPE_DIRECT2     0x0100 //FIXME
369
#define MB_TYPE_ACPRED     0x0200
370
#define MB_TYPE_GMC        0x0400
371
#define MB_TYPE_SKIP       0x0800
372
#define MB_TYPE_P0L0       0x1000
373
#define MB_TYPE_P1L0       0x2000
374
#define MB_TYPE_P0L1       0x4000
375
#define MB_TYPE_P1L1       0x8000
376
#define MB_TYPE_L0         (MB_TYPE_P0L0 | MB_TYPE_P1L0)
377
#define MB_TYPE_L1         (MB_TYPE_P0L1 | MB_TYPE_P1L1)
378
#define MB_TYPE_L0L1       (MB_TYPE_L0   | MB_TYPE_L1)
379
#define MB_TYPE_QUANT      0x00010000
380
#define MB_TYPE_CBP        0x00020000
381
//Note bits 24-31 are reserved for codec specific use (h264 ref0, mpeg1 0mv, ...)
382
383 fa384dcc Michael Niedermayer
/**
384
 * Pan Scan area.
385
 * this specifies the area which should be displayed. Note there may be multiple such areas for one frame
386
 */
387
typedef struct AVPanScan{
388
    /**
389
     * id.
390
     * - encoding: set by user.
391
     * - decoding: set by lavc
392
     */
393
    int id;
394
395
    /**
396
     * width and height in 1/16 pel
397
     * - encoding: set by user.
398
     * - decoding: set by lavc
399
     */
400
    int width;
401
    int height;
402
403
    /**
404
     * position of the top left corner in 1/16 pel for up to 3 fields/frames.
405
     * - encoding: set by user.
406
     * - decoding: set by lavc
407
     */
408
    int16_t position[3][2];
409
}AVPanScan;
410
411 492cd3a9 Michael Niedermayer
#define FF_COMMON_FRAME \
412 b536d0aa Michael Niedermayer
    /**\
413
     * pointer to the picture planes.\
414
     * this might be different from the first allocated byte\
415
     * - encoding: \
416
     * - decoding: \
417
     */\
418 1e491e29 Michael Niedermayer
    uint8_t *data[4];\
419
    int linesize[4];\
420
    /**\
421 32db2b1d Michael Niedermayer
     * pointer to the first allocated byte of the picture. can be used in get_buffer/release_buffer\
422 1e491e29 Michael Niedermayer
     * this isnt used by lavc unless the default get/release_buffer() is used\
423 64863965 Michael Niedermayer
     * - encoding: \
424
     * - decoding: \
425 1e491e29 Michael Niedermayer
     */\
426
    uint8_t *base[4];\
427
    /**\
428
     * 1 -> keyframe, 0-> not\
429 64863965 Michael Niedermayer
     * - encoding: set by lavc\
430
     * - decoding: set by lavc\
431 1e491e29 Michael Niedermayer
     */\
432
    int key_frame;\
433
\
434
    /**\
435 0da71265 Michael Niedermayer
     * picture type of the frame, see ?_TYPE below.\
436 64863965 Michael Niedermayer
     * - encoding: set by lavc for coded_picture (and set by user for input)\
437
     * - decoding: set by lavc\
438 1e491e29 Michael Niedermayer
     */\
439
    int pict_type;\
440
\
441
    /**\
442 9740beff Michael Niedermayer
     * presentation timestamp in AV_TIME_BASE (=micro seconds currently) (time when frame should be shown to user)\
443
     * if AV_NOPTS_VALUE then the frame_rate will be used as reference\
444 64863965 Michael Niedermayer
     * - encoding: MUST be set by user\
445
     * - decoding: set by lavc\
446 1e491e29 Michael Niedermayer
     */\
447 be6784dc Richard Hodges
    int64_t pts;\
448 1e491e29 Michael Niedermayer
\
449
    /**\
450
     * picture number in bitstream order.\
451 64863965 Michael Niedermayer
     * - encoding: set by\
452
     * - decoding: set by lavc\
453 1e491e29 Michael Niedermayer
     */\
454
    int coded_picture_number;\
455
    /**\
456
     * picture number in display order.\
457 64863965 Michael Niedermayer
     * - encoding: set by\
458
     * - decoding: set by lavc\
459 1e491e29 Michael Niedermayer
     */\
460
    int display_picture_number;\
461
\
462
    /**\
463 158c7f05 Michael Niedermayer
     * quality (between 1 (good) and FF_LAMBDA_MAX (bad)) \
464 64863965 Michael Niedermayer
     * - encoding: set by lavc for coded_picture (and set by user for input)\
465
     * - decoding: set by lavc\
466 1e491e29 Michael Niedermayer
     */\
467 158c7f05 Michael Niedermayer
    int quality; \
468 1e491e29 Michael Niedermayer
\
469
    /**\
470
     * buffer age (1->was last buffer and dint change, 2->..., ...).\
471 158c7f05 Michael Niedermayer
     * set to INT_MAX if the buffer has not been used yet \
472 64863965 Michael Niedermayer
     * - encoding: unused\
473
     * - decoding: MUST be set by get_buffer()\
474 1e491e29 Michael Niedermayer
     */\
475
    int age;\
476
\
477
    /**\
478
     * is this picture used as reference\
479 64863965 Michael Niedermayer
     * - encoding: unused\
480
     * - decoding: set by lavc (before get_buffer() call))\
481 1e491e29 Michael Niedermayer
     */\
482
    int reference;\
483
\
484
    /**\
485
     * QP table\
486 64863965 Michael Niedermayer
     * - encoding: unused\
487
     * - decoding: set by lavc\
488 1e491e29 Michael Niedermayer
     */\
489
    int8_t *qscale_table;\
490
    /**\
491
     * QP store stride\
492 64863965 Michael Niedermayer
     * - encoding: unused\
493
     * - decoding: set by lavc\
494 1e491e29 Michael Niedermayer
     */\
495
    int qstride;\
496
\
497
    /**\
498
     * mbskip_table[mb]>=1 if MB didnt change\
499
     * stride= mb_width = (width+15)>>4\
500 64863965 Michael Niedermayer
     * - encoding: unused\
501
     * - decoding: set by lavc\
502 1e491e29 Michael Niedermayer
     */\
503
    uint8_t *mbskip_table;\
504
\
505
    /**\
506 61436073 Michael Niedermayer
     * Motion vector table.\
507
     * @code\
508
     * example:\
509
     * int mv_sample_log2= 4 - motion_subsample_log2;\
510
     * int mb_width= (width+15)>>4;\
511
     * int mv_stride= (mb_width << mv_sample_log2) + 1;\
512
     * motion_val[direction][x + y*mv_stride][0->mv_x, 1->mv_y];\
513
     * @endcode\
514 a4d36c11 Michael Niedermayer
     * - encoding: set by user\
515 8d7ec294 Wolfgang Hesseler
     * - decoding: set by lavc\
516
     */\
517
    int16_t (*motion_val[2])[2];\
518
\
519
    /**\
520
     * Macroblock type table\
521
     * mb_type_base + mb_width + 2\
522 a4d36c11 Michael Niedermayer
     * - encoding: set by user\
523 8d7ec294 Wolfgang Hesseler
     * - decoding: set by lavc\
524
     */\
525
    uint32_t *mb_type;\
526
\
527
    /**\
528 f0b77c69 Michael Niedermayer
     * log2 of the size of the block which a single vector in motion_val represents: \
529
     * (4->16x16, 3->8x8, 2-> 4x4, 1-> 2x2)\
530 8d7ec294 Wolfgang Hesseler
     * - encoding: unused\
531
     * - decoding: set by lavc\
532
     */\
533
    uint8_t motion_subsample_log2;\
534
\
535
    /**\
536 1e491e29 Michael Niedermayer
     * for some private data of the user\
537 64863965 Michael Niedermayer
     * - encoding: unused\
538
     * - decoding: set by user\
539 1e491e29 Michael Niedermayer
     */\
540
    void *opaque;\
541 140cb663 Michael Niedermayer
\
542
    /**\
543
     * error\
544 64863965 Michael Niedermayer
     * - encoding: set by lavc if flags&CODEC_FLAG_PSNR\
545
     * - decoding: unused\
546 140cb663 Michael Niedermayer
     */\
547
    uint64_t error[4];\
548 4e00e76b Michael Niedermayer
\
549
    /**\
550
     * type of the buffer (to keep track of who has to dealloc data[*])\
551 64863965 Michael Niedermayer
     * - encoding: set by the one who allocs it\
552
     * - decoding: set by the one who allocs it\
553 3db320ea Falk Hüffner
     * Note: user allocated (direct rendering) & internal buffers can not coexist currently\
554 4e00e76b Michael Niedermayer
     */\
555
    int type;\
556 2ec23b6d Michael Niedermayer
    \
557
    /**\
558
     * when decoding, this signal how much the picture must be delayed.\
559
     * extra_delay = repeat_pict / (2*fps)\
560 64863965 Michael Niedermayer
     * - encoding: unused\
561
     * - decoding: set by lavc\
562 2ec23b6d Michael Niedermayer
     */\
563 0426af31 Michael Niedermayer
    int repeat_pict;\
564
    \
565
    /**\
566
     * \
567
     */\
568
    int qscale_type;\
569 2744ca9a Roman Shaposhnik
    \
570
    /**\
571
     * The content of the picture is interlaced.\
572
     * - encoding: set by user\
573
     * - decoding: set by lavc (default 0)\
574
     */\
575
    int interlaced_frame;\
576
    \
577
    /**\
578 9dad924e Michael Niedermayer
     * if the content is interlaced, is top field displayed first.\
579 2744ca9a Roman Shaposhnik
     * - encoding: set by user\
580 9dad924e Michael Niedermayer
     * - decoding: set by lavc\
581 2744ca9a Roman Shaposhnik
     */\
582 9dad924e Michael Niedermayer
    int top_field_first;\
583 fa384dcc Michael Niedermayer
    \
584
    /**\
585
     * Pan scan.\
586
     * - encoding: set by user\
587
     * - decoding: set by lavc\
588
     */\
589
    AVPanScan *pan_scan;\
590 2a2bbcb0 Mike Melanson
    \
591
    /**\
592
     * tell user application that palette has changed from previous frame.\
593
     * - encoding: ??? (no palette-enabled encoder yet)\
594
     * - decoding: set by lavc (default 0)\
595
     */\
596
    int palette_has_changed;\
597 074c4ca7 Roberto Togni
    \
598
    /**\
599
     * Codec suggestion on buffer type if != 0\
600
     * - encoding: unused\
601
     * - decoding: set by lavc (before get_buffer() call))\
602
     */\
603
    int buffer_hints;\
604 8289c6fa Wolfgang Hesseler
\
605
    /**\
606
     * DCT coeffitients\
607
     * - encoding: unused\
608
     * - decoding: set by lavc\
609
     */\
610
    short *dct_coeff;\
611 a4d36c11 Michael Niedermayer
\
612
    /**\
613
     * Motion referece frame index\
614
     * - encoding: set by user\
615
     * - decoding: set by lavc\
616
     */\
617
    int8_t *ref_index[2];
618 2ec23b6d Michael Niedermayer
619 0426af31 Michael Niedermayer
#define FF_QSCALE_TYPE_MPEG1        0
620
#define FF_QSCALE_TYPE_MPEG2        1
621 4e00e76b Michael Niedermayer
622
#define FF_BUFFER_TYPE_INTERNAL 1
623 9b56edf5 Michael Niedermayer
#define FF_BUFFER_TYPE_USER     2 ///< Direct rendering buffers (image is (de)allocated by user)
624 a4d36c11 Michael Niedermayer
#define FF_BUFFER_TYPE_SHARED   4 ///< buffer from somewher else, dont dealloc image (data/base), all other tables are not shared
625 9b56edf5 Michael Niedermayer
#define FF_BUFFER_TYPE_COPY     8 ///< just a (modified) copy of some other buffer, dont dealloc anything
626 4e00e76b Michael Niedermayer
627 1e491e29 Michael Niedermayer
628 140cb663 Michael Niedermayer
#define FF_I_TYPE 1 // Intra
629
#define FF_P_TYPE 2 // Predicted
630
#define FF_B_TYPE 3 // Bi-dir predicted
631
#define FF_S_TYPE 4 // S(GMC)-VOP MPEG4
632 0da71265 Michael Niedermayer
#define FF_SI_TYPE 5
633
#define FF_SP_TYPE 6
634 1e491e29 Michael Niedermayer
635 074c4ca7 Roberto Togni
#define FF_BUFFER_HINTS_VALID    0x01 // Buffer hints value is meaningful (if 0 ignore)
636
#define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer
637
#define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content
638
#define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update)
639
640 0da71265 Michael Niedermayer
/**
641
 * Audio Video Frame.
642
 */
643 492cd3a9 Michael Niedermayer
typedef struct AVFrame {
644
    FF_COMMON_FRAME
645
} AVFrame;
646 1e491e29 Michael Niedermayer
647 14bea432 Michael Niedermayer
#define DEFAULT_FRAME_RATE_BASE 1001000
648 d33c949c Michael Niedermayer
649
/**
650 bc874dae Michel Bardiaux
 * Used by av_log
651
 */
652
typedef struct AVCLASS AVClass;
653
struct AVCLASS {
654
    const char* class_name;
655
    const char* (*item_name)(void*); /* actually passing a pointer to an AVCodecContext
656
                                        or AVFormatContext, which begin with an AVClass.
657
                                        Needed because av_log is in libavcodec and has no visibility
658
                                        of AVIn/OutputFormat */
659
};
660
661
/**
662 d33c949c Michael Niedermayer
 * main external api structure.
663
 */
664 de6d9b64 Fabrice Bellard
typedef struct AVCodecContext {
665 b71901e6 Michael Niedermayer
    /**
666 bc874dae Michel Bardiaux
     * Info on struct for av_log
667
     * - set by avcodec_alloc_context
668
     */
669 43465395 Michael Niedermayer
    AVClass *av_class;
670 bc874dae Michel Bardiaux
    /**
671 64863965 Michael Niedermayer
     * the average bitrate.
672
     * - encoding: set by user. unused for constant quantizer encoding
673
     * - decoding: set by lavc. 0 or some bitrate if this info is available in the stream 
674 b71901e6 Michael Niedermayer
     */
675 de6d9b64 Fabrice Bellard
    int bit_rate;
676 b71901e6 Michael Niedermayer
677
    /**
678 64863965 Michael Niedermayer
     * number of bits the bitstream is allowed to diverge from the reference.
679 b71901e6 Michael Niedermayer
     *           the reference can be CBR (for CBR pass1) or VBR (for pass2)
680 64863965 Michael Niedermayer
     * - encoding: set by user. unused for constant quantizer encoding
681
     * - decoding: unused
682 b71901e6 Michael Niedermayer
     */
683
    int bit_rate_tolerance; 
684
685
    /**
686 64863965 Michael Niedermayer
     * CODEC_FLAG_*.
687
     * - encoding: set by user.
688
     * - decoding: set by user.
689 b71901e6 Michael Niedermayer
     */
690 de6d9b64 Fabrice Bellard
    int flags;
691 b71901e6 Michael Niedermayer
692
    /**
693
     * some codecs needs additionnal format info. It is stored here
694 64863965 Michael Niedermayer
     * - encoding: set by user. 
695
     * - decoding: set by lavc. (FIXME is this ok?)
696 b71901e6 Michael Niedermayer
     */
697
    int sub_id;
698
699
    /**
700 64863965 Michael Niedermayer
     * motion estimation algorithm used for video coding.
701
     * - encoding: MUST be set by user.
702
     * - decoding: unused
703 b71901e6 Michael Niedermayer
     */
704
    int me_method;
705
706
    /**
707 64863965 Michael Niedermayer
     * some codecs need / can use extra-data like huffman tables.
708 b71901e6 Michael Niedermayer
     * mjpeg: huffman tables
709
     * rv10: additional flags
710 b704e742 Michael Niedermayer
     * mpeg4: global headers (they can be in the bitstream or here)
711 dffcdbb5 Michael Niedermayer
     * the allocated memory should be FF_INPUT_BUFFER_PADDING_SIZE bytes larger
712
     * then extradata_size to avoid prolems if its read with the bitstream reader
713 64863965 Michael Niedermayer
     * - encoding: set/allocated/freed by lavc.
714
     * - decoding: set/allocated/freed by user.
715 b71901e6 Michael Niedermayer
     */
716 e84c31dc Arpi
    void *extradata;
717
    int extradata_size;
718
    
719 de6d9b64 Fabrice Bellard
    /* video only */
720 b71901e6 Michael Niedermayer
    /**
721 14bea432 Michael Niedermayer
     * frames per sec multiplied by frame_rate_base.
722 b71901e6 Michael Niedermayer
     * for variable fps this is the precission, so if the timestamps 
723 14bea432 Michael Niedermayer
     * can be specified in msec precssion then this is 1000*frame_rate_base
724 64863965 Michael Niedermayer
     * - encoding: MUST be set by user
725
     * - decoding: set by lavc. 0 or the frame_rate if available
726 b71901e6 Michael Niedermayer
     */
727
    int frame_rate;
728 14bea432 Michael Niedermayer
    
729
    /**
730 21adafec Michael Niedermayer
     * picture width / height.
731 64863965 Michael Niedermayer
     * - encoding: MUST be set by user. 
732 21adafec Michael Niedermayer
     * - decoding: set by lavc.
733
     * Note, for compatibility its possible to set this instead of 
734
     * coded_width/height before decoding
735 b71901e6 Michael Niedermayer
     */
736 de6d9b64 Fabrice Bellard
    int width, height;
737 b71901e6 Michael Niedermayer
    
738 e769f053 Alex Beregszaszi
#define FF_ASPECT_EXTENDED 15
739 b71901e6 Michael Niedermayer
740
    /**
741 64863965 Michael Niedermayer
     * the number of pictures in a group of pitures, or 0 for intra_only.
742
     * - encoding: set by user.
743
     * - decoding: unused
744 b71901e6 Michael Niedermayer
     */
745
    int gop_size;
746
747
    /**
748 64863965 Michael Niedermayer
     * pixel format, see PIX_FMT_xxx.
749 a3a5f4d6 Michael Niedermayer
     * - encoding: set by user.
750 64863965 Michael Niedermayer
     * - decoding: set by lavc.
751 b71901e6 Michael Niedermayer
     */
752 e4eadb4b Michael Niedermayer
    enum PixelFormat pix_fmt;
753 bdfcbbed Max Krasnyansky
 
754
    /**
755
     * Frame rate emulation. If not zero lower layer (i.e. format handler) 
756
     * has to read frames at native frame rate.
757
     * - encoding: set by user.
758
     * - decoding: unused.
759
     */
760
    int rate_emu;
761
       
762 b71901e6 Michael Niedermayer
    /**
763
     * if non NULL, 'draw_horiz_band' is called by the libavcodec
764
     * decoder to draw an horizontal band. It improve cache usage. Not
765
     * all codecs can do that. You must check the codec capabilities
766
     * before
767 64863965 Michael Niedermayer
     * - encoding: unused
768
     * - decoding: set by user.
769 3bb07d61 Michael Niedermayer
     * @param height the height of the slice
770
     * @param y the y position of the slice
771
     * @param type 1->top field, 2->bottom field, 3->frame
772
     * @param offset offset into the AVFrame.data from which the slice should be read
773 b71901e6 Michael Niedermayer
     */
774 bf89e6b1 Fabrice Bellard
    void (*draw_horiz_band)(struct AVCodecContext *s,
775 da64ecc3 Drew Hess
                            const AVFrame *src, int offset[4],
776 3bb07d61 Michael Niedermayer
                            int y, int type, int height);
777 bf89e6b1 Fabrice Bellard
778 de6d9b64 Fabrice Bellard
    /* audio only */
779 64863965 Michael Niedermayer
    int sample_rate; ///< samples per sec 
780 de6d9b64 Fabrice Bellard
    int channels;
781 a3a5f4d6 Michael Niedermayer
782
    /**
783
     * audio sample format.
784
     * - encoding: set by user.
785
     * - decoding: set by lavc.
786
     */
787
    enum SampleFormat sample_fmt;  ///< sample format, currenly unused 
788 de6d9b64 Fabrice Bellard
789
    /* the following data should not be initialized */
790 64863965 Michael Niedermayer
    int frame_size;     ///< in samples, initialized when calling 'init' 
791
    int frame_number;   ///< audio or video frame number 
792
    int real_pict_num;  ///< returns the real picture number of previous encoded frame 
793 1e491e29 Michael Niedermayer
    
794 b71901e6 Michael Niedermayer
    /**
795
     * number of frames the decoded output will be delayed relative to 
796 64863965 Michael Niedermayer
     * the encoded input.
797
     * - encoding: set by lavc.
798
     * - decoding: unused
799 b71901e6 Michael Niedermayer
     */
800
    int delay;
801 1ff662cc Michael Niedermayer
    
802 64863965 Michael Niedermayer
    /* - encoding parameters */
803
    float qcompress;  ///< amount of qscale change between easy & hard scenes (0.0-1.0)
804
    float qblur;      ///< amount of qscale smoothing over time (0.0-1.0) 
805 b71901e6 Michael Niedermayer
    
806
    /**
807 64863965 Michael Niedermayer
     * minimum quantizer.
808
     * - encoding: set by user.
809
     * - decoding: unused
810 b71901e6 Michael Niedermayer
     */
811
    int qmin;
812
813
    /**
814 64863965 Michael Niedermayer
     * maximum quantizer.
815
     * - encoding: set by user.
816
     * - decoding: unused
817 b71901e6 Michael Niedermayer
     */
818
    int qmax;
819
820
    /**
821 64863965 Michael Niedermayer
     * maximum quantizer difference etween frames.
822
     * - encoding: set by user.
823
     * - decoding: unused
824 b71901e6 Michael Niedermayer
     */
825
    int max_qdiff;
826
827
    /**
828 64863965 Michael Niedermayer
     * maximum number of b frames between non b frames.
829 b71901e6 Michael Niedermayer
     * note: the output will be delayed by max_b_frames+1 relative to the input
830 64863965 Michael Niedermayer
     * - encoding: set by user.
831
     * - decoding: unused
832 b71901e6 Michael Niedermayer
     */
833
    int max_b_frames;
834
835
    /**
836 64863965 Michael Niedermayer
     * qscale factor between ip and b frames.
837
     * - encoding: set by user.
838
     * - decoding: unused
839 b71901e6 Michael Niedermayer
     */
840
    float b_quant_factor;
841
    
842
    /** obsolete FIXME remove */
843
    int rc_strategy;
844 8b4c7dbc Michael Niedermayer
    int b_frame_strategy;
845 9dbcbd92 Michael Niedermayer
846 b71901e6 Michael Niedermayer
    /**
847 64863965 Michael Niedermayer
     * hurry up amount.
848
     * - encoding: unused
849
     * - decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too, 5-> skip everything except header
850 b71901e6 Michael Niedermayer
     */
851
    int hurry_up;
852 2417652e Michael Niedermayer
    
853 de6d9b64 Fabrice Bellard
    struct AVCodec *codec;
854 b71901e6 Michael Niedermayer
    
855 de6d9b64 Fabrice Bellard
    void *priv_data;
856
857 ba58dabc Michael Niedermayer
    /* unused, FIXME remove*/
858
    int rtp_mode;
859 644d98a4 Juanjo
    
860
    int rtp_payload_size;   /* The size of the RTP payload, the coder will  */
861
                            /* do it's best to deliver a chunk with size    */
862
                            /* below rtp_payload_size, the chunk will start */
863
                            /* with a start code on some codecs like H.263  */
864
                            /* This doesn't take account of any particular  */
865
                            /* headers inside the transmited RTP payload    */
866 81401c1f Juanjo
867
    
868
    /* The RTP callcack: This function is called  */
869
    /* every time the encoder as a packet to send */
870
    /* Depends on the encoder if the data starts  */
871 ebaa7e03 Johan Bilien
    /* with a Start Code (it should) H.263 does.  */
872
    /* mb_nb contains the number of macroblocks   */
873
    /* encoded in the RTP payload                 */
874
    void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb); 
875 81401c1f Juanjo
876 098eefe1 Michael Niedermayer
    /* statistics, used for 2-pass encoding */
877
    int mv_bits;
878
    int header_bits;
879
    int i_tex_bits;
880
    int p_tex_bits;
881
    int i_count;
882
    int p_count;
883
    int skip_count;
884 b71901e6 Michael Niedermayer
    int misc_bits;
885
    
886
    /**
887 64863965 Michael Niedermayer
     * number of bits used for the previously encoded frame.
888
     * - encoding: set by lavc
889 7004ffb3 Michael Niedermayer
     * - decoding: unused
890 b71901e6 Michael Niedermayer
     */
891 098eefe1 Michael Niedermayer
    int frame_bits;
892 7004ffb3 Michael Niedermayer
893 b71901e6 Michael Niedermayer
    /**
894 64863965 Michael Niedermayer
     * private data of the user, can be used to carry app specific stuff.
895
     * - encoding: set by user
896
     * - decoding: set by user
897 b71901e6 Michael Niedermayer
     */
898
    void *opaque;
899
900 de6d9b64 Fabrice Bellard
    char codec_name[32];
901 4a663d80 Philip Gladstone
    enum CodecType codec_type; /* see CODEC_TYPE_xxx */
902
    enum CodecID codec_id; /* see CODEC_ID_xxx */
903 7004ffb3 Michael Niedermayer
    
904
    /**
905
     * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
906
     * this is used to workaround some encoder bugs
907 bd5a6020 Michael Niedermayer
     * - encoding: set by user, if not then the default based on codec_id will be used
908 7004ffb3 Michael Niedermayer
     * - decoding: set by user, will be converted to upper case by lavc during init
909
     */
910
    unsigned int codec_tag;
911 92ba5ffb Michael Niedermayer
    
912 b71901e6 Michael Niedermayer
    /**
913 64863965 Michael Niedermayer
     * workaround bugs in encoders which sometimes cannot be detected automatically.
914 59fa3f96 Michael Niedermayer
     * - encoding: set by user
915 64863965 Michael Niedermayer
     * - decoding: set by user
916 b71901e6 Michael Niedermayer
     */
917
    int workaround_bugs;
918 64863965 Michael Niedermayer
#define FF_BUG_AUTODETECT       1  ///< autodetection
919 4d2858de Michael Niedermayer
#define FF_BUG_OLD_MSMPEG4      2
920
#define FF_BUG_XVID_ILACE       4
921
#define FF_BUG_UMP4             8
922
#define FF_BUG_NO_PADDING       16
923 3116cb14 Michael Niedermayer
#define FF_BUG_AMV              32
924 ac0c6638 Michael Niedermayer
#define FF_BUG_AC_VLC           0  ///< will be removed, libavcodec can now handle these non compliant files by default
925 03e93d35 Michael Niedermayer
#define FF_BUG_QPEL_CHROMA      64
926 db794953 Michael Niedermayer
#define FF_BUG_STD_QPEL         128
927 36df8805 Michael Niedermayer
#define FF_BUG_QPEL_CHROMA2     256
928 c40c3482 Michael Niedermayer
#define FF_BUG_DIRECT_BLOCKSIZE 512
929 1c6dcb0f Michael Niedermayer
#define FF_BUG_EDGE             1024
930 b44bdf7e Michael Niedermayer
#define FF_BUG_HPEL_CHROMA      2048
931 4ccde216 Michael Niedermayer
#define FF_BUG_DC_CLIP          4096
932 59fa3f96 Michael Niedermayer
#define FF_BUG_MS               8192 ///< workaround various bugs in microsofts broken decoders
933 4d2858de Michael Niedermayer
//#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
934
        
935 b71901e6 Michael Niedermayer
    /**
936 64863965 Michael Niedermayer
     * luma single coeff elimination threshold.
937
     * - encoding: set by user
938
     * - decoding: unused
939 b71901e6 Michael Niedermayer
     */
940 1f6b6e50 Michael Niedermayer
    int luma_elim_threshold;
941 b71901e6 Michael Niedermayer
    
942
    /**
943 64863965 Michael Niedermayer
     * chroma single coeff elimination threshold.
944
     * - encoding: set by user
945
     * - decoding: unused
946 b71901e6 Michael Niedermayer
     */
947 1f6b6e50 Michael Niedermayer
    int chroma_elim_threshold;
948 b71901e6 Michael Niedermayer
    
949
    /**
950 64863965 Michael Niedermayer
     * strictly follow the std (MPEG4, ...).
951
     * - encoding: set by user
952
     * - decoding: unused
953 b71901e6 Michael Niedermayer
     */
954
    int strict_std_compliance;
955
    
956
    /**
957 64863965 Michael Niedermayer
     * qscale offset between ip and b frames.
958 b3a391e8 Michael Niedermayer
     * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
959
     * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
960 64863965 Michael Niedermayer
     * - encoding: set by user.
961
     * - decoding: unused
962 b71901e6 Michael Niedermayer
     */
963
    float b_quant_offset;
964
    
965
    /**
966 ce3bcaed Michael Niedermayer
     * error resilience higher values will detect more errors but may missdetect
967 64863965 Michael Niedermayer
     * some more or less valid parts as errors.
968
     * - encoding: unused
969
     * - decoding: set by user
970 b71901e6 Michael Niedermayer
     */
971 1f6b6e50 Michael Niedermayer
    int error_resilience;
972 ce3bcaed Michael Niedermayer
#define FF_ER_CAREFULL        1
973
#define FF_ER_COMPLIANT       2
974
#define FF_ER_AGGRESSIVE      3
975
#define FF_ER_VERY_AGGRESSIVE 4
976 ae72cda6 Nick Kurshev
    
977 6b72ac63 Michael Niedermayer
    /**
978 1e491e29 Michael Niedermayer
     * called at the beginning of each frame to get a buffer for it.
979
     * if pic.reference is set then the frame will be read later by lavc
980 2b5296d2 Michael Niedermayer
     * avcodec_align_dimensions() should be used to find the required width and
981
     * height, as they normally need to be rounded up to the next multiple of 16
982 64863965 Michael Niedermayer
     * - encoding: unused
983
     * - decoding: set by lavc, user can override
984 b71901e6 Michael Niedermayer
     */
985 492cd3a9 Michael Niedermayer
    int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
986 b71901e6 Michael Niedermayer
    
987
    /**
988 1e491e29 Michael Niedermayer
     * called to release buffers which where allocated with get_buffer.
989
     * a released buffer can be reused in get_buffer()
990
     * pic.data[*] must be set to NULL
991 64863965 Michael Niedermayer
     * - encoding: unused
992
     * - decoding: set by lavc, user can override
993 b71901e6 Michael Niedermayer
     */
994 492cd3a9 Michael Niedermayer
    void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
995 0fd90455 Michael Niedermayer
996 b71901e6 Michael Niedermayer
    /**
997 e6a2ac34 Michael Niedermayer
     * if 1 the stream has a 1 frame delay during decoding.
998
     * - encoding: set by lavc
999 64863965 Michael Niedermayer
     * - decoding: set by lavc
1000 b71901e6 Michael Niedermayer
     */
1001
    int has_b_frames;
1002
    
1003 64863965 Michael Niedermayer
    int block_align; ///< used by some WAV based audio codecs
1004 ce980a95 Michael Niedermayer
    
1005 64863965 Michael Niedermayer
    int parse_only; /* - decoding only: if true, only parsing is done
1006 917e06c8 Fabrice Bellard
                       (function avcodec_parse_frame()). The frame
1007
                       data is returned. Only MPEG codecs support this now. */
1008 ce980a95 Michael Niedermayer
    
1009 b71901e6 Michael Niedermayer
    /**
1010 e4eadb4b Michael Niedermayer
     * 0-> h263 quant 1-> mpeg quant.
1011 64863965 Michael Niedermayer
     * - encoding: set by user.
1012
     * - decoding: unused
1013 b71901e6 Michael Niedermayer
     */
1014
    int mpeg_quant;
1015 ce980a95 Michael Niedermayer
    
1016 b71901e6 Michael Niedermayer
    /**
1017 64863965 Michael Niedermayer
     * pass1 encoding statistics output buffer.
1018
     * - encoding: set by lavc
1019
     * - decoding: unused
1020 b71901e6 Michael Niedermayer
     */
1021 64863965 Michael Niedermayer
    char *stats_out;
1022 b71901e6 Michael Niedermayer
    
1023
    /**
1024
     * pass2 encoding statistics input buffer.
1025
     * concatenated stuff from stats_out of pass1 should be placed here
1026 64863965 Michael Niedermayer
     * - encoding: allocated/set/freed by user
1027
     * - decoding: unused
1028 b71901e6 Michael Niedermayer
     */
1029
    char *stats_in;
1030
    
1031
    /**
1032 64863965 Michael Niedermayer
     * ratecontrol qmin qmax limiting method.
1033 b71901e6 Michael Niedermayer
     * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
1034 64863965 Michael Niedermayer
     * - encoding: set by user.
1035
     * - decoding: unused
1036 b71901e6 Michael Niedermayer
     */
1037 ce980a95 Michael Niedermayer
    float rc_qsquish;
1038 b71901e6 Michael Niedermayer
1039 ce980a95 Michael Niedermayer
    float rc_qmod_amp;
1040
    int rc_qmod_freq;
1041 b71901e6 Michael Niedermayer
    
1042
    /**
1043 64863965 Michael Niedermayer
     * ratecontrol override, see RcOverride.
1044
     * - encoding: allocated/set/freed by user.
1045
     * - decoding: unused
1046 b71901e6 Michael Niedermayer
     */
1047 ce980a95 Michael Niedermayer
    RcOverride *rc_override;
1048
    int rc_override_count;
1049 b71901e6 Michael Niedermayer
    
1050
    /**
1051 64863965 Michael Niedermayer
     * rate control equation.
1052
     * - encoding: set by user
1053
     * - decoding: unused
1054 b71901e6 Michael Niedermayer
     */
1055 ce980a95 Michael Niedermayer
    char *rc_eq;
1056 b71901e6 Michael Niedermayer
    
1057
    /**
1058 64863965 Michael Niedermayer
     * maximum bitrate.
1059
     * - encoding: set by user.
1060
     * - decoding: unused
1061 b71901e6 Michael Niedermayer
     */
1062 ce980a95 Michael Niedermayer
    int rc_max_rate;
1063 b71901e6 Michael Niedermayer
    
1064
    /**
1065 64863965 Michael Niedermayer
     * minimum bitrate.
1066
     * - encoding: set by user.
1067
     * - decoding: unused
1068 b71901e6 Michael Niedermayer
     */
1069 ce980a95 Michael Niedermayer
    int rc_min_rate;
1070 b71901e6 Michael Niedermayer
    
1071
    /**
1072 64863965 Michael Niedermayer
     * decoder bitstream buffer size.
1073
     * - encoding: set by user.
1074
     * - decoding: unused
1075 b71901e6 Michael Niedermayer
     */
1076 ce980a95 Michael Niedermayer
    int rc_buffer_size;
1077
    float rc_buffer_aggressivity;
1078 b71901e6 Michael Niedermayer
1079
    /**
1080 64863965 Michael Niedermayer
     * qscale factor between p and i frames.
1081 a1e257b2 Michael Niedermayer
     * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
1082
     * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
1083 64863965 Michael Niedermayer
     * - encoding: set by user.
1084
     * - decoding: unused
1085 b71901e6 Michael Niedermayer
     */
1086
    float i_quant_factor;
1087
    
1088
    /**
1089 64863965 Michael Niedermayer
     * qscale offset between p and i frames.
1090
     * - encoding: set by user.
1091
     * - decoding: unused
1092 b71901e6 Michael Niedermayer
     */
1093
    float i_quant_offset;
1094
    
1095
    /**
1096 64863965 Michael Niedermayer
     * initial complexity for pass1 ratecontrol.
1097
     * - encoding: set by user.
1098
     * - decoding: unused
1099 b71901e6 Michael Niedermayer
     */
1100 ce980a95 Michael Niedermayer
    float rc_initial_cplx;
1101 917e06c8 Fabrice Bellard
1102 b71901e6 Michael Niedermayer
    /**
1103 64863965 Michael Niedermayer
     * dct algorithm, see FF_DCT_* below.
1104
     * - encoding: set by user
1105
     * - decoding: unused
1106 b71901e6 Michael Niedermayer
     */
1107 28db7fce Michael Niedermayer
    int dct_algo;
1108 c7e07931 Martin Olschewski
#define FF_DCT_AUTO    0
1109 28db7fce Michael Niedermayer
#define FF_DCT_FASTINT 1
1110 c7e07931 Martin Olschewski
#define FF_DCT_INT     2
1111
#define FF_DCT_MMX     3
1112
#define FF_DCT_MLIB    4
1113 05c4072b Michael Niedermayer
#define FF_DCT_ALTIVEC 5
1114 65e4c8c9 Michael Niedermayer
#define FF_DCT_FAAN    6
1115 c5d309f2 Michael Niedermayer
    
1116
    /**
1117 64863965 Michael Niedermayer
     * luminance masking (0-> disabled).
1118
     * - encoding: set by user
1119
     * - decoding: unused
1120 c5d309f2 Michael Niedermayer
     */
1121
    float lumi_masking;
1122
    
1123
    /**
1124 64863965 Michael Niedermayer
     * temporary complexity masking (0-> disabled).
1125
     * - encoding: set by user
1126
     * - decoding: unused
1127 c5d309f2 Michael Niedermayer
     */
1128
    float temporal_cplx_masking;
1129
    
1130
    /**
1131 64863965 Michael Niedermayer
     * spatial complexity masking (0-> disabled).
1132
     * - encoding: set by user
1133
     * - decoding: unused
1134 c5d309f2 Michael Niedermayer
     */
1135
    float spatial_cplx_masking;
1136
    
1137
    /**
1138 64863965 Michael Niedermayer
     * p block masking (0-> disabled).
1139
     * - encoding: set by user
1140
     * - decoding: unused
1141 c5d309f2 Michael Niedermayer
     */
1142
    float p_masking;
1143 15415af4 Michael Niedermayer
1144 5e746b99 Michael Niedermayer
    /**
1145 64863965 Michael Niedermayer
     * darkness masking (0-> disabled).
1146
     * - encoding: set by user
1147
     * - decoding: unused
1148 5e746b99 Michael Niedermayer
     */
1149
    float dark_masking;
1150 0c2dd16e Michael Niedermayer
    
1151 3a694b04 Nick Kurshev
    
1152
    /* for binary compatibility */
1153
    int unused;
1154
    
1155 0c2dd16e Michael Niedermayer
    /**
1156 64863965 Michael Niedermayer
     * idct algorithm, see FF_IDCT_* below.
1157
     * - encoding: set by user
1158
     * - decoding: set by user
1159 2ad1516a Michael Niedermayer
     */
1160
    int idct_algo;
1161
#define FF_IDCT_AUTO         0
1162
#define FF_IDCT_INT          1
1163
#define FF_IDCT_SIMPLE       2
1164
#define FF_IDCT_SIMPLEMMX    3
1165
#define FF_IDCT_LIBMPEG2MMX  4
1166
#define FF_IDCT_PS2          5
1167
#define FF_IDCT_MLIB         6
1168
#define FF_IDCT_ARM          7
1169 05c4072b Michael Niedermayer
#define FF_IDCT_ALTIVEC      8
1170 b82cdc72 Michael Niedermayer
#define FF_IDCT_SH4          9
1171 bd7d1ea7 Alex Beregszaszi
#define FF_IDCT_SIMPLEARM    10
1172 0fa8158d Michael Niedermayer
#define FF_IDCT_H264         11
1173 2ad1516a Michael Niedermayer
1174 144f0625 Michael Niedermayer
    /**
1175 64863965 Michael Niedermayer
     * slice count.
1176
     * - encoding: set by lavc
1177
     * - decoding: set by user (or 0)
1178 144f0625 Michael Niedermayer
     */
1179
    int slice_count;
1180
    /**
1181 64863965 Michael Niedermayer
     * slice offsets in the frame in bytes.
1182
     * - encoding: set/allocated by lavc
1183
     * - decoding: set/allocated by user (or NULL)
1184 144f0625 Michael Niedermayer
     */
1185
    int *slice_offset;
1186
1187 4d2858de Michael Niedermayer
    /**
1188 64863965 Michael Niedermayer
     * error concealment flags.
1189
     * - encoding: unused
1190
     * - decoding: set by user
1191 4d2858de Michael Niedermayer
     */
1192
    int error_concealment;
1193
#define FF_EC_GUESS_MVS   1
1194
#define FF_EC_DEBLOCK     2
1195
1196 6b72ac63 Michael Niedermayer
    /**
1197 bec89a84 Zdenek Kabelac
     * dsp_mask could be add used to disable unwanted CPU features
1198 8350df97 Zdenek Kabelac
     * CPU features (i.e. MMX, SSE. ...)
1199 bec89a84 Zdenek Kabelac
     *
1200
     * with FORCE flag you may instead enable given CPU features
1201
     * (Dangerous: usable in case of misdetection, improper usage however will
1202
     * result into program crash)
1203
     */
1204
    unsigned dsp_mask;
1205
#define FF_MM_FORCE        0x80000000 /* force usage of selected flags (OR) */
1206
    /* lower 16 bits - CPU features */
1207
#ifdef HAVE_MMX
1208
#define FF_MM_MMX        0x0001 /* standard MMX */
1209
#define FF_MM_3DNOW        0x0004 /* AMD 3DNOW */
1210
#define FF_MM_MMXEXT        0x0002 /* SSE integer functions or AMD MMX ext */
1211
#define FF_MM_SSE        0x0008 /* SSE functions */
1212
#define FF_MM_SSE2        0x0010 /* PIV SSE2 functions */
1213 e42a152b Michael Niedermayer
#define FF_MM_3DNOWEXT        0x0020 /* AMD 3DNowExt */
1214 bec89a84 Zdenek Kabelac
#endif /* HAVE_MMX */
1215 11f18faf Michael Niedermayer
1216
    /**
1217 64863965 Michael Niedermayer
     * bits per sample/pixel from the demuxer (needed for huffyuv).
1218
     * - encoding: set by lavc
1219
     * - decoding: set by user
1220 11f18faf Michael Niedermayer
     */
1221
     int bits_per_sample;
1222
    
1223
    /**
1224 64863965 Michael Niedermayer
     * prediction method (needed for huffyuv).
1225
     * - encoding: set by user
1226
     * - decoding: unused
1227 11f18faf Michael Niedermayer
     */
1228
     int prediction_method;
1229
#define FF_PRED_LEFT   0
1230
#define FF_PRED_PLANE  1
1231
#define FF_PRED_MEDIAN 2
1232 5d3cea3a Michael Niedermayer
    
1233
    /**
1234 5ff85f1d Michael Niedermayer
     * sample aspect ratio (0 if unknown).
1235 1f26c6f3 Michael Niedermayer
     * numerator and denominator must be relative prime and smaller then 256 for some video standards
1236 64863965 Michael Niedermayer
     * - encoding: set by user.
1237
     * - decoding: set by lavc.
1238 5d3cea3a Michael Niedermayer
     */
1239 5ff85f1d Michael Niedermayer
    AVRational sample_aspect_ratio;
1240 1e491e29 Michael Niedermayer
1241
    /**
1242 64863965 Michael Niedermayer
     * the picture in the bitstream.
1243
     * - encoding: set by lavc
1244
     * - decoding: set by lavc
1245 1e491e29 Michael Niedermayer
     */
1246 492cd3a9 Michael Niedermayer
    AVFrame *coded_frame;
1247 c8c437bc Michael Niedermayer
1248
    /**
1249 64863965 Michael Niedermayer
     * debug.
1250
     * - encoding: set by user.
1251
     * - decoding: set by user.
1252 c8c437bc Michael Niedermayer
     */
1253
    int debug;
1254
#define FF_DEBUG_PICT_INFO 1
1255
#define FF_DEBUG_RC        2
1256
#define FF_DEBUG_BITSTREAM 4
1257
#define FF_DEBUG_MB_TYPE   8
1258
#define FF_DEBUG_QP        16
1259
#define FF_DEBUG_MV        32
1260 8289c6fa Wolfgang Hesseler
#define FF_DEBUG_DCT_COEFF 0x00000040
1261 41773b73 Michael Niedermayer
#define FF_DEBUG_SKIP      0x00000080
1262
#define FF_DEBUG_STARTCODE 0x00000100
1263
#define FF_DEBUG_PTS       0x00000200
1264 46b4feec Michael Niedermayer
#define FF_DEBUG_ER        0x00000400
1265 0da71265 Michael Niedermayer
#define FF_DEBUG_MMCO      0x00000800
1266 8fc6c2b5 Michael Niedermayer
#define FF_DEBUG_BUGS      0x00001000
1267 864119b6 Michael Niedermayer
#define FF_DEBUG_VIS_QP    0x00002000
1268
#define FF_DEBUG_VIS_MB_TYPE 0x00004000
1269 140cb663 Michael Niedermayer
    
1270
    /**
1271 0c9bbaec Wolfgang Hesseler
     * debug.
1272
     * - encoding: set by user.
1273
     * - decoding: set by user.
1274
     */
1275
    int debug_mv;
1276
#define FF_DEBUG_VIS_MV_P_FOR  0x00000001 //visualize forward predicted MVs of P frames
1277
#define FF_DEBUG_VIS_MV_B_FOR  0x00000002 //visualize forward predicted MVs of B frames
1278
#define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames
1279
1280
    /**
1281 64863965 Michael Niedermayer
     * error.
1282
     * - encoding: set by lavc if flags&CODEC_FLAG_PSNR
1283
     * - decoding: unused
1284 140cb663 Michael Niedermayer
     */
1285
    uint64_t error[4];
1286 17a70fde Michael Niedermayer
    
1287
    /**
1288 64863965 Michael Niedermayer
     * minimum MB quantizer.
1289 6e0d8c06 Michael Niedermayer
     * - encoding: unused
1290 64863965 Michael Niedermayer
     * - decoding: unused
1291 17a70fde Michael Niedermayer
     */
1292
    int mb_qmin;
1293
1294
    /**
1295 64863965 Michael Niedermayer
     * maximum MB quantizer.
1296 6e0d8c06 Michael Niedermayer
     * - encoding: unused
1297 64863965 Michael Niedermayer
     * - decoding: unused
1298 17a70fde Michael Niedermayer
     */
1299
    int mb_qmax;
1300 1457ab52 Michael Niedermayer
    
1301
    /**
1302 64863965 Michael Niedermayer
     * motion estimation compare function.
1303
     * - encoding: set by user.
1304
     * - decoding: unused
1305 1457ab52 Michael Niedermayer
     */
1306
    int me_cmp;
1307
    /**
1308 64863965 Michael Niedermayer
     * subpixel motion estimation compare function.
1309
     * - encoding: set by user.
1310
     * - decoding: unused
1311 1457ab52 Michael Niedermayer
     */
1312
    int me_sub_cmp;
1313
    /**
1314 64863965 Michael Niedermayer
     * macroblock compare function (not supported yet).
1315
     * - encoding: set by user.
1316
     * - decoding: unused
1317 1457ab52 Michael Niedermayer
     */
1318
    int mb_cmp;
1319 622348f9 Michael Niedermayer
    /**
1320
     * interlaced dct compare function
1321
     * - encoding: set by user.
1322
     * - decoding: unused
1323
     */
1324
    int ildct_cmp;
1325 1457ab52 Michael Niedermayer
#define FF_CMP_SAD  0
1326
#define FF_CMP_SSE  1
1327
#define FF_CMP_SATD 2
1328
#define FF_CMP_DCT  3
1329
#define FF_CMP_PSNR 4
1330
#define FF_CMP_BIT  5
1331
#define FF_CMP_RD   6
1332
#define FF_CMP_ZERO 7
1333 622348f9 Michael Niedermayer
#define FF_CMP_VSAD 8
1334
#define FF_CMP_VSSE 9
1335 e6a2ac34 Michael Niedermayer
#define FF_CMP_NSSE 10
1336 26efc54e Michael Niedermayer
#define FF_CMP_W53  11
1337
#define FF_CMP_W97  12
1338 0fd6aea1 Michael Niedermayer
#define FF_CMP_DCTMAX 13
1339 1457ab52 Michael Niedermayer
#define FF_CMP_CHROMA 256
1340
    
1341
    /**
1342 64863965 Michael Niedermayer
     * ME diamond size & shape.
1343
     * - encoding: set by user.
1344
     * - decoding: unused
1345 1457ab52 Michael Niedermayer
     */
1346
    int dia_size;
1347 b07a5980 Michael Niedermayer
1348
    /**
1349 64863965 Michael Niedermayer
     * amount of previous MV predictors (2a+1 x 2a+1 square).
1350
     * - encoding: set by user.
1351
     * - decoding: unused
1352 b07a5980 Michael Niedermayer
     */
1353
    int last_predictor_count;
1354 70ac76c0 Michael Niedermayer
1355 f5fb6b34 Michael Niedermayer
    /**
1356 64863965 Michael Niedermayer
     * pre pass for motion estimation.
1357
     * - encoding: set by user.
1358
     * - decoding: unused
1359 f5fb6b34 Michael Niedermayer
     */
1360
    int pre_me;
1361 b07a5980 Michael Niedermayer
1362 70ac76c0 Michael Niedermayer
    /**
1363 64863965 Michael Niedermayer
     * motion estimation pre pass compare function.
1364
     * - encoding: set by user.
1365
     * - decoding: unused
1366 70ac76c0 Michael Niedermayer
     */
1367
    int me_pre_cmp;
1368 826f429a Michael Niedermayer
1369 70ac76c0 Michael Niedermayer
    /**
1370 64863965 Michael Niedermayer
     * ME pre pass diamond size & shape.
1371
     * - encoding: set by user.
1372
     * - decoding: unused
1373 70ac76c0 Michael Niedermayer
     */
1374
    int pre_dia_size;
1375
1376 826f429a Michael Niedermayer
    /**
1377 64863965 Michael Niedermayer
     * subpel ME quality.
1378
     * - encoding: set by user.
1379
     * - decoding: unused
1380 826f429a Michael Niedermayer
     */
1381
    int me_subpel_quality;
1382
1383 a33c7159 Michael Niedermayer
    /**
1384 64863965 Michael Niedermayer
     * callback to negotiate the pixelFormat.
1385 a33c7159 Michael Niedermayer
     * @param fmt is the list of formats which are supported by the codec,
1386
     * its terminated by -1 as 0 is a valid format, the formats are ordered by quality
1387
     * the first is allways the native one
1388
     * @return the choosen format
1389 64863965 Michael Niedermayer
     * - encoding: unused
1390
     * - decoding: set by user, if not set then the native format will always be choosen
1391 a33c7159 Michael Niedermayer
     */
1392 494c56d3 Ivan Kalvachev
    enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt);
1393 e2f9490e Fabrice Bellard
1394
    /**
1395
     * DTG active format information (additionnal aspect ratio
1396
     * information only used in DVB MPEG2 transport streams). 0 if
1397
     * not set.
1398
     * 
1399 64863965 Michael Niedermayer
     * - encoding: unused.
1400
     * - decoding: set by decoder 
1401 e2f9490e Fabrice Bellard
     */
1402
    int dtg_active_format;
1403
#define FF_DTG_AFD_SAME         8
1404
#define FF_DTG_AFD_4_3          9
1405
#define FF_DTG_AFD_16_9         10
1406
#define FF_DTG_AFD_14_9         11
1407
#define FF_DTG_AFD_4_3_SP_14_9  13
1408
#define FF_DTG_AFD_16_9_SP_14_9 14
1409
#define FF_DTG_AFD_SP_4_3       15
1410
1411 ebbcdc9a Michael Niedermayer
    /**
1412
     * Maximum motion estimation search range in subpel units.
1413
     * if 0 then no limit
1414
     * 
1415 64863965 Michael Niedermayer
     * - encoding: set by user.
1416
     * - decoding: unused.
1417 ebbcdc9a Michael Niedermayer
     */
1418 59e0ac8e Zdenek Kabelac
    int me_range;
1419 ebbcdc9a Michael Niedermayer
1420 65f7062d Michael Niedermayer
    /**
1421
     * frame_rate_base.
1422
     * for variable fps this is 1
1423
     * - encoding: set by user.
1424
     * - decoding: set by lavc.
1425
     * @todo move this after frame_rate
1426
     */
1427
1428 1984f635 Michael Niedermayer
    int frame_rate_base;
1429
    /**
1430
     * intra quantizer bias.
1431
     * - encoding: set by user.
1432
     * - decoding: unused
1433
     */
1434
    int intra_quant_bias;
1435
#define FF_DEFAULT_QUANT_BIAS 999999
1436
    
1437
    /**
1438
     * inter quantizer bias.
1439
     * - encoding: set by user.
1440
     * - decoding: unused
1441
     */
1442
    int inter_quant_bias;
1443 5cd62665 Zdenek Kabelac
1444
    /**
1445
     * color table ID.
1446
     * - encoding: unused.
1447
     * - decoding: which clrtable should be used for 8bit RGB images
1448
     *             table have to be stored somewhere FIXME
1449
     */
1450
    int color_table_id;
1451 1984f635 Michael Niedermayer
    
1452 d90cf87b Michael Niedermayer
    /**
1453
     * internal_buffer count. 
1454
     * Dont touch, used by lavc default_get_buffer()
1455
     */
1456
    int internal_buffer_count;
1457
    
1458
    /**
1459
     * internal_buffers. 
1460
     * Dont touch, used by lavc default_get_buffer()
1461
     */
1462
    void *internal_buffer;
1463 158c7f05 Michael Niedermayer
1464
#define FF_LAMBDA_SHIFT 7
1465
#define FF_LAMBDA_SCALE (1<<FF_LAMBDA_SHIFT)
1466
#define FF_QP2LAMBDA 118 ///< factor to convert from H.263 QP to lambda
1467
#define FF_LAMBDA_MAX (256*128-1)
1468
1469
#define FF_QUALITY_SCALE FF_LAMBDA_SCALE //FIXME maybe remove
1470 3d2e8cce Michael Niedermayer
    /**
1471
     * global quality for codecs which cannot change it per frame.
1472
     * this should be proportional to MPEG1/2/4 qscale.
1473
     * - encoding: set by user.
1474
     * - decoding: unused
1475
     */
1476
    int global_quality;
1477 11e659c2 Michael Niedermayer
    
1478
#define FF_CODER_TYPE_VLC   0
1479
#define FF_CODER_TYPE_AC    1
1480
    /**
1481
     * coder type
1482
     * - encoding: set by user.
1483
     * - decoding: unused
1484
     */
1485
    int coder_type;
1486
1487
    /**
1488
     * context model
1489
     * - encoding: set by user.
1490
     * - decoding: unused
1491
     */
1492
    int context_model;
1493 3bb07d61 Michael Niedermayer
    
1494
    /**
1495
     * slice flags
1496
     * - encoding: unused
1497
     * - decoding: set by user.
1498
     */
1499
    int slice_flags;
1500
#define SLICE_FLAG_CODED_ORDER    0x0001 ///< draw_horiz_band() is called in coded order instead of display
1501
#define SLICE_FLAG_ALLOW_FIELD    0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics)
1502
#define SLICE_FLAG_ALLOW_PLANE    0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)
1503
1504 fb364ada Ivan Kalvachev
    /**
1505
     * XVideo Motion Acceleration
1506
     * - encoding: forbidden
1507
     * - decoding: set by decoder
1508
     */
1509
    int xvmc_acceleration;
1510 7d1c3fc1 Michael Niedermayer
    
1511
    /**
1512
     * macroblock decision mode
1513
     * - encoding: set by user.
1514
     * - decoding: unused
1515
     */
1516
    int mb_decision;
1517
#define FF_MB_DECISION_SIMPLE 0        ///< uses mb_cmp
1518
#define FF_MB_DECISION_BITS   1        ///< chooses the one which needs the fewest bits
1519
#define FF_MB_DECISION_RD     2        ///< rate distoration
1520 d6eb3c50 Michael Niedermayer
1521
    /**
1522
     * custom intra quantization matrix
1523
     * - encoding: set by user, can be NULL
1524
     * - decoding: set by lavc
1525
     */
1526
    uint16_t *intra_matrix;
1527
1528
    /**
1529
     * custom inter quantization matrix
1530
     * - encoding: set by user, can be NULL
1531
     * - decoding: set by lavc
1532
     */
1533
    uint16_t *inter_matrix;
1534 7d1c3fc1 Michael Niedermayer
    
1535 541ae140 Michael Niedermayer
    /**
1536
     * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
1537
     * this is used to workaround some encoder bugs
1538
     * - encoding: unused
1539
     * - decoding: set by user, will be converted to upper case by lavc during init
1540
     */
1541
    unsigned int stream_codec_tag;
1542 05fbd0a2 Michael Niedermayer
1543
    /**
1544
     * scene change detection threshold.
1545
     * 0 is default, larger means fewer detected scene changes
1546
     * - encoding: set by user.
1547
     * - decoding: unused
1548
     */
1549
    int scenechange_threshold;
1550 158c7f05 Michael Niedermayer
1551
    /**
1552
     * minimum lagrange multipler
1553
     * - encoding: set by user.
1554
     * - decoding: unused
1555
     */
1556
    int lmin;
1557
1558
    /**
1559
     * maximum lagrange multipler
1560
     * - encoding: set by user.
1561
     * - decoding: unused
1562
     */
1563
    int lmax;
1564 2a2bbcb0 Mike Melanson
1565
    /**
1566
     * Palette control structure
1567
     * - encoding: ??? (no palette-enabled encoder yet)
1568
     * - decoding: set by user.
1569
     */
1570
    struct AVPaletteControl *palctrl;
1571 821cb11f Michael Niedermayer
1572
    /**
1573
     * noise reduction strength
1574
     * - encoding: set by user.
1575
     * - decoding: unused
1576
     */
1577
    int noise_reduction;
1578 fa384dcc Michael Niedermayer
    
1579 074c4ca7 Roberto Togni
    /**
1580 e1c2a5a0 Roberto Togni
     * called at the beginning of a frame to get cr buffer for it.
1581
     * buffer type (size, hints) must be the same. lavc won't check it.
1582
     * lavc will pass previous buffer in pic, function should return
1583
     * same buffer or new buffer with old frame "painted" into it.
1584
     * if pic.data[0] == NULL must behave like get_buffer().
1585 074c4ca7 Roberto Togni
     * - encoding: unused
1586 e1c2a5a0 Roberto Togni
     * - decoding: set by lavc, user can override
1587 074c4ca7 Roberto Togni
     */
1588 e1c2a5a0 Roberto Togni
    int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic);
1589 ba58dabc Michael Niedermayer
1590
    /**
1591
     * number of bits which should be loaded into the rc buffer before decoding starts
1592
     * - encoding: set by user.
1593
     * - decoding: unused
1594
     */
1595
    int rc_initial_buffer_occupancy;
1596
1597
    /**
1598
     *
1599
     * - encoding: set by user.
1600
     * - decoding: unused
1601
     */
1602
    int inter_threshold;
1603
1604
    /**
1605
     * CODEC_FLAG2_*.
1606
     * - encoding: set by user.
1607
     * - decoding: set by user.
1608
     */
1609
    int flags2;
1610 7ebfc0ea Michael Niedermayer
1611
    /**
1612
     * simulates errors in the bitstream to test error concealment.
1613
     * - encoding: set by user.
1614
     * - decoding: unused.
1615
     */
1616
    int error_rate;
1617 a1e257b2 Michael Niedermayer
    
1618
    /**
1619
     * MP3 antialias algorithm, see FF_AA_* below.
1620
     * - encoding: unused
1621
     * - decoding: set by user
1622
     */
1623
    int antialias_algo;
1624
#define FF_AA_AUTO    0
1625
#define FF_AA_FASTINT 1 //not implemented yet
1626
#define FF_AA_INT     2
1627
#define FF_AA_FLOAT   3
1628 77ea0d4b Michael Niedermayer
    /**
1629
     * Quantizer noise shaping.
1630
     * - encoding: set by user
1631
     * - decoding: unused
1632
     */
1633
    int quantizer_noise_shaping;
1634 9c3d33d6 Michael Niedermayer
1635
    /**
1636
     * Thread count.
1637
     * is used to decide how many independant tasks should be passed to execute()
1638
     * - encoding: set by user
1639
     * - decoding: set by user
1640
     */
1641
    int thread_count;
1642
    
1643
    /**
1644
     * the codec may call this to execute several independant things. it will return only after
1645
     * finishing all tasks, the user may replace this with some multithreaded implementation, the
1646
     * default implementation will execute the parts serially
1647 399cec2f Michael Niedermayer
     * @param count the number of things to execute
1648 9c3d33d6 Michael Niedermayer
     * - encoding: set by lavc, user can override
1649
     * - decoding: set by lavc, user can override
1650
     */
1651
    int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void **arg2, int *ret, int count);
1652
    
1653
    /**
1654
     * Thread opaque.
1655
     * can be used by execute() to store some per AVCodecContext stuff.
1656
     * - encoding: set by execute()
1657
     * - decoding: set by execute()
1658
     */
1659
    void *thread_opaque;
1660 a4d36c11 Michael Niedermayer
1661
    /**
1662 f20f8a8b Michael Niedermayer
     * Motion estimation threshold. under which no motion estimation is 
1663
     * performed, but instead the user specified motion vectors are used
1664 a4d36c11 Michael Niedermayer
     * 
1665
     * - encoding: set by user
1666 f20f8a8b Michael Niedermayer
     * - decoding: unused
1667 a4d36c11 Michael Niedermayer
     */
1668 2750b827 Michael Niedermayer
     int me_threshold;
1669 f20f8a8b Michael Niedermayer
1670
    /**
1671
     * Macroblock threshold. under which the user specified macroblock types will be used
1672
     * - encoding: set by user
1673
     * - decoding: unused
1674
     */
1675
     int mb_threshold;
1676 bf266e19 Michael Niedermayer
1677
    /**
1678 d4c5d2ad Michael Niedermayer
     * precision of the intra dc coefficient - 8.
1679 bf266e19 Michael Niedermayer
     * - encoding: set by user
1680
     * - decoding: unused
1681
     */
1682
     int intra_dc_precision;
1683 d4c5d2ad Michael Niedermayer
1684
    /**
1685
     * noise vs. sse weight for the nsse comparsion function.
1686
     * - encoding: set by user
1687
     * - decoding: unused
1688
     */
1689
     int nsse_weight;
1690 0dfd33c3 Michael Niedermayer
1691
    /**
1692
     * number of macroblock rows at the top which are skiped.
1693
     * - encoding: unused
1694
     * - decoding: set by user
1695
     */
1696
     int skip_top;
1697
1698
    /**
1699
     * number of macroblock rows at the bottom which are skiped.
1700
     * - encoding: unused
1701
     * - decoding: set by user
1702
     */
1703
     int skip_bottom;
1704 baced9f5 Michael Niedermayer
1705
    /**
1706
     * profile
1707
     * - encoding: set by user
1708
     * - decoding: set by lavc
1709
     */
1710
     int profile;
1711
#define FF_PROFILE_UNKNOWN -99
1712
1713
    /**
1714
     * level
1715
     * - encoding: set by user
1716
     * - decoding: set by lavc
1717
     */
1718
     int level;
1719
#define FF_LEVEL_UNKNOWN -99
1720 178fcca8 Michael Niedermayer
1721
    /**
1722
     * low resolution decoding. 1-> 1/2 size, 2->1/4 size
1723
     * - encoding: unused
1724
     * - decoding: set by user
1725
     */
1726
     int lowres;
1727 21adafec Michael Niedermayer
1728
    /**
1729 bbf18b21 Michael Niedermayer
     * bitsream width / height. may be different from width/height if lowres
1730 21adafec Michael Niedermayer
     * or other things are used
1731
     * - encoding: unused
1732
     * - decoding: set by user before init if known, codec should override / dynamically change if needed
1733
     */
1734
    int coded_width, coded_height;
1735 bbf18b21 Michael Niedermayer
1736
    /**
1737
     * frame skip threshold
1738
     * - encoding: set by user
1739
     * - decoding: unused
1740
     */
1741
    int frame_skip_threshold;
1742
1743
    /**
1744
     * frame skip factor
1745
     * - encoding: set by user
1746
     * - decoding: unused
1747
     */
1748
    int frame_skip_factor;
1749 0fd6aea1 Michael Niedermayer
1750
    /**
1751
     * frame skip exponent
1752
     * - encoding: set by user
1753
     * - decoding: unused
1754
     */
1755
    int frame_skip_exp;
1756
1757
    /**
1758
     * frame skip comparission function
1759
     * - encoding: set by user.
1760
     * - decoding: unused
1761
     */
1762
    int frame_skip_cmp;
1763 957c743a Christophe Massiot
1764
    /**
1765
     * border processing masking. raises the quantizer for mbs on the borders
1766
     * of the picture.
1767
     * - encoding: set by user
1768
     * - decoding: unused
1769
     */
1770
    float border_masking;
1771 6e0d8c06 Michael Niedermayer
1772
    /**
1773
     * minimum MB lagrange multipler.
1774
     * - encoding: set by user.
1775
     * - decoding: unused
1776
     */
1777
    int mb_lmin;
1778
1779
    /**
1780
     * maximum MB lagrange multipler.
1781
     * - encoding: set by user.
1782
     * - decoding: unused
1783
     */
1784
    int mb_lmax;
1785 09c3e44e Michael Niedermayer
1786
    /**
1787
     * 
1788
     * - encoding: set by user.
1789
     * - decoding: unused
1790
     */
1791
    int me_penalty_compensation;
1792 de6d9b64 Fabrice Bellard
} AVCodecContext;
1793
1794 97d96aaa Zdenek Kabelac
1795 64863965 Michael Niedermayer
/**
1796
 * AVOption.
1797
 */
1798 97d96aaa Zdenek Kabelac
typedef struct AVOption {
1799
    /** options' name */
1800
    const char *name; /* if name is NULL, it indicates a link to next */
1801 bec89a84 Zdenek Kabelac
    /** short English text help or const struct AVOption* subpointer */
1802
    const char *help; //        const struct AVOption* sub;
1803 97d96aaa Zdenek Kabelac
    /** offset to context structure where the parsed value should be stored */
1804
    int offset;
1805
    /** options' type */
1806
    int type;
1807 64863965 Michael Niedermayer
#define FF_OPT_TYPE_BOOL 1      ///< boolean - true,1,on  (or simply presence)
1808
#define FF_OPT_TYPE_DOUBLE 2    ///< double
1809
#define FF_OPT_TYPE_INT 3       ///< integer
1810
#define FF_OPT_TYPE_STRING 4    ///< string (finished with \0)
1811
#define FF_OPT_TYPE_MASK 0x1f        ///< mask for types - upper bits are various flags
1812 97d96aaa Zdenek Kabelac
//#define FF_OPT_TYPE_EXPERT 0x20 // flag for expert option
1813
#define FF_OPT_TYPE_FLAG (FF_OPT_TYPE_BOOL | 0x40)
1814
#define FF_OPT_TYPE_RCOVERRIDE (FF_OPT_TYPE_STRING | 0x80)
1815
    /** min value  (min == max   ->  no limits) */
1816
    double min;
1817
    /** maximum value for double/int */
1818
    double max;
1819
    /** default boo [0,1]l/double/int value */
1820
    double defval;
1821
    /**
1822
     * default string value (with optional semicolon delimited extra option-list
1823
     * i.e.   option1;option2;option3
1824
     * defval might select other then first argument as default
1825
     */
1826
    const char *defstr;
1827
#define FF_OPT_MAX_DEPTH 10
1828
} AVOption;
1829
1830 64863965 Michael Niedermayer
/**
1831
 * AVCodec.
1832
 */
1833 de6d9b64 Fabrice Bellard
typedef struct AVCodec {
1834 18f77016 Zdenek Kabelac
    const char *name;
1835 5d234974 Zdenek Kabelac
    enum CodecType type;
1836 9297ddd3 Michael Niedermayer
    enum CodecID id;
1837 de6d9b64 Fabrice Bellard
    int priv_data_size;
1838
    int (*init)(AVCodecContext *);
1839 0c1a9eda Zdenek Kabelac
    int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
1840 de6d9b64 Fabrice Bellard
    int (*close)(AVCodecContext *);
1841 0fd90455 Michael Niedermayer
    int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
1842 0c1a9eda Zdenek Kabelac
                  uint8_t *buf, int buf_size);
1843 bf89e6b1 Fabrice Bellard
    int capabilities;
1844 40c5fa26 Michael Niedermayer
    void *dummy; // FIXME remove next time we break binary compatibility
1845 de6d9b64 Fabrice Bellard
    struct AVCodec *next;
1846 7a06ff14 Michael Niedermayer
    void (*flush)(AVCodecContext *);
1847 b0df362b Zdenek Kabelac
    const AVRational *supported_framerates; ///array of supported framerates, or NULL if any, array is terminated by {0,0}
1848 fcee0164 Michael Niedermayer
    const enum PixelFormat *pix_fmts;       ///array of supported pixel formats, or NULL if unknown, array is terminanted by -1
1849 de6d9b64 Fabrice Bellard
} AVCodec;
1850
1851 97d96aaa Zdenek Kabelac
/**
1852 d7425f59 Michael Niedermayer
 * four components are given, that's all.
1853
 * the last component is alpha
1854
 */
1855 de6d9b64 Fabrice Bellard
typedef struct AVPicture {
1856 0c1a9eda Zdenek Kabelac
    uint8_t *data[4];
1857 cd394651 Michael Niedermayer
    int linesize[4];       ///< number of bytes per line
1858 de6d9b64 Fabrice Bellard
} AVPicture;
1859
1860 ba118447 Mike Melanson
/**
1861
 * AVPaletteControl
1862
 * This structure defines a method for communicating palette changes
1863
 * between and demuxer and a decoder.
1864
 */
1865 2e99641b Roberto Togni
#define AVPALETTE_SIZE 1024
1866 432d84c3 Michael Niedermayer
#define AVPALETTE_COUNT 256
1867 ba118447 Mike Melanson
typedef struct AVPaletteControl {
1868
1869
    /* demuxer sets this to 1 to indicate the palette has changed;
1870
     * decoder resets to 0 */
1871
    int palette_changed;
1872
1873 2a2bbcb0 Mike Melanson
    /* 4-byte ARGB palette entries, stored in native byte order; note that
1874
     * the individual palette components should be on a 8-bit scale; if
1875
     * the palette data comes from a IBM VGA native format, the component
1876
     * data is probably 6 bits in size and needs to be scaled */
1877 2e99641b Roberto Togni
    unsigned int palette[AVPALETTE_COUNT];
1878 ba118447 Mike Melanson
1879
} AVPaletteControl;
1880
1881 de6d9b64 Fabrice Bellard
extern AVCodec ac3_encoder;
1882
extern AVCodec mp2_encoder;
1883 9d36bdc9 Juanjo
extern AVCodec mp3lame_encoder;
1884 81e0d0b4 Mark Hills
extern AVCodec oggvorbis_encoder;
1885 5c5dea3f Nilesh Bansal
extern AVCodec oggtheora_encoder;
1886 29d48296 Michael Niedermayer
extern AVCodec faac_encoder;
1887 1ddadfa9 Adam Thayer
extern AVCodec xvid_encoder;
1888 de6d9b64 Fabrice Bellard
extern AVCodec mpeg1video_encoder;
1889 029911d1 Michael Niedermayer
extern AVCodec mpeg2video_encoder;
1890 1c3990db Michael Niedermayer
extern AVCodec h261_encoder;
1891 de6d9b64 Fabrice Bellard
extern AVCodec h263_encoder;
1892
extern AVCodec h263p_encoder;
1893 d4f5d74a Garrick Meeker
extern AVCodec flv_encoder;
1894 de6d9b64 Fabrice Bellard
extern AVCodec rv10_encoder;
1895 68b94c35 Michael Niedermayer
extern AVCodec rv20_encoder;
1896 6faa4645 Roman Shaposhnik
extern AVCodec dvvideo_encoder;
1897 de6d9b64 Fabrice Bellard
extern AVCodec mjpeg_encoder;
1898 b1e6b355 Michael Niedermayer
extern AVCodec ljpeg_encoder;
1899 4eff7cf4 Michael Niedermayer
extern AVCodec png_encoder;
1900 5b6d5596 Michael Niedermayer
extern AVCodec ppm_encoder;
1901
extern AVCodec pgm_encoder;
1902
extern AVCodec pgmyuv_encoder;
1903
extern AVCodec pbm_encoder;
1904
extern AVCodec pam_encoder;
1905 bf89e6b1 Fabrice Bellard
extern AVCodec mpeg4_encoder;
1906 84afee34 Michael Niedermayer
extern AVCodec msmpeg4v1_encoder;
1907
extern AVCodec msmpeg4v2_encoder;
1908
extern AVCodec msmpeg4v3_encoder;
1909 0151a6f5 Michael Niedermayer
extern AVCodec wmv1_encoder;
1910
extern AVCodec wmv2_encoder;
1911 11f18faf Michael Niedermayer
extern AVCodec huffyuv_encoder;
1912 f37b9768 Loren Merritt
extern AVCodec ffvhuff_encoder;
1913 0da71265 Michael Niedermayer
extern AVCodec h264_encoder;
1914 3d2e8cce Michael Niedermayer
extern AVCodec asv1_encoder;
1915 9b56edf5 Michael Niedermayer
extern AVCodec asv2_encoder;
1916 be3564ed Michael Niedermayer
extern AVCodec vcr1_encoder;
1917 5e20f836 Michael Niedermayer
extern AVCodec ffv1_encoder;
1918 791e7b83 Michael Niedermayer
extern AVCodec snow_encoder;
1919 c3bf0288 Michael Niedermayer
extern AVCodec mdec_encoder;
1920 a273bbfb Roberto Togni
extern AVCodec zlib_encoder;
1921 54f5fd22 Alex Beregszaszi
extern AVCodec sonic_encoder;
1922
extern AVCodec sonic_ls_encoder;
1923 3b64893d Mike Melanson
extern AVCodec svq1_encoder;
1924 6662ec29 Michael Niedermayer
extern AVCodec x264_encoder;
1925 de6d9b64 Fabrice Bellard
1926
extern AVCodec h263_decoder;
1927 c6148de2 Michael Niedermayer
extern AVCodec h261_decoder;
1928 bf89e6b1 Fabrice Bellard
extern AVCodec mpeg4_decoder;
1929 84afee34 Michael Niedermayer
extern AVCodec msmpeg4v1_decoder;
1930
extern AVCodec msmpeg4v2_decoder;
1931
extern AVCodec msmpeg4v3_decoder;
1932 e1a9dbff Michael Niedermayer
extern AVCodec wmv1_decoder;
1933 0151a6f5 Michael Niedermayer
extern AVCodec wmv2_decoder;
1934 21aa398f Alex Beregszaszi
extern AVCodec vc9_decoder;
1935
extern AVCodec wmv3_decoder;
1936 922bc38d Michael Niedermayer
extern AVCodec mpeg1video_decoder;
1937
extern AVCodec mpeg2video_decoder;
1938 c512b303 Ivan Kalvachev
extern AVCodec mpegvideo_decoder;
1939 fb364ada Ivan Kalvachev
extern AVCodec mpeg_xvmc_decoder;
1940 de6d9b64 Fabrice Bellard
extern AVCodec h263i_decoder;
1941 d4f5d74a Garrick Meeker
extern AVCodec flv_decoder;
1942 de6d9b64 Fabrice Bellard
extern AVCodec rv10_decoder;
1943 68b94c35 Michael Niedermayer
extern AVCodec rv20_decoder;
1944 3f05305d Michael Niedermayer
extern AVCodec rv30_decoder;
1945
extern AVCodec rv40_decoder;
1946 be8ffec9 Nick Kurshev
extern AVCodec svq1_decoder;
1947 8b82a956 Michael Niedermayer
extern AVCodec svq3_decoder;
1948 020fcc94 Fabrice Bellard
extern AVCodec dvvideo_decoder;
1949 bc8d1857 Fabrice Bellard
extern AVCodec wmav1_decoder;
1950
extern AVCodec wmav2_decoder;
1951 4e66ab3b Fabrice Bellard
extern AVCodec mjpeg_decoder;
1952 b135d9fb Alex Beregszaszi
extern AVCodec mjpegb_decoder;
1953 5e83dec4 Alex Beregszaszi
extern AVCodec sp5x_decoder;
1954 4eff7cf4 Michael Niedermayer
extern AVCodec png_decoder;
1955 4b1f4f23 Juanjo
extern AVCodec mp2_decoder;
1956 a96b68b7 Fabrice Bellard
extern AVCodec mp3_decoder;
1957 1ede228a Roberto Togni
extern AVCodec mp3adu_decoder;
1958 d2a7718d Roberto Togni
extern AVCodec mp3on4_decoder;
1959 3f95e843 François Revol
extern AVCodec mace3_decoder;
1960
extern AVCodec mace6_decoder;
1961 11f18faf Michael Niedermayer
extern AVCodec huffyuv_decoder;
1962 f37b9768 Loren Merritt
extern AVCodec ffvhuff_decoder;
1963 3aca208a Mark Hills
extern AVCodec oggvorbis_decoder;
1964 5c5dea3f Nilesh Bansal
extern AVCodec oggtheora_decoder;
1965 f70f7c6d Michael Niedermayer
extern AVCodec cyuv_decoder;
1966 0da71265 Michael Niedermayer
extern AVCodec h264_decoder;
1967 deabd4fd Mike Melanson
extern AVCodec indeo3_decoder;
1968 d86053a4 Mike Melanson
extern AVCodec vp3_decoder;
1969 f44ee2c3 Alex Beregszaszi
extern AVCodec theora_decoder;
1970 891f64b3 joca@rixmail.se
extern AVCodec amr_nb_decoder;
1971 bc634f6f Zdenek Kabelac
extern AVCodec amr_nb_encoder;
1972 d663a1fd Michael Niedermayer
extern AVCodec amr_wb_encoder;
1973
extern AVCodec amr_wb_decoder;
1974 280bd7b7 Zdenek Kabelac
extern AVCodec aac_decoder;
1975
extern AVCodec mpeg4aac_decoder;
1976 3d2e8cce Michael Niedermayer
extern AVCodec asv1_decoder;
1977 9b56edf5 Michael Niedermayer
extern AVCodec asv2_decoder;
1978 be3564ed Michael Niedermayer
extern AVCodec vcr1_decoder;
1979 3aff069b Alex Beregszaszi
extern AVCodec cljr_decoder;
1980 5e20f836 Michael Niedermayer
extern AVCodec ffv1_decoder;
1981 791e7b83 Michael Niedermayer
extern AVCodec snow_decoder;
1982 8809cfee Michael Niedermayer
extern AVCodec fourxm_decoder;
1983 c3bf0288 Michael Niedermayer
extern AVCodec mdec_decoder;
1984 3ef8be2b Mike Melanson
extern AVCodec roq_decoder;
1985
extern AVCodec interplay_video_decoder;
1986 9937e686 Mike Melanson
extern AVCodec xan_wc3_decoder;
1987 2fdf638b Mike Melanson
extern AVCodec rpza_decoder;
1988
extern AVCodec cinepak_decoder;
1989
extern AVCodec msrle_decoder;
1990
extern AVCodec msvideo1_decoder;
1991 6955a882 Mike Melanson
extern AVCodec vqa_decoder;
1992 4120a53a Mike Melanson
extern AVCodec idcin_decoder;
1993 1dc1ed99 Roberto Togni
extern AVCodec eightbps_decoder;
1994 11e29a41 Mike Melanson
extern AVCodec smc_decoder;
1995 42cad81a Mike Melanson
extern AVCodec flic_decoder;
1996 fafa0b75 Mike Melanson
extern AVCodec vmdvideo_decoder;
1997
extern AVCodec vmdaudio_decoder;
1998 9a4117d5 Mike Melanson
extern AVCodec truemotion1_decoder;
1999 a273bbfb Roberto Togni
extern AVCodec mszh_decoder;
2000
extern AVCodec zlib_decoder;
2001 b8414bbd Nick Kurshev
extern AVCodec ra_144_decoder;
2002
extern AVCodec ra_288_decoder;
2003 3ef8be2b Mike Melanson
extern AVCodec roq_dpcm_decoder;
2004
extern AVCodec interplay_dpcm_decoder;
2005 9937e686 Mike Melanson
extern AVCodec xan_dpcm_decoder;
2006 d08d7142 Mike Melanson
extern AVCodec sol_dpcm_decoder;
2007 54f5fd22 Alex Beregszaszi
extern AVCodec sonic_decoder;
2008 070ed1bc Mike Melanson
extern AVCodec qtrle_decoder;
2009 ac2570a8 Michael Niedermayer
extern AVCodec flac_decoder;
2010 9d53d58e Mike Melanson
extern AVCodec tscc_decoder;
2011 d0a0bbd2 Mike Melanson
extern AVCodec ulti_decoder;
2012 d08d7142 Mike Melanson
extern AVCodec qdraw_decoder;
2013 ab711b3c Mike Melanson
extern AVCodec xl_decoder;
2014 acfd8f0f Mike Melanson
extern AVCodec qpeg_decoder;
2015 85ad5695 Michael Niedermayer
extern AVCodec shorten_decoder;
2016 9c7fb608 Mike Melanson
extern AVCodec loco_decoder;
2017 a8a15e9d Mike Melanson
extern AVCodec wnv1_decoder;
2018 6d6d7970 Mike Melanson
extern AVCodec alac_decoder;
2019 034eeaa1 Mike Melanson
extern AVCodec ws_snd1_decoder;
2020 de6d9b64 Fabrice Bellard
2021 a96b68b7 Fabrice Bellard
/* pcm codecs */
2022
#define PCM_CODEC(id, name) \
2023
extern AVCodec name ## _decoder; \
2024 f11d3f23 Michael Niedermayer
extern AVCodec name ## _encoder
2025 a96b68b7 Fabrice Bellard
2026
PCM_CODEC(CODEC_ID_PCM_S16LE, pcm_s16le);
2027
PCM_CODEC(CODEC_ID_PCM_S16BE, pcm_s16be);
2028
PCM_CODEC(CODEC_ID_PCM_U16LE, pcm_u16le);
2029
PCM_CODEC(CODEC_ID_PCM_U16BE, pcm_u16be);
2030
PCM_CODEC(CODEC_ID_PCM_S8, pcm_s8);
2031
PCM_CODEC(CODEC_ID_PCM_U8, pcm_u8);
2032
PCM_CODEC(CODEC_ID_PCM_ALAW, pcm_alaw);
2033
PCM_CODEC(CODEC_ID_PCM_MULAW, pcm_mulaw);
2034
2035 0147f198 François Revol
/* adpcm codecs */
2036
2037
PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
2038
PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
2039 9937e686 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_IMA_DK3, adpcm_ima_dk3);
2040
PCM_CODEC(CODEC_ID_ADPCM_IMA_DK4, adpcm_ima_dk4);
2041 2fdf638b Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_IMA_WS, adpcm_ima_ws);
2042 7d8379f2 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_SMJPEG, adpcm_ima_smjpeg);
2043 0147f198 François Revol
PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);
2044 4b465299 Michael Niedermayer
PCM_CODEC(CODEC_ID_ADPCM_4XM, adpcm_4xm);
2045 fc384777 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_XA, adpcm_xa);
2046
PCM_CODEC(CODEC_ID_ADPCM_ADX, adpcm_adx);
2047 7d8379f2 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_EA, adpcm_ea);
2048 e5966052 Roman Shaposhnik
PCM_CODEC(CODEC_ID_ADPCM_G726, adpcm_g726);
2049 b3bfb299 Mike Melanson
PCM_CODEC(CODEC_ID_ADPCM_CT, adpcm_ct);
2050 659c3692 Alex Beregszaszi
PCM_CODEC(CODEC_ID_ADPCM_SWF, adpcm_swf);
2051 0147f198 François Revol
2052 a96b68b7 Fabrice Bellard
#undef PCM_CODEC
2053
2054
/* dummy raw video codec */
2055 63167088 Roman Shaposhnik
extern AVCodec rawvideo_encoder;
2056
extern AVCodec rawvideo_decoder;
2057 de6d9b64 Fabrice Bellard
2058
/* the following codecs use external GPL libs */
2059
extern AVCodec ac3_decoder;
2060 23c99253 Michael Niedermayer
extern AVCodec dts_decoder;
2061 de6d9b64 Fabrice Bellard
2062
/* resample.c */
2063
2064
struct ReSampleContext;
2065 aaaf1635 Michael Niedermayer
struct AVResampleContext;
2066 de6d9b64 Fabrice Bellard
2067
typedef struct ReSampleContext ReSampleContext;
2068
2069
ReSampleContext *audio_resample_init(int output_channels, int input_channels, 
2070
                                     int output_rate, int input_rate);
2071
int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
2072
void audio_resample_close(ReSampleContext *s);
2073
2074 6e225de2 Michael Niedermayer
struct AVResampleContext *av_resample_init(int out_rate, int in_rate, int filter_length, int log2_phase_count, int linear, double cutoff);
2075 aaaf1635 Michael Niedermayer
int av_resample(struct AVResampleContext *c, short *dst, short *src, int *consumed, int src_size, int dst_size, int update_ctx);
2076 2d48eddd Michael Niedermayer
void av_resample_compensate(struct AVResampleContext *c, int sample_delta, int compensation_distance);
2077 d88443ae William Juwono
void av_resample_close(struct AVResampleContext *c);
2078 aaaf1635 Michael Niedermayer
2079 de6d9b64 Fabrice Bellard
/* YUV420 format is assumed ! */
2080
2081
struct ImgReSampleContext;
2082
2083
typedef struct ImgReSampleContext ImgReSampleContext;
2084
2085
ImgReSampleContext *img_resample_init(int output_width, int output_height,
2086
                                      int input_width, int input_height);
2087 ab6d194a Michael Niedermayer
2088
ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
2089
                                      int iwidth, int iheight,
2090
                                      int topBand, int bottomBand,
2091 1ff93ffc Todd Kirby
                                      int leftBand, int rightBand,
2092
                                      int padtop, int padbottom,
2093
                                      int padleft, int padright);
2094
2095 ab6d194a Michael Niedermayer
2096 de6d9b64 Fabrice Bellard
void img_resample(ImgReSampleContext *s, 
2097 da64ecc3 Drew Hess
                  AVPicture *output, const AVPicture *input);
2098 de6d9b64 Fabrice Bellard
2099
void img_resample_close(ImgReSampleContext *s);
2100
2101 75917b88 Drew Hess
/**
2102
 * Allocate memory for a picture.  Call avpicture_free to free it.
2103
 *
2104
 * @param picture the picture to be filled in.
2105
 * @param pix_fmt the format of the picture.
2106
 * @param width the width of the picture.
2107
 * @param height the height of the picture.
2108
 * @return 0 if successful, -1 if not.
2109
 */
2110
int avpicture_alloc(AVPicture *picture, int pix_fmt, int width, int height);
2111
2112
/* Free a picture previously allocated by avpicture_alloc. */
2113
void avpicture_free(AVPicture *picture);
2114
2115 0c1a9eda Zdenek Kabelac
int avpicture_fill(AVPicture *picture, uint8_t *ptr,
2116 2d1a4094 Fabrice Bellard
                   int pix_fmt, int width, int height);
2117 da64ecc3 Drew Hess
int avpicture_layout(const AVPicture* src, int pix_fmt, int width, int height,
2118 63167088 Roman Shaposhnik
                     unsigned char *dest, int dest_size);
2119 219b06c6 Fabrice Bellard
int avpicture_get_size(int pix_fmt, int width, int height);
2120 dab64ebc Fabrice Bellard
void avcodec_get_chroma_sub_sample(int pix_fmt, int *h_shift, int *v_shift);
2121
const char *avcodec_get_pix_fmt_name(int pix_fmt);
2122 21adafec Michael Niedermayer
void avcodec_set_dimensions(AVCodecContext *s, int width, int height);
2123 63167088 Roman Shaposhnik
enum PixelFormat avcodec_get_pix_fmt(const char* name);
2124 d07730dd Michael Niedermayer
unsigned int avcodec_pix_fmt_to_codec_tag(enum PixelFormat p);
2125 219b06c6 Fabrice Bellard
2126 fab21997 Fabrice Bellard
#define FF_LOSS_RESOLUTION  0x0001 /* loss due to resolution change */
2127
#define FF_LOSS_DEPTH       0x0002 /* loss due to color depth change */
2128
#define FF_LOSS_COLORSPACE  0x0004 /* loss due to color space conversion */
2129
#define FF_LOSS_ALPHA       0x0008 /* loss of alpha bits */
2130
#define FF_LOSS_COLORQUANT  0x0010 /* loss due to color quantization */
2131
#define FF_LOSS_CHROMA      0x0020 /* loss of chroma (e.g. rgb to gray conversion) */
2132
2133
int avcodec_get_pix_fmt_loss(int dst_pix_fmt, int src_pix_fmt,
2134
                             int has_alpha);
2135
int avcodec_find_best_pix_fmt(int pix_fmt_mask, int src_pix_fmt,
2136
                              int has_alpha, int *loss_ptr);
2137
2138 0469baf1 Fabrice Bellard
#define FF_ALPHA_TRANSP       0x0001 /* image has some totally transparent pixels */
2139
#define FF_ALPHA_SEMI_TRANSP  0x0002 /* image has some transparent pixels */
2140 da64ecc3 Drew Hess
int img_get_alpha_info(const AVPicture *src,
2141
                       int pix_fmt, int width, int height);
2142 0469baf1 Fabrice Bellard
2143 219b06c6 Fabrice Bellard
/* convert among pixel formats */
2144
int img_convert(AVPicture *dst, int dst_pix_fmt,
2145 da64ecc3 Drew Hess
                const AVPicture *src, int pix_fmt, 
2146 219b06c6 Fabrice Bellard
                int width, int height);
2147
2148
/* deinterlace a picture */
2149 da64ecc3 Drew Hess
int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
2150 de6d9b64 Fabrice Bellard
                          int pix_fmt, int width, int height);
2151
2152
/* external high level API */
2153
2154
extern AVCodec *first_avcodec;
2155
2156 156e5023 Nick Kurshev
/* returns LIBAVCODEC_VERSION_INT constant */
2157 51a49663 Fabrice Bellard
unsigned avcodec_version(void);
2158 8bceb6af Nick Kurshev
/* returns LIBAVCODEC_BUILD constant */
2159 51a49663 Fabrice Bellard
unsigned avcodec_build(void);
2160 de6d9b64 Fabrice Bellard
void avcodec_init(void);
2161
2162
void register_avcodec(AVCodec *format);
2163
AVCodec *avcodec_find_encoder(enum CodecID id);
2164 98f3b098 Arpi
AVCodec *avcodec_find_encoder_by_name(const char *name);
2165 de6d9b64 Fabrice Bellard
AVCodec *avcodec_find_decoder(enum CodecID id);
2166
AVCodec *avcodec_find_decoder_by_name(const char *name);
2167
void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
2168
2169 1e491e29 Michael Niedermayer
void avcodec_get_context_defaults(AVCodecContext *s);
2170 7ffbb60e Falk Hüffner
AVCodecContext *avcodec_alloc_context(void);
2171 7906085f Falk Hüffner
void avcodec_get_frame_defaults(AVFrame *pic);
2172 492cd3a9 Michael Niedermayer
AVFrame *avcodec_alloc_frame(void);
2173 1e491e29 Michael Niedermayer
2174 492cd3a9 Michael Niedermayer
int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
2175
void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
2176 3a569751 Michael Niedermayer
int avcodec_default_reget_buffer(AVCodecContext *s, AVFrame *pic);
2177
void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height);
2178 0ecca7a4 Michael Niedermayer
int avcodec_check_dimensions(void *av_log_ctx, unsigned int w, unsigned int h);
2179 3a569751 Michael Niedermayer
enum PixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum PixelFormat * fmt);
2180 1e491e29 Michael Niedermayer
2181 5a815088 Michael Niedermayer
int avcodec_thread_init(AVCodecContext *s, int thread_count);
2182
void avcodec_thread_free(AVCodecContext *s);
2183
int avcodec_thread_execute(AVCodecContext *s, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
2184 3a569751 Michael Niedermayer
int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
2185 9c3d33d6 Michael Niedermayer
//FIXME func typedef
2186
2187 7a06ff14 Michael Niedermayer
/**
2188
 * opens / inits the AVCodecContext.
2189
 * not thread save!
2190
 */
2191 de6d9b64 Fabrice Bellard
int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
2192 7a06ff14 Michael Niedermayer
2193 0c1a9eda Zdenek Kabelac
int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples, 
2194 de6d9b64 Fabrice Bellard
                         int *frame_size_ptr,
2195 0c1a9eda Zdenek Kabelac
                         uint8_t *buf, int buf_size);
2196 492cd3a9 Michael Niedermayer
int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture, 
2197 de6d9b64 Fabrice Bellard
                         int *got_picture_ptr,
2198 0c1a9eda Zdenek Kabelac
                         uint8_t *buf, int buf_size);
2199
int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata, 
2200 917e06c8 Fabrice Bellard
                        int *data_size_ptr,
2201 0c1a9eda Zdenek Kabelac
                        uint8_t *buf, int buf_size);
2202
int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size, 
2203 de6d9b64 Fabrice Bellard
                         const short *samples);
2204 0c1a9eda Zdenek Kabelac
int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size, 
2205 492cd3a9 Michael Niedermayer
                         const AVFrame *pict);
2206 de6d9b64 Fabrice Bellard
2207
int avcodec_close(AVCodecContext *avctx);
2208
2209
void avcodec_register_all(void);
2210 a96b68b7 Fabrice Bellard
2211 1c2a8c7f Michael Niedermayer
void avcodec_flush_buffers(AVCodecContext *avctx);
2212
2213 88730be6 Måns Rullgård
void avcodec_default_free_buffers(AVCodecContext *s);
2214
2215 14bea432 Michael Niedermayer
/* misc usefull functions */
2216 d8085ea7 Michael Niedermayer
2217
/**
2218
 * returns a single letter to describe the picture type
2219
 */
2220
char av_get_pict_type_char(int pict_type);
2221
2222 14bea432 Michael Niedermayer
/**
2223
 * reduce a fraction.
2224
 * this is usefull for framerate calculations
2225
 * @param max the maximum allowed for dst_nom & dst_den
2226
 * @return 1 if exact, 0 otherwise
2227
 */
2228
int av_reduce(int *dst_nom, int *dst_den, int64_t nom, int64_t den, int64_t max);
2229
2230
/**
2231 1f018225 Michael Niedermayer
 * rescale a 64bit integer with rounding to nearest.
2232 14bea432 Michael Niedermayer
 * a simple a*b/c isnt possible as it can overflow
2233
 */
2234 4c263142 Michael Niedermayer
int64_t av_rescale(int64_t a, int64_t b, int64_t c);
2235 628d601b Zdenek Kabelac
2236 1f018225 Michael Niedermayer
/**
2237
 * rescale a 64bit integer with specified rounding.
2238
 * a simple a*b/c isnt possible as it can overflow
2239
 */
2240
int64_t av_rescale_rnd(int64_t a, int64_t b, int64_t c, enum AVRounding);
2241 628d601b Zdenek Kabelac
2242 8424cf50 Fabrice Bellard
/* frame parsing */
2243
typedef struct AVCodecParserContext {
2244
    void *priv_data;
2245
    struct AVCodecParser *parser;
2246
    int64_t frame_offset; /* offset of the current frame */
2247
    int64_t cur_offset; /* current offset 
2248
                           (incremented by each av_parser_parse()) */
2249
    int64_t last_frame_offset; /* offset of the last frame */
2250
    /* video info */
2251
    int pict_type; /* XXX: put it back in AVCodecContext */
2252
    int repeat_pict; /* XXX: put it back in AVCodecContext */
2253 b84f2a35 Fabrice Bellard
    int64_t pts;     /* pts of the current frame */
2254
    int64_t dts;     /* dts of the current frame */
2255
2256
    /* private data */
2257
    int64_t last_pts;
2258
    int64_t last_dts;
2259 a62aecce Michael Niedermayer
    int fetch_timestamp;
2260 b84f2a35 Fabrice Bellard
2261
#define AV_PARSER_PTS_NB 4
2262
    int cur_frame_start_index;
2263
    int64_t cur_frame_offset[AV_PARSER_PTS_NB];
2264
    int64_t cur_frame_pts[AV_PARSER_PTS_NB];
2265
    int64_t cur_frame_dts[AV_PARSER_PTS_NB];
2266 8424cf50 Fabrice Bellard
} AVCodecParserContext;
2267
2268
typedef struct AVCodecParser {
2269 99f06236 Michael Niedermayer
    int codec_ids[5]; /* several codec IDs are permitted */
2270 8424cf50 Fabrice Bellard
    int priv_data_size;
2271
    int (*parser_init)(AVCodecParserContext *s);
2272
    int (*parser_parse)(AVCodecParserContext *s, 
2273
                        AVCodecContext *avctx,
2274
                        uint8_t **poutbuf, int *poutbuf_size, 
2275
                        const uint8_t *buf, int buf_size);
2276
    void (*parser_close)(AVCodecParserContext *s);
2277
    struct AVCodecParser *next;
2278
} AVCodecParser;
2279
2280
extern AVCodecParser *av_first_parser;
2281
2282
void av_register_codec_parser(AVCodecParser *parser);
2283
AVCodecParserContext *av_parser_init(int codec_id);
2284
int av_parser_parse(AVCodecParserContext *s, 
2285
                    AVCodecContext *avctx,
2286
                    uint8_t **poutbuf, int *poutbuf_size, 
2287 b84f2a35 Fabrice Bellard
                    const uint8_t *buf, int buf_size,
2288
                    int64_t pts, int64_t dts);
2289 8424cf50 Fabrice Bellard
void av_parser_close(AVCodecParserContext *s);
2290
2291
extern AVCodecParser mpegvideo_parser;
2292
extern AVCodecParser mpeg4video_parser;
2293 c6148de2 Michael Niedermayer
extern AVCodecParser h261_parser;
2294 8424cf50 Fabrice Bellard
extern AVCodecParser h263_parser;
2295
extern AVCodecParser h264_parser;
2296 8e6325b9 Michael Niedermayer
extern AVCodecParser mjpeg_parser;
2297 99f06236 Michael Niedermayer
extern AVCodecParser pnm_parser;
2298 8424cf50 Fabrice Bellard
extern AVCodecParser mpegaudio_parser;
2299
extern AVCodecParser ac3_parser;
2300
2301 544eb99c Fabrice Bellard
/* memory */
2302 e4eadb4b Michael Niedermayer
void *av_malloc(unsigned int size);
2303 18f77016 Zdenek Kabelac
void *av_mallocz(unsigned int size);
2304 8e1e6f31 Fabrice Bellard
void *av_realloc(void *ptr, unsigned int size);
2305 544eb99c Fabrice Bellard
void av_free(void *ptr);
2306 8e1e6f31 Fabrice Bellard
char *av_strdup(const char *s);
2307 81c5f887 Michael Niedermayer
void av_freep(void *ptr);
2308 97d96aaa Zdenek Kabelac
void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
2309 855ea723 Zdenek Kabelac
/* for static data only */
2310
/* call av_free_static to release all staticaly allocated tables */
2311 628d601b Zdenek Kabelac
void av_free_static(void);
2312 8d1f2ba5 Michael Niedermayer
void *av_mallocz_static(unsigned int size);
2313 073c2593 Burkhard Plaum
void *av_realloc_static(void *ptr, unsigned int size);
2314 544eb99c Fabrice Bellard
2315 fc384777 Mike Melanson
/* add by bero : in adx.c */
2316
int is_adx(const unsigned char *buf,size_t bufsize);
2317
2318 e1c2a5a0 Roberto Togni
void img_copy(AVPicture *dst, const AVPicture *src,
2319
              int pix_fmt, int width, int height);
2320
2321 9b879566 Michel Bardiaux
/* av_log API */
2322
2323
#include <stdarg.h>
2324
2325 d8019eb5 Allen Day
#define AV_LOG_QUIET -1
2326 9b879566 Michel Bardiaux
#define AV_LOG_ERROR 0
2327
#define AV_LOG_INFO 1
2328
#define AV_LOG_DEBUG 2
2329
2330 f4bd8cf0 Michael Niedermayer
#ifdef __GNUC__
2331 bc874dae Michel Bardiaux
extern void av_log(void*, int level, const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4)));
2332 f4bd8cf0 Michael Niedermayer
#else
2333
extern void av_log(void*, int level, const char *fmt, ...);
2334
#endif
2335
2336 bc874dae Michel Bardiaux
extern void av_vlog(void*, int level, const char *fmt, va_list);
2337 9b879566 Michel Bardiaux
extern int av_log_get_level(void);
2338
extern void av_log_set_level(int);
2339 bc874dae Michel Bardiaux
extern void av_log_set_callback(void (*)(void*, int, const char*, va_list));
2340 9b879566 Michel Bardiaux
2341 3a278992 Mike Melanson
/* endian macros */
2342 e96682e6 Michael Niedermayer
#if !defined(BE_16) || !defined(BE_32) || !defined(LE_16) || !defined(LE_32)
2343 3a278992 Mike Melanson
#define BE_16(x)  ((((uint8_t*)(x))[0] << 8) | ((uint8_t*)(x))[1])
2344
#define BE_32(x)  ((((uint8_t*)(x))[0] << 24) | \
2345
                   (((uint8_t*)(x))[1] << 16) | \
2346
                   (((uint8_t*)(x))[2] << 8) | \
2347
                    ((uint8_t*)(x))[3])
2348
#define LE_16(x)  ((((uint8_t*)(x))[1] << 8) | ((uint8_t*)(x))[0])
2349
#define LE_32(x)  ((((uint8_t*)(x))[3] << 24) | \
2350
                   (((uint8_t*)(x))[2] << 16) | \
2351
                   (((uint8_t*)(x))[1] << 8) | \
2352
                    ((uint8_t*)(x))[0])
2353 e96682e6 Michael Niedermayer
#endif
2354 3a278992 Mike Melanson
2355 02d697aa Zdenek Kabelac
#ifdef __cplusplus
2356
}
2357
#endif
2358
2359 a96b68b7 Fabrice Bellard
#endif /* AVCODEC_H */