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