Commit | Line | Data |
---|---|---|
04d7f601 DB |
1 | /* |
2 | * copyright (c) 2001 Fabrice Bellard | |
3 | * | |
2912e87a | 4 | * This file is part of Libav. |
b78e7197 | 5 | * |
2912e87a | 6 | * Libav is free software; you can redistribute it and/or |
04d7f601 DB |
7 | * modify it under the terms of the GNU Lesser General Public |
8 | * License as published by the Free Software Foundation; either | |
b78e7197 | 9 | * version 2.1 of the License, or (at your option) any later version. |
04d7f601 | 10 | * |
2912e87a | 11 | * Libav is distributed in the hope that it will be useful, |
04d7f601 DB |
12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
14 | * Lesser General Public License for more details. | |
15 | * | |
16 | * You should have received a copy of the GNU Lesser General Public | |
2912e87a | 17 | * License along with Libav; if not, write to the Free Software |
e5a389a1 | 18 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
04d7f601 DB |
19 | */ |
20 | ||
98790382 SS |
21 | #ifndef AVCODEC_AVCODEC_H |
22 | #define AVCODEC_AVCODEC_H | |
a96b68b7 | 23 | |
36df8805 | 24 | /** |
ba87f080 | 25 | * @file |
f5bccd85 | 26 | * external API header |
36df8805 MN |
27 | */ |
28 | ||
c60208e7 | 29 | #include <errno.h> |
737eb597 | 30 | #include "libavutil/samplefmt.h" |
76a448ed | 31 | #include "libavutil/avutil.h" |
7160bb71 | 32 | #include "libavutil/cpu.h" |
de6d9b64 | 33 | |
3dd851c4 | 34 | #include "libavcodec/version.h" |
eda7c983 | 35 | |
372c3f82 MN |
36 | #if LIBAVCODEC_VERSION_MAJOR < 53 |
37 | # define FF_INTERNALC_MEM_TYPE unsigned int | |
38 | #else | |
39 | # define FF_INTERNALC_MEM_TYPE size_t | |
40 | #endif | |
41 | ||
7ebf5927 | 42 | /** |
48966b02 | 43 | * Identify the syntax and semantics of the bitstream. |
6b0cdb6e NG |
44 | * The principle is roughly: |
45 | * Two decoders with the same ID can decode the same streams. | |
46 | * Two encoders with the same ID can encode compatible streams. | |
47 | * There may be slight deviations from the principle due to implementation | |
48 | * details. | |
7ebf5927 | 49 | * |
f5bccd85 DB |
50 | * If you add a codec ID to this list, add it so that |
51 | * 1. no value of a existing codec ID changes (that would break ABI), | |
52 | * 2. it is as close as possible to similar codecs. | |
7ebf5927 | 53 | */ |
de6d9b64 | 54 | enum CodecID { |
115329f1 | 55 | CODEC_ID_NONE, |
ba0dabbf DB |
56 | |
57 | /* video codecs */ | |
de6d9b64 | 58 | CODEC_ID_MPEG1VIDEO, |
0e373b95 | 59 | CODEC_ID_MPEG2VIDEO, ///< preferred ID for MPEG-1/2 video decoding |
fb364ada | 60 | CODEC_ID_MPEG2VIDEO_XVMC, |
c6148de2 | 61 | CODEC_ID_H261, |
de6d9b64 FB |
62 | CODEC_ID_H263, |
63 | CODEC_ID_RV10, | |
68b94c35 | 64 | CODEC_ID_RV20, |
de6d9b64 | 65 | CODEC_ID_MJPEG, |
b135d9fb | 66 | CODEC_ID_MJPEGB, |
b1e6b355 | 67 | CODEC_ID_LJPEG, |
5e83dec4 | 68 | CODEC_ID_SP5X, |
5639729b | 69 | CODEC_ID_JPEGLS, |
bf89e6b1 | 70 | CODEC_ID_MPEG4, |
de6d9b64 | 71 | CODEC_ID_RAWVIDEO, |
84afee34 MN |
72 | CODEC_ID_MSMPEG4V1, |
73 | CODEC_ID_MSMPEG4V2, | |
74 | CODEC_ID_MSMPEG4V3, | |
e1a9dbff | 75 | CODEC_ID_WMV1, |
b50eef3a | 76 | CODEC_ID_WMV2, |
de6d9b64 FB |
77 | CODEC_ID_H263P, |
78 | CODEC_ID_H263I, | |
d4f5d74a | 79 | CODEC_ID_FLV1, |
be8ffec9 | 80 | CODEC_ID_SVQ1, |
8b82a956 | 81 | CODEC_ID_SVQ3, |
020fcc94 | 82 | CODEC_ID_DVVIDEO, |
11f18faf | 83 | CODEC_ID_HUFFYUV, |
f70f7c6d | 84 | CODEC_ID_CYUV, |
0da71265 | 85 | CODEC_ID_H264, |
deabd4fd | 86 | CODEC_ID_INDEO3, |
d86053a4 | 87 | CODEC_ID_VP3, |
f44ee2c3 | 88 | CODEC_ID_THEORA, |
3d2e8cce | 89 | CODEC_ID_ASV1, |
9b56edf5 | 90 | CODEC_ID_ASV2, |
5e20f836 | 91 | CODEC_ID_FFV1, |
e2a7bb28 | 92 | CODEC_ID_4XM, |
be3564ed | 93 | CODEC_ID_VCR1, |
3aff069b | 94 | CODEC_ID_CLJR, |
c3bf0288 | 95 | CODEC_ID_MDEC, |
3ef8be2b MM |
96 | CODEC_ID_ROQ, |
97 | CODEC_ID_INTERPLAY_VIDEO, | |
9937e686 MM |
98 | CODEC_ID_XAN_WC3, |
99 | CODEC_ID_XAN_WC4, | |
2fdf638b MM |
100 | CODEC_ID_RPZA, |
101 | CODEC_ID_CINEPAK, | |
102 | CODEC_ID_WS_VQA, | |
103 | CODEC_ID_MSRLE, | |
104 | CODEC_ID_MSVIDEO1, | |
4120a53a | 105 | CODEC_ID_IDCIN, |
1dc1ed99 | 106 | CODEC_ID_8BPS, |
11e29a41 | 107 | CODEC_ID_SMC, |
42cad81a | 108 | CODEC_ID_FLIC, |
9a4117d5 | 109 | CODEC_ID_TRUEMOTION1, |
fafa0b75 | 110 | CODEC_ID_VMDVIDEO, |
a273bbfb RT |
111 | CODEC_ID_MSZH, |
112 | CODEC_ID_ZLIB, | |
070ed1bc | 113 | CODEC_ID_QTRLE, |
791e7b83 | 114 | CODEC_ID_SNOW, |
9d53d58e | 115 | CODEC_ID_TSCC, |
d0a0bbd2 | 116 | CODEC_ID_ULTI, |
d08d7142 | 117 | CODEC_ID_QDRAW, |
ab711b3c | 118 | CODEC_ID_VIXL, |
acfd8f0f | 119 | CODEC_ID_QPEG, |
382b5b3a | 120 | #if LIBAVCODEC_VERSION_MAJOR < 53 |
17179d2d | 121 | CODEC_ID_XVID, |
382b5b3a | 122 | #endif |
17179d2d MN |
123 | CODEC_ID_PNG, |
124 | CODEC_ID_PPM, | |
125 | CODEC_ID_PBM, | |
126 | CODEC_ID_PGM, | |
127 | CODEC_ID_PGMYUV, | |
128 | CODEC_ID_PAM, | |
f37b9768 | 129 | CODEC_ID_FFVHUFF, |
3f05305d MN |
130 | CODEC_ID_RV30, |
131 | CODEC_ID_RV40, | |
10b9c374 | 132 | CODEC_ID_VC1, |
21aa398f | 133 | CODEC_ID_WMV3, |
9c7fb608 | 134 | CODEC_ID_LOCO, |
a8a15e9d | 135 | CODEC_ID_WNV1, |
589f8220 | 136 | CODEC_ID_AASC, |
856dbbff | 137 | CODEC_ID_INDEO2, |
b81f8949 | 138 | CODEC_ID_FRAPS, |
64af6168 | 139 | CODEC_ID_TRUEMOTION2, |
9fa62f2a | 140 | CODEC_ID_BMP, |
e0f80bd7 | 141 | CODEC_ID_CSCD, |
4e114829 | 142 | CODEC_ID_MMVIDEO, |
9c8d8e84 | 143 | CODEC_ID_ZMBV, |
26376701 | 144 | CODEC_ID_AVS, |
348efc18 | 145 | CODEC_ID_SMACKVIDEO, |
dfca23e3 | 146 | CODEC_ID_NUV, |
fd7b1991 | 147 | CODEC_ID_KMVC, |
0919e788 | 148 | CODEC_ID_FLASHSV, |
20ffddb9 | 149 | CODEC_ID_CAVS, |
f31065f6 | 150 | CODEC_ID_JPEG2000, |
eb57c889 | 151 | CODEC_ID_VMNC, |
5ce117c3 AJ |
152 | CODEC_ID_VP5, |
153 | CODEC_ID_VP6, | |
154 | CODEC_ID_VP6F, | |
3689cf16 | 155 | CODEC_ID_TARGA, |
72450e50 | 156 | CODEC_ID_DSICINVIDEO, |
29f86228 | 157 | CODEC_ID_TIERTEXSEQVIDEO, |
a991b1fe | 158 | CODEC_ID_TIFF, |
06d392a7 | 159 | CODEC_ID_GIF, |
3edeab82 | 160 | CODEC_ID_FFH264, |
33a0dd37 | 161 | CODEC_ID_DXA, |
52b6bad2 | 162 | CODEC_ID_DNXHD, |
efb0c399 | 163 | CODEC_ID_THP, |
2d99eed1 | 164 | CODEC_ID_SGI, |
9a0ddd09 | 165 | CODEC_ID_C93, |
1e6c6759 | 166 | CODEC_ID_BETHSOFTVID, |
b46d68c6 | 167 | CODEC_ID_PTX, |
1ca779e7 | 168 | CODEC_ID_TXD, |
91fc2cf1 | 169 | CODEC_ID_VP6A, |
8787d837 | 170 | CODEC_ID_AMV, |
66f7679c | 171 | CODEC_ID_VB, |
b4abe1d1 | 172 | CODEC_ID_PCX, |
d43df959 | 173 | CODEC_ID_SUNRAST, |
800b9c24 BL |
174 | CODEC_ID_INDEO4, |
175 | CODEC_ID_INDEO5, | |
a7129de5 | 176 | CODEC_ID_MIMIC, |
975cdc8f | 177 | CODEC_ID_RL2, |
cb21e0a7 JM |
178 | CODEC_ID_8SVX_EXP, |
179 | CODEC_ID_8SVX_FIB, | |
40d26273 | 180 | CODEC_ID_ESCAPE124, |
782a58ec | 181 | CODEC_ID_DIRAC, |
b64c096b | 182 | CODEC_ID_BFI, |
495900f7 | 183 | CODEC_ID_CMV, |
974e0eee | 184 | CODEC_ID_MOTIONPIXELS, |
cfc78718 | 185 | CODEC_ID_TGV, |
42b30357 | 186 | CODEC_ID_TGQ, |
d8964f3a | 187 | CODEC_ID_TQI, |
c21fbefb KS |
188 | CODEC_ID_AURA, |
189 | CODEC_ID_AURA2, | |
97f92143 | 190 | CODEC_ID_V210X, |
a1fd2bc3 | 191 | CODEC_ID_TMV, |
ca0bb1c4 | 192 | CODEC_ID_V210, |
94d3d6a4 | 193 | CODEC_ID_DPX, |
c63ea92b | 194 | CODEC_ID_MAD, |
d8b35b85 | 195 | CODEC_ID_FRWU, |
0aa6a518 | 196 | CODEC_ID_FLASHSV2, |
a3d995c1 | 197 | CODEC_ID_CDGRAPHICS, |
4aaab0a3 | 198 | CODEC_ID_R210, |
a1ae40fd | 199 | CODEC_ID_ANM, |
4e5f42dd | 200 | CODEC_ID_BINKVIDEO, |
b9e06ddd PR |
201 | CODEC_ID_IFF_ILBM, |
202 | CODEC_ID_IFF_BYTERUN1, | |
bf354122 | 203 | CODEC_ID_KGV1, |
148bcae9 | 204 | CODEC_ID_YOP, |
a98c2dfa | 205 | CODEC_ID_VP8, |
a526d619 | 206 | CODEC_ID_PICTOR, |
beaa963c | 207 | CODEC_ID_ANSI, |
40c5ee99 TB |
208 | CODEC_ID_A64_MULTI, |
209 | CODEC_ID_A64_MULTI5, | |
43836928 | 210 | CODEC_ID_R10K, |
9d09ebf1 | 211 | CODEC_ID_MXPEG, |
d267b339 | 212 | CODEC_ID_LAGARITH, |
f5b82f45 | 213 | CODEC_ID_PRORES, |
0697440c | 214 | CODEC_ID_JV, |
40c5ee99 | 215 | |
f5bccd85 | 216 | /* various PCM "codecs" */ |
17179d2d | 217 | CODEC_ID_PCM_S16LE= 0x10000, |
a96b68b7 FB |
218 | CODEC_ID_PCM_S16BE, |
219 | CODEC_ID_PCM_U16LE, | |
220 | CODEC_ID_PCM_U16BE, | |
221 | CODEC_ID_PCM_S8, | |
222 | CODEC_ID_PCM_U8, | |
223 | CODEC_ID_PCM_MULAW, | |
224 | CODEC_ID_PCM_ALAW, | |
b461b3bc RD |
225 | CODEC_ID_PCM_S32LE, |
226 | CODEC_ID_PCM_S32BE, | |
227 | CODEC_ID_PCM_U32LE, | |
228 | CODEC_ID_PCM_U32BE, | |
229 | CODEC_ID_PCM_S24LE, | |
230 | CODEC_ID_PCM_S24BE, | |
231 | CODEC_ID_PCM_U24LE, | |
232 | CODEC_ID_PCM_U24BE, | |
233 | CODEC_ID_PCM_S24DAUD, | |
a11c2a2c | 234 | CODEC_ID_PCM_ZORK, |
725d86bf | 235 | CODEC_ID_PCM_S16LE_PLANAR, |
1472b7dd | 236 | CODEC_ID_PCM_DVD, |
aa29709e | 237 | CODEC_ID_PCM_F32BE, |
143a5d6f PR |
238 | CODEC_ID_PCM_F32LE, |
239 | CODEC_ID_PCM_F64BE, | |
240 | CODEC_ID_PCM_F64LE, | |
5dd3707b | 241 | CODEC_ID_PCM_BLURAY, |
fbeabfca | 242 | CODEC_ID_PCM_LXF, |
0147f198 | 243 | |
f5bccd85 | 244 | /* various ADPCM codecs */ |
17179d2d | 245 | CODEC_ID_ADPCM_IMA_QT= 0x11000, |
0147f198 | 246 | CODEC_ID_ADPCM_IMA_WAV, |
9937e686 MM |
247 | CODEC_ID_ADPCM_IMA_DK3, |
248 | CODEC_ID_ADPCM_IMA_DK4, | |
2fdf638b | 249 | CODEC_ID_ADPCM_IMA_WS, |
7d8379f2 | 250 | CODEC_ID_ADPCM_IMA_SMJPEG, |
0147f198 | 251 | CODEC_ID_ADPCM_MS, |
e2a7bb28 | 252 | CODEC_ID_ADPCM_4XM, |
fc384777 MM |
253 | CODEC_ID_ADPCM_XA, |
254 | CODEC_ID_ADPCM_ADX, | |
7d8379f2 | 255 | CODEC_ID_ADPCM_EA, |
e5966052 | 256 | CODEC_ID_ADPCM_G726, |
b3bfb299 | 257 | CODEC_ID_ADPCM_CT, |
659c3692 | 258 | CODEC_ID_ADPCM_SWF, |
2ff4524e | 259 | CODEC_ID_ADPCM_YAMAHA, |
2433f24f AJ |
260 | CODEC_ID_ADPCM_SBPRO_4, |
261 | CODEC_ID_ADPCM_SBPRO_3, | |
262 | CODEC_ID_ADPCM_SBPRO_2, | |
d1e0d21f | 263 | CODEC_ID_ADPCM_THP, |
3a7f5d07 | 264 | CODEC_ID_ADPCM_IMA_AMV, |
e7583962 PR |
265 | CODEC_ID_ADPCM_EA_R1, |
266 | CODEC_ID_ADPCM_EA_R3, | |
267 | CODEC_ID_ADPCM_EA_R2, | |
7bb65d89 | 268 | CODEC_ID_ADPCM_IMA_EA_SEAD, |
fac84d3c | 269 | CODEC_ID_ADPCM_IMA_EA_EACS, |
271b4095 | 270 | CODEC_ID_ADPCM_EA_XAS, |
861c63a2 | 271 | CODEC_ID_ADPCM_EA_MAXIS_XA, |
055dc116 | 272 | CODEC_ID_ADPCM_IMA_ISS, |
58e37eaf | 273 | CODEC_ID_ADPCM_G722, |
891f64b3 | 274 | |
17179d2d MN |
275 | /* AMR */ |
276 | CODEC_ID_AMR_NB= 0x12000, | |
d663a1fd MN |
277 | CODEC_ID_AMR_WB, |
278 | ||
b8414bbd | 279 | /* RealAudio codecs*/ |
17179d2d | 280 | CODEC_ID_RA_144= 0x13000, |
b8414bbd | 281 | CODEC_ID_RA_288, |
3ef8be2b MM |
282 | |
283 | /* various DPCM codecs */ | |
17179d2d | 284 | CODEC_ID_ROQ_DPCM= 0x14000, |
3ef8be2b | 285 | CODEC_ID_INTERPLAY_DPCM, |
9937e686 | 286 | CODEC_ID_XAN_DPCM, |
d08d7142 | 287 | CODEC_ID_SOL_DPCM, |
115329f1 | 288 | |
ba0dabbf | 289 | /* audio codecs */ |
17179d2d | 290 | CODEC_ID_MP2= 0x15000, |
0e373b95 | 291 | CODEC_ID_MP3, ///< preferred ID for decoding MPEG audio layer 1, 2 or 3 |
17179d2d | 292 | CODEC_ID_AAC, |
17179d2d MN |
293 | CODEC_ID_AC3, |
294 | CODEC_ID_DTS, | |
295 | CODEC_ID_VORBIS, | |
296 | CODEC_ID_DVAUDIO, | |
297 | CODEC_ID_WMAV1, | |
298 | CODEC_ID_WMAV2, | |
299 | CODEC_ID_MACE3, | |
300 | CODEC_ID_MACE6, | |
301 | CODEC_ID_VMDAUDIO, | |
302 | CODEC_ID_SONIC, | |
303 | CODEC_ID_SONIC_LS, | |
ac2570a8 | 304 | CODEC_ID_FLAC, |
1ede228a | 305 | CODEC_ID_MP3ADU, |
d2a7718d | 306 | CODEC_ID_MP3ON4, |
85ad5695 | 307 | CODEC_ID_SHORTEN, |
5df8a0c6 | 308 | CODEC_ID_ALAC, |
034eeaa1 | 309 | CODEC_ID_WESTWOOD_SND1, |
0e373b95 | 310 | CODEC_ID_GSM, ///< as in Berlin toast format |
d9b1c197 | 311 | CODEC_ID_QDM2, |
e0f7e329 | 312 | CODEC_ID_COOK, |
bf3027c8 | 313 | CODEC_ID_TRUESPEECH, |
a24c4a2a | 314 | CODEC_ID_TTA, |
348efc18 | 315 | CODEC_ID_SMACKAUDIO, |
6c496518 | 316 | CODEC_ID_QCELP, |
730581f3 | 317 | CODEC_ID_WAVPACK, |
72450e50 | 318 | CODEC_ID_DSICINAUDIO, |
84ed36da | 319 | CODEC_ID_IMC, |
185c7b6b | 320 | CODEC_ID_MUSEPACK7, |
aad512b4 | 321 | CODEC_ID_MLP, |
f5bccd85 | 322 | CODEC_ID_GSM_MS, /* as found in WAV */ |
10e26bc7 | 323 | CODEC_ID_ATRAC3, |
8950f828 | 324 | CODEC_ID_VOXWARE, |
bf4a1f17 | 325 | CODEC_ID_APE, |
636b13c5 | 326 | CODEC_ID_NELLYMOSER, |
12877faf | 327 | CODEC_ID_MUSEPACK8, |
cb4ddf77 | 328 | CODEC_ID_SPEEX, |
7bb8d51c BL |
329 | CODEC_ID_WMAVOICE, |
330 | CODEC_ID_WMAPRO, | |
800b9c24 | 331 | CODEC_ID_WMALOSSLESS, |
b339f0c6 | 332 | CODEC_ID_ATRAC3P, |
2988c93d | 333 | CODEC_ID_EAC3, |
faeedbbb | 334 | CODEC_ID_SIPR, |
7f507b2d | 335 | CODEC_ID_MP1, |
616e899c | 336 | CODEC_ID_TWINVQ, |
9ba4821d | 337 | CODEC_ID_TRUEHD, |
b24bbbb4 | 338 | CODEC_ID_MP4ALS, |
223e8df1 | 339 | CODEC_ID_ATRAC1, |
4e5f42dd DV |
340 | CODEC_ID_BINKAUDIO_RDFT, |
341 | CODEC_ID_BINKAUDIO_DCT, | |
136e19e1 | 342 | CODEC_ID_AAC_LATM, |
ed19fafd | 343 | CODEC_ID_QDMC, |
115329f1 | 344 | |
240c1657 | 345 | /* subtitle codecs */ |
115329f1 DB |
346 | CODEC_ID_DVD_SUBTITLE= 0x17000, |
347 | CODEC_ID_DVB_SUBTITLE, | |
0e373b95 | 348 | CODEC_ID_TEXT, ///< raw UTF-8 text |
7e2643ae | 349 | CODEC_ID_XSUB, |
f9a9b350 | 350 | CODEC_ID_SSA, |
cc8c2c6a | 351 | CODEC_ID_MOV_TEXT, |
c58b82a2 | 352 | CODEC_ID_HDMV_PGS_SUBTITLE, |
e58992e4 | 353 | CODEC_ID_DVB_TELETEXT, |
ba2c508d | 354 | CODEC_ID_SRT, |
115329f1 | 355 | |
7ce68923 | 356 | /* other specific kind of codecs (generally used for attachments) */ |
f8d7c9d3 ES |
357 | CODEC_ID_TTF= 0x18000, |
358 | ||
0bef08e5 MN |
359 | CODEC_ID_PROBE= 0x19000, ///< codec_id is not known (like CODEC_ID_NONE) but lavf should attempt to identify it |
360 | ||
0e373b95 | 361 | CODEC_ID_MPEG2TS= 0x20000, /**< _FAKE_ codec to indicate a raw MPEG-2 TS |
f5bccd85 | 362 | * stream (only used by libavformat) */ |
fd5b124d | 363 | CODEC_ID_FFMETADATA=0x21000, ///< Dummy codec for streams containing only metadata information. |
de6d9b64 | 364 | }; |
dcedf586 | 365 | |
72415b2a SS |
366 | #if LIBAVCODEC_VERSION_MAJOR < 53 |
367 | #define CodecType AVMediaType | |
368 | ||
369 | #define CODEC_TYPE_UNKNOWN AVMEDIA_TYPE_UNKNOWN | |
370 | #define CODEC_TYPE_VIDEO AVMEDIA_TYPE_VIDEO | |
371 | #define CODEC_TYPE_AUDIO AVMEDIA_TYPE_AUDIO | |
372 | #define CODEC_TYPE_DATA AVMEDIA_TYPE_DATA | |
373 | #define CODEC_TYPE_SUBTITLE AVMEDIA_TYPE_SUBTITLE | |
374 | #define CODEC_TYPE_ATTACHMENT AVMEDIA_TYPE_ATTACHMENT | |
375 | #define CODEC_TYPE_NB AVMEDIA_TYPE_NB | |
376 | #endif | |
377 | ||
262d1c5d SS |
378 | #if FF_API_OLD_SAMPLE_FMT |
379 | #define SampleFormat AVSampleFormat | |
380 | ||
381 | #define SAMPLE_FMT_NONE AV_SAMPLE_FMT_NONE | |
382 | #define SAMPLE_FMT_U8 AV_SAMPLE_FMT_U8 | |
383 | #define SAMPLE_FMT_S16 AV_SAMPLE_FMT_S16 | |
384 | #define SAMPLE_FMT_S32 AV_SAMPLE_FMT_S32 | |
385 | #define SAMPLE_FMT_FLT AV_SAMPLE_FMT_FLT | |
386 | #define SAMPLE_FMT_DBL AV_SAMPLE_FMT_DBL | |
387 | #define SAMPLE_FMT_NB AV_SAMPLE_FMT_NB | |
388 | #endif | |
a96b68b7 | 389 | |
176a6157 | 390 | #if FF_API_OLD_AUDIOCONVERT |
737eb597 | 391 | #include "libavutil/audioconvert.h" |
176a6157 | 392 | |
0d72e7d0 | 393 | /* Audio channel masks */ |
176a6157 SS |
394 | #define CH_FRONT_LEFT AV_CH_FRONT_LEFT |
395 | #define CH_FRONT_RIGHT AV_CH_FRONT_RIGHT | |
396 | #define CH_FRONT_CENTER AV_CH_FRONT_CENTER | |
397 | #define CH_LOW_FREQUENCY AV_CH_LOW_FREQUENCY | |
398 | #define CH_BACK_LEFT AV_CH_BACK_LEFT | |
399 | #define CH_BACK_RIGHT AV_CH_BACK_RIGHT | |
400 | #define CH_FRONT_LEFT_OF_CENTER AV_CH_FRONT_LEFT_OF_CENTER | |
401 | #define CH_FRONT_RIGHT_OF_CENTER AV_CH_FRONT_RIGHT_OF_CENTER | |
402 | #define CH_BACK_CENTER AV_CH_BACK_CENTER | |
403 | #define CH_SIDE_LEFT AV_CH_SIDE_LEFT | |
404 | #define CH_SIDE_RIGHT AV_CH_SIDE_RIGHT | |
405 | #define CH_TOP_CENTER AV_CH_TOP_CENTER | |
406 | #define CH_TOP_FRONT_LEFT AV_CH_TOP_FRONT_LEFT | |
407 | #define CH_TOP_FRONT_CENTER AV_CH_TOP_FRONT_CENTER | |
408 | #define CH_TOP_FRONT_RIGHT AV_CH_TOP_FRONT_RIGHT | |
409 | #define CH_TOP_BACK_LEFT AV_CH_TOP_BACK_LEFT | |
410 | #define CH_TOP_BACK_CENTER AV_CH_TOP_BACK_CENTER | |
411 | #define CH_TOP_BACK_RIGHT AV_CH_TOP_BACK_RIGHT | |
412 | #define CH_STEREO_LEFT AV_CH_STEREO_LEFT | |
413 | #define CH_STEREO_RIGHT AV_CH_STEREO_RIGHT | |
0d72e7d0 | 414 | |
31557166 JR |
415 | /** Channel mask value used for AVCodecContext.request_channel_layout |
416 | to indicate that the user requests the channel order of the decoder output | |
417 | to be the native codec channel order. */ | |
176a6157 | 418 | #define CH_LAYOUT_NATIVE AV_CH_LAYOUT_NATIVE |
31557166 | 419 | |
0d72e7d0 | 420 | /* Audio channel convenience macros */ |
176a6157 SS |
421 | #define CH_LAYOUT_MONO AV_CH_LAYOUT_MONO |
422 | #define CH_LAYOUT_STEREO AV_CH_LAYOUT_STEREO | |
423 | #define CH_LAYOUT_2_1 AV_CH_LAYOUT_2_1 | |
424 | #define CH_LAYOUT_SURROUND AV_CH_LAYOUT_SURROUND | |
425 | #define CH_LAYOUT_4POINT0 AV_CH_LAYOUT_4POINT0 | |
426 | #define CH_LAYOUT_2_2 AV_CH_LAYOUT_2_2 | |
427 | #define CH_LAYOUT_QUAD AV_CH_LAYOUT_QUAD | |
428 | #define CH_LAYOUT_5POINT0 AV_CH_LAYOUT_5POINT0 | |
429 | #define CH_LAYOUT_5POINT1 AV_CH_LAYOUT_5POINT1 | |
430 | #define CH_LAYOUT_5POINT0_BACK AV_CH_LAYOUT_5POINT0_BACK | |
431 | #define CH_LAYOUT_5POINT1_BACK AV_CH_LAYOUT_5POINT1_BACK | |
432 | #define CH_LAYOUT_7POINT0 AV_CH_LAYOUT_7POINT0 | |
433 | #define CH_LAYOUT_7POINT1 AV_CH_LAYOUT_7POINT1 | |
434 | #define CH_LAYOUT_7POINT1_WIDE AV_CH_LAYOUT_7POINT1_WIDE | |
435 | #define CH_LAYOUT_STEREO_DOWNMIX AV_CH_LAYOUT_STEREO_DOWNMIX | |
436 | #endif | |
0d72e7d0 | 437 | |
de6d9b64 | 438 | /* in bytes */ |
8170e5fb | 439 | #define AVCODEC_MAX_AUDIO_FRAME_SIZE 192000 // 1 second of 48khz 32bit audio |
de6d9b64 | 440 | |
d7425f59 | 441 | /** |
cf713bb8 | 442 | * Required number of additionally allocated bytes at the end of the input bitstream for decoding. |
171b7b91 AC |
443 | * This is mainly needed because some optimized bitstream readers read |
444 | * 32 or 64 bit at once and could read over the end.<br> | |
f5bccd85 DB |
445 | * Note: If the first 23 bits of the additional bytes are not 0, then damaged |
446 | * MPEG bitstreams could cause overread and segfault. | |
d7425f59 | 447 | */ |
171b7b91 | 448 | #define FF_INPUT_BUFFER_PADDING_SIZE 8 |
d7425f59 | 449 | |
0ecca7a4 | 450 | /** |
f5bccd85 DB |
451 | * minimum encoding buffer size |
452 | * Used to avoid some checks during header writing. | |
0ecca7a4 MN |
453 | */ |
454 | #define FF_MIN_BUFFER_SIZE 16384 | |
455 | ||
47146dfb | 456 | |
0e373b95 | 457 | /** |
bafc102b | 458 | * motion estimation type. |
0e373b95 | 459 | */ |
e4986da9 | 460 | enum Motion_Est_ID { |
9b4dd1b8 | 461 | ME_ZERO = 1, ///< no search, that is use 0,0 vector whenever one is needed |
e4986da9 J |
462 | ME_FULL, |
463 | ME_LOG, | |
464 | ME_PHODS, | |
9b4dd1b8 MN |
465 | ME_EPZS, ///< enhanced predictive zonal search |
466 | ME_X1, ///< reserved for experiments | |
467 | ME_HEX, ///< hexagon based search | |
468 | ME_UMH, ///< uneven multi-hexagon search | |
469 | ME_ITER, ///< iterative search | |
359bbdab | 470 | ME_TESA, ///< transformed exhaustive search algorithm |
e4986da9 J |
471 | }; |
472 | ||
8c3eba7c | 473 | enum AVDiscard{ |
f5bccd85 DB |
474 | /* We leave some space between them for extensions (drop some |
475 | * keyframes for intra-only or drop just some bidir frames). */ | |
8c3eba7c MN |
476 | AVDISCARD_NONE =-16, ///< discard nothing |
477 | AVDISCARD_DEFAULT= 0, ///< discard useless packets like 0 size packets in avi | |
478 | AVDISCARD_NONREF = 8, ///< discard all non reference | |
479 | AVDISCARD_BIDIR = 16, ///< discard all bidirectional frames | |
480 | AVDISCARD_NONKEY = 32, ///< discard all frames except keyframes | |
481 | AVDISCARD_ALL = 48, ///< discard all | |
482 | }; | |
483 | ||
4ee6a5c1 MN |
484 | enum AVColorPrimaries{ |
485 | AVCOL_PRI_BT709 =1, ///< also ITU-R BT1361 / IEC 61966-2-4 / SMPTE RP177 Annex B | |
486 | AVCOL_PRI_UNSPECIFIED=2, | |
487 | AVCOL_PRI_BT470M =4, | |
488 | AVCOL_PRI_BT470BG =5, ///< also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM | |
489 | AVCOL_PRI_SMPTE170M =6, ///< also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC | |
490 | AVCOL_PRI_SMPTE240M =7, ///< functionally identical to above | |
491 | AVCOL_PRI_FILM =8, | |
492 | AVCOL_PRI_NB , ///< Not part of ABI | |
493 | }; | |
494 | ||
495 | enum AVColorTransferCharacteristic{ | |
496 | AVCOL_TRC_BT709 =1, ///< also ITU-R BT1361 | |
497 | AVCOL_TRC_UNSPECIFIED=2, | |
498 | AVCOL_TRC_GAMMA22 =4, ///< also ITU-R BT470M / ITU-R BT1700 625 PAL & SECAM | |
499 | AVCOL_TRC_GAMMA28 =5, ///< also ITU-R BT470BG | |
500 | AVCOL_TRC_NB , ///< Not part of ABI | |
501 | }; | |
502 | ||
503 | enum AVColorSpace{ | |
504 | AVCOL_SPC_RGB =0, | |
505 | AVCOL_SPC_BT709 =1, ///< also ITU-R BT1361 / IEC 61966-2-4 xvYCC709 / SMPTE RP177 Annex B | |
506 | AVCOL_SPC_UNSPECIFIED=2, | |
507 | AVCOL_SPC_FCC =4, | |
508 | AVCOL_SPC_BT470BG =5, ///< also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM / IEC 61966-2-4 xvYCC601 | |
509 | AVCOL_SPC_SMPTE170M =6, ///< also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC / functionally identical to above | |
510 | AVCOL_SPC_SMPTE240M =7, | |
511 | AVCOL_SPC_NB , ///< Not part of ABI | |
512 | }; | |
513 | ||
514 | enum AVColorRange{ | |
515 | AVCOL_RANGE_UNSPECIFIED=0, | |
516 | AVCOL_RANGE_MPEG =1, ///< the normal 219*2^(n-8) "MPEG" YUV ranges | |
517 | AVCOL_RANGE_JPEG =2, ///< the normal 2^n-1 "JPEG" YUV ranges | |
518 | AVCOL_RANGE_NB , ///< Not part of ABI | |
519 | }; | |
520 | ||
580a7465 DC |
521 | /** |
522 | * X X 3 4 X X are luma samples, | |
523 | * 1 2 1-6 are possible chroma positions | |
524 | * X X 5 6 X 0 is undefined/unknown position | |
525 | */ | |
526 | enum AVChromaLocation{ | |
527 | AVCHROMA_LOC_UNSPECIFIED=0, | |
528 | AVCHROMA_LOC_LEFT =1, ///< mpeg2/4, h264 default | |
529 | AVCHROMA_LOC_CENTER =2, ///< mpeg1, jpeg, h263 | |
530 | AVCHROMA_LOC_TOPLEFT =3, ///< DV | |
531 | AVCHROMA_LOC_TOP =4, | |
532 | AVCHROMA_LOC_BOTTOMLEFT =5, | |
533 | AVCHROMA_LOC_BOTTOM =6, | |
534 | AVCHROMA_LOC_NB , ///< Not part of ABI | |
535 | }; | |
536 | ||
23940f14 JR |
537 | /** |
538 | * LPC analysis type | |
539 | */ | |
540 | enum AVLPCType { | |
541 | AV_LPC_TYPE_DEFAULT = -1, ///< use the codec default LPC type | |
542 | AV_LPC_TYPE_NONE = 0, ///< do not use LPC prediction or use all zero coefficients | |
543 | AV_LPC_TYPE_FIXED = 1, ///< fixed LPC coefficients | |
544 | AV_LPC_TYPE_LEVINSON = 2, ///< Levinson-Durbin recursion | |
545 | AV_LPC_TYPE_CHOLESKY = 3, ///< Cholesky factorization | |
546 | AV_LPC_TYPE_NB , ///< Not part of ABI | |
547 | }; | |
548 | ||
ce980a95 MN |
549 | typedef struct RcOverride{ |
550 | int start_frame; | |
551 | int end_frame; | |
f5bccd85 | 552 | int qscale; // If this is 0 then quality_factor will be used instead. |
ce980a95 MN |
553 | float quality_factor; |
554 | } RcOverride; | |
555 | ||
b0ec9efd | 556 | #define FF_MAX_B_FRAMES 16 |
9dbcbd92 | 557 | |
a949d72e | 558 | /* encoding support |
f5bccd85 DB |
559 | These flags can be passed in AVCodecContext.flags before initialization. |
560 | Note: Not everything is supported yet. | |
a949d72e | 561 | */ |
de6d9b64 | 562 | |
f5bccd85 DB |
563 | #define CODEC_FLAG_QSCALE 0x0002 ///< Use fixed qscale. |
564 | #define CODEC_FLAG_4MV 0x0004 ///< 4 MV per MB allowed / advanced prediction for H.263. | |
565 | #define CODEC_FLAG_QPEL 0x0010 ///< Use qpel MC. | |
566 | #define CODEC_FLAG_GMC 0x0020 ///< Use GMC. | |
567 | #define CODEC_FLAG_MV0 0x0040 ///< Always try a MB with MV=<0,0>. | |
568 | #define CODEC_FLAG_PART 0x0080 ///< Use data partitioning. | |
1ba8f5eb MN |
569 | /** |
570 | * The parent program guarantees that the input for B-frames containing | |
f5bccd85 | 571 | * streams is not written to for at least s->max_b_frames+1 frames, if |
1ba8f5eb MN |
572 | * this is not set the input will be copied. |
573 | */ | |
8b4c7dbc | 574 | #define CODEC_FLAG_INPUT_PRESERVED 0x0100 |
273b0cd3 DB |
575 | #define CODEC_FLAG_PASS1 0x0200 ///< Use internal 2pass ratecontrol in first pass mode. |
576 | #define CODEC_FLAG_PASS2 0x0400 ///< Use internal 2pass ratecontrol in second pass mode. | |
577 | #define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< Use external Huffman table (for MJPEG). | |
578 | #define CODEC_FLAG_GRAY 0x2000 ///< Only decode/encode grayscale. | |
579 | #define CODEC_FLAG_EMU_EDGE 0x4000 ///< Don't draw edges. | |
580 | #define CODEC_FLAG_PSNR 0x8000 ///< error[?] variables will be set during encoding. | |
581 | #define CODEC_FLAG_TRUNCATED 0x00010000 /** Input bitstream might be truncated at a random | |
582 | location instead of only at frame boundaries. */ | |
f5bccd85 DB |
583 | #define CODEC_FLAG_NORMALIZE_AQP 0x00020000 ///< Normalize adaptive quantization. |
584 | #define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< Use interlaced DCT. | |
585 | #define CODEC_FLAG_LOW_DELAY 0x00080000 ///< Force low delay. | |
586 | #define CODEC_FLAG_ALT_SCAN 0x00100000 ///< Use alternate scan. | |
f5bccd85 DB |
587 | #define CODEC_FLAG_GLOBAL_HEADER 0x00400000 ///< Place global headers in extradata instead of every keyframe. |
588 | #define CODEC_FLAG_BITEXACT 0x00800000 ///< Use only bitexact stuff (except (I)DCT). | |
21e59552 | 589 | /* Fx : Flag for h263+ extra options */ |
f5bccd85 DB |
590 | #define CODEC_FLAG_AC_PRED 0x01000000 ///< H.263 advanced intra coding / MPEG-4 AC prediction |
591 | #define CODEC_FLAG_H263P_UMV 0x02000000 ///< unlimited motion vector | |
592 | #define CODEC_FLAG_CBP_RD 0x04000000 ///< Use rate distortion optimization for cbp. | |
593 | #define CODEC_FLAG_QP_RD 0x08000000 ///< Use rate distortion optimization for qp selectioon. | |
594 | #define CODEC_FLAG_H263P_AIV 0x00000008 ///< H.263 alternative inter VLC | |
332f9ac4 MN |
595 | #define CODEC_FLAG_OBMC 0x00000001 ///< OBMC |
596 | #define CODEC_FLAG_LOOP_FILTER 0x00000800 ///< loop filter | |
bb198e19 MN |
597 | #define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000 |
598 | #define CODEC_FLAG_INTERLACED_ME 0x20000000 ///< interlaced motion estimation | |
f5bccd85 | 599 | #define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< Will reserve space for SVCD scan offset user data. |
f3eec1cf | 600 | #define CODEC_FLAG_CLOSED_GOP 0x80000000 |
f5bccd85 DB |
601 | #define CODEC_FLAG2_FAST 0x00000001 ///< Allow non spec compliant speedup tricks. |
602 | #define CODEC_FLAG2_STRICT_GOP 0x00000002 ///< Strictly enforce GOP size. | |
603 | #define CODEC_FLAG2_NO_OUTPUT 0x00000004 ///< Skip bitstream encoding. | |
604 | #define CODEC_FLAG2_LOCAL_HEADER 0x00000008 ///< Place global headers at every keyframe instead of in extradata. | |
605 | #define CODEC_FLAG2_BPYRAMID 0x00000010 ///< H.264 allow B-frames to be used as references. | |
606 | #define CODEC_FLAG2_WPRED 0x00000020 ///< H.264 weighted biprediction for B-frames | |
d3075ed5 | 607 | #define CODEC_FLAG2_MIXED_REFS 0x00000040 ///< H.264 one reference per partition, as opposed to one reference per macroblock |
58f7833e RS |
608 | #define CODEC_FLAG2_8X8DCT 0x00000080 ///< H.264 high profile 8x8 transform |
609 | #define CODEC_FLAG2_FASTPSKIP 0x00000100 ///< H.264 fast pskip | |
610 | #define CODEC_FLAG2_AUD 0x00000200 ///< H.264 access unit delimiters | |
f5bccd85 DB |
611 | #define CODEC_FLAG2_BRDO 0x00000400 ///< B-frame rate-distortion optimization |
612 | #define CODEC_FLAG2_INTRA_VLC 0x00000800 ///< Use MPEG-2 intra VLC table. | |
613 | #define CODEC_FLAG2_MEMC_ONLY 0x00001000 ///< Only do ME/MC (I frames -> ref, P frame -> ME+MC). | |
614 | #define CODEC_FLAG2_DROP_FRAME_TIMECODE 0x00002000 ///< timecode is in drop frame format. | |
615 | #define CODEC_FLAG2_SKIP_RD 0x00004000 ///< RD optimal MB level residual skipping | |
616 | #define CODEC_FLAG2_CHUNKS 0x00008000 ///< Input bitstream might be truncated at a packet boundaries instead of only at frame boundaries. | |
617 | #define CODEC_FLAG2_NON_LINEAR_QUANT 0x00010000 ///< Use MPEG-2 nonlinear quantizer. | |
f1618fd9 | 618 | #define CODEC_FLAG2_BIT_RESERVOIR 0x00020000 ///< Use a bit reservoir when encoding if possible |
25a42948 | 619 | #define CODEC_FLAG2_MBTREE 0x00040000 ///< Use macroblock tree ratecontrol (x264 only) |
f3b3b489 BC |
620 | #define CODEC_FLAG2_PSY 0x00080000 ///< Use psycho visual optimizations. |
621 | #define CODEC_FLAG2_SSIM 0x00100000 ///< Compute SSIM during encoding, error[] values are undefined. | |
e8c7fca9 | 622 | #define CODEC_FLAG2_INTRA_REFRESH 0x00200000 ///< Use periodic insertion of intra blocks instead of keyframes. |
6fc5b059 | 623 | |
21e59552 | 624 | /* Unsupported options : |
bb270c08 DB |
625 | * Syntax Arithmetic coding (SAC) |
626 | * Reference Picture Selection | |
eafcac6a | 627 | * Independent Segment Decoding */ |
21e59552 | 628 | /* /Fx */ |
bf89e6b1 FB |
629 | /* codec capabilities */ |
630 | ||
f5bccd85 | 631 | #define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< Decoder can use draw_horiz_band callback. |
6814a25c | 632 | /** |
9b489e02 RD |
633 | * Codec uses get_buffer() for allocating buffers and supports custom allocators. |
634 | * If not set, it might not use get_buffer() at all or use operations that | |
635 | * assume the buffer was allocated by avcodec_default_get_buffer. | |
6814a25c MN |
636 | */ |
637 | #define CODEC_CAP_DR1 0x0002 | |
f5bccd85 | 638 | /* If 'parse_only' field is true, then avcodec_parse_frame() can be used. */ |
917e06c8 | 639 | #define CODEC_CAP_PARSE_ONLY 0x0004 |
d7425f59 | 640 | #define CODEC_CAP_TRUNCATED 0x0008 |
f5bccd85 | 641 | /* Codec can export data for HW decoding (XvMC). */ |
5e5c247a | 642 | #define CODEC_CAP_HWACCEL 0x0010 |
115329f1 | 643 | /** |
f5bccd85 DB |
644 | * Codec has a nonzero delay and needs to be fed with NULL at the end to get the delayed data. |
645 | * If this is not set, the codec is guaranteed to never be fed with NULL data. | |
934982c4 | 646 | */ |
6f824977 | 647 | #define CODEC_CAP_DELAY 0x0020 |
cef7cc72 JR |
648 | /** |
649 | * Codec can be fed a final frame with a smaller size. | |
650 | * This can be used to prevent truncation of the last audio samples. | |
651 | */ | |
652 | #define CODEC_CAP_SMALL_LAST_FRAME 0x0040 | |
369122dd NC |
653 | /** |
654 | * Codec can export data for HW decoding (VDPAU). | |
655 | */ | |
656 | #define CODEC_CAP_HWACCEL_VDPAU 0x0080 | |
d859bb1d SS |
657 | /** |
658 | * Codec can output multiple frames per AVPacket | |
e9e949cf MN |
659 | * Normally demuxers return one frame at a time, demuxers which do not do |
660 | * are connected to a parser to split what they return into proper frames. | |
661 | * This flag is reserved to the very rare category of codecs which have a | |
662 | * bitstream that cannot be split into frames without timeconsuming | |
663 | * operations like full decoding. Demuxers carring such bitstreams thus | |
664 | * may return multiple frames in a packet. This has many disadvantages like | |
665 | * prohibiting stream copy in many cases thus it should only be considered | |
666 | * as a last resort. | |
d859bb1d SS |
667 | */ |
668 | #define CODEC_CAP_SUBFRAMES 0x0100 | |
93ebfeea JG |
669 | /** |
670 | * Codec is experimental and is thus avoided in favor of non experimental | |
671 | * encoders | |
672 | */ | |
673 | #define CODEC_CAP_EXPERIMENTAL 0x0200 | |
62784e37 BL |
674 | /** |
675 | * Codec should fill in channel configuration and samplerate instead of container | |
676 | */ | |
677 | #define CODEC_CAP_CHANNEL_CONF 0x0400 | |
16cfc961 SS |
678 | /** |
679 | * Codec is able to deal with negative linesizes | |
680 | */ | |
681 | #define CODEC_CAP_NEG_LINESIZES 0x0800 | |
37b00b47 AS |
682 | /** |
683 | * Codec supports frame-level multithreading. | |
684 | */ | |
685 | #define CODEC_CAP_FRAME_THREADS 0x1000 | |
bf89e6b1 | 686 | |
f5bccd85 | 687 | //The following defines may change, don't expect compatibility if you use them. |
8d7ec294 | 688 | #define MB_TYPE_INTRA4x4 0x0001 |
f5bccd85 DB |
689 | #define MB_TYPE_INTRA16x16 0x0002 //FIXME H.264-specific |
690 | #define MB_TYPE_INTRA_PCM 0x0004 //FIXME H.264-specific | |
8d7ec294 WH |
691 | #define MB_TYPE_16x16 0x0008 |
692 | #define MB_TYPE_16x8 0x0010 | |
693 | #define MB_TYPE_8x16 0x0020 | |
694 | #define MB_TYPE_8x8 0x0040 | |
695 | #define MB_TYPE_INTERLACED 0x0080 | |
273b0cd3 | 696 | #define MB_TYPE_DIRECT2 0x0100 //FIXME |
8d7ec294 WH |
697 | #define MB_TYPE_ACPRED 0x0200 |
698 | #define MB_TYPE_GMC 0x0400 | |
699 | #define MB_TYPE_SKIP 0x0800 | |
700 | #define MB_TYPE_P0L0 0x1000 | |
701 | #define MB_TYPE_P1L0 0x2000 | |
702 | #define MB_TYPE_P0L1 0x4000 | |
703 | #define MB_TYPE_P1L1 0x8000 | |
704 | #define MB_TYPE_L0 (MB_TYPE_P0L0 | MB_TYPE_P1L0) | |
705 | #define MB_TYPE_L1 (MB_TYPE_P0L1 | MB_TYPE_P1L1) | |
706 | #define MB_TYPE_L0L1 (MB_TYPE_L0 | MB_TYPE_L1) | |
707 | #define MB_TYPE_QUANT 0x00010000 | |
708 | #define MB_TYPE_CBP 0x00020000 | |
709 | //Note bits 24-31 are reserved for codec specific use (h264 ref0, mpeg1 0mv, ...) | |
710 | ||
fa384dcc MN |
711 | /** |
712 | * Pan Scan area. | |
f5bccd85 DB |
713 | * This specifies the area which should be displayed. |
714 | * Note there may be multiple such areas for one frame. | |
fa384dcc MN |
715 | */ |
716 | typedef struct AVPanScan{ | |
717 | /** | |
f5bccd85 DB |
718 | * id |
719 | * - encoding: Set by user. | |
720 | * - decoding: Set by libavcodec. | |
fa384dcc MN |
721 | */ |
722 | int id; | |
723 | ||
724 | /** | |
725 | * width and height in 1/16 pel | |
f5bccd85 DB |
726 | * - encoding: Set by user. |
727 | * - decoding: Set by libavcodec. | |
fa384dcc MN |
728 | */ |
729 | int width; | |
730 | int height; | |
731 | ||
732 | /** | |
f5bccd85 DB |
733 | * position of the top left corner in 1/16 pel for up to 3 fields/frames |
734 | * - encoding: Set by user. | |
735 | * - decoding: Set by libavcodec. | |
fa384dcc MN |
736 | */ |
737 | int16_t position[3][2]; | |
738 | }AVPanScan; | |
739 | ||
492cd3a9 | 740 | #define FF_COMMON_FRAME \ |
b536d0aa MN |
741 | /**\ |
742 | * pointer to the picture planes.\ | |
f5bccd85 | 743 | * This might be different from the first allocated byte\ |
b536d0aa MN |
744 | * - encoding: \ |
745 | * - decoding: \ | |
746 | */\ | |
1e491e29 MN |
747 | uint8_t *data[4];\ |
748 | int linesize[4];\ | |
749 | /**\ | |
f5bccd85 DB |
750 | * pointer to the first allocated byte of the picture. Can be used in get_buffer/release_buffer.\ |
751 | * This isn't used by libavcodec unless the default get/release_buffer() is used.\ | |
64863965 MN |
752 | * - encoding: \ |
753 | * - decoding: \ | |
1e491e29 MN |
754 | */\ |
755 | uint8_t *base[4];\ | |
756 | /**\ | |
757 | * 1 -> keyframe, 0-> not\ | |
f5bccd85 DB |
758 | * - encoding: Set by libavcodec.\ |
759 | * - decoding: Set by libavcodec.\ | |
1e491e29 MN |
760 | */\ |
761 | int key_frame;\ | |
762 | \ | |
763 | /**\ | |
f5bccd85 DB |
764 | * Picture type of the frame, see ?_TYPE below.\ |
765 | * - encoding: Set by libavcodec. for coded_picture (and set by user for input).\ | |
766 | * - decoding: Set by libavcodec.\ | |
1e491e29 MN |
767 | */\ |
768 | int pict_type;\ | |
769 | \ | |
770 | /**\ | |
c0df9d75 | 771 | * presentation timestamp in time_base units (time when frame should be shown to user)\ |
f5bccd85 DB |
772 | * If AV_NOPTS_VALUE then frame_rate = 1/time_base will be assumed.\ |
773 | * - encoding: MUST be set by user.\ | |
774 | * - decoding: Set by libavcodec.\ | |
1e491e29 | 775 | */\ |
be6784dc | 776 | int64_t pts;\ |
1e491e29 MN |
777 | \ |
778 | /**\ | |
f5bccd85 | 779 | * picture number in bitstream order\ |
64863965 | 780 | * - encoding: set by\ |
f5bccd85 | 781 | * - decoding: Set by libavcodec.\ |
1e491e29 MN |
782 | */\ |
783 | int coded_picture_number;\ | |
784 | /**\ | |
f5bccd85 | 785 | * picture number in display order\ |
64863965 | 786 | * - encoding: set by\ |
f5bccd85 | 787 | * - decoding: Set by libavcodec.\ |
1e491e29 MN |
788 | */\ |
789 | int display_picture_number;\ | |
790 | \ | |
791 | /**\ | |
158c7f05 | 792 | * quality (between 1 (good) and FF_LAMBDA_MAX (bad)) \ |
f5bccd85 DB |
793 | * - encoding: Set by libavcodec. for coded_picture (and set by user for input).\ |
794 | * - decoding: Set by libavcodec.\ | |
1e491e29 | 795 | */\ |
158c7f05 | 796 | int quality; \ |
1e491e29 MN |
797 | \ |
798 | /**\ | |
799 | * buffer age (1->was last buffer and dint change, 2->..., ...).\ | |
f5bccd85 | 800 | * Set to INT_MAX if the buffer has not been used yet.\ |
64863965 | 801 | * - encoding: unused\ |
f5bccd85 | 802 | * - decoding: MUST be set by get_buffer().\ |
1e491e29 MN |
803 | */\ |
804 | int age;\ | |
805 | \ | |
806 | /**\ | |
807 | * is this picture used as reference\ | |
8474f58e MN |
808 | * The values for this are the same as the MpegEncContext.picture_structure\ |
809 | * variable, that is 1->top field, 2->bottom field, 3->frame/both fields.\ | |
5fe2a515 | 810 | * Set to 4 for delayed, non-reference frames.\ |
64863965 | 811 | * - encoding: unused\ |
f5bccd85 | 812 | * - decoding: Set by libavcodec. (before get_buffer() call)).\ |
1e491e29 MN |
813 | */\ |
814 | int reference;\ | |
815 | \ | |
816 | /**\ | |
817 | * QP table\ | |
64863965 | 818 | * - encoding: unused\ |
f5bccd85 | 819 | * - decoding: Set by libavcodec.\ |
1e491e29 MN |
820 | */\ |
821 | int8_t *qscale_table;\ | |
822 | /**\ | |
823 | * QP store stride\ | |
64863965 | 824 | * - encoding: unused\ |
f5bccd85 | 825 | * - decoding: Set by libavcodec.\ |
1e491e29 MN |
826 | */\ |
827 | int qstride;\ | |
828 | \ | |
829 | /**\ | |
f5bccd85 | 830 | * mbskip_table[mb]>=1 if MB didn't change\ |
1e491e29 | 831 | * stride= mb_width = (width+15)>>4\ |
64863965 | 832 | * - encoding: unused\ |
f5bccd85 | 833 | * - decoding: Set by libavcodec.\ |
1e491e29 MN |
834 | */\ |
835 | uint8_t *mbskip_table;\ | |
836 | \ | |
837 | /**\ | |
f5bccd85 | 838 | * motion vector table\ |
61436073 MN |
839 | * @code\ |
840 | * example:\ | |
841 | * int mv_sample_log2= 4 - motion_subsample_log2;\ | |
842 | * int mb_width= (width+15)>>4;\ | |
843 | * int mv_stride= (mb_width << mv_sample_log2) + 1;\ | |
844 | * motion_val[direction][x + y*mv_stride][0->mv_x, 1->mv_y];\ | |
845 | * @endcode\ | |
f5bccd85 DB |
846 | * - encoding: Set by user.\ |
847 | * - decoding: Set by libavcodec.\ | |
8d7ec294 WH |
848 | */\ |
849 | int16_t (*motion_val[2])[2];\ | |
850 | \ | |
851 | /**\ | |
f5bccd85 | 852 | * macroblock type table\ |
8d7ec294 | 853 | * mb_type_base + mb_width + 2\ |
f5bccd85 DB |
854 | * - encoding: Set by user.\ |
855 | * - decoding: Set by libavcodec.\ | |
8d7ec294 WH |
856 | */\ |
857 | uint32_t *mb_type;\ | |
858 | \ | |
859 | /**\ | |
f0b77c69 MN |
860 | * log2 of the size of the block which a single vector in motion_val represents: \ |
861 | * (4->16x16, 3->8x8, 2-> 4x4, 1-> 2x2)\ | |
8d7ec294 | 862 | * - encoding: unused\ |
f5bccd85 | 863 | * - decoding: Set by libavcodec.\ |
8d7ec294 WH |
864 | */\ |
865 | uint8_t motion_subsample_log2;\ | |
866 | \ | |
867 | /**\ | |
1e491e29 | 868 | * for some private data of the user\ |
64863965 | 869 | * - encoding: unused\ |
f5bccd85 | 870 | * - decoding: Set by user.\ |
1e491e29 MN |
871 | */\ |
872 | void *opaque;\ | |
140cb663 MN |
873 | \ |
874 | /**\ | |
875 | * error\ | |
f5bccd85 | 876 | * - encoding: Set by libavcodec. if flags&CODEC_FLAG_PSNR.\ |
64863965 | 877 | * - decoding: unused\ |
140cb663 MN |
878 | */\ |
879 | uint64_t error[4];\ | |
4e00e76b MN |
880 | \ |
881 | /**\ | |
f5bccd85 DB |
882 | * type of the buffer (to keep track of who has to deallocate data[*])\ |
883 | * - encoding: Set by the one who allocates it.\ | |
884 | * - decoding: Set by the one who allocates it.\ | |
885 | * Note: User allocated (direct rendering) & internal buffers cannot coexist currently.\ | |
4e00e76b MN |
886 | */\ |
887 | int type;\ | |
2ec23b6d MN |
888 | \ |
889 | /**\ | |
f5bccd85 | 890 | * When decoding, this signals how much the picture must be delayed.\ |
2ec23b6d | 891 | * extra_delay = repeat_pict / (2*fps)\ |
64863965 | 892 | * - encoding: unused\ |
f5bccd85 | 893 | * - decoding: Set by libavcodec.\ |
2ec23b6d | 894 | */\ |
0426af31 MN |
895 | int repeat_pict;\ |
896 | \ | |
897 | /**\ | |
898 | * \ | |
899 | */\ | |
900 | int qscale_type;\ | |
2744ca9a RS |
901 | \ |
902 | /**\ | |
903 | * The content of the picture is interlaced.\ | |
f5bccd85 DB |
904 | * - encoding: Set by user.\ |
905 | * - decoding: Set by libavcodec. (default 0)\ | |
2744ca9a RS |
906 | */\ |
907 | int interlaced_frame;\ | |
908 | \ | |
909 | /**\ | |
f5bccd85 DB |
910 | * If the content is interlaced, is top field displayed first.\ |
911 | * - encoding: Set by user.\ | |
912 | * - decoding: Set by libavcodec.\ | |
2744ca9a | 913 | */\ |
9dad924e | 914 | int top_field_first;\ |
fa384dcc MN |
915 | \ |
916 | /**\ | |
917 | * Pan scan.\ | |
f5bccd85 DB |
918 | * - encoding: Set by user.\ |
919 | * - decoding: Set by libavcodec.\ | |
fa384dcc MN |
920 | */\ |
921 | AVPanScan *pan_scan;\ | |
2a2bbcb0 MM |
922 | \ |
923 | /**\ | |
f5bccd85 | 924 | * Tell user application that palette has changed from previous frame.\ |
2a2bbcb0 | 925 | * - encoding: ??? (no palette-enabled encoder yet)\ |
f5bccd85 | 926 | * - decoding: Set by libavcodec. (default 0).\ |
2a2bbcb0 MM |
927 | */\ |
928 | int palette_has_changed;\ | |
074c4ca7 RT |
929 | \ |
930 | /**\ | |
f5bccd85 | 931 | * codec suggestion on buffer type if != 0\ |
074c4ca7 | 932 | * - encoding: unused\ |
f5bccd85 | 933 | * - decoding: Set by libavcodec. (before get_buffer() call)).\ |
074c4ca7 RT |
934 | */\ |
935 | int buffer_hints;\ | |
8289c6fa WH |
936 | \ |
937 | /**\ | |
f5bccd85 | 938 | * DCT coefficients\ |
8289c6fa | 939 | * - encoding: unused\ |
f5bccd85 | 940 | * - decoding: Set by libavcodec.\ |
8289c6fa WH |
941 | */\ |
942 | short *dct_coeff;\ | |
a4d36c11 MN |
943 | \ |
944 | /**\ | |
58184187 BF |
945 | * motion reference frame index\ |
946 | * the order in which these are stored can depend on the codec.\ | |
f5bccd85 DB |
947 | * - encoding: Set by user.\ |
948 | * - decoding: Set by libavcodec.\ | |
a4d36c11 | 949 | */\ |
79de84f2 MN |
950 | int8_t *ref_index[2];\ |
951 | \ | |
952 | /**\ | |
421167b0 | 953 | * reordered opaque 64bit (generally an integer or a double precision float\ |
e75229fa MN |
954 | * PTS but can be anything). \ |
955 | * The user sets AVCodecContext.reordered_opaque to represent the input at\ | |
421167b0 SS |
956 | * that time,\ |
957 | * the decoder reorders values as needed and sets AVFrame.reordered_opaque\ | |
e75229fa | 958 | * to exactly one of the values provided by the user through AVCodecContext.reordered_opaque \ |
81c623fa | 959 | * @deprecated in favor of pkt_pts\ |
79de84f2 MN |
960 | * - encoding: unused\ |
961 | * - decoding: Read by user.\ | |
962 | */\ | |
963 | int64_t reordered_opaque;\ | |
68e5d523 GB |
964 | \ |
965 | /**\ | |
966 | * hardware accelerator private data (FFmpeg allocated)\ | |
967 | * - encoding: unused\ | |
968 | * - decoding: Set by libavcodec\ | |
969 | */\ | |
952e2083 | 970 | void *hwaccel_picture_private;\ |
393cbb96 MN |
971 | \ |
972 | /**\ | |
973 | * reordered pts from the last AVPacket that has been input into the decoder\ | |
974 | * - encoding: unused\ | |
975 | * - decoding: Read by user.\ | |
976 | */\ | |
977 | int64_t pkt_pts;\ | |
1919feaf MN |
978 | \ |
979 | /**\ | |
980 | * dts from the last AVPacket that has been input into the decoder\ | |
981 | * - encoding: unused\ | |
982 | * - decoding: Read by user.\ | |
983 | */\ | |
984 | int64_t pkt_dts;\ | |
37b00b47 AS |
985 | \ |
986 | /**\ | |
987 | * the AVCodecContext which ff_thread_get_buffer() was last called on\ | |
988 | * - encoding: Set by libavcodec.\ | |
989 | * - decoding: Set by libavcodec.\ | |
990 | */\ | |
991 | struct AVCodecContext *owner;\ | |
992 | \ | |
993 | /**\ | |
994 | * used by multithreading to store frame-specific info\ | |
995 | * - encoding: Set by libavcodec.\ | |
996 | * - decoding: Set by libavcodec.\ | |
997 | */\ | |
2a03e873 | 998 | void *thread_opaque;\ |
2ec23b6d | 999 | |
bb270c08 DB |
1000 | #define FF_QSCALE_TYPE_MPEG1 0 |
1001 | #define FF_QSCALE_TYPE_MPEG2 1 | |
1002 | #define FF_QSCALE_TYPE_H264 2 | |
800274f8 | 1003 | #define FF_QSCALE_TYPE_VP56 3 |
4e00e76b MN |
1004 | |
1005 | #define FF_BUFFER_TYPE_INTERNAL 1 | |
f5bccd85 DB |
1006 | #define FF_BUFFER_TYPE_USER 2 ///< direct rendering buffers (image is (de)allocated by user) |
1007 | #define FF_BUFFER_TYPE_SHARED 4 ///< Buffer from somewhere else; don't deallocate image (data/base), all other tables are not shared. | |
1008 | #define FF_BUFFER_TYPE_COPY 8 ///< Just a (modified) copy of some other buffer, don't deallocate anything. | |
4e00e76b | 1009 | |
1e491e29 | 1010 | |
dc85e859 AJ |
1011 | #define FF_I_TYPE 1 ///< Intra |
1012 | #define FF_P_TYPE 2 ///< Predicted | |
1013 | #define FF_B_TYPE 3 ///< Bi-dir predicted | |
1014 | #define FF_S_TYPE 4 ///< S(GMC)-VOP MPEG4 | |
1015 | #define FF_SI_TYPE 5 ///< Switching Intra | |
1016 | #define FF_SP_TYPE 6 ///< Switching Predicted | |
48d533e6 | 1017 | #define FF_BI_TYPE 7 |
1e491e29 | 1018 | |
f5bccd85 DB |
1019 | #define FF_BUFFER_HINTS_VALID 0x01 // Buffer hints value is meaningful (if 0 ignore). |
1020 | #define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer. | |
1021 | #define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content. | |
1022 | #define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update). | |
074c4ca7 | 1023 | |
18c915ee TB |
1024 | typedef struct AVPacket { |
1025 | /** | |
7b356d39 RS |
1026 | * Presentation timestamp in AVStream->time_base units; the time at which |
1027 | * the decompressed packet will be presented to the user. | |
18c915ee TB |
1028 | * Can be AV_NOPTS_VALUE if it is not stored in the file. |
1029 | * pts MUST be larger or equal to dts as presentation cannot happen before | |
1030 | * decompression, unless one wants to view hex dumps. Some formats misuse | |
1031 | * the terms dts and pts/cts to mean something different. Such timestamps | |
1032 | * must be converted to true pts/dts before they are stored in AVPacket. | |
1033 | */ | |
1034 | int64_t pts; | |
1035 | /** | |
7b356d39 RS |
1036 | * Decompression timestamp in AVStream->time_base units; the time at which |
1037 | * the packet is decompressed. | |
18c915ee TB |
1038 | * Can be AV_NOPTS_VALUE if it is not stored in the file. |
1039 | */ | |
1040 | int64_t dts; | |
1041 | uint8_t *data; | |
1042 | int size; | |
1043 | int stream_index; | |
1044 | int flags; | |
1045 | /** | |
7b356d39 | 1046 | * Duration of this packet in AVStream->time_base units, 0 if unknown. |
18c915ee TB |
1047 | * Equals next_pts - this_pts in presentation order. |
1048 | */ | |
1049 | int duration; | |
1050 | void (*destruct)(struct AVPacket *); | |
1051 | void *priv; | |
1052 | int64_t pos; ///< byte position in stream, -1 if unknown | |
1053 | ||
1054 | /** | |
7b356d39 | 1055 | * Time difference in AVStream->time_base units from the pts of this |
18c915ee TB |
1056 | * packet to the point at which the output from the decoder has converged |
1057 | * independent from the availability of previous frames. That is, the | |
1058 | * frames are virtually identical no matter if decoding started from | |
1059 | * the very first frame or from this keyframe. | |
1060 | * Is AV_NOPTS_VALUE if unknown. | |
1061 | * This field is not the display duration of the current packet. | |
8ee82f40 AJ |
1062 | * This field has no meaning if the packet does not have AV_PKT_FLAG_KEY |
1063 | * set. | |
18c915ee TB |
1064 | * |
1065 | * The purpose of this field is to allow seeking in streams that have no | |
1066 | * keyframes in the conventional sense. It corresponds to the | |
1067 | * recovery point SEI in H.264 and match_time_delta in NUT. It is also | |
1068 | * essential for some types of subtitle streams to ensure that all | |
1069 | * subtitles are correctly displayed after seeking. | |
1070 | */ | |
1071 | int64_t convergence_duration; | |
1072 | } AVPacket; | |
8f3f2e06 RD |
1073 | #define AV_PKT_FLAG_KEY 0x0001 |
1074 | #if LIBAVCODEC_VERSION_MAJOR < 53 | |
1075 | #define PKT_FLAG_KEY AV_PKT_FLAG_KEY | |
1076 | #endif | |
18c915ee | 1077 | |
0da71265 MN |
1078 | /** |
1079 | * Audio Video Frame. | |
ba66ae94 MN |
1080 | * New fields can be added to the end of FF_COMMON_FRAME with minor version |
1081 | * bumps. | |
8bfb108b | 1082 | * Removal, reordering and changes to existing fields require a major |
ba66ae94 MN |
1083 | * version bump. No fields should be added into AVFrame before or after |
1084 | * FF_COMMON_FRAME! | |
8bfb108b | 1085 | * sizeof(AVFrame) must not be used outside libav*. |
0da71265 | 1086 | */ |
492cd3a9 MN |
1087 | typedef struct AVFrame { |
1088 | FF_COMMON_FRAME | |
1089 | } AVFrame; | |
1e491e29 | 1090 | |
d33c949c | 1091 | /** |
252f17e2 MN |
1092 | * main external API structure. |
1093 | * New fields can be added to the end with minor version bumps. | |
8bfb108b | 1094 | * Removal, reordering and changes to existing fields require a major |
252f17e2 | 1095 | * version bump. |
8bfb108b | 1096 | * sizeof(AVCodecContext) must not be used outside libav*. |
d33c949c | 1097 | */ |
de6d9b64 | 1098 | typedef struct AVCodecContext { |
b71901e6 | 1099 | /** |
f5bccd85 | 1100 | * information on struct for av_log |
bc874dae MB |
1101 | * - set by avcodec_alloc_context |
1102 | */ | |
d42a814e | 1103 | const AVClass *av_class; |
bc874dae | 1104 | /** |
f5bccd85 DB |
1105 | * the average bitrate |
1106 | * - encoding: Set by user; unused for constant quantizer encoding. | |
1107 | * - decoding: Set by libavcodec. 0 or some bitrate if this info is available in the stream. | |
b71901e6 | 1108 | */ |
de6d9b64 | 1109 | int bit_rate; |
b71901e6 MN |
1110 | |
1111 | /** | |
64863965 | 1112 | * number of bits the bitstream is allowed to diverge from the reference. |
b71901e6 | 1113 | * the reference can be CBR (for CBR pass1) or VBR (for pass2) |
f5bccd85 | 1114 | * - encoding: Set by user; unused for constant quantizer encoding. |
64863965 | 1115 | * - decoding: unused |
b71901e6 | 1116 | */ |
115329f1 | 1117 | int bit_rate_tolerance; |
b71901e6 MN |
1118 | |
1119 | /** | |
64863965 | 1120 | * CODEC_FLAG_*. |
f5bccd85 DB |
1121 | * - encoding: Set by user. |
1122 | * - decoding: Set by user. | |
b71901e6 | 1123 | */ |
de6d9b64 | 1124 | int flags; |
b71901e6 MN |
1125 | |
1126 | /** | |
f5bccd85 DB |
1127 | * Some codecs need additional format info. It is stored here. |
1128 | * If any muxer uses this then ALL demuxers/parsers AND encoders for the | |
1129 | * specific codec MUST set it correctly otherwise stream copy breaks. | |
1130 | * In general use of this field by muxers is not recommanded. | |
1131 | * - encoding: Set by libavcodec. | |
1132 | * - decoding: Set by libavcodec. (FIXME: Is this OK?) | |
b71901e6 MN |
1133 | */ |
1134 | int sub_id; | |
1135 | ||
1136 | /** | |
f5bccd85 | 1137 | * Motion estimation algorithm used for video coding. |
58f7833e | 1138 | * 1 (zero), 2 (full), 3 (log), 4 (phods), 5 (epzs), 6 (x1), 7 (hex), |
89223ef6 | 1139 | * 8 (umh), 9 (iter), 10 (tesa) [7, 8, 10 are x264 specific, 9 is snow specific] |
64863965 MN |
1140 | * - encoding: MUST be set by user. |
1141 | * - decoding: unused | |
b71901e6 MN |
1142 | */ |
1143 | int me_method; | |
1144 | ||
1145 | /** | |
f5bccd85 DB |
1146 | * some codecs need / can use extradata like Huffman tables. |
1147 | * mjpeg: Huffman tables | |
b71901e6 | 1148 | * rv10: additional flags |
b704e742 | 1149 | * mpeg4: global headers (they can be in the bitstream or here) |
f5bccd85 DB |
1150 | * The allocated memory should be FF_INPUT_BUFFER_PADDING_SIZE bytes larger |
1151 | * than extradata_size to avoid prolems if it is read with the bitstream reader. | |
1152 | * The bytewise contents of extradata must not depend on the architecture or CPU endianness. | |
1153 | * - encoding: Set/allocated/freed by libavcodec. | |
1154 | * - decoding: Set/allocated/freed by user. | |
b71901e6 | 1155 | */ |
58f2a4b0 | 1156 | uint8_t *extradata; |
e84c31dc | 1157 | int extradata_size; |
115329f1 | 1158 | |
b71901e6 | 1159 | /** |
f5bccd85 DB |
1160 | * This is the fundamental unit of time (in seconds) in terms |
1161 | * of which frame timestamps are represented. For fixed-fps content, | |
5b28c8c3 MN |
1162 | * timebase should be 1/framerate and timestamp increments should be |
1163 | * identically 1. | |
f5bccd85 DB |
1164 | * - encoding: MUST be set by user. |
1165 | * - decoding: Set by libavcodec. | |
b71901e6 | 1166 | */ |
c0df9d75 | 1167 | AVRational time_base; |
115329f1 | 1168 | |
5b28c8c3 | 1169 | /* video only */ |
14bea432 | 1170 | /** |
21adafec | 1171 | * picture width / height. |
115329f1 | 1172 | * - encoding: MUST be set by user. |
f5bccd85 DB |
1173 | * - decoding: Set by libavcodec. |
1174 | * Note: For compatibility it is possible to set this instead of | |
1175 | * coded_width/height before decoding. | |
b71901e6 | 1176 | */ |
de6d9b64 | 1177 | int width, height; |
115329f1 | 1178 | |
e769f053 | 1179 | #define FF_ASPECT_EXTENDED 15 |
b71901e6 MN |
1180 | |
1181 | /** | |
f5bccd85 DB |
1182 | * the number of pictures in a group of pictures, or 0 for intra_only |
1183 | * - encoding: Set by user. | |
64863965 | 1184 | * - decoding: unused |
b71901e6 MN |
1185 | */ |
1186 | int gop_size; | |
1187 | ||
1188 | /** | |
f5bccd85 | 1189 | * Pixel format, see PIX_FMT_xxx. |
c1bdc930 TH |
1190 | * May be set by the demuxer if known from headers. |
1191 | * May be overriden by the decoder if it knows better. | |
f5bccd85 | 1192 | * - encoding: Set by user. |
c1bdc930 | 1193 | * - decoding: Set by user if known, overridden by libavcodec if known |
b71901e6 | 1194 | */ |
e4eadb4b | 1195 | enum PixelFormat pix_fmt; |
115329f1 | 1196 | |
bdfcbbed | 1197 | /** |
f5bccd85 | 1198 | * Frame rate emulation. If not zero, the lower layer (i.e. format handler) |
bdfcbbed | 1199 | * has to read frames at native frame rate. |
f5bccd85 DB |
1200 | * - encoding: Set by user. |
1201 | * - decoding: unused | |
bdfcbbed MK |
1202 | */ |
1203 | int rate_emu; | |
115329f1 | 1204 | |
b71901e6 | 1205 | /** |
f5bccd85 DB |
1206 | * If non NULL, 'draw_horiz_band' is called by the libavcodec |
1207 | * decoder to draw a horizontal band. It improves cache usage. Not | |
b71901e6 | 1208 | * all codecs can do that. You must check the codec capabilities |
f5bccd85 | 1209 | * beforehand. |
37b00b47 AS |
1210 | * When multithreading is used, it may be called from multiple threads |
1211 | * at the same time; threads might draw different parts of the same AVFrame, | |
1212 | * or multiple AVFrames, and there is no guarantee that slices will be drawn | |
1213 | * in order. | |
24b1583a IK |
1214 | * The function is also used by hardware acceleration APIs. |
1215 | * It is called at least once during frame decoding to pass | |
1216 | * the data needed for hardware render. | |
1217 | * In that mode instead of pixel data, AVFrame points to | |
1218 | * a structure specific to the acceleration API. The application | |
1219 | * reads the structure and can change some fields to indicate progress | |
1220 | * or mark state. | |
64863965 | 1221 | * - encoding: unused |
f5bccd85 | 1222 | * - decoding: Set by user. |
3bb07d61 MN |
1223 | * @param height the height of the slice |
1224 | * @param y the y position of the slice | |
1225 | * @param type 1->top field, 2->bottom field, 3->frame | |
1226 | * @param offset offset into the AVFrame.data from which the slice should be read | |
b71901e6 | 1227 | */ |
bf89e6b1 | 1228 | void (*draw_horiz_band)(struct AVCodecContext *s, |
da64ecc3 | 1229 | const AVFrame *src, int offset[4], |
3bb07d61 | 1230 | int y, int type, int height); |
bf89e6b1 | 1231 | |
de6d9b64 | 1232 | /* audio only */ |
f5bccd85 | 1233 | int sample_rate; ///< samples per second |
5fcc4a23 | 1234 | int channels; ///< number of audio channels |
a3a5f4d6 MN |
1235 | |
1236 | /** | |
f5bccd85 DB |
1237 | * audio sample format |
1238 | * - encoding: Set by user. | |
1239 | * - decoding: Set by libavcodec. | |
a3a5f4d6 | 1240 | */ |
5d6e4c16 | 1241 | enum AVSampleFormat sample_fmt; ///< sample format |
de6d9b64 | 1242 | |
f5bccd85 | 1243 | /* The following data should not be initialized. */ |
718b27a7 | 1244 | /** |
f5bccd85 | 1245 | * Samples per packet, initialized when calling 'init'. |
718b27a7 MN |
1246 | */ |
1247 | int frame_size; | |
115329f1 | 1248 | int frame_number; ///< audio or video frame number |
c0601d70 | 1249 | #if LIBAVCODEC_VERSION_MAJOR < 53 |
f5bccd85 | 1250 | int real_pict_num; ///< Returns the real picture number of previous encoded frame. |
c0601d70 | 1251 | #endif |
115329f1 | 1252 | |
b71901e6 | 1253 | /** |
f5bccd85 | 1254 | * Number of frames the decoded output will be delayed relative to |
64863965 | 1255 | * the encoded input. |
f5bccd85 | 1256 | * - encoding: Set by libavcodec. |
64863965 | 1257 | * - decoding: unused |
b71901e6 MN |
1258 | */ |
1259 | int delay; | |
115329f1 | 1260 | |
64863965 MN |
1261 | /* - encoding parameters */ |
1262 | float qcompress; ///< amount of qscale change between easy & hard scenes (0.0-1.0) | |
115329f1 DB |
1263 | float qblur; ///< amount of qscale smoothing over time (0.0-1.0) |
1264 | ||
b71901e6 | 1265 | /** |
f5bccd85 DB |
1266 | * minimum quantizer |
1267 | * - encoding: Set by user. | |
64863965 | 1268 | * - decoding: unused |
b71901e6 MN |
1269 | */ |
1270 | int qmin; | |
1271 | ||
1272 | /** | |
f5bccd85 DB |
1273 | * maximum quantizer |
1274 | * - encoding: Set by user. | |
64863965 | 1275 | * - decoding: unused |
b71901e6 MN |
1276 | */ |
1277 | int qmax; | |
1278 | ||
1279 | /** | |
f5bccd85 DB |
1280 | * maximum quantizer difference between frames |
1281 | * - encoding: Set by user. | |
64863965 | 1282 | * - decoding: unused |
b71901e6 MN |
1283 | */ |
1284 | int max_qdiff; | |
1285 | ||
1286 | /** | |
f5bccd85 DB |
1287 | * maximum number of B-frames between non-B-frames |
1288 | * Note: The output will be delayed by max_b_frames+1 relative to the input. | |
1289 | * - encoding: Set by user. | |
64863965 | 1290 | * - decoding: unused |
b71901e6 MN |
1291 | */ |
1292 | int max_b_frames; | |
1293 | ||
1294 | /** | |
f5bccd85 | 1295 | * qscale factor between IP and B-frames |
662e5411 | 1296 | * If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset). |
1297 | * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset). | |
f5bccd85 | 1298 | * - encoding: Set by user. |
64863965 | 1299 | * - decoding: unused |
b71901e6 MN |
1300 | */ |
1301 | float b_quant_factor; | |
115329f1 | 1302 | |
b71901e6 MN |
1303 | /** obsolete FIXME remove */ |
1304 | int rc_strategy; | |
64b7c5b6 MN |
1305 | #define FF_RC_STRATEGY_XVID 1 |
1306 | ||
8b4c7dbc | 1307 | int b_frame_strategy; |
9dbcbd92 | 1308 | |
b71901e6 | 1309 | /** |
85947156 VS |
1310 | * hurry up amount |
1311 | * - encoding: unused | |
1312 | * - decoding: Set by user. 1-> Skip B-frames, 2-> Skip IDCT/dequant too, 5-> Skip everything except header | |
f9ec0aa1 | 1313 | * @deprecated Deprecated in favor of skip_idct and skip_frame. |
b71901e6 MN |
1314 | */ |
1315 | int hurry_up; | |
115329f1 | 1316 | |
de6d9b64 | 1317 | struct AVCodec *codec; |
115329f1 | 1318 | |
de6d9b64 FB |
1319 | void *priv_data; |
1320 | ||
bb628dae | 1321 | int rtp_payload_size; /* The size of the RTP payload: the coder will */ |
f5bccd85 | 1322 | /* do its best to deliver a chunk with size */ |
644d98a4 | 1323 | /* below rtp_payload_size, the chunk will start */ |
f5bccd85 | 1324 | /* with a start code on some codecs like H.263. */ |
644d98a4 | 1325 | /* This doesn't take account of any particular */ |
f5bccd85 | 1326 | /* headers inside the transmitted RTP payload. */ |
81401c1f | 1327 | |
115329f1 | 1328 | |
f5bccd85 DB |
1329 | /* The RTP callback: This function is called */ |
1330 | /* every time the encoder has a packet to send. */ | |
1331 | /* It depends on the encoder if the data starts */ | |
1332 | /* with a Start Code (it should). H.263 does. */ | |
1333 | /* mb_nb contains the number of macroblocks */ | |
1334 | /* encoded in the RTP payload. */ | |
115329f1 | 1335 | void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb); |
81401c1f | 1336 | |
098eefe1 MN |
1337 | /* statistics, used for 2-pass encoding */ |
1338 | int mv_bits; | |
1339 | int header_bits; | |
1340 | int i_tex_bits; | |
1341 | int p_tex_bits; | |
1342 | int i_count; | |
1343 | int p_count; | |
1344 | int skip_count; | |
b71901e6 | 1345 | int misc_bits; |
115329f1 | 1346 | |
b71901e6 | 1347 | /** |
f5bccd85 DB |
1348 | * number of bits used for the previously encoded frame |
1349 | * - encoding: Set by libavcodec. | |
7004ffb3 | 1350 | * - decoding: unused |
b71901e6 | 1351 | */ |
098eefe1 | 1352 | int frame_bits; |
7004ffb3 | 1353 | |
b71901e6 | 1354 | /** |
f5bccd85 DB |
1355 | * Private data of the user, can be used to carry app specific stuff. |
1356 | * - encoding: Set by user. | |
1357 | * - decoding: Set by user. | |
b71901e6 MN |
1358 | */ |
1359 | void *opaque; | |
1360 | ||
de6d9b64 | 1361 | char codec_name[32]; |
72415b2a | 1362 | enum AVMediaType codec_type; /* see AVMEDIA_TYPE_xxx */ |
4a663d80 | 1363 | enum CodecID codec_id; /* see CODEC_ID_xxx */ |
115329f1 | 1364 | |
7004ffb3 MN |
1365 | /** |
1366 | * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A'). | |
f5bccd85 DB |
1367 | * This is used to work around some encoder bugs. |
1368 | * A demuxer should set this to what is stored in the field used to identify the codec. | |
1369 | * If there are multiple such fields in a container then the demuxer should choose the one | |
1370 | * which maximizes the information about the used codec. | |
1371 | * If the codec tag field in a container is larger then 32 bits then the demuxer should | |
1372 | * remap the longer ID to 32 bits with a table or other structure. Alternatively a new | |
47bbf8a7 | 1373 | * extra_codec_tag + size could be added but for this a clear advantage must be demonstrated |
f5bccd85 DB |
1374 | * first. |
1375 | * - encoding: Set by user, if not then the default based on codec_id will be used. | |
1376 | * - decoding: Set by user, will be converted to uppercase by libavcodec during init. | |
7004ffb3 MN |
1377 | */ |
1378 | unsigned int codec_tag; | |
115329f1 | 1379 | |
b71901e6 | 1380 | /** |
f5bccd85 DB |
1381 | * Work around bugs in encoders which sometimes cannot be detected automatically. |
1382 | * - encoding: Set by user | |
1383 | * - decoding: Set by user | |
b71901e6 MN |
1384 | */ |
1385 | int workaround_bugs; | |
64863965 | 1386 | #define FF_BUG_AUTODETECT 1 ///< autodetection |
4d2858de MN |
1387 | #define FF_BUG_OLD_MSMPEG4 2 |
1388 | #define FF_BUG_XVID_ILACE 4 | |
1389 | #define FF_BUG_UMP4 8 | |
1390 | #define FF_BUG_NO_PADDING 16 | |
3116cb14 | 1391 | #define FF_BUG_AMV 32 |
f5bccd85 | 1392 | #define FF_BUG_AC_VLC 0 ///< Will be removed, libavcodec can now handle these non-compliant files by default. |
03e93d35 | 1393 | #define FF_BUG_QPEL_CHROMA 64 |
db794953 | 1394 | #define FF_BUG_STD_QPEL 128 |
36df8805 | 1395 | #define FF_BUG_QPEL_CHROMA2 256 |
c40c3482 | 1396 | #define FF_BUG_DIRECT_BLOCKSIZE 512 |
1c6dcb0f | 1397 | #define FF_BUG_EDGE 1024 |
b44bdf7e | 1398 | #define FF_BUG_HPEL_CHROMA 2048 |
4ccde216 | 1399 | #define FF_BUG_DC_CLIP 4096 |
f5bccd85 | 1400 | #define FF_BUG_MS 8192 ///< Work around various bugs in Microsoft's broken decoders. |
3566042a | 1401 | #define FF_BUG_TRUNCATED 16384 |
f5bccd85 | 1402 | //#define FF_BUG_FAKE_SCALABILITY 16 //Autodetection should work 100%. |
115329f1 | 1403 | |
b71901e6 | 1404 | /** |
f5bccd85 DB |
1405 | * luma single coefficient elimination threshold |
1406 | * - encoding: Set by user. | |
64863965 | 1407 | * - decoding: unused |
b71901e6 | 1408 | */ |
1f6b6e50 | 1409 | int luma_elim_threshold; |
115329f1 | 1410 | |
b71901e6 | 1411 | /** |
f5bccd85 DB |
1412 | * chroma single coeff elimination threshold |
1413 | * - encoding: Set by user. | |
64863965 | 1414 | * - decoding: unused |
b71901e6 | 1415 | */ |
1f6b6e50 | 1416 | int chroma_elim_threshold; |
115329f1 | 1417 | |
b71901e6 | 1418 | /** |
f5bccd85 DB |
1419 | * strictly follow the standard (MPEG4, ...). |
1420 | * - encoding: Set by user. | |
5771b2c3 MN |
1421 | * - decoding: Set by user. |
1422 | * Setting this to STRICT or higher means the encoder and decoder will | |
2d525ef4 | 1423 | * generally do stupid things, whereas setting it to unofficial or lower |
538c0e13 RB |
1424 | * will mean the encoder might produce output that is not supported by all |
1425 | * spec-compliant decoders. Decoders don't differentiate between normal, | |
2d525ef4 | 1426 | * unofficial and experimental (that is, they always try to decode things |
538c0e13 | 1427 | * when they can) unless they are explicitly asked to behave stupidly |
5771b2c3 | 1428 | * (=strictly conform to the specs) |
b71901e6 MN |
1429 | */ |
1430 | int strict_std_compliance; | |
538c0e13 | 1431 | #define FF_COMPLIANCE_VERY_STRICT 2 ///< Strictly conform to an older more strict version of the spec or reference software. |
f5bccd85 | 1432 | #define FF_COMPLIANCE_STRICT 1 ///< Strictly conform to all the things in the spec no matter what consequences. |
9cd81798 | 1433 | #define FF_COMPLIANCE_NORMAL 0 |
59b4e5ba | 1434 | #if FF_API_INOFFICIAL |
2d525ef4 RB |
1435 | #define FF_COMPLIANCE_INOFFICIAL -1 ///< Allow inofficial extensions (deprecated - use FF_COMPLIANCE_UNOFFICIAL instead). |
1436 | #endif | |
1437 | #define FF_COMPLIANCE_UNOFFICIAL -1 ///< Allow unofficial extensions | |
f5bccd85 | 1438 | #define FF_COMPLIANCE_EXPERIMENTAL -2 ///< Allow nonstandardized experimental things. |
9cd81798 | 1439 | |
b71901e6 | 1440 | /** |
f5bccd85 | 1441 | * qscale offset between IP and B-frames |
f5bccd85 | 1442 | * - encoding: Set by user. |
64863965 | 1443 | * - decoding: unused |
b71901e6 MN |
1444 | */ |
1445 | float b_quant_offset; | |
115329f1 | 1446 | |
b71901e6 | 1447 | /** |
047599a4 | 1448 | * Error recognization; higher values will detect more errors but may |
f5bccd85 | 1449 | * misdetect some more or less valid parts as errors. |
64863965 | 1450 | * - encoding: unused |
f5bccd85 | 1451 | * - decoding: Set by user. |
b71901e6 | 1452 | */ |
047599a4 | 1453 | int error_recognition; |
1471c6c2 | 1454 | #define FF_ER_CAREFUL 1 |
ce3bcaed MN |
1455 | #define FF_ER_COMPLIANT 2 |
1456 | #define FF_ER_AGGRESSIVE 3 | |
1457 | #define FF_ER_VERY_AGGRESSIVE 4 | |
115329f1 | 1458 | |
6b72ac63 | 1459 | /** |
f5bccd85 DB |
1460 | * Called at the beginning of each frame to get a buffer for it. |
1461 | * If pic.reference is set then the frame will be read later by libavcodec. | |
eb285cfe | 1462 | * avcodec_align_dimensions2() should be used to find the required width and |
f5bccd85 | 1463 | * height, as they normally need to be rounded up to the next multiple of 16. |
f1b99cc6 MN |
1464 | * if CODEC_CAP_DR1 is not set then get_buffer() must call |
1465 | * avcodec_default_get_buffer() instead of providing buffers allocated by | |
1466 | * some other means. | |
37b00b47 AS |
1467 | * If frame multithreading is used and thread_safe_callbacks is set, |
1468 | * it may be called from a different thread, but not from more than one at once. | |
1469 | * Does not need to be reentrant. | |
64863965 | 1470 | * - encoding: unused |
53128bc3 | 1471 | * - decoding: Set by libavcodec, user can override. |
b71901e6 | 1472 | */ |
492cd3a9 | 1473 | int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic); |
115329f1 | 1474 | |
b71901e6 | 1475 | /** |
69b192ac | 1476 | * Called to release buffers which were allocated with get_buffer. |
f5bccd85 DB |
1477 | * A released buffer can be reused in get_buffer(). |
1478 | * pic.data[*] must be set to NULL. | |
37b00b47 AS |
1479 | * May be called from a different thread if frame multithreading is used, |
1480 | * but not by more than one thread at once, so does not need to be reentrant. | |
64863965 | 1481 | * - encoding: unused |
53128bc3 | 1482 | * - decoding: Set by libavcodec, user can override. |
b71901e6 | 1483 | */ |
492cd3a9 | 1484 | void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic); |
0fd90455 | 1485 | |
b71901e6 | 1486 | /** |
eb8a25c8 | 1487 | * Size of the frame reordering buffer in the decoder. |
2d7b0560 | 1488 | * For MPEG-2 it is 1 IPB or 0 low delay IP. |
f5bccd85 DB |
1489 | * - encoding: Set by libavcodec. |
1490 | * - decoding: Set by libavcodec. | |
b71901e6 MN |
1491 | */ |
1492 | int has_b_frames; | |
718b27a7 MN |
1493 | |
1494 | /** | |
1495 | * number of bytes per packet if constant and known or 0 | |
f5bccd85 | 1496 | * Used by some WAV based audio codecs. |
718b27a7 MN |
1497 | */ |
1498 | int block_align; | |
115329f1 | 1499 | |
f5bccd85 | 1500 | int parse_only; /* - decoding only: If true, only parsing is done |
917e06c8 FB |
1501 | (function avcodec_parse_frame()). The frame |
1502 | data is returned. Only MPEG codecs support this now. */ | |
115329f1 | 1503 | |
b71901e6 | 1504 | /** |
f5bccd85 DB |
1505 | * 0-> h263 quant 1-> mpeg quant |
1506 | * - encoding: Set by user. | |
64863965 | 1507 | * - decoding: unused |
b71901e6 MN |
1508 | */ |
1509 | int mpeg_quant; | |
115329f1 | 1510 | |
b71901e6 | 1511 | /** |
f5bccd85 DB |
1512 | * pass1 encoding statistics output buffer |
1513 | * - encoding: Set by libavcodec. | |
64863965 | 1514 | * - decoding: unused |
b71901e6 | 1515 | */ |
64863965 | 1516 | char *stats_out; |
115329f1 | 1517 | |
b71901e6 | 1518 | /** |
f5bccd85 DB |
1519 | * pass2 encoding statistics input buffer |
1520 | * Concatenated stuff from stats_out of pass1 should be placed here. | |
1521 | * - encoding: Allocated/set/freed by user. | |
64863965 | 1522 | * - decoding: unused |
b71901e6 MN |
1523 | */ |
1524 | char *stats_in; | |
115329f1 | 1525 | |
b71901e6 | 1526 | /** |
f5bccd85 DB |
1527 | * ratecontrol qmin qmax limiting method |
1528 | * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax. | |
1529 | * - encoding: Set by user. | |
64863965 | 1530 | * - decoding: unused |
b71901e6 | 1531 | */ |
ce980a95 | 1532 | float rc_qsquish; |
b71901e6 | 1533 | |
ce980a95 MN |
1534 | float rc_qmod_amp; |
1535 | int rc_qmod_freq; | |
115329f1 | 1536 | |
b71901e6 | 1537 | /** |
f5bccd85 DB |
1538 | * ratecontrol override, see RcOverride |
1539 | * - encoding: Allocated/set/freed by user. | |
64863965 | 1540 | * - decoding: unused |
b71901e6 | 1541 | */ |
ce980a95 MN |
1542 | RcOverride *rc_override; |
1543 | int rc_override_count; | |
115329f1 | 1544 | |
b71901e6 | 1545 | /** |
f5bccd85 DB |
1546 | * rate control equation |
1547 | * - encoding: Set by user | |
64863965 | 1548 | * - decoding: unused |
b71901e6 | 1549 | */ |
6881b8e5 | 1550 | const char *rc_eq; |
115329f1 | 1551 | |
b71901e6 | 1552 | /** |
f5bccd85 DB |
1553 | * maximum bitrate |
1554 | * - encoding: Set by user. | |
64863965 | 1555 | * - decoding: unused |
b71901e6 | 1556 | */ |
ce980a95 | 1557 | int rc_max_rate; |
115329f1 | 1558 | |
b71901e6 | 1559 | /** |
f5bccd85 DB |
1560 | * minimum bitrate |
1561 | * - encoding: Set by user. | |
64863965 | 1562 | * - decoding: unused |
b71901e6 | 1563 | */ |
ce980a95 | 1564 | int rc_min_rate; |
115329f1 | 1565 | |
b71901e6 | 1566 | /** |
f5bccd85 DB |
1567 | * decoder bitstream buffer size |
1568 | * - encoding: Set by user. | |
64863965 | 1569 | * - decoding: unused |
b71901e6 | 1570 | */ |
ce980a95 MN |
1571 | int rc_buffer_size; |
1572 | float rc_buffer_aggressivity; | |
b71901e6 MN |
1573 | |
1574 | /** | |
f5bccd85 DB |
1575 | * qscale factor between P and I-frames |
1576 | * If > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset). | |
1577 | * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset). | |
1578 | * - encoding: Set by user. | |
64863965 | 1579 | * - decoding: unused |
b71901e6 MN |
1580 | */ |
1581 | float i_quant_factor; | |
115329f1 | 1582 | |
b71901e6 | 1583 | /** |
f5bccd85 DB |
1584 | * qscale offset between P and I-frames |
1585 | * - encoding: Set by user. | |
64863965 | 1586 | * - decoding: unused |
b71901e6 MN |
1587 | */ |
1588 | float i_quant_offset; | |
115329f1 | 1589 | |
b71901e6 | 1590 | /** |
f5bccd85 DB |
1591 | * initial complexity for pass1 ratecontrol |
1592 | * - encoding: Set by user. | |
64863965 | 1593 | * - decoding: unused |
b71901e6 | 1594 | */ |
ce980a95 | 1595 | float rc_initial_cplx; |
917e06c8 | 1596 | |
b71901e6 | 1597 | /** |
f5bccd85 DB |
1598 | * DCT algorithm, see FF_DCT_* below |
1599 | * - encoding: Set by user. | |
64863965 | 1600 | * - decoding: unused |
b71901e6 | 1601 | */ |
28db7fce | 1602 | int dct_algo; |
c7e07931 | 1603 | #define FF_DCT_AUTO 0 |
28db7fce | 1604 | #define FF_DCT_FASTINT 1 |
c7e07931 MO |
1605 | #define FF_DCT_INT 2 |
1606 | #define FF_DCT_MMX 3 | |
1607 | #define FF_DCT_MLIB 4 | |
05c4072b | 1608 | #define FF_DCT_ALTIVEC 5 |
65e4c8c9 | 1609 | #define FF_DCT_FAAN 6 |
115329f1 | 1610 | |
c5d309f2 | 1611 | /** |
f5bccd85 DB |
1612 | * luminance masking (0-> disabled) |
1613 | * - encoding: Set by user. | |
64863965 | 1614 | * - decoding: unused |
c5d309f2 MN |
1615 | */ |
1616 | float lumi_masking; | |
115329f1 | 1617 | |
c5d309f2 | 1618 | /** |
f5bccd85 DB |
1619 | * temporary complexity masking (0-> disabled) |
1620 | * - encoding: Set by user. | |
64863965 | 1621 | * - decoding: unused |
c5d309f2 MN |
1622 | */ |
1623 | float temporal_cplx_masking; | |
115329f1 | 1624 | |
c5d309f2 | 1625 | /** |
f5bccd85 DB |
1626 | * spatial complexity masking (0-> disabled) |
1627 | * - encoding: Set by user. | |
64863965 | 1628 | * - decoding: unused |
c5d309f2 MN |
1629 | */ |
1630 | float spatial_cplx_masking; | |
115329f1 | 1631 | |
c5d309f2 | 1632 | /** |
f5bccd85 DB |
1633 | * p block masking (0-> disabled) |
1634 | * - encoding: Set by user. | |
64863965 | 1635 | * - decoding: unused |
c5d309f2 MN |
1636 | */ |
1637 | float p_masking; | |
15415af4 | 1638 | |
5e746b99 | 1639 | /** |
f5bccd85 DB |
1640 | * darkness masking (0-> disabled) |
1641 | * - encoding: Set by user. | |
64863965 | 1642 | * - decoding: unused |
5e746b99 MN |
1643 | */ |
1644 | float dark_masking; | |
115329f1 | 1645 | |
0c2dd16e | 1646 | /** |
f5bccd85 DB |
1647 | * IDCT algorithm, see FF_IDCT_* below. |
1648 | * - encoding: Set by user. | |
1649 | * - decoding: Set by user. | |
2ad1516a MN |
1650 | */ |
1651 | int idct_algo; | |
273b0cd3 DB |
1652 | #define FF_IDCT_AUTO 0 |
1653 | #define FF_IDCT_INT 1 | |
1654 | #define FF_IDCT_SIMPLE 2 | |
1655 | #define FF_IDCT_SIMPLEMMX 3 | |
1656 | #define FF_IDCT_LIBMPEG2MMX 4 | |
1657 | #define FF_IDCT_PS2 5 | |
1658 | #define FF_IDCT_MLIB 6 | |
1659 | #define FF_IDCT_ARM 7 | |
1660 | #define FF_IDCT_ALTIVEC 8 | |
1661 | #define FF_IDCT_SH4 9 | |
1662 | #define FF_IDCT_SIMPLEARM 10 | |
1663 | #define FF_IDCT_H264 11 | |
1664 | #define FF_IDCT_VP3 12 | |
1665 | #define FF_IDCT_IPP 13 | |
1666 | #define FF_IDCT_XVIDMMX 14 | |
1667 | #define FF_IDCT_CAVS 15 | |
a0403006 | 1668 | #define FF_IDCT_SIMPLEARMV5TE 16 |
273b0cd3 | 1669 | #define FF_IDCT_SIMPLEARMV6 17 |
d9420d4d | 1670 | #define FF_IDCT_SIMPLEVIS 18 |
9abc7e0f | 1671 | #define FF_IDCT_WMV2 19 |
6f08c541 | 1672 | #define FF_IDCT_FAAN 20 |
42b30357 | 1673 | #define FF_IDCT_EA 21 |
7eec4328 | 1674 | #define FF_IDCT_SIMPLENEON 22 |
74c47463 | 1675 | #define FF_IDCT_SIMPLEALPHA 23 |
342c7dfd | 1676 | #define FF_IDCT_BINK 24 |
2ad1516a | 1677 | |
144f0625 | 1678 | /** |
f5bccd85 DB |
1679 | * slice count |
1680 | * - encoding: Set by libavcodec. | |
1681 | * - decoding: Set by user (or 0). | |
144f0625 MN |
1682 | */ |
1683 | int slice_count; | |
1684 | /** | |
f5bccd85 DB |
1685 | * slice offsets in the frame in bytes |
1686 | * - encoding: Set/allocated by libavcodec. | |
1687 | * - decoding: Set/allocated by user (or NULL). | |
144f0625 MN |
1688 | */ |
1689 | int *slice_offset; | |
1690 | ||
4d2858de | 1691 | /** |
f5bccd85 | 1692 | * error concealment flags |
64863965 | 1693 | * - encoding: unused |
f5bccd85 | 1694 | * - decoding: Set by user. |
4d2858de MN |
1695 | */ |
1696 | int error_concealment; | |
1697 | #define FF_EC_GUESS_MVS 1 | |
1698 | #define FF_EC_DEBLOCK 2 | |
1699 | ||
6b72ac63 | 1700 | /** |
bec89a84 | 1701 | * dsp_mask could be add used to disable unwanted CPU features |
8350df97 | 1702 | * CPU features (i.e. MMX, SSE. ...) |
bec89a84 | 1703 | * |
f5bccd85 DB |
1704 | * With the FORCE flag you may instead enable given CPU features. |
1705 | * (Dangerous: Usable in case of misdetection, improper usage however will | |
1706 | * result into program crash.) | |
bec89a84 ZK |
1707 | */ |
1708 | unsigned dsp_mask; | |
7160bb71 SS |
1709 | |
1710 | #if FF_API_MM_FLAGS | |
1711 | #define FF_MM_FORCE AV_CPU_FLAG_FORCE | |
1712 | #define FF_MM_MMX AV_CPU_FLAG_MMX | |
1713 | #define FF_MM_3DNOW AV_CPU_FLAG_3DNOW | |
1714 | #define FF_MM_MMXEXT AV_CPU_FLAG_MMX2 | |
1715 | #define FF_MM_MMX2 AV_CPU_FLAG_MMX2 | |
1716 | #define FF_MM_SSE AV_CPU_FLAG_SSE | |
1717 | #define FF_MM_SSE2 AV_CPU_FLAG_SSE2 | |
1718 | #define FF_MM_SSE2SLOW AV_CPU_FLAG_SSE2SLOW | |
1719 | #define FF_MM_3DNOWEXT AV_CPU_FLAG_3DNOWEXT | |
1720 | #define FF_MM_SSE3 AV_CPU_FLAG_SSE3 | |
1721 | #define FF_MM_SSE3SLOW AV_CPU_FLAG_SSE3SLOW | |
1722 | #define FF_MM_SSSE3 AV_CPU_FLAG_SSSE3 | |
1723 | #define FF_MM_SSE4 AV_CPU_FLAG_SSE4 | |
1724 | #define FF_MM_SSE42 AV_CPU_FLAG_SSE42 | |
1725 | #define FF_MM_IWMMXT AV_CPU_FLAG_IWMMXT | |
1726 | #define FF_MM_ALTIVEC AV_CPU_FLAG_ALTIVEC | |
6b434361 | 1727 | #endif |
11f18faf MN |
1728 | |
1729 | /** | |
64863965 | 1730 | * bits per sample/pixel from the demuxer (needed for huffyuv). |
f5bccd85 DB |
1731 | * - encoding: Set by libavcodec. |
1732 | * - decoding: Set by user. | |
11f18faf | 1733 | */ |
46a73068 | 1734 | int bits_per_coded_sample; |
115329f1 | 1735 | |
11f18faf | 1736 | /** |
f5bccd85 DB |
1737 | * prediction method (needed for huffyuv) |
1738 | * - encoding: Set by user. | |
64863965 | 1739 | * - decoding: unused |
11f18faf MN |
1740 | */ |
1741 | int prediction_method; | |
1742 | #define FF_PRED_LEFT 0 | |
1743 | #define FF_PRED_PLANE 1 | |
1744 | #define FF_PRED_MEDIAN 2 | |
115329f1 | 1745 | |
5d3cea3a | 1746 | /** |
f5bccd85 | 1747 | * sample aspect ratio (0 if unknown) |
8e5af7a6 | 1748 | * That is the width of a pixel divided by the height of the pixel. |
f5bccd85 DB |
1749 | * Numerator and denominator must be relatively prime and smaller than 256 for some video standards. |
1750 | * - encoding: Set by user. | |
1751 | * - decoding: Set by libavcodec. | |
5d3cea3a | 1752 | */ |
5ff85f1d | 1753 | AVRational sample_aspect_ratio; |
1e491e29 MN |
1754 | |
1755 | /** | |
f5bccd85 DB |
1756 | * the picture in the bitstream |
1757 | * - encoding: Set by libavcodec. | |
1758 | * - decoding: Set by libavcodec. | |
1e491e29 | 1759 | */ |
492cd3a9 | 1760 | AVFrame *coded_frame; |
c8c437bc MN |
1761 | |
1762 | /** | |
f5bccd85 DB |
1763 | * debug |
1764 | * - encoding: Set by user. | |
1765 | * - decoding: Set by user. | |
c8c437bc MN |
1766 | */ |
1767 | int debug; | |
273b0cd3 DB |
1768 | #define FF_DEBUG_PICT_INFO 1 |
1769 | #define FF_DEBUG_RC 2 | |
1770 | #define FF_DEBUG_BITSTREAM 4 | |
1771 | #define FF_DEBUG_MB_TYPE 8 | |
1772 | #define FF_DEBUG_QP 16 | |
1773 | #define FF_DEBUG_MV 32 | |
1774 | #define FF_DEBUG_DCT_COEFF 0x00000040 | |
1775 | #define FF_DEBUG_SKIP 0x00000080 | |
1776 | #define FF_DEBUG_STARTCODE 0x00000100 | |
1777 | #define FF_DEBUG_PTS 0x00000200 | |
1778 | #define FF_DEBUG_ER 0x00000400 | |
1779 | #define FF_DEBUG_MMCO 0x00000800 | |
1780 | #define FF_DEBUG_BUGS 0x00001000 | |
1781 | #define FF_DEBUG_VIS_QP 0x00002000 | |
864119b6 | 1782 | #define FF_DEBUG_VIS_MB_TYPE 0x00004000 |
385c820b | 1783 | #define FF_DEBUG_BUFFERS 0x00008000 |
37b00b47 | 1784 | #define FF_DEBUG_THREADS 0x00010000 |
115329f1 | 1785 | |
140cb663 | 1786 | /** |
f5bccd85 DB |
1787 | * debug |
1788 | * - encoding: Set by user. | |
1789 | * - decoding: Set by user. | |
0c9bbaec WH |
1790 | */ |
1791 | int debug_mv; | |
1792 | #define FF_DEBUG_VIS_MV_P_FOR 0x00000001 //visualize forward predicted MVs of P frames | |
1793 | #define FF_DEBUG_VIS_MV_B_FOR 0x00000002 //visualize forward predicted MVs of B frames | |
1794 | #define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames | |
1795 | ||
1796 | /** | |
f5bccd85 DB |
1797 | * error |
1798 | * - encoding: Set by libavcodec if flags&CODEC_FLAG_PSNR. | |
64863965 | 1799 | * - decoding: unused |
140cb663 MN |
1800 | */ |
1801 | uint64_t error[4]; | |
115329f1 | 1802 | |
17a70fde | 1803 | /** |
f5bccd85 | 1804 | * minimum MB quantizer |
6e0d8c06 | 1805 | * - encoding: unused |
64863965 | 1806 | * - decoding: unused |
17a70fde MN |
1807 | */ |
1808 | int mb_qmin; | |
1809 | ||
1810 | /** | |
f5bccd85 | 1811 | * maximum MB quantizer |
6e0d8c06 | 1812 | * - encoding: unused |
64863965 | 1813 | * - decoding: unused |
17a70fde MN |
1814 | */ |
1815 | int mb_qmax; | |
115329f1 | 1816 | |
1457ab52 | 1817 | /** |
f5bccd85 DB |
1818 | * motion estimation comparison function |
1819 | * - encoding: Set by user. | |
64863965 | 1820 | * - decoding: unused |
1457ab52 MN |
1821 | */ |
1822 | int me_cmp; | |
1823 | /** | |
f5bccd85 DB |
1824 | * subpixel motion estimation comparison function |
1825 | * - encoding: Set by user. | |
64863965 | 1826 | * - decoding: unused |
1457ab52 MN |
1827 | */ |
1828 | int me_sub_cmp; | |
1829 | /** | |
f5bccd85 DB |
1830 | * macroblock comparison function (not supported yet) |
1831 | * - encoding: Set by user. | |
64863965 | 1832 | * - decoding: unused |
1457ab52 MN |
1833 | */ |
1834 | int mb_cmp; | |
622348f9 | 1835 | /** |
f5bccd85 DB |
1836 | * interlaced DCT comparison function |
1837 | * - encoding: Set by user. | |
622348f9 MN |
1838 | * - decoding: unused |
1839 | */ | |
1840 | int ildct_cmp; | |
273b0cd3 DB |
1841 | #define FF_CMP_SAD 0 |
1842 | #define FF_CMP_SSE 1 | |
1843 | #define FF_CMP_SATD 2 | |
1844 | #define FF_CMP_DCT 3 | |
1845 | #define FF_CMP_PSNR 4 | |
1846 | #define FF_CMP_BIT 5 | |
1847 | #define FF_CMP_RD 6 | |
1848 | #define FF_CMP_ZERO 7 | |
1849 | #define FF_CMP_VSAD 8 | |
1850 | #define FF_CMP_VSSE 9 | |
1851 | #define FF_CMP_NSSE 10 | |
1852 | #define FF_CMP_W53 11 | |
1853 | #define FF_CMP_W97 12 | |
0fd6aea1 | 1854 | #define FF_CMP_DCTMAX 13 |
27c61ac5 | 1855 | #define FF_CMP_DCT264 14 |
1457ab52 | 1856 | #define FF_CMP_CHROMA 256 |
115329f1 | 1857 | |
1457ab52 | 1858 | /** |
f5bccd85 DB |
1859 | * ME diamond size & shape |
1860 | * - encoding: Set by user. | |
64863965 | 1861 | * - decoding: unused |
1457ab52 MN |
1862 | */ |
1863 | int dia_size; | |
b07a5980 MN |
1864 | |
1865 | /** | |
f5bccd85 DB |
1866 | * amount of previous MV predictors (2a+1 x 2a+1 square) |
1867 | * - encoding: Set by user. | |
64863965 | 1868 | * - decoding: unused |
b07a5980 MN |
1869 | */ |
1870 | int last_predictor_count; | |
70ac76c0 | 1871 | |
f5fb6b34 | 1872 | /** |
f5bccd85 DB |
1873 | * prepass for motion estimation |
1874 | * - encoding: Set by user. | |
64863965 | 1875 | * - decoding: unused |
f5fb6b34 MN |
1876 | */ |
1877 | int pre_me; | |
b07a5980 | 1878 | |
70ac76c0 | 1879 | /** |
f5bccd85 DB |
1880 | * motion estimation prepass comparison function |
1881 | * - encoding: Set by user. | |
64863965 | 1882 | * - decoding: unused |
70ac76c0 MN |
1883 | */ |
1884 | int me_pre_cmp; | |
826f429a | 1885 | |
70ac76c0 | 1886 | /** |
f5bccd85 DB |
1887 | * ME prepass diamond size & shape |
1888 | * - encoding: Set by user. | |
64863965 | 1889 | * - decoding: unused |
70ac76c0 MN |
1890 | */ |
1891 | int pre_dia_size; | |
1892 | ||
826f429a | 1893 | /** |
f5bccd85 DB |
1894 | * subpel ME quality |
1895 | * - encoding: Set by user. | |
64863965 | 1896 | * - decoding: unused |
826f429a MN |
1897 | */ |
1898 | int me_subpel_quality; | |
1899 | ||
a33c7159 | 1900 | /** |
f5bccd85 | 1901 | * callback to negotiate the pixelFormat |
a33c7159 | 1902 | * @param fmt is the list of formats which are supported by the codec, |
f5bccd85 DB |
1903 | * it is terminated by -1 as 0 is a valid format, the formats are ordered by quality. |
1904 | * The first is always the native one. | |
1905 | * @return the chosen format | |
64863965 | 1906 | * - encoding: unused |
f5bccd85 | 1907 | * - decoding: Set by user, if not set the native format will be chosen. |
a33c7159 | 1908 | */ |
494c56d3 | 1909 | enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt); |
e2f9490e FB |
1910 | |
1911 | /** | |
f5bccd85 DB |
1912 | * DTG active format information (additional aspect ratio |
1913 | * information only used in DVB MPEG-2 transport streams) | |
1914 | * 0 if not set. | |
115329f1 | 1915 | * |
f5bccd85 DB |
1916 | * - encoding: unused |
1917 | * - decoding: Set by decoder. | |
e2f9490e FB |
1918 | */ |
1919 | int dtg_active_format; | |
1920 | #define FF_DTG_AFD_SAME 8 | |
1921 | #define FF_DTG_AFD_4_3 9 | |
1922 | #define FF_DTG_AFD_16_9 10 | |
1923 | #define FF_DTG_AFD_14_9 11 | |
1924 | #define FF_DTG_AFD_4_3_SP_14_9 13 | |
1925 | #define FF_DTG_AFD_16_9_SP_14_9 14 | |
1926 | #define FF_DTG_AFD_SP_4_3 15 | |
1927 | ||
ebbcdc9a | 1928 | /** |
f5bccd85 DB |
1929 | * maximum motion estimation search range in subpel units |
1930 | * If 0 then no limit. | |
115329f1 | 1931 | * |
f5bccd85 DB |
1932 | * - encoding: Set by user. |
1933 | * - decoding: unused | |
ebbcdc9a | 1934 | */ |
59e0ac8e | 1935 | int me_range; |
ebbcdc9a | 1936 | |
65f7062d | 1937 | /** |
f5bccd85 DB |
1938 | * intra quantizer bias |
1939 | * - encoding: Set by user. | |
1984f635 MN |
1940 | * - decoding: unused |
1941 | */ | |
1942 | int intra_quant_bias; | |
1943 | #define FF_DEFAULT_QUANT_BIAS 999999 | |
115329f1 | 1944 | |
1984f635 | 1945 | /** |
f5bccd85 DB |
1946 | * inter quantizer bias |
1947 | * - encoding: Set by user. | |
1984f635 MN |
1948 | * - decoding: unused |
1949 | */ | |
1950 | int inter_quant_bias; | |
5cd62665 ZK |
1951 | |
1952 | /** | |
f5bccd85 DB |
1953 | * color table ID |
1954 | * - encoding: unused | |
1955 | * - decoding: Which clrtable should be used for 8bit RGB images. | |
1956 | * Tables have to be stored somewhere. FIXME | |
5cd62665 ZK |
1957 | */ |
1958 | int color_table_id; | |
115329f1 | 1959 | |
d90cf87b | 1960 | /** |
f5bccd85 DB |
1961 | * internal_buffer count |
1962 | * Don't touch, used by libavcodec default_get_buffer(). | |
d90cf87b MN |
1963 | */ |
1964 | int internal_buffer_count; | |
115329f1 | 1965 | |
d90cf87b | 1966 | /** |
f5bccd85 DB |
1967 | * internal_buffers |
1968 | * Don't touch, used by libavcodec default_get_buffer(). | |
d90cf87b MN |
1969 | */ |
1970 | void *internal_buffer; | |
158c7f05 | 1971 | |
3d2e8cce | 1972 | /** |
f5bccd85 DB |
1973 | * Global quality for codecs which cannot change it per frame. |
1974 | * This should be proportional to MPEG-1/2/4 qscale. | |
1975 | * - encoding: Set by user. | |
3d2e8cce MN |
1976 | * - decoding: unused |
1977 | */ | |
1978 | int global_quality; | |
115329f1 | 1979 | |
bd446bb1 MN |
1980 | #define FF_CODER_TYPE_VLC 0 |
1981 | #define FF_CODER_TYPE_AC 1 | |
f87459e4 KN |
1982 | #define FF_CODER_TYPE_RAW 2 |
1983 | #define FF_CODER_TYPE_RLE 3 | |
1984 | #define FF_CODER_TYPE_DEFLATE 4 | |
11e659c2 MN |
1985 | /** |
1986 | * coder type | |
f5bccd85 | 1987 | * - encoding: Set by user. |
11e659c2 MN |
1988 | * - decoding: unused |
1989 | */ | |
1990 | int coder_type; | |
1991 | ||
1992 | /** | |
1993 | * context model | |
f5bccd85 | 1994 | * - encoding: Set by user. |
11e659c2 MN |
1995 | * - decoding: unused |
1996 | */ | |
1997 | int context_model; | |
5639729b MN |
1998 | #if 0 |
1999 | /** | |
2000 | * | |
2001 | * - encoding: unused | |
f5bccd85 | 2002 | * - decoding: Set by user. |
5639729b MN |
2003 | */ |
2004 | uint8_t * (*realloc)(struct AVCodecContext *s, uint8_t *buf, int buf_size); | |
2005 | #endif | |
115329f1 | 2006 | |
3bb07d61 MN |
2007 | /** |
2008 | * slice flags | |
2009 | * - encoding: unused | |
f5bccd85 | 2010 | * - decoding: Set by user. |
3bb07d61 MN |
2011 | */ |
2012 | int slice_flags; | |
2013 | #define SLICE_FLAG_CODED_ORDER 0x0001 ///< draw_horiz_band() is called in coded order instead of display | |
2014 | #define SLICE_FLAG_ALLOW_FIELD 0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics) | |
2015 | #define SLICE_FLAG_ALLOW_PLANE 0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1) | |
2016 | ||
fb364ada IK |
2017 | /** |
2018 | * XVideo Motion Acceleration | |
2019 | * - encoding: forbidden | |
2020 | * - decoding: set by decoder | |
2021 | */ | |
2022 | int xvmc_acceleration; | |
115329f1 | 2023 | |
7d1c3fc1 MN |
2024 | /** |
2025 | * macroblock decision mode | |
f5bccd85 | 2026 | * - encoding: Set by user. |
7d1c3fc1 MN |
2027 | * - decoding: unused |
2028 | */ | |
2029 | int mb_decision; | |
2030 | #define FF_MB_DECISION_SIMPLE 0 ///< uses mb_cmp | |
2031 | #define FF_MB_DECISION_BITS 1 ///< chooses the one which needs the fewest bits | |
e6dba5df | 2032 | #define FF_MB_DECISION_RD 2 ///< rate distortion |
d6eb3c50 MN |
2033 | |
2034 | /** | |
2035 | * custom intra quantization matrix | |
f5bccd85 DB |
2036 | * - encoding: Set by user, can be NULL. |
2037 | * - decoding: Set by libavcodec. | |
d6eb3c50 MN |
2038 | */ |
2039 | uint16_t *intra_matrix; | |
2040 | ||
2041 | /** | |
2042 | * custom inter quantization matrix | |
f5bccd85 DB |
2043 | * - encoding: Set by user, can be NULL. |
2044 | * - decoding: Set by libavcodec. | |
d6eb3c50 MN |
2045 | */ |
2046 | uint16_t *inter_matrix; | |
115329f1 | 2047 | |
541ae140 MN |
2048 | /** |
2049 | * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A'). | |
f5bccd85 | 2050 | * This is used to work around some encoder bugs. |
541ae140 | 2051 | * - encoding: unused |
f5bccd85 | 2052 | * - decoding: Set by user, will be converted to uppercase by libavcodec during init. |
541ae140 MN |
2053 | */ |
2054 | unsigned int stream_codec_tag; | |
05fbd0a2 MN |
2055 | |
2056 | /** | |
f5bccd85 DB |
2057 | * scene change detection threshold |
2058 | * 0 is default, larger means fewer detected scene changes. | |
2059 | * - encoding: Set by user. | |
05fbd0a2 MN |
2060 | * - decoding: unused |
2061 | */ | |
2062 | int scenechange_threshold; | |
158c7f05 MN |
2063 | |
2064 | /** | |
f5bccd85 DB |
2065 | * minimum Lagrange multipler |
2066 | * - encoding: Set by user. | |
158c7f05 MN |
2067 | * - decoding: unused |
2068 | */ | |
2069 | int lmin; | |
2070 | ||
2071 | /** | |
f5bccd85 DB |
2072 | * maximum Lagrange multipler |
2073 | * - encoding: Set by user. | |
158c7f05 MN |
2074 | * - decoding: unused |
2075 | */ | |
2076 | int lmax; | |
2a2bbcb0 | 2077 | |
eda7c983 | 2078 | #if FF_API_PALETTE_CONTROL |
2a2bbcb0 | 2079 | /** |
f5bccd85 | 2080 | * palette control structure |
2a2bbcb0 | 2081 | * - encoding: ??? (no palette-enabled encoder yet) |
f5bccd85 | 2082 | * - decoding: Set by user. |
2a2bbcb0 MM |
2083 | */ |
2084 | struct AVPaletteControl *palctrl; | |
eda7c983 | 2085 | #endif |
821cb11f MN |
2086 | |
2087 | /** | |
2088 | * noise reduction strength | |
f5bccd85 | 2089 | * - encoding: Set by user. |
821cb11f MN |
2090 | * - decoding: unused |
2091 | */ | |
2092 | int noise_reduction; | |
115329f1 | 2093 | |
074c4ca7 | 2094 | /** |
f5bccd85 DB |
2095 | * Called at the beginning of a frame to get cr buffer for it. |
2096 | * Buffer type (size, hints) must be the same. libavcodec won't check it. | |
2097 | * libavcodec will pass previous buffer in pic, function should return | |
e1c2a5a0 | 2098 | * same buffer or new buffer with old frame "painted" into it. |
f5bccd85 | 2099 | * If pic.data[0] == NULL must behave like get_buffer(). |
f1b99cc6 MN |
2100 | * if CODEC_CAP_DR1 is not set then reget_buffer() must call |
2101 | * avcodec_default_reget_buffer() instead of providing buffers allocated by | |
2102 | * some other means. | |
074c4ca7 | 2103 | * - encoding: unused |
53128bc3 | 2104 | * - decoding: Set by libavcodec, user can override. |
074c4ca7 | 2105 | */ |
e1c2a5a0 | 2106 | int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic); |
ba58dabc MN |
2107 | |
2108 | /** | |
f5bccd85 DB |
2109 | * Number of bits which should be loaded into the rc buffer before decoding starts. |
2110 | * - encoding: Set by user. | |
ba58dabc MN |
2111 | * - decoding: unused |
2112 | */ | |
2113 | int rc_initial_buffer_occupancy; | |
2114 | ||
2115 | /** | |
2116 | * | |
f5bccd85 | 2117 | * - encoding: Set by user. |
ba58dabc MN |
2118 | * - decoding: unused |
2119 | */ | |
2120 | int inter_threshold; | |
2121 | ||
2122 | /** | |
f5bccd85 DB |
2123 | * CODEC_FLAG2_* |
2124 | * - encoding: Set by user. | |
2125 | * - decoding: Set by user. | |
ba58dabc MN |
2126 | */ |
2127 | int flags2; | |
7ebfc0ea MN |
2128 | |
2129 | /** | |
f5bccd85 DB |
2130 | * Simulates errors in the bitstream to test error concealment. |
2131 | * - encoding: Set by user. | |
2132 | * - decoding: unused | |
7ebfc0ea MN |
2133 | */ |
2134 | int error_rate; | |
115329f1 | 2135 | |
a1e257b2 MN |
2136 | /** |
2137 | * MP3 antialias algorithm, see FF_AA_* below. | |
2138 | * - encoding: unused | |
f5bccd85 | 2139 | * - decoding: Set by user. |
a1e257b2 MN |
2140 | */ |
2141 | int antialias_algo; | |
2142 | #define FF_AA_AUTO 0 | |
2143 | #define FF_AA_FASTINT 1 //not implemented yet | |
2144 | #define FF_AA_INT 2 | |
2145 | #define FF_AA_FLOAT 3 | |
77ea0d4b | 2146 | /** |
f5bccd85 DB |
2147 | * quantizer noise shaping |
2148 | * - encoding: Set by user. | |
77ea0d4b MN |
2149 | * - decoding: unused |
2150 | */ | |
2151 | int quantizer_noise_shaping; | |
9c3d33d6 MN |
2152 | |
2153 | /** | |
f5bccd85 | 2154 | * thread count |
eafcac6a | 2155 | * is used to decide how many independent tasks should be passed to execute() |
f5bccd85 DB |
2156 | * - encoding: Set by user. |
2157 | * - decoding: Set by user. | |
9c3d33d6 MN |
2158 | */ |
2159 | int thread_count; | |
115329f1 | 2160 | |
9c3d33d6 | 2161 | /** |
f5bccd85 DB |
2162 | * The codec may call this to execute several independent things. |
2163 | * It will return only after finishing all tasks. | |
2164 | * The user may replace this with some multithreaded implementation, | |
2165 | * the default implementation will execute the parts serially. | |
399cec2f | 2166 | * @param count the number of things to execute |
f5bccd85 DB |
2167 | * - encoding: Set by libavcodec, user can override. |
2168 | * - decoding: Set by libavcodec, user can override. | |
9c3d33d6 | 2169 | */ |
3a84713a | 2170 | int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void *arg2, int *ret, int count, int size); |
115329f1 | 2171 | |
9c3d33d6 | 2172 | /** |
f5bccd85 DB |
2173 | * thread opaque |
2174 | * Can be used by execute() to store some per AVCodecContext stuff. | |
9c3d33d6 MN |
2175 | * - encoding: set by execute() |
2176 | * - decoding: set by execute() | |
2177 | */ | |
2178 | void *thread_opaque; | |
a4d36c11 MN |
2179 | |
2180 | /** | |
f5bccd85 DB |
2181 | * Motion estimation threshold below which no motion estimation is |
2182 | * performed, but instead the user specified motion vectors are used. | |
115329f1 | 2183 | * |
f5bccd85 | 2184 | * - encoding: Set by user. |
f20f8a8b | 2185 | * - decoding: unused |
a4d36c11 | 2186 | */ |
2750b827 | 2187 | int me_threshold; |
f20f8a8b MN |
2188 | |
2189 | /** | |
f5bccd85 DB |
2190 | * Macroblock threshold below which the user specified macroblock types will be used. |
2191 | * - encoding: Set by user. | |
f20f8a8b MN |
2192 | * - decoding: unused |
2193 | */ | |
2194 | int mb_threshold; | |
bf266e19 MN |
2195 | |
2196 | /** | |
f5bccd85 DB |
2197 | * precision of the intra DC coefficient - 8 |
2198 | * - encoding: Set by user. | |
bf266e19 MN |
2199 | * - decoding: unused |
2200 | */ | |
2201 | int intra_dc_precision; | |
d4c5d2ad MN |
2202 | |
2203 | /** | |
f5bccd85 DB |
2204 | * noise vs. sse weight for the nsse comparsion function |
2205 | * - encoding: Set by user. | |
d4c5d2ad MN |
2206 | * - decoding: unused |
2207 | */ | |
2208 | int nsse_weight; | |
0dfd33c3 MN |
2209 | |
2210 | /** | |
f5bccd85 | 2211 | * Number of macroblock rows at the top which are skipped. |
0dfd33c3 | 2212 | * - encoding: unused |
f5bccd85 | 2213 | * - decoding: Set by user. |
0dfd33c3 MN |
2214 | */ |
2215 | int skip_top; | |
2216 | ||
2217 | /** | |
f5bccd85 | 2218 | * Number of macroblock rows at the bottom which are skipped. |
0dfd33c3 | 2219 | * - encoding: unused |
f5bccd85 | 2220 | * - decoding: Set by user. |
0dfd33c3 MN |
2221 | */ |
2222 | int skip_bottom; | |
baced9f5 MN |
2223 | |
2224 | /** | |
2225 | * profile | |
f5bccd85 DB |
2226 | * - encoding: Set by user. |
2227 | * - decoding: Set by libavcodec. | |
baced9f5 MN |
2228 | */ |
2229 | int profile; | |
2230 | #define FF_PROFILE_UNKNOWN -99 | |
aecd0a44 | 2231 | #define FF_PROFILE_RESERVED -100 |
dd0cd3d2 | 2232 | |
4f2c36ac | 2233 | #define FF_PROFILE_AAC_MAIN 0 |
273b0cd3 DB |
2234 | #define FF_PROFILE_AAC_LOW 1 |
2235 | #define FF_PROFILE_AAC_SSR 2 | |
2236 | #define FF_PROFILE_AAC_LTP 3 | |
baced9f5 | 2237 | |
f5a2d285 AH |
2238 | #define FF_PROFILE_DTS 20 |
2239 | #define FF_PROFILE_DTS_ES 30 | |
2240 | #define FF_PROFILE_DTS_96_24 40 | |
2241 | #define FF_PROFILE_DTS_HD_HRA 50 | |
2242 | #define FF_PROFILE_DTS_HD_MA 60 | |
2243 | ||
aecd0a44 BL |
2244 | #define FF_PROFILE_MPEG2_422 0 |
2245 | #define FF_PROFILE_MPEG2_HIGH 1 | |
2246 | #define FF_PROFILE_MPEG2_SS 2 | |
2247 | #define FF_PROFILE_MPEG2_SNR_SCALABLE 3 | |
2248 | #define FF_PROFILE_MPEG2_MAIN 4 | |
2249 | #define FF_PROFILE_MPEG2_SIMPLE 5 | |
2250 | ||
fe9a3fbe JG |
2251 | #define FF_PROFILE_H264_CONSTRAINED (1<<9) // 8+1; constraint_set1_flag |
2252 | #define FF_PROFILE_H264_INTRA (1<<11) // 8+3; constraint_set3_flag | |
2253 | ||
2254 | #define FF_PROFILE_H264_BASELINE 66 | |
2255 | #define FF_PROFILE_H264_CONSTRAINED_BASELINE (66|FF_PROFILE_H264_CONSTRAINED) | |
2256 | #define FF_PROFILE_H264_MAIN 77 | |
2257 | #define FF_PROFILE_H264_EXTENDED 88 | |
2258 | #define FF_PROFILE_H264_HIGH 100 | |
2259 | #define FF_PROFILE_H264_HIGH_10 110 | |
2260 | #define FF_PROFILE_H264_HIGH_10_INTRA (110|FF_PROFILE_H264_INTRA) | |
2261 | #define FF_PROFILE_H264_HIGH_422 122 | |
2262 | #define FF_PROFILE_H264_HIGH_422_INTRA (122|FF_PROFILE_H264_INTRA) | |
440b6169 | 2263 | #define FF_PROFILE_H264_HIGH_444 144 |
fe9a3fbe JG |
2264 | #define FF_PROFILE_H264_HIGH_444_PREDICTIVE 244 |
2265 | #define FF_PROFILE_H264_HIGH_444_INTRA (244|FF_PROFILE_H264_INTRA) | |
2266 | #define FF_PROFILE_H264_CAVLC_444 44 | |
dd0cd3d2 | 2267 | |
0215006a HL |
2268 | #define FF_PROFILE_VC1_SIMPLE 0 |
2269 | #define FF_PROFILE_VC1_MAIN 1 | |
2270 | #define FF_PROFILE_VC1_COMPLEX 2 | |
2271 | #define FF_PROFILE_VC1_ADVANCED 3 | |
2272 | ||
baced9f5 MN |
2273 | /** |
2274 | * level | |
f5bccd85 DB |
2275 | * - encoding: Set by user. |
2276 | * - decoding: Set by libavcodec. | |
baced9f5 MN |
2277 | */ |
2278 | int level; | |
2279 | #define FF_LEVEL_UNKNOWN -99 | |
178fcca8 MN |
2280 | |
2281 | /** | |
f5bccd85 | 2282 | * low resolution decoding, 1-> 1/2 size, 2->1/4 size |
178fcca8 | 2283 | * - encoding: unused |
f5bccd85 | 2284 | * - decoding: Set by user. |
178fcca8 MN |
2285 | */ |
2286 | int lowres; | |
21adafec MN |
2287 | |
2288 | /** | |
f5bccd85 DB |
2289 | * Bitstream width / height, may be different from width/height if lowres |
2290 | * or other things are used. | |
21adafec | 2291 | * - encoding: unused |
f5bccd85 | 2292 | * - decoding: Set by user before init if known. Codec should override / dynamically change if needed. |
21adafec MN |
2293 | */ |
2294 | int coded_width, coded_height; | |
bbf18b21 MN |
2295 | |
2296 | /** | |
2297 | * frame skip threshold | |
f5bccd85 | 2298 | * - encoding: Set by user. |
bbf18b21 MN |
2299 | * - decoding: unused |
2300 | */ | |
2301 | int frame_skip_threshold; | |
2302 | ||
2303 | /** | |
2304 | * frame skip factor | |
f5bccd85 | 2305 | * - encoding: Set by user. |
bbf18b21 MN |
2306 | * - decoding: unused |
2307 | */ | |
2308 | int frame_skip_factor; | |
0fd6aea1 MN |
2309 | |
2310 | /** | |
2311 | * frame skip exponent | |
f5bccd85 | 2312 | * - encoding: Set by user. |
0fd6aea1 MN |
2313 | * - decoding: unused |
2314 | */ | |
2315 | int frame_skip_exp; | |
2316 | ||
2317 | /** | |
f5bccd85 DB |
2318 | * frame skip comparison function |
2319 | * - encoding: Set by user. | |
0fd6aea1 MN |
2320 | * - decoding: unused |
2321 | */ | |
2322 | int frame_skip_cmp; | |
957c743a CM |
2323 | |
2324 | /** | |
f5bccd85 | 2325 | * Border processing masking, raises the quantizer for mbs on the borders |
957c743a | 2326 | * of the picture. |
f5bccd85 | 2327 | * - encoding: Set by user. |
957c743a CM |
2328 | * - decoding: unused |
2329 | */ | |
2330 | float border_masking; | |
6e0d8c06 MN |
2331 | |
2332 | /** | |
f5bccd85 DB |
2333 | * minimum MB lagrange multipler |
2334 | * - encoding: Set by user. | |
6e0d8c06 MN |
2335 | * - decoding: unused |
2336 | */ | |
2337 | int mb_lmin; | |
2338 | ||
2339 | /** | |
f5bccd85 DB |
2340 | * maximum MB lagrange multipler |
2341 | * - encoding: Set by user. | |
6e0d8c06 MN |
2342 | * - decoding: unused |
2343 | */ | |
2344 | int mb_lmax; | |
09c3e44e MN |
2345 | |
2346 | /** | |
115329f1 | 2347 | * |
f5bccd85 | 2348 | * - encoding: Set by user. |
09c3e44e MN |
2349 | * - decoding: unused |
2350 | */ | |
2351 | int me_penalty_compensation; | |
8c3eba7c MN |
2352 | |
2353 | /** | |
115329f1 | 2354 | * |
8c3eba7c | 2355 | * - encoding: unused |
f5bccd85 | 2356 | * - decoding: Set by user. |
8c3eba7c MN |
2357 | */ |
2358 | enum AVDiscard skip_loop_filter; | |
2359 | ||
2360 | /** | |
115329f1 | 2361 | * |
8c3eba7c | 2362 | * - encoding: unused |
f5bccd85 | 2363 | * - decoding: Set by user. |
8c3eba7c MN |
2364 | */ |
2365 | enum AVDiscard skip_idct; | |
2366 | ||
2367 | /** | |
115329f1 | 2368 | * |
8c3eba7c | 2369 | * - encoding: unused |
f5bccd85 | 2370 | * - decoding: Set by user. |
8c3eba7c MN |
2371 | */ |
2372 | enum AVDiscard skip_frame; | |
316a2ec8 MN |
2373 | |
2374 | /** | |
2375 | * | |
f5bccd85 | 2376 | * - encoding: Set by user. |
316a2ec8 MN |
2377 | * - decoding: unused |
2378 | */ | |
2379 | int bidir_refine; | |
e8501c93 MN |
2380 | |
2381 | /** | |
2382 | * | |
f5bccd85 | 2383 | * - encoding: Set by user. |
e8501c93 MN |
2384 | * - decoding: unused |
2385 | */ | |
2386 | int brd_scale; | |
58f7833e RS |
2387 | |
2388 | /** | |
2389 | * constant rate factor - quality-based VBR - values ~correspond to qps | |
f5bccd85 | 2390 | * - encoding: Set by user. |
58f7833e RS |
2391 | * - decoding: unused |
2392 | */ | |
9f1c1c99 | 2393 | float crf; |
58f7833e RS |
2394 | |
2395 | /** | |
2396 | * constant quantization parameter rate control method | |
f5bccd85 | 2397 | * - encoding: Set by user. |
58f7833e RS |
2398 | * - decoding: unused |
2399 | */ | |
2400 | int cqp; | |
2401 | ||
2402 | /** | |
f5bccd85 DB |
2403 | * minimum GOP size |
2404 | * - encoding: Set by user. | |
58f7833e RS |
2405 | * - decoding: unused |
2406 | */ | |
2407 | int keyint_min; | |
2408 | ||
2409 | /** | |
2410 | * number of reference frames | |
f5bccd85 | 2411 | * - encoding: Set by user. |
53d55e9e | 2412 | * - decoding: Set by lavc. |
58f7833e RS |
2413 | */ |
2414 | int refs; | |
2415 | ||
2416 | /** | |
2417 | * chroma qp offset from luma | |
f5bccd85 | 2418 | * - encoding: Set by user. |
58f7833e RS |
2419 | * - decoding: unused |
2420 | */ | |
2421 | int chromaoffset; | |
2422 | ||
2423 | /** | |
f5bccd85 DB |
2424 | * Influences how often B-frames are used. |
2425 | * - encoding: Set by user. | |
58f7833e RS |
2426 | * - decoding: unused |
2427 | */ | |
2428 | int bframebias; | |
2429 | ||
2430 | /** | |
2431 | * trellis RD quantization | |
f5bccd85 | 2432 | * - encoding: Set by user. |
58f7833e RS |
2433 | * - decoding: unused |
2434 | */ | |
2435 | int trellis; | |
2436 | ||
2437 | /** | |
f5bccd85 DB |
2438 | * Reduce fluctuations in qp (before curve compression). |
2439 | * - encoding: Set by user. | |
58f7833e RS |
2440 | * - decoding: unused |
2441 | */ | |
2442 | float complexityblur; | |
2443 | ||
2444 | /** | |
2445 | * in-loop deblocking filter alphac0 parameter | |
2446 | * alpha is in the range -6...6 | |
f5bccd85 | 2447 | * - encoding: Set by user. |
58f7833e RS |
2448 | * - decoding: unused |
2449 | */ | |
2450 | int deblockalpha; | |
2451 | ||
2452 | /** | |
2453 | * in-loop deblocking filter beta parameter | |
2454 | * beta is in the range -6...6 | |
f5bccd85 | 2455 | * - encoding: Set by user. |
58f7833e RS |
2456 | * - decoding: unused |
2457 | */ | |
2458 | int deblockbeta; | |
2459 | ||
2460 | /** | |
2461 | * macroblock subpartition sizes to consider - p8x8, p4x4, b8x8, i8x8, i4x4 | |
f5bccd85 | 2462 | * - encoding: Set by user. |
58f7833e RS |
2463 | * - decoding: unused |
2464 | */ | |
2465 | int partitions; | |
56cc85a0 DB |
2466 | #define X264_PART_I4X4 0x001 /* Analyze i4x4 */ |
2467 | #define X264_PART_I8X8 0x002 /* Analyze i8x8 (requires 8x8 transform) */ | |
2468 | #define X264_PART_P8X8 0x010 /* Analyze p16x8, p8x16 and p8x8 */ | |
2469 | #define X264_PART_P4X4 0x020 /* Analyze p8x4, p4x8, p4x4 */ | |
2470 | #define X264_PART_B8X8 0x100 /* Analyze b16x8, b8x16 and b8x8 */ | |
58f7833e RS |
2471 | |
2472 | /** | |
30ab4ded | 2473 | * direct MV prediction mode - 0 (none), 1 (spatial), 2 (temporal), 3 (auto) |
f5bccd85 | 2474 | * - encoding: Set by user. |
58f7833e RS |
2475 | * - decoding: unused |
2476 | */ | |
2477 | int directpred; | |
4f59b684 | 2478 | |
14f0c8e2 | 2479 | /** |
02c164c1 | 2480 | * Audio cutoff bandwidth (0 means "automatic") |
f5bccd85 | 2481 | * - encoding: Set by user. |
14f0c8e2 LA |
2482 | * - decoding: unused |
2483 | */ | |
2484 | int cutoff; | |
39a64e30 CH |
2485 | |
2486 | /** | |
f5bccd85 DB |
2487 | * Multiplied by qscale for each frame and added to scene_change_score. |
2488 | * - encoding: Set by user. | |
39a64e30 CH |
2489 | * - decoding: unused |
2490 | */ | |
2491 | int scenechange_factor; | |
1dd509b1 MN |
2492 | |
2493 | /** | |
2494 | * | |
f5bccd85 DB |
2495 | * Note: Value depends upon the compare function used for fullpel ME. |
2496 | * - encoding: Set by user. | |
1dd509b1 MN |
2497 | * - decoding: unused |
2498 | */ | |
2499 | int mv0_threshold; | |
f9243d34 CH |
2500 | |
2501 | /** | |
f5bccd85 DB |
2502 | * Adjusts sensitivity of b_frame_strategy 1. |
2503 | * - encoding: Set by user. | |
f9243d34 CH |
2504 | * - decoding: unused |
2505 | */ | |
2506 | int b_sensitivity; | |
a403fc03 JR |
2507 | |
2508 | /** | |
f5bccd85 | 2509 | * - encoding: Set by user. |
a403fc03 JR |
2510 | * - decoding: unused |
2511 | */ | |
2512 | int compression_level; | |
2513 | #define FF_COMPRESSION_DEFAULT -1 | |
2514 | ||
0743de4f | 2515 | #if FF_API_USE_LPC |
a403fc03 | 2516 | /** |
f5bccd85 DB |
2517 | * Sets whether to use LPC mode - used by FLAC encoder. |
2518 | * - encoding: Set by user. | |
2519 | * - decoding: unused | |
23940f14 | 2520 | * @deprecated Deprecated in favor of lpc_type and lpc_passes. |
a403fc03 JR |
2521 | */ |
2522 | int use_lpc; | |
23940f14 | 2523 | #endif |
a403fc03 JR |
2524 | |
2525 | /** | |
2526 | * LPC coefficient precision - used by FLAC encoder | |
f5bccd85 DB |
2527 | * - encoding: Set by user. |
2528 | * - decoding: unused | |
a403fc03 JR |
2529 | */ |
2530 | int lpc_coeff_precision; | |
2531 | ||
2532 | /** | |
f5bccd85 DB |
2533 | * - encoding: Set by user. |
2534 | * - decoding: unused | |
a403fc03 JR |
2535 | */ |
2536 | int min_prediction_order; | |
2537 | ||
2538 | /** | |
f5bccd85 DB |
2539 | * - encoding: Set by user. |
2540 | * - decoding: unused | |
a403fc03 JR |
2541 | */ |
2542 | int max_prediction_order; | |
2543 | ||
2544 | /** | |
2545 | * search method for selecting prediction order | |
f5bccd85 DB |
2546 | * - encoding: Set by user. |
2547 | * - decoding: unused | |
a403fc03 JR |
2548 | */ |
2549 | int prediction_order_method; | |
2550 | ||
2551 | /** | |
f5bccd85 DB |
2552 | * - encoding: Set by user. |
2553 | * - decoding: unused | |
a403fc03 JR |
2554 | */ |
2555 | int min_partition_order; | |
2556 | ||
2557 | /** | |
f5bccd85 DB |
2558 | * - encoding: Set by user. |
2559 | * - decoding: unused | |
a403fc03 JR |
2560 | */ |
2561 | int max_partition_order; | |
80d617f5 BC |
2562 | |
2563 | /** | |
2564 | * GOP timecode frame start number, in non drop frame format | |
f5bccd85 DB |
2565 | * - encoding: Set by user. |
2566 | * - decoding: unused | |
80d617f5 BC |
2567 | */ |
2568 | int64_t timecode_frame_start; | |
b1ec601f | 2569 | |
0d72e7d0 | 2570 | #if LIBAVCODEC_VERSION_MAJOR < 53 |
b1ec601f | 2571 | /** |
85947156 VS |
2572 | * Decoder should decode to this many channels if it can (0 for default) |
2573 | * - encoding: unused | |
2574 | * - decoding: Set by user. | |
0d72e7d0 | 2575 | * @deprecated Deprecated in favor of request_channel_layout. |
b1ec601f RD |
2576 | */ |
2577 | int request_channels; | |
0d72e7d0 | 2578 | #endif |
1408352a JR |
2579 | |
2580 | /** | |
2581 | * Percentage of dynamic range compression to be applied by the decoder. | |
2582 | * The default value is 1.0, corresponding to full compression. | |
2583 | * - encoding: unused | |
2584 | * - decoding: Set by user. | |
2585 | */ | |
2586 | float drc_scale; | |
79de84f2 MN |
2587 | |
2588 | /** | |
2589 | * opaque 64bit number (generally a PTS) that will be reordered and | |
2590 | * output in AVFrame.reordered_opaque | |
81c623fa | 2591 | * @deprecated in favor of pkt_pts |
79de84f2 MN |
2592 | * - encoding: unused |
2593 | * - decoding: Set by user. | |
2594 | */ | |
2595 | int64_t reordered_opaque; | |
312420f3 PR |
2596 | |
2597 | /** | |
2598 | * Bits per sample/pixel of internal libavcodec pixel/sample format. | |
5d6e4c16 | 2599 | * This field is applicable only when sample_fmt is AV_SAMPLE_FMT_S32. |
312420f3 PR |
2600 | * - encoding: set by user. |
2601 | * - decoding: set by libavcodec. | |
2602 | */ | |
2603 | int bits_per_raw_sample; | |
0d72e7d0 PR |
2604 | |
2605 | /** | |
2606 | * Audio channel layout. | |
2607 | * - encoding: set by user. | |
2608 | * - decoding: set by libavcodec. | |
2609 | */ | |
2610 | int64_t channel_layout; | |
2611 | ||
2612 | /** | |
2613 | * Request decoder to use this channel layout if it can (0 for default) | |
2614 | * - encoding: unused | |
2615 | * - decoding: Set by user. | |
2616 | */ | |
2617 | int64_t request_channel_layout; | |
3bff4d8b BC |
2618 | |
2619 | /** | |
2620 | * Ratecontrol attempt to use, at maximum, <value> of what can be used without an underflow. | |
2621 | * - encoding: Set by user. | |
2622 | * - decoding: unused. | |
2623 | */ | |
2624 | float rc_max_available_vbv_use; | |
2625 | ||
2626 | /** | |
2627 | * Ratecontrol attempt to use, at least, <value> times the amount needed to prevent a vbv overflow. | |
2628 | * - encoding: Set by user. | |
2629 | * - decoding: unused. | |
2630 | */ | |
2631 | float rc_min_vbv_overflow_use; | |
40e5d31b GB |
2632 | |
2633 | /** | |
2634 | * Hardware accelerator in use | |
2635 | * - encoding: unused. | |
2636 | * - decoding: Set by libavcodec | |
2637 | */ | |
2638 | struct AVHWAccel *hwaccel; | |
3797c74b MN |
2639 | |
2640 | /** | |
2641 | * For some codecs, the time base is closer to the field rate than the frame rate. | |
2642 | * Most notably, H.264 and MPEG-2 specify time_base as half of frame duration | |
2643 | * if no telecine is used ... | |
2644 | * | |
2645 | * Set to time_base ticks per frame. Default 1, e.g., H.264/MPEG-2 set it to 2. | |
2646 | */ | |
2647 | int ticks_per_frame; | |
1aea7018 GB |
2648 | |
2649 | /** | |
2650 | * Hardware accelerator context. | |
2651 | * For some hardware accelerators, a global context needs to be | |
2652 | * provided by the user. In that case, this holds display-dependent | |
2653 | * data FFmpeg cannot instantiate itself. Please refer to the | |
2654 | * FFmpeg HW accelerator documentation to know how to fill this | |
2655 | * is. e.g. for VA API, this is a struct vaapi_context. | |
2656 | * - encoding: unused | |
2657 | * - decoding: Set by user | |
2658 | */ | |
2659 | void *hwaccel_context; | |
4ee6a5c1 MN |
2660 | |
2661 | /** | |
2662 | * Chromaticity coordinates of the source primaries. | |
2663 | * - encoding: Set by user | |
2664 | * - decoding: Set by libavcodec | |
2665 | */ | |
2666 | enum AVColorPrimaries color_primaries; | |
2667 | ||
2668 | /** | |
2669 | * Color Transfer Characteristic. | |
2670 | * - encoding: Set by user | |
2671 | * - decoding: Set by libavcodec | |
2672 | */ | |
2673 | enum AVColorTransferCharacteristic color_trc; | |
2674 | ||
2675 | /** | |
2676 | * YUV colorspace type. | |
2677 | * - encoding: Set by user | |
2678 | * - decoding: Set by libavcodec | |
2679 | */ | |
2680 | enum AVColorSpace colorspace; | |
2681 | ||
2682 | /** | |
2683 | * MPEG vs JPEG YUV range. | |
2684 | * - encoding: Set by user | |
2685 | * - decoding: Set by libavcodec | |
2686 | */ | |
2687 | enum AVColorRange color_range; | |
580a7465 DC |
2688 | |
2689 | /** | |
2690 | * This defines the location of chroma samples. | |
2691 | * - encoding: Set by user | |
2692 | * - decoding: Set by libavcodec | |
2693 | */ | |
8ea08bec | 2694 | enum AVChromaLocation chroma_sample_location; |
8d23a86f RD |
2695 | |
2696 | /** | |
2697 | * The codec may call this to execute several independent things. | |
2698 | * It will return only after finishing all tasks. | |
2699 | * The user may replace this with some multithreaded implementation, | |
2700 | * the default implementation will execute the parts serially. | |
2701 | * Also see avcodec_thread_init and e.g. the --enable-pthread configure option. | |
2702 | * @param c context passed also to func | |
2703 | * @param count the number of things to execute | |
2704 | * @param arg2 argument passed unchanged to func | |
2705 | * @param ret return values of executed functions, must have space for "count" values. May be NULL. | |
2706 | * @param func function that will be called count times, with jobnr from 0 to count-1. | |
2707 | * threadnr will be in the range 0 to c->thread_count-1 < MAX_THREADS and so that no | |
2708 | * two instances of func executing at the same time will have the same threadnr. | |
2709 | * @return always 0 currently, but code should handle a future improvement where when any call to func | |
2710 | * returns < 0 no further calls to func may be done and < 0 is returned. | |
2711 | * - encoding: Set by libavcodec, user can override. | |
2712 | * - decoding: Set by libavcodec, user can override. | |
2713 | */ | |
2714 | int (*execute2)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg, int jobnr, int threadnr), void *arg2, int *ret, int count); | |
096c87f6 JGG |
2715 | |
2716 | /** | |
2717 | * explicit P-frame weighted prediction analysis method | |
2718 | * 0: off | |
2719 | * 1: fast blind weighting (one reference duplicate with -1 offset) | |
2720 | * 2: smart weighting (full fade detection analysis) | |
2721 | * - encoding: Set by user. | |
2722 | * - decoding: unused | |
2723 | */ | |
2724 | int weighted_p_pred; | |
f3b3b489 BC |
2725 | |
2726 | /** | |
2727 | * AQ mode | |
2728 | * 0: Disabled | |
2729 | * 1: Variance AQ (complexity mask) | |
2730 | * 2: Auto-variance AQ (experimental) | |
2731 | * - encoding: Set by user | |
2732 | * - decoding: unused | |
2733 | */ | |
2734 | int aq_mode; | |
2735 | ||
2736 | /** | |
2737 | * AQ strength | |
2738 | * Reduces blocking and blurring in flat and textured areas. | |
2739 | * - encoding: Set by user | |
2740 | * - decoding: unused | |
2741 | */ | |
2742 | float aq_strength; | |
2743 | ||
2744 | /** | |
2745 | * PSY RD | |
2746 | * Strength of psychovisual optimization | |
2747 | * - encoding: Set by user | |
2748 | * - decoding: unused | |
2749 | */ | |
2750 | float psy_rd; | |
2751 | ||
2752 | /** | |
2753 | * PSY trellis | |
2754 | * Strength of psychovisual optimization | |
2755 | * - encoding: Set by user | |
2756 | * - decoding: unused | |
2757 | */ | |
2758 | float psy_trellis; | |
2759 | ||
2760 | /** | |
2761 | * RC lookahead | |
2762 | * Number of frames for frametype and ratecontrol lookahead | |
2763 | * - encoding: Set by user | |
2764 | * - decoding: unused | |
2765 | */ | |
2766 | int rc_lookahead; | |
e8c7fca9 JGG |
2767 | |
2768 | /** | |
2769 | * Constant rate factor maximum | |
2770 | * With CRF encoding mode and VBV restrictions enabled, prevents quality from being worse | |
2771 | * than crf_max, even if doing so would violate VBV restrictions. | |
2772 | * - encoding: Set by user. | |
2773 | * - decoding: unused | |
2774 | */ | |
2775 | float crf_max; | |
fecd7b45 SS |
2776 | |
2777 | int log_level_offset; | |
23940f14 JR |
2778 | |
2779 | /** | |
2780 | * Determines which LPC analysis algorithm to use. | |
2781 | * - encoding: Set by user | |
2782 | * - decoding: unused | |
2783 | */ | |
2784 | enum AVLPCType lpc_type; | |
2785 | ||
2786 | /** | |
2787 | * Number of passes to use for Cholesky factorization during LPC analysis | |
2788 | * - encoding: Set by user | |
2789 | * - decoding: unused | |
2790 | */ | |
2791 | int lpc_passes; | |
2aa72ecc JZ |
2792 | |
2793 | /** | |
2794 | * Number of slices. | |
2795 | * Indicates number of picture subdivisions. Used for parallelized | |
2796 | * decoding. | |
2797 | * - encoding: Set by user | |
2798 | * - decoding: unused | |
2799 | */ | |
2800 | int slices; | |
cb2c971d AJ |
2801 | |
2802 | /** | |
2803 | * Header containing style information for text subtitles. | |
2804 | * For SUBTITLE_ASS subtitle type, it should contain the whole ASS | |
2805 | * [Script Info] and [V4+ Styles] section, plus the [Events] line and | |
2806 | * the Format line following. It shouldn't include any Dialogue line. | |
2807 | * - encoding: Set/allocated/freed by user (before avcodec_open()) | |
2808 | * - decoding: Set/allocated/freed by libavcodec (by avcodec_open()) | |
2809 | */ | |
2810 | uint8_t *subtitle_header; | |
2811 | int subtitle_header_size; | |
393cbb96 MN |
2812 | |
2813 | /** | |
2814 | * Current packet as passed into the decoder, to avoid having | |
2815 | * to pass the packet into every function. Currently only valid | |
2816 | * inside lavc and get/release_buffer callbacks. | |
2817 | * - decoding: set by avcodec_decode_*, read by get_buffer() for setting pkt_pts | |
2818 | * - encoding: unused | |
2819 | */ | |
2820 | AVPacket *pkt; | |
37b00b47 AS |
2821 | |
2822 | /** | |
2823 | * Whether this is a copy of the context which had init() called on it. | |
2824 | * This is used by multithreading - shared tables and picture pointers | |
2825 | * should be freed from the original context only. | |
2826 | * - encoding: Set by libavcodec. | |
2827 | * - decoding: Set by libavcodec. | |
2828 | */ | |
2829 | int is_copy; | |
2830 | ||
2831 | /** | |
2832 | * Which multithreading methods to use. | |
2833 | * Use of FF_THREAD_FRAME will increase decoding delay by one frame per thread, | |
2834 | * so clients which cannot provide future frames should not use it. | |
2835 | * | |
2836 | * - encoding: Set by user, otherwise the default is used. | |
2837 | * - decoding: Set by user, otherwise the default is used. | |
2838 | */ | |
2839 | int thread_type; | |
2840 | #define FF_THREAD_FRAME 1 //< Decode more than one frame at once | |
2841 | #define FF_THREAD_SLICE 2 //< Decode more than one part of a single frame at once | |
2842 | ||
2843 | /** | |
2844 | * Which multithreading methods are in use by the codec. | |
2845 | * - encoding: Set by libavcodec. | |
2846 | * - decoding: Set by libavcodec. | |
2847 | */ | |
2848 | int active_thread_type; | |
2849 | ||
2850 | /** | |
2851 | * Set by the client if its custom get_buffer() callback can be called | |
2852 | * from another thread, which allows faster multithreaded decoding. | |
2853 | * draw_horiz_band() will be called from other threads regardless of this setting. | |
2854 | * Ignored if the default get_buffer() is used. | |
2855 | * - encoding: Set by user. | |
2856 | * - decoding: Set by user. | |
2857 | */ | |
2858 | int thread_safe_callbacks; | |
55bad0c6 CM |
2859 | |
2860 | /** | |
2861 | * VBV delay coded in the last frame (in periods of a 27 MHz clock). | |
2862 | * Used for compliant TS muxing. | |
2863 | * - encoding: Set by libavcodec. | |
2864 | * - decoding: unused. | |
2865 | */ | |
2866 | uint64_t vbv_delay; | |
de6d9b64 FB |
2867 | } AVCodecContext; |
2868 | ||
64863965 | 2869 | /** |
060ec0a8 AH |
2870 | * AVProfile. |
2871 | */ | |
2872 | typedef struct AVProfile { | |
2873 | int profile; | |
2874 | const char *name; ///< short name for the profile | |
2875 | } AVProfile; | |
2876 | ||
2877 | /** | |
64863965 MN |
2878 | * AVCodec. |
2879 | */ | |
de6d9b64 | 2880 | typedef struct AVCodec { |
6b0cdb6e NG |
2881 | /** |
2882 | * Name of the codec implementation. | |
2883 | * The name is globally unique among encoders and among decoders (but an | |
2884 | * encoder and a decoder can share the same name). | |
2885 | * This is the primary way to find a codec from the user perspective. | |
2886 | */ | |
18f77016 | 2887 | const char *name; |
72415b2a | 2888 | enum AVMediaType type; |
9297ddd3 | 2889 | enum CodecID id; |
de6d9b64 FB |
2890 | int priv_data_size; |
2891 | int (*init)(AVCodecContext *); | |
0c1a9eda | 2892 | int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data); |
de6d9b64 | 2893 | int (*close)(AVCodecContext *); |
7a00bbad | 2894 | int (*decode)(AVCodecContext *, void *outdata, int *outdata_size, AVPacket *avpkt); |
a2d11246 MN |
2895 | /** |
2896 | * Codec capabilities. | |
2897 | * see CODEC_CAP_* | |
2898 | */ | |
bf89e6b1 | 2899 | int capabilities; |
de6d9b64 | 2900 | struct AVCodec *next; |
c8cf325a MN |
2901 | /** |
2902 | * Flush buffers. | |
2903 | * Will be called when seeking | |
2904 | */ | |
7a06ff14 | 2905 | void (*flush)(AVCodecContext *); |
716e31ea | 2906 | const AVRational *supported_framerates; ///< array of supported framerates, or NULL if any, array is terminated by {0,0} |
1beb670a | 2907 | const enum PixelFormat *pix_fmts; ///< array of supported pixel formats, or NULL if unknown, array is terminated by -1 |
fe4bf374 | 2908 | /** |
bf7e799c SS |
2909 | * Descriptive name for the codec, meant to be more human readable than name. |
2910 | * You should use the NULL_IF_CONFIG_SMALL() macro to define it. | |
fe4bf374 SS |
2911 | */ |
2912 | const char *long_name; | |
3ade5d56 | 2913 | const int *supported_samplerates; ///< array of supported audio samplerates, or NULL if unknown, array is terminated by 0 |
5d6e4c16 | 2914 | const enum AVSampleFormat *sample_fmts; ///< array of supported sample formats, or NULL if unknown, array is terminated by -1 |
0d72e7d0 | 2915 | const int64_t *channel_layouts; ///< array of support channel layouts, or NULL if unknown. array is terminated by 0 |
0fd0ef79 | 2916 | uint8_t max_lowres; ///< maximum value for lowres supported by the decoder |
655c36b2 | 2917 | AVClass *priv_class; ///< AVClass for the private context |
060ec0a8 | 2918 | const AVProfile *profiles; ///< array of recognized profiles, or NULL if unknown, array is terminated by {FF_PROFILE_UNKNOWN} |
37b00b47 AS |
2919 | |
2920 | /** | |
2921 | * @defgroup framethreading Frame-level threading support functions. | |
2922 | * @{ | |
2923 | */ | |
2924 | /** | |
2925 | * If defined, called on thread contexts when they are created. | |
2926 | * If the codec allocates writable tables in init(), re-allocate them here. | |
2927 | * priv_data will be set to a copy of the original. | |
2928 | */ | |
2929 | int (*init_thread_copy)(AVCodecContext *); | |
2930 | /** | |
2931 | * Copy necessary context variables from a previous thread context to the current one. | |
2932 | * If not defined, the next thread will start automatically; otherwise, the codec | |
2933 | * must call ff_thread_finish_setup(). | |
2934 | * | |
2935 | * dst and src will (rarely) point to the same context, in which case memcpy should be skipped. | |
2936 | */ | |
2937 | int (*update_thread_context)(AVCodecContext *dst, const AVCodecContext *src); | |
2938 | /** @} */ | |
de6d9b64 FB |
2939 | } AVCodec; |
2940 | ||
97d96aaa | 2941 | /** |
40e5d31b GB |
2942 | * AVHWAccel. |
2943 | */ | |
2944 | typedef struct AVHWAccel { | |
2945 | /** | |
2946 | * Name of the hardware accelerated codec. | |
2947 | * The name is globally unique among encoders and among decoders (but an | |
2948 | * encoder and a decoder can share the same name). | |
2949 | */ | |
2950 | const char *name; | |
2951 | ||
2952 | /** | |
2953 | * Type of codec implemented by the hardware accelerator. | |
2954 | * | |
72415b2a | 2955 | * See AVMEDIA_TYPE_xxx |
40e5d31b | 2956 | */ |
72415b2a | 2957 | enum AVMediaType type; |
40e5d31b GB |
2958 | |
2959 | /** | |
2960 | * Codec implemented by the hardware accelerator. | |
2961 | * | |
2962 | * See CODEC_ID_xxx | |
2963 | */ | |
2964 | enum CodecID id; | |
2965 | ||
2966 | /** | |
2967 | * Supported pixel format. | |
2968 | * | |
2969 | * Only hardware accelerated formats are supported here. | |
2970 | */ | |
2971 | enum PixelFormat pix_fmt; | |
2972 | ||
2973 | /** | |
2974 | * Hardware accelerated codec capabilities. | |
2975 | * see FF_HWACCEL_CODEC_CAP_* | |
2976 | */ | |
2977 | int capabilities; | |
2978 | ||
2979 | struct AVHWAccel *next; | |
2980 | ||
2981 | /** | |
2982 | * Called at the beginning of each frame or field picture. | |
2983 | * | |
2984 | * Meaningful frame information (codec specific) is guaranteed to | |
2985 | * be parsed at this point. This function is mandatory. | |
2986 | * | |
bf7e799c | 2987 | * Note that buf can be NULL along with buf_size set to 0. |
40e5d31b GB |
2988 | * Otherwise, this means the whole frame is available at this point. |
2989 | * | |
2990 | * @param avctx the codec context | |
2991 | * @param buf the frame data buffer base | |
2992 | * @param buf_size the size of the frame in bytes | |
2993 | * @return zero if successful, a negative value otherwise | |
2994 | */ | |
2995 | int (*start_frame)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size); | |
2996 | ||
2997 | /** | |
2998 | * Callback for each slice. | |
2999 | * | |
3000 | * Meaningful slice information (codec specific) is guaranteed to | |
3001 | * be parsed at this point. This function is mandatory. | |
3002 | * | |
3003 | * @param avctx the codec context | |
3004 | * @param buf the slice data buffer base | |
3005 | * @param buf_size the size of the slice in bytes | |
3006 | * @return zero if successful, a negative value otherwise | |
3007 | */ | |
3008 | int (*decode_slice)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size); | |
3009 | ||
3010 | /** | |
3011 | * Called at the end of each frame or field picture. | |
3012 | * | |
3013 | * The whole picture is parsed at this point and can now be sent | |
3014 | * to the hardware accelerator. This function is mandatory. | |
3015 | * | |
3016 | * @param avctx the codec context | |
3017 | * @return zero if successful, a negative value otherwise | |
3018 | */ | |
3019 | int (*end_frame)(AVCodecContext *avctx); | |
68e5d523 GB |
3020 | |
3021 | /** | |
3022 | * Size of HW accelerator private data. | |
3023 | * | |
cd823ff9 GB |
3024 | * Private data is allocated with av_mallocz() before |
3025 | * AVCodecContext.get_buffer() and deallocated after | |
3026 | * AVCodecContext.release_buffer(). | |
68e5d523 GB |
3027 | */ |
3028 | int priv_data_size; | |
40e5d31b GB |
3029 | } AVHWAccel; |
3030 | ||
3031 | /** | |
d7425f59 MN |
3032 | * four components are given, that's all. |
3033 | * the last component is alpha | |
3034 | */ | |
de6d9b64 | 3035 | typedef struct AVPicture { |
0c1a9eda | 3036 | uint8_t *data[4]; |
cd394651 | 3037 | int linesize[4]; ///< number of bytes per line |
de6d9b64 FB |
3038 | } AVPicture; |
3039 | ||
eda7c983 | 3040 | #if FF_API_PALETTE_CONTROL |
ba118447 | 3041 | /** |
85947156 VS |
3042 | * AVPaletteControl |
3043 | * This structure defines a method for communicating palette changes | |
3044 | * between and demuxer and a decoder. | |
3045 | * | |
671adb17 | 3046 | * @deprecated Use AVPacket to send palette changes instead. |
85947156 | 3047 | * This is totally broken. |
ba118447 | 3048 | */ |
2e99641b | 3049 | #define AVPALETTE_SIZE 1024 |
432d84c3 | 3050 | #define AVPALETTE_COUNT 256 |
ba118447 MM |
3051 | typedef struct AVPaletteControl { |
3052 | ||
f5bccd85 DB |
3053 | /* Demuxer sets this to 1 to indicate the palette has changed; |
3054 | * decoder resets to 0. */ | |
ba118447 MM |
3055 | int palette_changed; |
3056 | ||
2a2bbcb0 MM |
3057 | /* 4-byte ARGB palette entries, stored in native byte order; note that |
3058 | * the individual palette components should be on a 8-bit scale; if | |
f5bccd85 DB |
3059 | * the palette data comes from an IBM VGA native format, the component |
3060 | * data is probably 6 bits in size and needs to be scaled. */ | |
2e99641b | 3061 | unsigned int palette[AVPALETTE_COUNT]; |
ba118447 | 3062 | |
18239edf | 3063 | } AVPaletteControl attribute_deprecated; |
2bbd8571 | 3064 | #endif |
ba118447 | 3065 | |
c66216ed MN |
3066 | enum AVSubtitleType { |
3067 | SUBTITLE_NONE, | |
3068 | ||
3069 | SUBTITLE_BITMAP, ///< A bitmap, pict will be set | |
3070 | ||
3071 | /** | |
3072 | * Plain text, the text field must be set by the decoder and is | |
3073 | * authoritative. ass and pict fields may contain approximations. | |
3074 | */ | |
3075 | SUBTITLE_TEXT, | |
3076 | ||
3077 | /** | |
3078 | * Formatted text, the ass field must be set by the decoder and is | |
3079 | * authoritative. pict and text fields may contain approximations. | |
3080 | */ | |
3081 | SUBTITLE_ASS, | |
3082 | }; | |
3083 | ||
c6ec28b1 | 3084 | typedef struct AVSubtitleRect { |
ebc466bb MN |
3085 | int x; ///< top left corner of pict, undefined when pict is not set |
3086 | int y; ///< top left corner of pict, undefined when pict is not set | |
3087 | int w; ///< width of pict, undefined when pict is not set | |
3088 | int h; ///< height of pict, undefined when pict is not set | |
3089 | int nb_colors; ///< number of colors in pict, undefined when pict is not set | |
25b4c651 MN |
3090 | |
3091 | /** | |
3092 | * data+linesize for the bitmap of this subtitle. | |
3093 | * can be set for text/ass as well once they where rendered | |
3094 | */ | |
3095 | AVPicture pict; | |
f656106f MN |
3096 | enum AVSubtitleType type; |
3097 | ||
3098 | char *text; ///< 0 terminated plain UTF-8 text | |
3099 | ||
3100 | /** | |
3101 | * 0 terminated ASS/SSA compatible event line. | |
3102 | * The pressentation of this is unaffected by the other values in this | |
3103 | * struct. | |
3104 | */ | |
3105 | char *ass; | |
c6ec28b1 MN |
3106 | } AVSubtitleRect; |
3107 | ||
3108 | typedef struct AVSubtitle { | |
3109 | uint16_t format; /* 0 = graphics */ | |
3110 | uint32_t start_display_time; /* relative to packet pts, in ms */ | |
3111 | uint32_t end_display_time; /* relative to packet pts, in ms */ | |
ebc466bb | 3112 | unsigned num_rects; |
db4fac64 | 3113 | AVSubtitleRect **rects; |
4bbe788a | 3114 | int64_t pts; ///< Same as packet pts, in AV_TIME_BASE |
240c1657 FB |
3115 | } AVSubtitle; |
3116 | ||
cdd8930e TB |
3117 | /* packet functions */ |
3118 | ||
80d403fc RD |
3119 | /** |
3120 | * @deprecated use NULL instead | |
3121 | */ | |
3122 | attribute_deprecated void av_destruct_packet_nofree(AVPacket *pkt); | |
cdd8930e TB |
3123 | |
3124 | /** | |
3125 | * Default packet destructor. | |
3126 | */ | |
3127 | void av_destruct_packet(AVPacket *pkt); | |
3128 | ||
3129 | /** | |
3130 | * Initialize optional fields of a packet with default values. | |
3131 | * | |
3132 | * @param pkt packet | |
3133 | */ | |
3134 | void av_init_packet(AVPacket *pkt); | |
3135 | ||
3136 | /** | |
3137 | * Allocate the payload of a packet and initialize its fields with | |
3138 | * default values. | |
3139 | * | |
3140 | * @param pkt packet | |
3141 | * @param size wanted payload size | |
3142 | * @return 0 if OK, AVERROR_xxx otherwise | |
3143 | */ | |
3144 | int av_new_packet(AVPacket *pkt, int size); | |
3145 | ||
3146 | /** | |
feb993e5 RD |
3147 | * Reduce packet size, correctly zeroing padding |
3148 | * | |
3149 | * @param pkt packet | |
3150 | * @param size new size | |
3151 | */ | |
3152 | void av_shrink_packet(AVPacket *pkt, int size); | |
3153 | ||
3154 | /** | |
a08d918e RD |
3155 | * Increase packet size, correctly zeroing padding |
3156 | * | |
3157 | * @param pkt packet | |
3158 | * @param grow_by number of bytes by which to increase the size of the packet | |
3159 | */ | |
3160 | int av_grow_packet(AVPacket *pkt, int grow_by); | |
3161 | ||
3162 | /** | |
cdd8930e TB |
3163 | * @warning This is a hack - the packet memory allocation stuff is broken. The |
3164 | * packet is allocated if it was not really allocated. | |
3165 | */ | |
3166 | int av_dup_packet(AVPacket *pkt); | |
3167 | ||
3168 | /** | |
3169 | * Free a packet. | |
3170 | * | |
3171 | * @param pkt packet to free | |
3172 | */ | |
ce1d9c85 | 3173 | void av_free_packet(AVPacket *pkt); |
240c1657 | 3174 | |
de6d9b64 FB |
3175 | /* resample.c */ |
3176 | ||
3177 | struct ReSampleContext; | |
aaaf1635 | 3178 | struct AVResampleContext; |
de6d9b64 FB |
3179 | |
3180 | typedef struct ReSampleContext ReSampleContext; | |
3181 | ||
a377cfa6 | 3182 | #if FF_API_AUDIO_OLD |
d1e3c6fd BC |