Statistics
| Branch: | Revision:

ffmpeg / libavcodec / avcodec.h @ 9e96ab03

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