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