RoQ audio encoder
[libav.git] / libavcodec / avcodec.h
CommitLineData
04d7f601
DB
1/*
2 * copyright (c) 2001 Fabrice Bellard
3 *
b78e7197
DB
4 * This file is part of FFmpeg.
5 *
6 * FFmpeg 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 *
b78e7197 11 * FFmpeg 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
b78e7197 17 * License along with FFmpeg; if not, write to the Free Software
04d7f601
DB
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
a96b68b7
FB
21#ifndef AVCODEC_H
22#define AVCODEC_H
23
36df8805
MN
24/**
25 * @file avcodec.h
f5bccd85 26 * external API header
36df8805
MN
27 */
28
29
02d697aa
ZK
30#ifdef __cplusplus
31extern "C" {
32#endif
33
c11c2bc2 34#include "avutil.h"
4b813d5c 35#include <sys/types.h> /* size_t */
de6d9b64 36
bb270c08 37#define AV_STRINGIFY(s) AV_TOSTRING(s)
7b7d86f1 38#define AV_TOSTRING(s) #s
5aa083ee 39
1e839177
BL
40#define LIBAVCODEC_VERSION_INT ((51<<16)+(40<<8)+4)
41#define LIBAVCODEC_VERSION 51.40.4
bb270c08 42#define LIBAVCODEC_BUILD LIBAVCODEC_VERSION_INT
5aa083ee 43
bb270c08 44#define LIBAVCODEC_IDENT "Lavc" AV_STRINGIFY(LIBAVCODEC_VERSION)
ce2749d2 45
8da9266c 46#define AV_NOPTS_VALUE INT64_C(0x8000000000000000)
bb270c08
DB
47#define AV_TIME_BASE 1000000
48#define AV_TIME_BASE_Q (AVRational){1, AV_TIME_BASE}
9740beff 49
7ebf5927
MN
50/**
51 *
f5bccd85
DB
52 * If you add a codec ID to this list, add it so that
53 * 1. no value of a existing codec ID changes (that would break ABI),
54 * 2. it is as close as possible to similar codecs.
7ebf5927 55 */
de6d9b64 56enum CodecID {
115329f1 57 CODEC_ID_NONE,
de6d9b64 58 CODEC_ID_MPEG1VIDEO,
f5bccd85 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,
17179d2d
MN
120 CODEC_ID_XVID,
121 CODEC_ID_PNG,
122 CODEC_ID_PPM,
123 CODEC_ID_PBM,
124 CODEC_ID_PGM,
125 CODEC_ID_PGMYUV,
126 CODEC_ID_PAM,
f37b9768 127 CODEC_ID_FFVHUFF,
3f05305d
MN
128 CODEC_ID_RV30,
129 CODEC_ID_RV40,
10b9c374 130 CODEC_ID_VC1,
21aa398f 131 CODEC_ID_WMV3,
9c7fb608 132 CODEC_ID_LOCO,
a8a15e9d 133 CODEC_ID_WNV1,
589f8220 134 CODEC_ID_AASC,
856dbbff 135 CODEC_ID_INDEO2,
b81f8949 136 CODEC_ID_FRAPS,
64af6168 137 CODEC_ID_TRUEMOTION2,
9fa62f2a 138 CODEC_ID_BMP,
e0f80bd7 139 CODEC_ID_CSCD,
4e114829 140 CODEC_ID_MMVIDEO,
9c8d8e84 141 CODEC_ID_ZMBV,
26376701 142 CODEC_ID_AVS,
348efc18 143 CODEC_ID_SMACKVIDEO,
dfca23e3 144 CODEC_ID_NUV,
fd7b1991 145 CODEC_ID_KMVC,
0919e788 146 CODEC_ID_FLASHSV,
20ffddb9 147 CODEC_ID_CAVS,
f31065f6 148 CODEC_ID_JPEG2000,
eb57c889 149 CODEC_ID_VMNC,
5ce117c3
AJ
150 CODEC_ID_VP5,
151 CODEC_ID_VP6,
152 CODEC_ID_VP6F,
3689cf16 153 CODEC_ID_TARGA,
72450e50 154 CODEC_ID_DSICINVIDEO,
29f86228 155 CODEC_ID_TIERTEXSEQVIDEO,
a991b1fe 156 CODEC_ID_TIFF,
06d392a7 157 CODEC_ID_GIF,
3edeab82 158 CODEC_ID_FFH264,
33a0dd37 159 CODEC_ID_DXA,
52b6bad2 160 CODEC_ID_DNXHD,
efb0c399 161 CODEC_ID_THP,
2d99eed1 162 CODEC_ID_SGI,
9a0ddd09 163 CODEC_ID_C93,
1e6c6759 164 CODEC_ID_BETHSOFTVID,
b46d68c6 165 CODEC_ID_PTX,
a96b68b7 166
f5bccd85 167 /* various PCM "codecs" */
17179d2d 168 CODEC_ID_PCM_S16LE= 0x10000,
a96b68b7
FB
169 CODEC_ID_PCM_S16BE,
170 CODEC_ID_PCM_U16LE,
171 CODEC_ID_PCM_U16BE,
172 CODEC_ID_PCM_S8,
173 CODEC_ID_PCM_U8,
174 CODEC_ID_PCM_MULAW,
175 CODEC_ID_PCM_ALAW,
b461b3bc
RD
176 CODEC_ID_PCM_S32LE,
177 CODEC_ID_PCM_S32BE,
178 CODEC_ID_PCM_U32LE,
179 CODEC_ID_PCM_U32BE,
180 CODEC_ID_PCM_S24LE,
181 CODEC_ID_PCM_S24BE,
182 CODEC_ID_PCM_U24LE,
183 CODEC_ID_PCM_U24BE,
184 CODEC_ID_PCM_S24DAUD,
0147f198 185
f5bccd85 186 /* various ADPCM codecs */
17179d2d 187 CODEC_ID_ADPCM_IMA_QT= 0x11000,
0147f198 188 CODEC_ID_ADPCM_IMA_WAV,
9937e686
MM
189 CODEC_ID_ADPCM_IMA_DK3,
190 CODEC_ID_ADPCM_IMA_DK4,
2fdf638b 191 CODEC_ID_ADPCM_IMA_WS,
7d8379f2 192 CODEC_ID_ADPCM_IMA_SMJPEG,
0147f198 193 CODEC_ID_ADPCM_MS,
e2a7bb28 194 CODEC_ID_ADPCM_4XM,
fc384777
MM
195 CODEC_ID_ADPCM_XA,
196 CODEC_ID_ADPCM_ADX,
7d8379f2 197 CODEC_ID_ADPCM_EA,
e5966052 198 CODEC_ID_ADPCM_G726,
b3bfb299 199 CODEC_ID_ADPCM_CT,
659c3692 200 CODEC_ID_ADPCM_SWF,
2ff4524e 201 CODEC_ID_ADPCM_YAMAHA,
2433f24f
AJ
202 CODEC_ID_ADPCM_SBPRO_4,
203 CODEC_ID_ADPCM_SBPRO_3,
204 CODEC_ID_ADPCM_SBPRO_2,
d1e0d21f 205 CODEC_ID_ADPCM_THP,
891f64b3 206
17179d2d
MN
207 /* AMR */
208 CODEC_ID_AMR_NB= 0x12000,
d663a1fd
MN
209 CODEC_ID_AMR_WB,
210
b8414bbd 211 /* RealAudio codecs*/
17179d2d 212 CODEC_ID_RA_144= 0x13000,
b8414bbd 213 CODEC_ID_RA_288,
3ef8be2b
MM
214
215 /* various DPCM codecs */
17179d2d 216 CODEC_ID_ROQ_DPCM= 0x14000,
3ef8be2b 217 CODEC_ID_INTERPLAY_DPCM,
9937e686 218 CODEC_ID_XAN_DPCM,
d08d7142 219 CODEC_ID_SOL_DPCM,
115329f1 220
17179d2d 221 CODEC_ID_MP2= 0x15000,
f5bccd85 222 CODEC_ID_MP3, /* preferred ID for decoding MPEG audio layer 1, 2 or 3 */
17179d2d 223 CODEC_ID_AAC,
cbee7a69 224#if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
17179d2d 225 CODEC_ID_MPEG4AAC,
cbee7a69 226#endif
17179d2d
MN
227 CODEC_ID_AC3,
228 CODEC_ID_DTS,
229 CODEC_ID_VORBIS,
230 CODEC_ID_DVAUDIO,
231 CODEC_ID_WMAV1,
232 CODEC_ID_WMAV2,
233 CODEC_ID_MACE3,
234 CODEC_ID_MACE6,
235 CODEC_ID_VMDAUDIO,
236 CODEC_ID_SONIC,
237 CODEC_ID_SONIC_LS,
ac2570a8 238 CODEC_ID_FLAC,
1ede228a 239 CODEC_ID_MP3ADU,
d2a7718d 240 CODEC_ID_MP3ON4,
85ad5695 241 CODEC_ID_SHORTEN,
5df8a0c6 242 CODEC_ID_ALAC,
034eeaa1 243 CODEC_ID_WESTWOOD_SND1,
f5bccd85 244 CODEC_ID_GSM, /* as in Berlin toast format */
d9b1c197 245 CODEC_ID_QDM2,
e0f7e329 246 CODEC_ID_COOK,
bf3027c8 247 CODEC_ID_TRUESPEECH,
a24c4a2a 248 CODEC_ID_TTA,
348efc18 249 CODEC_ID_SMACKAUDIO,
6c496518 250 CODEC_ID_QCELP,
730581f3 251 CODEC_ID_WAVPACK,
72450e50 252 CODEC_ID_DSICINAUDIO,
84ed36da 253 CODEC_ID_IMC,
185c7b6b 254 CODEC_ID_MUSEPACK7,
aad512b4 255 CODEC_ID_MLP,
f5bccd85 256 CODEC_ID_GSM_MS, /* as found in WAV */
10e26bc7 257 CODEC_ID_ATRAC3,
115329f1 258
240c1657 259 /* subtitle codecs */
115329f1
DB
260 CODEC_ID_DVD_SUBTITLE= 0x17000,
261 CODEC_ID_DVB_SUBTITLE,
262
f5bccd85
DB
263 CODEC_ID_MPEG2TS= 0x20000, /* _FAKE_ codec to indicate a raw MPEG-2 TS
264 * stream (only used by libavformat) */
de6d9b64 265};
dcedf586 266
abd6a4fc 267#if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
f5bccd85 268/* CODEC_ID_MP3LAME is obsolete */
dcedf586 269#define CODEC_ID_MP3LAME CODEC_ID_MP3
abd6a4fc
BC
270#define CODEC_ID_MPEG4AAC CODEC_ID_AAC
271#endif
de6d9b64
FB
272
273enum CodecType {
4a663d80 274 CODEC_TYPE_UNKNOWN = -1,
de6d9b64
FB
275 CODEC_TYPE_VIDEO,
276 CODEC_TYPE_AUDIO,
985180a1 277 CODEC_TYPE_DATA,
240c1657 278 CODEC_TYPE_SUBTITLE,
9ff77d17 279 CODEC_TYPE_NB
de6d9b64
FB
280};
281
f5bccd85
DB
282/* Currently unused, may be used if 24/32 bits samples are ever supported. */
283/* all in native-endian format */
a96b68b7 284enum SampleFormat {
9076fee4 285 SAMPLE_FMT_NONE = -1,
1319a77b
AB
286 SAMPLE_FMT_U8, ///< unsigned 8 bits
287 SAMPLE_FMT_S16, ///< signed 16 bits
288 SAMPLE_FMT_S24, ///< signed 24 bits
115329f1 289 SAMPLE_FMT_S32, ///< signed 32 bits
a3a5f4d6 290 SAMPLE_FMT_FLT, ///< float
a96b68b7
FB
291};
292
de6d9b64 293/* in bytes */
8170e5fb 294#define AVCODEC_MAX_AUDIO_FRAME_SIZE 192000 // 1 second of 48khz 32bit audio
de6d9b64 295
d7425f59 296/**
cf713bb8 297 * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
f5bccd85
DB
298 * This is mainly needed because some optimized bitstream readers read
299 * 32 or 64 bit at once and could read over the end.<br>
300 * Note: If the first 23 bits of the additional bytes are not 0, then damaged
301 * MPEG bitstreams could cause overread and segfault.
d7425f59
MN
302 */
303#define FF_INPUT_BUFFER_PADDING_SIZE 8
304
0ecca7a4 305/**
f5bccd85
DB
306 * minimum encoding buffer size
307 * Used to avoid some checks during header writing.
0ecca7a4
MN
308 */
309#define FF_MIN_BUFFER_SIZE 16384
310
e4986da9
J
311/* motion estimation type, EPZS by default */
312enum Motion_Est_ID {
101bea5f 313 ME_ZERO = 1,
e4986da9
J
314 ME_FULL,
315 ME_LOG,
316 ME_PHODS,
317 ME_EPZS,
51d6a3cf
MN
318 ME_X1,
319 ME_HEX,
320 ME_UMH,
321 ME_ITER,
e4986da9
J
322};
323
8c3eba7c 324enum AVDiscard{
f5bccd85
DB
325 /* We leave some space between them for extensions (drop some
326 * keyframes for intra-only or drop just some bidir frames). */
8c3eba7c
MN
327 AVDISCARD_NONE =-16, ///< discard nothing
328 AVDISCARD_DEFAULT= 0, ///< discard useless packets like 0 size packets in avi
329 AVDISCARD_NONREF = 8, ///< discard all non reference
330 AVDISCARD_BIDIR = 16, ///< discard all bidirectional frames
331 AVDISCARD_NONKEY = 32, ///< discard all frames except keyframes
332 AVDISCARD_ALL = 48, ///< discard all
333};
334
ce980a95
MN
335typedef struct RcOverride{
336 int start_frame;
337 int end_frame;
f5bccd85 338 int qscale; // If this is 0 then quality_factor will be used instead.
ce980a95
MN
339 float quality_factor;
340} RcOverride;
341
b0ec9efd 342#define FF_MAX_B_FRAMES 16
9dbcbd92 343
a949d72e 344/* encoding support
f5bccd85
DB
345 These flags can be passed in AVCodecContext.flags before initialization.
346 Note: Not everything is supported yet.
a949d72e 347*/
de6d9b64 348
f5bccd85
DB
349#define CODEC_FLAG_QSCALE 0x0002 ///< Use fixed qscale.
350#define CODEC_FLAG_4MV 0x0004 ///< 4 MV per MB allowed / advanced prediction for H.263.
351#define CODEC_FLAG_QPEL 0x0010 ///< Use qpel MC.
352#define CODEC_FLAG_GMC 0x0020 ///< Use GMC.
353#define CODEC_FLAG_MV0 0x0040 ///< Always try a MB with MV=<0,0>.
354#define CODEC_FLAG_PART 0x0080 ///< Use data partitioning.
355/* The parent program guarantees that the input for B-frames containing
356 * streams is not written to for at least s->max_b_frames+1 frames, if
357 * this is not set the input will be copied. */
8b4c7dbc 358#define CODEC_FLAG_INPUT_PRESERVED 0x0100
f5bccd85
DB
359#define CODEC_FLAG_PASS1 0x0200 ///< Use internal 2pass ratecontrol in first pass mode.
360#define CODEC_FLAG_PASS2 0x0400 ///< Use internal 2pass ratecontrol in second pass mode.
361#define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< Use external Huffman table (for MJPEG).
362#define CODEC_FLAG_GRAY 0x2000 ///< Only decode/encode grayscale.
363#define CODEC_FLAG_EMU_EDGE 0x4000///< Don't draw edges.
364#define CODEC_FLAG_PSNR 0x8000 ///< error[?] variables will be set during encoding.
365#define CODEC_FLAG_TRUNCATED 0x00010000 /** Input bitstream might be truncated at a random location instead
366 of only at frame boundaries. */
367#define CODEC_FLAG_NORMALIZE_AQP 0x00020000 ///< Normalize adaptive quantization.
368#define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< Use interlaced DCT.
369#define CODEC_FLAG_LOW_DELAY 0x00080000 ///< Force low delay.
370#define CODEC_FLAG_ALT_SCAN 0x00100000 ///< Use alternate scan.
371#define CODEC_FLAG_TRELLIS_QUANT 0x00200000 ///< Use trellis quantization.
372#define CODEC_FLAG_GLOBAL_HEADER 0x00400000 ///< Place global headers in extradata instead of every keyframe.
373#define CODEC_FLAG_BITEXACT 0x00800000 ///< Use only bitexact stuff (except (I)DCT).
21e59552 374/* Fx : Flag for h263+ extra options */
6b936ec6 375#if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
f5bccd85 376#define CODEC_FLAG_H263P_AIC 0x01000000 ///< H.263 advanced intra coding / MPEG-4 AC prediction (remove this)
6b936ec6 377#endif
f5bccd85
DB
378#define CODEC_FLAG_AC_PRED 0x01000000 ///< H.263 advanced intra coding / MPEG-4 AC prediction
379#define CODEC_FLAG_H263P_UMV 0x02000000 ///< unlimited motion vector
380#define CODEC_FLAG_CBP_RD 0x04000000 ///< Use rate distortion optimization for cbp.
381#define CODEC_FLAG_QP_RD 0x08000000 ///< Use rate distortion optimization for qp selectioon.
382#define CODEC_FLAG_H263P_AIV 0x00000008 ///< H.263 alternative inter VLC
332f9ac4
MN
383#define CODEC_FLAG_OBMC 0x00000001 ///< OBMC
384#define CODEC_FLAG_LOOP_FILTER 0x00000800 ///< loop filter
bb198e19
MN
385#define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000
386#define CODEC_FLAG_INTERLACED_ME 0x20000000 ///< interlaced motion estimation
f5bccd85 387#define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< Will reserve space for SVCD scan offset user data.
f2cf4a6b 388#define CODEC_FLAG_CLOSED_GOP ((int)0x80000000)
f5bccd85
DB
389#define CODEC_FLAG2_FAST 0x00000001 ///< Allow non spec compliant speedup tricks.
390#define CODEC_FLAG2_STRICT_GOP 0x00000002 ///< Strictly enforce GOP size.
391#define CODEC_FLAG2_NO_OUTPUT 0x00000004 ///< Skip bitstream encoding.
392#define CODEC_FLAG2_LOCAL_HEADER 0x00000008 ///< Place global headers at every keyframe instead of in extradata.
393#define CODEC_FLAG2_BPYRAMID 0x00000010 ///< H.264 allow B-frames to be used as references.
394#define CODEC_FLAG2_WPRED 0x00000020 ///< H.264 weighted biprediction for B-frames
d3075ed5 395#define CODEC_FLAG2_MIXED_REFS 0x00000040 ///< H.264 one reference per partition, as opposed to one reference per macroblock
58f7833e
RS
396#define CODEC_FLAG2_8X8DCT 0x00000080 ///< H.264 high profile 8x8 transform
397#define CODEC_FLAG2_FASTPSKIP 0x00000100 ///< H.264 fast pskip
398#define CODEC_FLAG2_AUD 0x00000200 ///< H.264 access unit delimiters
f5bccd85
DB
399#define CODEC_FLAG2_BRDO 0x00000400 ///< B-frame rate-distortion optimization
400#define CODEC_FLAG2_INTRA_VLC 0x00000800 ///< Use MPEG-2 intra VLC table.
401#define CODEC_FLAG2_MEMC_ONLY 0x00001000 ///< Only do ME/MC (I frames -> ref, P frame -> ME+MC).
402#define CODEC_FLAG2_DROP_FRAME_TIMECODE 0x00002000 ///< timecode is in drop frame format.
403#define CODEC_FLAG2_SKIP_RD 0x00004000 ///< RD optimal MB level residual skipping
404#define CODEC_FLAG2_CHUNKS 0x00008000 ///< Input bitstream might be truncated at a packet boundaries instead of only at frame boundaries.
405#define CODEC_FLAG2_NON_LINEAR_QUANT 0x00010000 ///< Use MPEG-2 nonlinear quantizer.
6fc5b059 406
21e59552 407/* Unsupported options :
bb270c08
DB
408 * Syntax Arithmetic coding (SAC)
409 * Reference Picture Selection
eafcac6a 410 * Independent Segment Decoding */
21e59552 411/* /Fx */
bf89e6b1
FB
412/* codec capabilities */
413
f5bccd85 414#define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< Decoder can use draw_horiz_band callback.
6814a25c
MN
415/**
416 * Codec uses get_buffer() for allocating buffers.
417 * direct rendering method 1
418 */
419#define CODEC_CAP_DR1 0x0002
f5bccd85 420/* If 'parse_only' field is true, then avcodec_parse_frame() can be used. */
917e06c8 421#define CODEC_CAP_PARSE_ONLY 0x0004
d7425f59 422#define CODEC_CAP_TRUNCATED 0x0008
f5bccd85 423/* Codec can export data for HW decoding (XvMC). */
5e5c247a 424#define CODEC_CAP_HWACCEL 0x0010
115329f1 425/**
f5bccd85
DB
426 * Codec has a nonzero delay and needs to be fed with NULL at the end to get the delayed data.
427 * If this is not set, the codec is guaranteed to never be fed with NULL data.
934982c4 428 */
6f824977 429#define CODEC_CAP_DELAY 0x0020
cef7cc72
JR
430/**
431 * Codec can be fed a final frame with a smaller size.
432 * This can be used to prevent truncation of the last audio samples.
433 */
434#define CODEC_CAP_SMALL_LAST_FRAME 0x0040
bf89e6b1 435
f5bccd85 436//The following defines may change, don't expect compatibility if you use them.
8d7ec294 437#define MB_TYPE_INTRA4x4 0x0001
f5bccd85
DB
438#define MB_TYPE_INTRA16x16 0x0002 //FIXME H.264-specific
439#define MB_TYPE_INTRA_PCM 0x0004 //FIXME H.264-specific
8d7ec294
WH
440#define MB_TYPE_16x16 0x0008
441#define MB_TYPE_16x8 0x0010
442#define MB_TYPE_8x16 0x0020
443#define MB_TYPE_8x8 0x0040
444#define MB_TYPE_INTERLACED 0x0080
445#define MB_TYPE_DIRECT2 0x0100 //FIXME
446#define MB_TYPE_ACPRED 0x0200
447#define MB_TYPE_GMC 0x0400
448#define MB_TYPE_SKIP 0x0800
449#define MB_TYPE_P0L0 0x1000
450#define MB_TYPE_P1L0 0x2000
451#define MB_TYPE_P0L1 0x4000
452#define MB_TYPE_P1L1 0x8000
453#define MB_TYPE_L0 (MB_TYPE_P0L0 | MB_TYPE_P1L0)
454#define MB_TYPE_L1 (MB_TYPE_P0L1 | MB_TYPE_P1L1)
455#define MB_TYPE_L0L1 (MB_TYPE_L0 | MB_TYPE_L1)
456#define MB_TYPE_QUANT 0x00010000
457#define MB_TYPE_CBP 0x00020000
458//Note bits 24-31 are reserved for codec specific use (h264 ref0, mpeg1 0mv, ...)
459
fa384dcc
MN
460/**
461 * Pan Scan area.
f5bccd85
DB
462 * This specifies the area which should be displayed.
463 * Note there may be multiple such areas for one frame.
fa384dcc
MN
464 */
465typedef struct AVPanScan{
466 /**
f5bccd85
DB
467 * id
468 * - encoding: Set by user.
469 * - decoding: Set by libavcodec.
fa384dcc
MN
470 */
471 int id;
472
473 /**
474 * width and height in 1/16 pel
f5bccd85
DB
475 * - encoding: Set by user.
476 * - decoding: Set by libavcodec.
fa384dcc
MN
477 */
478 int width;
479 int height;
480
481 /**
f5bccd85
DB
482 * position of the top left corner in 1/16 pel for up to 3 fields/frames
483 * - encoding: Set by user.
484 * - decoding: Set by libavcodec.
fa384dcc
MN
485 */
486 int16_t position[3][2];
487}AVPanScan;
488
492cd3a9 489#define FF_COMMON_FRAME \
b536d0aa
MN
490 /**\
491 * pointer to the picture planes.\
f5bccd85 492 * This might be different from the first allocated byte\
b536d0aa
MN
493 * - encoding: \
494 * - decoding: \
495 */\
1e491e29
MN
496 uint8_t *data[4];\
497 int linesize[4];\
498 /**\
f5bccd85
DB
499 * pointer to the first allocated byte of the picture. Can be used in get_buffer/release_buffer.\
500 * This isn't used by libavcodec unless the default get/release_buffer() is used.\
64863965
MN
501 * - encoding: \
502 * - decoding: \
1e491e29
MN
503 */\
504 uint8_t *base[4];\
505 /**\
506 * 1 -> keyframe, 0-> not\
f5bccd85
DB
507 * - encoding: Set by libavcodec.\
508 * - decoding: Set by libavcodec.\
1e491e29
MN
509 */\
510 int key_frame;\
511\
512 /**\
f5bccd85
DB
513 * Picture type of the frame, see ?_TYPE below.\
514 * - encoding: Set by libavcodec. for coded_picture (and set by user for input).\
515 * - decoding: Set by libavcodec.\
1e491e29
MN
516 */\
517 int pict_type;\
518\
519 /**\
c0df9d75 520 * presentation timestamp in time_base units (time when frame should be shown to user)\
f5bccd85
DB
521 * If AV_NOPTS_VALUE then frame_rate = 1/time_base will be assumed.\
522 * - encoding: MUST be set by user.\
523 * - decoding: Set by libavcodec.\
1e491e29 524 */\
be6784dc 525 int64_t pts;\
1e491e29
MN
526\
527 /**\
f5bccd85 528 * picture number in bitstream order\
64863965 529 * - encoding: set by\
f5bccd85 530 * - decoding: Set by libavcodec.\
1e491e29
MN
531 */\
532 int coded_picture_number;\
533 /**\
f5bccd85 534 * picture number in display order\
64863965 535 * - encoding: set by\
f5bccd85 536 * - decoding: Set by libavcodec.\
1e491e29
MN
537 */\
538 int display_picture_number;\
539\
540 /**\
158c7f05 541 * quality (between 1 (good) and FF_LAMBDA_MAX (bad)) \
f5bccd85
DB
542 * - encoding: Set by libavcodec. for coded_picture (and set by user for input).\
543 * - decoding: Set by libavcodec.\
1e491e29 544 */\
158c7f05 545 int quality; \
1e491e29
MN
546\
547 /**\
548 * buffer age (1->was last buffer and dint change, 2->..., ...).\
f5bccd85 549 * Set to INT_MAX if the buffer has not been used yet.\
64863965 550 * - encoding: unused\
f5bccd85 551 * - decoding: MUST be set by get_buffer().\
1e491e29
MN
552 */\
553 int age;\
554\
555 /**\
556 * is this picture used as reference\
64863965 557 * - encoding: unused\
f5bccd85 558 * - decoding: Set by libavcodec. (before get_buffer() call)).\
1e491e29
MN
559 */\
560 int reference;\
561\
562 /**\
563 * QP table\
64863965 564 * - encoding: unused\
f5bccd85 565 * - decoding: Set by libavcodec.\
1e491e29
MN
566 */\
567 int8_t *qscale_table;\
568 /**\
569 * QP store stride\
64863965 570 * - encoding: unused\
f5bccd85 571 * - decoding: Set by libavcodec.\
1e491e29
MN
572 */\
573 int qstride;\
574\
575 /**\
f5bccd85 576 * mbskip_table[mb]>=1 if MB didn't change\
1e491e29 577 * stride= mb_width = (width+15)>>4\
64863965 578 * - encoding: unused\
f5bccd85 579 * - decoding: Set by libavcodec.\
1e491e29
MN
580 */\
581 uint8_t *mbskip_table;\
582\
583 /**\
f5bccd85 584 * motion vector table\
61436073
MN
585 * @code\
586 * example:\
587 * int mv_sample_log2= 4 - motion_subsample_log2;\
588 * int mb_width= (width+15)>>4;\
589 * int mv_stride= (mb_width << mv_sample_log2) + 1;\
590 * motion_val[direction][x + y*mv_stride][0->mv_x, 1->mv_y];\
591 * @endcode\
f5bccd85
DB
592 * - encoding: Set by user.\
593 * - decoding: Set by libavcodec.\
8d7ec294
WH
594 */\
595 int16_t (*motion_val[2])[2];\
596\
597 /**\
f5bccd85 598 * macroblock type table\
8d7ec294 599 * mb_type_base + mb_width + 2\
f5bccd85
DB
600 * - encoding: Set by user.\
601 * - decoding: Set by libavcodec.\
8d7ec294
WH
602 */\
603 uint32_t *mb_type;\
604\
605 /**\
f0b77c69
MN
606 * log2 of the size of the block which a single vector in motion_val represents: \
607 * (4->16x16, 3->8x8, 2-> 4x4, 1-> 2x2)\
8d7ec294 608 * - encoding: unused\
f5bccd85 609 * - decoding: Set by libavcodec.\
8d7ec294
WH
610 */\
611 uint8_t motion_subsample_log2;\
612\
613 /**\
1e491e29 614 * for some private data of the user\
64863965 615 * - encoding: unused\
f5bccd85 616 * - decoding: Set by user.\
1e491e29
MN
617 */\
618 void *opaque;\
140cb663
MN
619\
620 /**\
621 * error\
f5bccd85 622 * - encoding: Set by libavcodec. if flags&CODEC_FLAG_PSNR.\
64863965 623 * - decoding: unused\
140cb663
MN
624 */\
625 uint64_t error[4];\
4e00e76b
MN
626\
627 /**\
f5bccd85
DB
628 * type of the buffer (to keep track of who has to deallocate data[*])\
629 * - encoding: Set by the one who allocates it.\
630 * - decoding: Set by the one who allocates it.\
631 * Note: User allocated (direct rendering) & internal buffers cannot coexist currently.\
4e00e76b
MN
632 */\
633 int type;\
2ec23b6d
MN
634 \
635 /**\
f5bccd85 636 * When decoding, this signals how much the picture must be delayed.\
2ec23b6d 637 * extra_delay = repeat_pict / (2*fps)\
64863965 638 * - encoding: unused\
f5bccd85 639 * - decoding: Set by libavcodec.\
2ec23b6d 640 */\
0426af31
MN
641 int repeat_pict;\
642 \
643 /**\
644 * \
645 */\
646 int qscale_type;\
2744ca9a
RS
647 \
648 /**\
649 * The content of the picture is interlaced.\
f5bccd85
DB
650 * - encoding: Set by user.\
651 * - decoding: Set by libavcodec. (default 0)\
2744ca9a
RS
652 */\
653 int interlaced_frame;\
654 \
655 /**\
f5bccd85
DB
656 * If the content is interlaced, is top field displayed first.\
657 * - encoding: Set by user.\
658 * - decoding: Set by libavcodec.\
2744ca9a 659 */\
9dad924e 660 int top_field_first;\
fa384dcc
MN
661 \
662 /**\
663 * Pan scan.\
f5bccd85
DB
664 * - encoding: Set by user.\
665 * - decoding: Set by libavcodec.\
fa384dcc
MN
666 */\
667 AVPanScan *pan_scan;\
2a2bbcb0
MM
668 \
669 /**\
f5bccd85 670 * Tell user application that palette has changed from previous frame.\
2a2bbcb0 671 * - encoding: ??? (no palette-enabled encoder yet)\
f5bccd85 672 * - decoding: Set by libavcodec. (default 0).\
2a2bbcb0
MM
673 */\
674 int palette_has_changed;\
074c4ca7
RT
675 \
676 /**\
f5bccd85 677 * codec suggestion on buffer type if != 0\
074c4ca7 678 * - encoding: unused\
f5bccd85 679 * - decoding: Set by libavcodec. (before get_buffer() call)).\
074c4ca7
RT
680 */\
681 int buffer_hints;\
8289c6fa
WH
682\
683 /**\
f5bccd85 684 * DCT coefficients\
8289c6fa 685 * - encoding: unused\
f5bccd85 686 * - decoding: Set by libavcodec.\
8289c6fa
WH
687 */\
688 short *dct_coeff;\
a4d36c11
MN
689\
690 /**\
f5bccd85
DB
691 * motion referece frame index\
692 * - encoding: Set by user.\
693 * - decoding: Set by libavcodec.\
a4d36c11
MN
694 */\
695 int8_t *ref_index[2];
2ec23b6d 696
bb270c08
DB
697#define FF_QSCALE_TYPE_MPEG1 0
698#define FF_QSCALE_TYPE_MPEG2 1
699#define FF_QSCALE_TYPE_H264 2
4e00e76b
MN
700
701#define FF_BUFFER_TYPE_INTERNAL 1
f5bccd85
DB
702#define FF_BUFFER_TYPE_USER 2 ///< direct rendering buffers (image is (de)allocated by user)
703#define FF_BUFFER_TYPE_SHARED 4 ///< Buffer from somewhere else; don't deallocate image (data/base), all other tables are not shared.
704#define FF_BUFFER_TYPE_COPY 8 ///< Just a (modified) copy of some other buffer, don't deallocate anything.
4e00e76b 705
1e491e29 706
140cb663
MN
707#define FF_I_TYPE 1 // Intra
708#define FF_P_TYPE 2 // Predicted
709#define FF_B_TYPE 3 // Bi-dir predicted
710#define FF_S_TYPE 4 // S(GMC)-VOP MPEG4
0da71265
MN
711#define FF_SI_TYPE 5
712#define FF_SP_TYPE 6
1e491e29 713
f5bccd85
DB
714#define FF_BUFFER_HINTS_VALID 0x01 // Buffer hints value is meaningful (if 0 ignore).
715#define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer.
716#define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content.
717#define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update).
074c4ca7 718
0da71265
MN
719/**
720 * Audio Video Frame.
721 */
492cd3a9
MN
722typedef struct AVFrame {
723 FF_COMMON_FRAME
724} AVFrame;
1e491e29 725
14bea432 726#define DEFAULT_FRAME_RATE_BASE 1001000
d33c949c
MN
727
728/**
f5bccd85 729 * main external API structure
d33c949c 730 */
de6d9b64 731typedef struct AVCodecContext {
b71901e6 732 /**
f5bccd85 733 * information on struct for av_log
bc874dae
MB
734 * - set by avcodec_alloc_context
735 */
43465395 736 AVClass *av_class;
bc874dae 737 /**
f5bccd85
DB
738 * the average bitrate
739 * - encoding: Set by user; unused for constant quantizer encoding.
740 * - decoding: Set by libavcodec. 0 or some bitrate if this info is available in the stream.
b71901e6 741 */
de6d9b64 742 int bit_rate;
b71901e6
MN
743
744 /**
64863965 745 * number of bits the bitstream is allowed to diverge from the reference.
b71901e6 746 * the reference can be CBR (for CBR pass1) or VBR (for pass2)
f5bccd85 747 * - encoding: Set by user; unused for constant quantizer encoding.
64863965 748 * - decoding: unused
b71901e6 749 */
115329f1 750 int bit_rate_tolerance;
b71901e6
MN
751
752 /**
64863965 753 * CODEC_FLAG_*.
f5bccd85
DB
754 * - encoding: Set by user.
755 * - decoding: Set by user.
b71901e6 756 */
de6d9b64 757 int flags;
b71901e6
MN
758
759 /**
f5bccd85
DB
760 * Some codecs need additional format info. It is stored here.
761 * If any muxer uses this then ALL demuxers/parsers AND encoders for the
762 * specific codec MUST set it correctly otherwise stream copy breaks.
763 * In general use of this field by muxers is not recommanded.
764 * - encoding: Set by libavcodec.
765 * - decoding: Set by libavcodec. (FIXME: Is this OK?)
b71901e6
MN
766 */
767 int sub_id;
768
769 /**
f5bccd85 770 * Motion estimation algorithm used for video coding.
58f7833e
RS
771 * 1 (zero), 2 (full), 3 (log), 4 (phods), 5 (epzs), 6 (x1), 7 (hex),
772 * 8 (umh), 9 (iter) [7, 8 are x264 specific, 9 is snow specific]
64863965
MN
773 * - encoding: MUST be set by user.
774 * - decoding: unused
b71901e6
MN
775 */
776 int me_method;
777
778 /**
f5bccd85
DB
779 * some codecs need / can use extradata like Huffman tables.
780 * mjpeg: Huffman tables
b71901e6 781 * rv10: additional flags
b704e742 782 * mpeg4: global headers (they can be in the bitstream or here)
f5bccd85
DB
783 * The allocated memory should be FF_INPUT_BUFFER_PADDING_SIZE bytes larger
784 * than extradata_size to avoid prolems if it is read with the bitstream reader.
785 * The bytewise contents of extradata must not depend on the architecture or CPU endianness.
786 * - encoding: Set/allocated/freed by libavcodec.
787 * - decoding: Set/allocated/freed by user.
b71901e6 788 */
58f2a4b0 789 uint8_t *extradata;
e84c31dc 790 int extradata_size;
115329f1 791
b71901e6 792 /**
f5bccd85
DB
793 * This is the fundamental unit of time (in seconds) in terms
794 * of which frame timestamps are represented. For fixed-fps content,
5b28c8c3
MN
795 * timebase should be 1/framerate and timestamp increments should be
796 * identically 1.
f5bccd85
DB
797 * - encoding: MUST be set by user.
798 * - decoding: Set by libavcodec.
b71901e6 799 */
c0df9d75 800 AVRational time_base;
115329f1 801
5b28c8c3 802 /* video only */
14bea432 803 /**
21adafec 804 * picture width / height.
115329f1 805 * - encoding: MUST be set by user.
f5bccd85
DB
806 * - decoding: Set by libavcodec.
807 * Note: For compatibility it is possible to set this instead of
808 * coded_width/height before decoding.
b71901e6 809 */
de6d9b64 810 int width, height;
115329f1 811
e769f053 812#define FF_ASPECT_EXTENDED 15
b71901e6
MN
813
814 /**
f5bccd85
DB
815 * the number of pictures in a group of pictures, or 0 for intra_only
816 * - encoding: Set by user.
64863965 817 * - decoding: unused
b71901e6
MN
818 */
819 int gop_size;
820
821 /**
f5bccd85
DB
822 * Pixel format, see PIX_FMT_xxx.
823 * - encoding: Set by user.
824 * - decoding: Set by libavcodec.
b71901e6 825 */
e4eadb4b 826 enum PixelFormat pix_fmt;
115329f1 827
bdfcbbed 828 /**
f5bccd85 829 * Frame rate emulation. If not zero, the lower layer (i.e. format handler)
bdfcbbed 830 * has to read frames at native frame rate.
f5bccd85
DB
831 * - encoding: Set by user.
832 * - decoding: unused
bdfcbbed
MK
833 */
834 int rate_emu;
115329f1 835
b71901e6 836 /**
f5bccd85
DB
837 * If non NULL, 'draw_horiz_band' is called by the libavcodec
838 * decoder to draw a horizontal band. It improves cache usage. Not
b71901e6 839 * all codecs can do that. You must check the codec capabilities
f5bccd85 840 * beforehand.
64863965 841 * - encoding: unused
f5bccd85 842 * - decoding: Set by user.
3bb07d61
MN
843 * @param height the height of the slice
844 * @param y the y position of the slice
845 * @param type 1->top field, 2->bottom field, 3->frame
846 * @param offset offset into the AVFrame.data from which the slice should be read
b71901e6 847 */
bf89e6b1 848 void (*draw_horiz_band)(struct AVCodecContext *s,
da64ecc3 849 const AVFrame *src, int offset[4],
3bb07d61 850 int y, int type, int height);
bf89e6b1 851
de6d9b64 852 /* audio only */
f5bccd85 853 int sample_rate; ///< samples per second
de6d9b64 854 int channels;
a3a5f4d6
MN
855
856 /**
f5bccd85
DB
857 * audio sample format
858 * - encoding: Set by user.
859 * - decoding: Set by libavcodec.
a3a5f4d6 860 */
f5bccd85 861 enum SampleFormat sample_fmt; ///< sample format, currently unused
de6d9b64 862
f5bccd85 863 /* The following data should not be initialized. */
718b27a7 864 /**
f5bccd85 865 * Samples per packet, initialized when calling 'init'.
718b27a7
MN
866 */
867 int frame_size;
115329f1 868 int frame_number; ///< audio or video frame number
f5bccd85 869 int real_pict_num; ///< Returns the real picture number of previous encoded frame.
115329f1 870
b71901e6 871 /**
f5bccd85 872 * Number of frames the decoded output will be delayed relative to
64863965 873 * the encoded input.
f5bccd85 874 * - encoding: Set by libavcodec.
64863965 875 * - decoding: unused
b71901e6
MN
876 */
877 int delay;
115329f1 878
64863965
MN
879 /* - encoding parameters */
880 float qcompress; ///< amount of qscale change between easy & hard scenes (0.0-1.0)
115329f1
DB
881 float qblur; ///< amount of qscale smoothing over time (0.0-1.0)
882
b71901e6 883 /**
f5bccd85
DB
884 * minimum quantizer
885 * - encoding: Set by user.
64863965 886 * - decoding: unused
b71901e6
MN
887 */
888 int qmin;
889
890 /**
f5bccd85
DB
891 * maximum quantizer
892 * - encoding: Set by user.
64863965 893 * - decoding: unused
b71901e6
MN
894 */
895 int qmax;
896
897 /**
f5bccd85
DB
898 * maximum quantizer difference between frames
899 * - encoding: Set by user.
64863965 900 * - decoding: unused
b71901e6
MN
901 */
902 int max_qdiff;
903
904 /**
f5bccd85
DB
905 * maximum number of B-frames between non-B-frames
906 * Note: The output will be delayed by max_b_frames+1 relative to the input.
907 * - encoding: Set by user.
64863965 908 * - decoding: unused
b71901e6
MN
909 */
910 int max_b_frames;
911
912 /**
f5bccd85
DB
913 * qscale factor between IP and B-frames
914 * - encoding: Set by user.
64863965 915 * - decoding: unused
b71901e6
MN
916 */
917 float b_quant_factor;
115329f1 918
b71901e6
MN
919 /** obsolete FIXME remove */
920 int rc_strategy;
64b7c5b6
MN
921#define FF_RC_STRATEGY_XVID 1
922
8b4c7dbc 923 int b_frame_strategy;
9dbcbd92 924
b71901e6 925 /**
f5bccd85 926 * hurry up amount
64863965 927 * - encoding: unused
f5bccd85 928 * - decoding: Set by user. 1-> Skip B-frames, 2-> Skip IDCT/dequant too, 5-> Skip everything except header
f9ec0aa1 929 * @deprecated Deprecated in favor of skip_idct and skip_frame.
b71901e6
MN
930 */
931 int hurry_up;
115329f1 932
de6d9b64 933 struct AVCodec *codec;
115329f1 934
de6d9b64
FB
935 void *priv_data;
936
ccec0f4f 937#if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
ba58dabc
MN
938 /* unused, FIXME remove*/
939 int rtp_mode;
ccec0f4f 940#endif
115329f1 941
bb628dae 942 int rtp_payload_size; /* The size of the RTP payload: the coder will */
f5bccd85 943 /* do its best to deliver a chunk with size */
644d98a4 944 /* below rtp_payload_size, the chunk will start */
f5bccd85 945 /* with a start code on some codecs like H.263. */
644d98a4 946 /* This doesn't take account of any particular */
f5bccd85 947 /* headers inside the transmitted RTP payload. */
81401c1f 948
115329f1 949
f5bccd85
DB
950 /* The RTP callback: This function is called */
951 /* every time the encoder has a packet to send. */
952 /* It depends on the encoder if the data starts */
953 /* with a Start Code (it should). H.263 does. */
954 /* mb_nb contains the number of macroblocks */
955 /* encoded in the RTP payload. */
115329f1 956 void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb);
81401c1f 957
098eefe1
MN
958 /* statistics, used for 2-pass encoding */
959 int mv_bits;
960 int header_bits;
961 int i_tex_bits;
962 int p_tex_bits;
963 int i_count;
964 int p_count;
965 int skip_count;
b71901e6 966 int misc_bits;
115329f1 967
b71901e6 968 /**
f5bccd85
DB
969 * number of bits used for the previously encoded frame
970 * - encoding: Set by libavcodec.
7004ffb3 971 * - decoding: unused
b71901e6 972 */
098eefe1 973 int frame_bits;
7004ffb3 974
b71901e6 975 /**
f5bccd85
DB
976 * Private data of the user, can be used to carry app specific stuff.
977 * - encoding: Set by user.
978 * - decoding: Set by user.
b71901e6
MN
979 */
980 void *opaque;
981
de6d9b64 982 char codec_name[32];
4a663d80
PG
983 enum CodecType codec_type; /* see CODEC_TYPE_xxx */
984 enum CodecID codec_id; /* see CODEC_ID_xxx */
115329f1 985
7004ffb3
MN
986 /**
987 * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
f5bccd85
DB
988 * This is used to work around some encoder bugs.
989 * A demuxer should set this to what is stored in the field used to identify the codec.
990 * If there are multiple such fields in a container then the demuxer should choose the one
991 * which maximizes the information about the used codec.
992 * If the codec tag field in a container is larger then 32 bits then the demuxer should
993 * remap the longer ID to 32 bits with a table or other structure. Alternatively a new
47bbf8a7 994 * extra_codec_tag + size could be added but for this a clear advantage must be demonstrated
f5bccd85
DB
995 * first.
996 * - encoding: Set by user, if not then the default based on codec_id will be used.
997 * - decoding: Set by user, will be converted to uppercase by libavcodec during init.
7004ffb3
MN
998 */
999 unsigned int codec_tag;
115329f1 1000
b71901e6 1001 /**
f5bccd85
DB
1002 * Work around bugs in encoders which sometimes cannot be detected automatically.
1003 * - encoding: Set by user
1004 * - decoding: Set by user
b71901e6
MN
1005 */
1006 int workaround_bugs;
64863965 1007#define FF_BUG_AUTODETECT 1 ///< autodetection
4d2858de
MN
1008#define FF_BUG_OLD_MSMPEG4 2
1009#define FF_BUG_XVID_ILACE 4
1010#define FF_BUG_UMP4 8
1011#define FF_BUG_NO_PADDING 16
3116cb14 1012#define FF_BUG_AMV 32
f5bccd85 1013#define FF_BUG_AC_VLC 0 ///< Will be removed, libavcodec can now handle these non-compliant files by default.
03e93d35 1014#define FF_BUG_QPEL_CHROMA 64
db794953 1015#define FF_BUG_STD_QPEL 128
36df8805 1016#define FF_BUG_QPEL_CHROMA2 256
c40c3482 1017#define FF_BUG_DIRECT_BLOCKSIZE 512
1c6dcb0f 1018#define FF_BUG_EDGE 1024
b44bdf7e 1019#define FF_BUG_HPEL_CHROMA 2048
4ccde216 1020#define FF_BUG_DC_CLIP 4096
f5bccd85
DB
1021#define FF_BUG_MS 8192 ///< Work around various bugs in Microsoft's broken decoders.
1022//#define FF_BUG_FAKE_SCALABILITY 16 //Autodetection should work 100%.
115329f1 1023
b71901e6 1024 /**
f5bccd85
DB
1025 * luma single coefficient elimination threshold
1026 * - encoding: Set by user.
64863965 1027 * - decoding: unused
b71901e6 1028 */
1f6b6e50 1029 int luma_elim_threshold;
115329f1 1030
b71901e6 1031 /**
f5bccd85
DB
1032 * chroma single coeff elimination threshold
1033 * - encoding: Set by user.
64863965 1034 * - decoding: unused
b71901e6 1035 */
1f6b6e50 1036 int chroma_elim_threshold;
115329f1 1037
b71901e6 1038 /**
f5bccd85
DB
1039 * strictly follow the standard (MPEG4, ...).
1040 * - encoding: Set by user.
64863965 1041 * - decoding: unused
b71901e6
MN
1042 */
1043 int strict_std_compliance;
f5bccd85
DB
1044#define FF_COMPLIANCE_VERY_STRICT 2 ///< Strictly conform to a older more strict version of the spec or reference software.
1045#define FF_COMPLIANCE_STRICT 1 ///< Strictly conform to all the things in the spec no matter what consequences.
9cd81798 1046#define FF_COMPLIANCE_NORMAL 0
f5bccd85
DB
1047#define FF_COMPLIANCE_INOFFICIAL -1 ///< Allow inofficial extensions.
1048#define FF_COMPLIANCE_EXPERIMENTAL -2 ///< Allow nonstandardized experimental things.
9cd81798 1049
b71901e6 1050 /**
f5bccd85
DB
1051 * qscale offset between IP and B-frames
1052 * If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset).
1053 * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
1054 * - encoding: Set by user.
64863965 1055 * - decoding: unused
b71901e6
MN
1056 */
1057 float b_quant_offset;
115329f1 1058
b71901e6 1059 /**
f5bccd85
DB
1060 * Error resilience; higher values will detect more errors but may
1061 * misdetect some more or less valid parts as errors.
64863965 1062 * - encoding: unused
f5bccd85 1063 * - decoding: Set by user.
b71901e6 1064 */
1f6b6e50 1065 int error_resilience;
1471c6c2 1066#define FF_ER_CAREFUL 1
ce3bcaed
MN
1067#define FF_ER_COMPLIANT 2
1068#define FF_ER_AGGRESSIVE 3
1069#define FF_ER_VERY_AGGRESSIVE 4
115329f1 1070
6b72ac63 1071 /**
f5bccd85
DB
1072 * Called at the beginning of each frame to get a buffer for it.
1073 * If pic.reference is set then the frame will be read later by libavcodec.
2b5296d2 1074 * avcodec_align_dimensions() should be used to find the required width and
f5bccd85 1075 * height, as they normally need to be rounded up to the next multiple of 16.
64863965 1076 * - encoding: unused
f5bccd85 1077 * - decoding: Set by libavcodec., user can override.
b71901e6 1078 */
492cd3a9 1079 int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
115329f1 1080
b71901e6 1081 /**
f5bccd85
DB
1082 * Called to release buffers which where allocated with get_buffer.
1083 * A released buffer can be reused in get_buffer().
1084 * pic.data[*] must be set to NULL.
64863965 1085 * - encoding: unused
f5bccd85 1086 * - decoding: Set by libavcodec., user can override.
b71901e6 1087 */
492cd3a9 1088 void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
0fd90455 1089
b71901e6 1090 /**
f5bccd85
DB
1091 * If 1 the stream has a 1 frame delay during decoding.
1092 * - encoding: Set by libavcodec.
1093 * - decoding: Set by libavcodec.
b71901e6
MN
1094 */
1095 int has_b_frames;
718b27a7
MN
1096
1097 /**
1098 * number of bytes per packet if constant and known or 0
f5bccd85 1099 * Used by some WAV based audio codecs.
718b27a7
MN
1100 */
1101 int block_align;
115329f1 1102
f5bccd85 1103 int parse_only; /* - decoding only: If true, only parsing is done
917e06c8
FB
1104 (function avcodec_parse_frame()). The frame
1105 data is returned. Only MPEG codecs support this now. */
115329f1 1106
b71901e6 1107 /**
f5bccd85
DB
1108 * 0-> h263 quant 1-> mpeg quant
1109 * - encoding: Set by user.
64863965 1110 * - decoding: unused
b71901e6
MN
1111 */
1112 int mpeg_quant;
115329f1 1113
b71901e6 1114 /**
f5bccd85
DB
1115 * pass1 encoding statistics output buffer
1116 * - encoding: Set by libavcodec.
64863965 1117 * - decoding: unused
b71901e6 1118 */
64863965 1119 char *stats_out;
115329f1 1120
b71901e6 1121 /**
f5bccd85
DB
1122 * pass2 encoding statistics input buffer
1123 * Concatenated stuff from stats_out of pass1 should be placed here.
1124 * - encoding: Allocated/set/freed by user.
64863965 1125 * - decoding: unused
b71901e6
MN
1126 */
1127 char *stats_in;
115329f1 1128
b71901e6 1129 /**
f5bccd85
DB
1130 * ratecontrol qmin qmax limiting method
1131 * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax.
1132 * - encoding: Set by user.
64863965 1133 * - decoding: unused
b71901e6 1134 */
ce980a95 1135 float rc_qsquish;
b71901e6 1136
ce980a95
MN
1137 float rc_qmod_amp;
1138 int rc_qmod_freq;
115329f1 1139
b71901e6 1140 /**
f5bccd85
DB
1141 * ratecontrol override, see RcOverride
1142 * - encoding: Allocated/set/freed by user.
64863965 1143 * - decoding: unused
b71901e6 1144 */
ce980a95
MN
1145 RcOverride *rc_override;
1146 int rc_override_count;
115329f1 1147
b71901e6 1148 /**
f5bccd85
DB
1149 * rate control equation
1150 * - encoding: Set by user
64863965 1151 * - decoding: unused
b71901e6 1152 */
ce980a95 1153 char *rc_eq;
115329f1 1154
b71901e6 1155 /**
f5bccd85
DB
1156 * maximum bitrate
1157 * - encoding: Set by user.
64863965 1158 * - decoding: unused
b71901e6 1159 */
ce980a95 1160 int rc_max_rate;
115329f1 1161
b71901e6 1162 /**
f5bccd85
DB
1163 * minimum bitrate
1164 * - encoding: Set by user.
64863965 1165 * - decoding: unused
b71901e6 1166 */
ce980a95 1167 int rc_min_rate;
115329f1 1168
b71901e6 1169 /**
f5bccd85
DB
1170 * decoder bitstream buffer size
1171 * - encoding: Set by user.
64863965 1172 * - decoding: unused
b71901e6 1173 */
ce980a95
MN
1174 int rc_buffer_size;
1175 float rc_buffer_aggressivity;
b71901e6
MN
1176
1177 /**
f5bccd85
DB
1178 * qscale factor between P and I-frames
1179 * If > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset).
1180 * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
1181 * - encoding: Set by user.
64863965 1182 * - decoding: unused
b71901e6
MN
1183 */
1184 float i_quant_factor;
115329f1 1185
b71901e6 1186 /**
f5bccd85
DB
1187 * qscale offset between P and I-frames
1188 * - encoding: Set by user.
64863965 1189 * - decoding: unused
b71901e6
MN
1190 */
1191 float i_quant_offset;
115329f1 1192
b71901e6 1193 /**
f5bccd85
DB
1194 * initial complexity for pass1 ratecontrol
1195 * - encoding: Set by user.
64863965 1196 * - decoding: unused
b71901e6 1197 */
ce980a95 1198 float rc_initial_cplx;
917e06c8 1199
b71901e6 1200 /**
f5bccd85
DB
1201 * DCT algorithm, see FF_DCT_* below
1202 * - encoding: Set by user.
64863965 1203 * - decoding: unused
b71901e6 1204 */
28db7fce 1205 int dct_algo;
c7e07931 1206#define FF_DCT_AUTO 0
28db7fce 1207#define FF_DCT_FASTINT 1
c7e07931
MO
1208#define FF_DCT_INT 2
1209#define FF_DCT_MMX 3
1210#define FF_DCT_MLIB 4
05c4072b 1211#define FF_DCT_ALTIVEC 5
65e4c8c9 1212#define FF_DCT_FAAN 6
115329f1 1213
c5d309f2 1214 /**
f5bccd85
DB
1215 * luminance masking (0-> disabled)
1216 * - encoding: Set by user.
64863965 1217 * - decoding: unused
c5d309f2
MN
1218 */
1219 float lumi_masking;
115329f1 1220
c5d309f2 1221 /**
f5bccd85
DB
1222 * temporary complexity masking (0-> disabled)
1223 * - encoding: Set by user.
64863965 1224 * - decoding: unused
c5d309f2
MN
1225 */
1226 float temporal_cplx_masking;
115329f1 1227
c5d309f2 1228 /**
f5bccd85
DB
1229 * spatial complexity masking (0-> disabled)
1230 * - encoding: Set by user.
64863965 1231 * - decoding: unused
c5d309f2
MN
1232 */
1233 float spatial_cplx_masking;
115329f1 1234
c5d309f2 1235 /**
f5bccd85
DB
1236 * p block masking (0-> disabled)
1237 * - encoding: Set by user.
64863965 1238 * - decoding: unused
c5d309f2
MN
1239 */
1240 float p_masking;
15415af4 1241
5e746b99 1242 /**
f5bccd85
DB
1243 * darkness masking (0-> disabled)
1244 * - encoding: Set by user.
64863965 1245 * - decoding: unused
5e746b99
MN
1246 */
1247 float dark_masking;
115329f1
DB
1248
1249
3a694b04
NK
1250 /* for binary compatibility */
1251 int unused;
115329f1 1252
0c2dd16e 1253 /**
f5bccd85
DB
1254 * IDCT algorithm, see FF_IDCT_* below.
1255 * - encoding: Set by user.
1256 * - decoding: Set by user.
2ad1516a
MN
1257 */
1258 int idct_algo;
1259#define FF_IDCT_AUTO 0
1260#define FF_IDCT_INT 1
1261#define FF_IDCT_SIMPLE 2
1262#define FF_IDCT_SIMPLEMMX 3
1263#define FF_IDCT_LIBMPEG2MMX 4
1264#define FF_IDCT_PS2 5
1265#define FF_IDCT_MLIB 6
1266#define FF_IDCT_ARM 7
05c4072b 1267#define FF_IDCT_ALTIVEC 8
b82cdc72 1268#define FF_IDCT_SH4 9
bd7d1ea7 1269#define FF_IDCT_SIMPLEARM 10
0fa8158d 1270#define FF_IDCT_H264 11
8b6103da 1271#define FF_IDCT_VP3 12
eba9ae3c 1272#define FF_IDCT_IPP 13
84740d59 1273#define FF_IDCT_XVIDMMX 14
595e7bd9 1274#define FF_IDCT_CAVS 15
a0403006 1275#define FF_IDCT_SIMPLEARMV5TE 16
7d42886b 1276#define FF_IDCT_SIMPLEARMV6 17
2ad1516a 1277
144f0625 1278 /**
f5bccd85
DB
1279 * slice count
1280 * - encoding: Set by libavcodec.
1281 * - decoding: Set by user (or 0).
144f0625
MN
1282 */
1283 int slice_count;
1284 /**
f5bccd85
DB
1285 * slice offsets in the frame in bytes
1286 * - encoding: Set/allocated by libavcodec.
1287 * - decoding: Set/allocated by user (or NULL).
144f0625
MN
1288 */
1289 int *slice_offset;
1290
4d2858de 1291 /**
f5bccd85 1292 * error concealment flags
64863965 1293 * - encoding: unused
f5bccd85 1294 * - decoding: Set by user.
4d2858de
MN
1295 */
1296 int error_concealment;
1297#define FF_EC_GUESS_MVS 1
1298#define FF_EC_DEBLOCK 2
1299
6b72ac63 1300 /**
bec89a84 1301 * dsp_mask could be add used to disable unwanted CPU features
8350df97 1302 * CPU features (i.e. MMX, SSE. ...)
bec89a84 1303 *
f5bccd85
DB
1304 * With the FORCE flag you may instead enable given CPU features.
1305 * (Dangerous: Usable in case of misdetection, improper usage however will
1306 * result into program crash.)
bec89a84
ZK
1307 */
1308 unsigned dsp_mask;
f5bccd85 1309#define FF_MM_FORCE 0x80000000 /* Force usage of selected flags (OR) */
bec89a84
ZK
1310 /* lower 16 bits - CPU features */
1311#ifdef HAVE_MMX
bb270c08
DB
1312#define FF_MM_MMX 0x0001 /* standard MMX */
1313#define FF_MM_3DNOW 0x0004 /* AMD 3DNOW */
1314#define FF_MM_MMXEXT 0x0002 /* SSE integer functions or AMD MMX ext */
1315#define FF_MM_SSE 0x0008 /* SSE functions */
1316#define FF_MM_SSE2 0x0010 /* PIV SSE2 functions */
1317#define FF_MM_3DNOWEXT 0x0020 /* AMD 3DNowExt */
bec89a84 1318#endif /* HAVE_MMX */
eba9ae3c 1319#ifdef HAVE_IWMMXT
bb270c08 1320#define FF_MM_IWMMXT 0x0100 /* XScale IWMMXT */
eba9ae3c 1321#endif /* HAVE_IWMMXT */
11f18faf
MN
1322
1323 /**
64863965 1324 * bits per sample/pixel from the demuxer (needed for huffyuv).
f5bccd85
DB
1325 * - encoding: Set by libavcodec.
1326 * - decoding: Set by user.
11f18faf
MN
1327 */
1328 int bits_per_sample;
115329f1 1329
11f18faf 1330 /**
f5bccd85
DB
1331 * prediction method (needed for huffyuv)
1332 * - encoding: Set by user.
64863965 1333 * - decoding: unused
11f18faf
MN
1334 */
1335 int prediction_method;
1336#define FF_PRED_LEFT 0
1337#define FF_PRED_PLANE 1
1338#define FF_PRED_MEDIAN 2
115329f1 1339
5d3cea3a 1340 /**
f5bccd85
DB
1341 * sample aspect ratio (0 if unknown)
1342 * Numerator and denominator must be relatively prime and smaller than 256 for some video standards.
1343 * - encoding: Set by user.
1344 * - decoding: Set by libavcodec.
5d3cea3a 1345 */
5ff85f1d 1346 AVRational sample_aspect_ratio;
1e491e29
MN
1347
1348 /**
f5bccd85
DB
1349 * the picture in the bitstream
1350 * - encoding: Set by libavcodec.
1351 * - decoding: Set by libavcodec.
1e491e29 1352 */
492cd3a9 1353 AVFrame *coded_frame;
c8c437bc
MN
1354
1355 /**
f5bccd85
DB
1356 * debug
1357 * - encoding: Set by user.
1358 * - decoding: Set by user.
c8c437bc
MN
1359 */
1360 int debug;
1361#define FF_DEBUG_PICT_INFO 1
1362#define FF_DEBUG_RC 2
1363#define FF_DEBUG_BITSTREAM 4
1364#define FF_DEBUG_MB_TYPE 8
1365#define FF_DEBUG_QP 16
1366#define FF_DEBUG_MV 32
8289c6fa 1367#define FF_DEBUG_DCT_COEFF 0x00000040
41773b73
MN
1368#define FF_DEBUG_SKIP 0x00000080
1369#define FF_DEBUG_STARTCODE 0x00000100
1370#define FF_DEBUG_PTS 0x00000200
46b4feec 1371#define FF_DEBUG_ER 0x00000400
0da71265 1372#define FF_DEBUG_MMCO 0x00000800
8fc6c2b5 1373#define FF_DEBUG_BUGS 0x00001000
864119b6
MN
1374#define FF_DEBUG_VIS_QP 0x00002000
1375#define FF_DEBUG_VIS_MB_TYPE 0x00004000
115329f1 1376
140cb663 1377 /**
f5bccd85
DB
1378 * debug
1379 * - encoding: Set by user.
1380 * - decoding: Set by user.
0c9bbaec
WH
1381 */
1382 int debug_mv;
1383#define FF_DEBUG_VIS_MV_P_FOR 0x00000001 //visualize forward predicted MVs of P frames
1384#define FF_DEBUG_VIS_MV_B_FOR 0x00000002 //visualize forward predicted MVs of B frames
1385#define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames
1386
1387 /**
f5bccd85
DB
1388 * error
1389 * - encoding: Set by libavcodec if flags&CODEC_FLAG_PSNR.
64863965 1390 * - decoding: unused
140cb663
MN
1391 */
1392 uint64_t error[4];
115329f1 1393
17a70fde 1394 /**
f5bccd85 1395 * minimum MB quantizer
6e0d8c06 1396 * - encoding: unused
64863965 1397 * - decoding: unused
17a70fde
MN
1398 */
1399 int mb_qmin;
1400
1401 /**
f5bccd85 1402 * maximum MB quantizer
6e0d8c06 1403 * - encoding: unused
64863965 1404 * - decoding: unused
17a70fde
MN
1405 */
1406 int mb_qmax;
115329f1 1407
1457ab52 1408 /**
f5bccd85
DB
1409 * motion estimation comparison function
1410 * - encoding: Set by user.
64863965 1411 * - decoding: unused
1457ab52
MN
1412 */
1413 int me_cmp;
1414 /**
f5bccd85
DB
1415 * subpixel motion estimation comparison function
1416 * - encoding: Set by user.
64863965 1417 * - decoding: unused
1457ab52
MN
1418 */
1419 int me_sub_cmp;
1420 /**
f5bccd85
DB
1421 * macroblock comparison function (not supported yet)
1422 * - encoding: Set by user.
64863965 1423 * - decoding: unused
1457ab52
MN
1424 */
1425 int mb_cmp;
622348f9 1426 /**
f5bccd85
DB
1427 * interlaced DCT comparison function
1428 * - encoding: Set by user.
622348f9
MN
1429 * - decoding: unused
1430 */
1431 int ildct_cmp;
1457ab52
MN
1432#define FF_CMP_SAD 0
1433#define FF_CMP_SSE 1
1434#define FF_CMP_SATD 2
1435#define FF_CMP_DCT 3
1436#define FF_CMP_PSNR 4
1437#define FF_CMP_BIT 5
1438#define FF_CMP_RD 6
1439#define FF_CMP_ZERO 7
622348f9
MN
1440#define FF_CMP_VSAD 8
1441#define FF_CMP_VSSE 9
e6a2ac34 1442#define FF_CMP_NSSE 10
26efc54e
MN
1443#define FF_CMP_W53 11
1444#define FF_CMP_W97 12
0fd6aea1 1445#define FF_CMP_DCTMAX 13
27c61ac5 1446#define FF_CMP_DCT264 14
1457ab52 1447#define FF_CMP_CHROMA 256
115329f1 1448
1457ab52 1449 /**
f5bccd85
DB
1450 * ME diamond size & shape
1451 * - encoding: Set by user.
64863965 1452 * - decoding: unused
1457ab52
MN
1453 */
1454 int dia_size;
b07a5980
MN
1455
1456 /**
f5bccd85
DB
1457 * amount of previous MV predictors (2a+1 x 2a+1 square)
1458 * - encoding: Set by user.
64863965 1459 * - decoding: unused
b07a5980
MN
1460 */
1461 int last_predictor_count;
70ac76c0 1462
f5fb6b34 1463 /**
f5bccd85
DB
1464 * prepass for motion estimation
1465 * - encoding: Set by user.
64863965 1466 * - decoding: unused
f5fb6b34
MN
1467 */
1468 int pre_me;
b07a5980 1469
70ac76c0 1470 /**
f5bccd85
DB
1471 * motion estimation prepass comparison function
1472 * - encoding: Set by user.
64863965 1473 * - decoding: unused
70ac76c0
MN
1474 */
1475 int me_pre_cmp;
826f429a 1476
70ac76c0 1477 /**
f5bccd85
DB
1478 * ME prepass diamond size & shape
1479 * - encoding: Set by user.
64863965 1480 * - decoding: unused
70ac76c0
MN
1481 */
1482 int pre_dia_size;
1483
826f429a 1484 /**
f5bccd85
DB
1485 * subpel ME quality
1486 * - encoding: Set by user.
64863965 1487 * - decoding: unused
826f429a
MN
1488 */
1489 int me_subpel_quality;
1490
a33c7159 1491 /**
f5bccd85 1492 * callback to negotiate the pixelFormat
a33c7159 1493 * @param fmt is the list of formats which are supported by the codec,
f5bccd85
DB
1494 * it is terminated by -1 as 0 is a valid format, the formats are ordered by quality.
1495 * The first is always the native one.
1496 * @return the chosen format
64863965 1497 * - encoding: unused
f5bccd85 1498 * - decoding: Set by user, if not set the native format will be chosen.
a33c7159 1499 */
494c56d3 1500 enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt);
e2f9490e
FB
1501
1502 /**
f5bccd85
DB
1503 * DTG active format information (additional aspect ratio
1504 * information only used in DVB MPEG-2 transport streams)
1505 * 0 if not set.
115329f1 1506 *
f5bccd85
DB
1507 * - encoding: unused
1508 * - decoding: Set by decoder.
e2f9490e
FB
1509 */
1510 int dtg_active_format;
1511#define FF_DTG_AFD_SAME 8
1512#define FF_DTG_AFD_4_3 9
1513#define FF_DTG_AFD_16_9 10
1514#define FF_DTG_AFD_14_9 11
1515#define FF_DTG_AFD_4_3_SP_14_9 13
1516#define FF_DTG_AFD_16_9_SP_14_9 14
1517#define FF_DTG_AFD_SP_4_3 15
1518
ebbcdc9a 1519 /**
f5bccd85
DB
1520 * maximum motion estimation search range in subpel units
1521 * If 0 then no limit.
115329f1 1522 *
f5bccd85
DB
1523 * - encoding: Set by user.
1524 * - decoding: unused
ebbcdc9a 1525 */
59e0ac8e 1526 int me_range;
ebbcdc9a 1527
65f7062d 1528 /**
f5bccd85
DB
1529 * intra quantizer bias
1530 * - encoding: Set by user.
1984f635
MN
1531 * - decoding: unused
1532 */
1533 int intra_quant_bias;
1534#define FF_DEFAULT_QUANT_BIAS 999999
115329f1 1535
1984f635 1536 /**
f5bccd85
DB
1537 * inter quantizer bias
1538 * - encoding: Set by user.
1984f635
MN
1539 * - decoding: unused
1540 */
1541 int inter_quant_bias;
5cd62665
ZK
1542
1543 /**
f5bccd85
DB
1544 * color table ID
1545 * - encoding: unused
1546 * - decoding: Which clrtable should be used for 8bit RGB images.
1547 * Tables have to be stored somewhere. FIXME
5cd62665
ZK
1548 */
1549 int color_table_id;
115329f1 1550
d90cf87b 1551 /**
f5bccd85
DB
1552 * internal_buffer count
1553 * Don't touch, used by libavcodec default_get_buffer().
d90cf87b
MN
1554 */
1555 int internal_buffer_count;
115329f1 1556
d90cf87b 1557 /**
f5bccd85
DB
1558 * internal_buffers
1559 * Don't touch, used by libavcodec default_get_buffer().
d90cf87b
MN
1560 */
1561 void *internal_buffer;
158c7f05
MN
1562
1563#define FF_LAMBDA_SHIFT 7
1564#define FF_LAMBDA_SCALE (1<<FF_LAMBDA_SHIFT)
1565#define FF_QP2LAMBDA 118 ///< factor to convert from H.263 QP to lambda
1566#define FF_LAMBDA_MAX (256*128-1)
1567
1568#define FF_QUALITY_SCALE FF_LAMBDA_SCALE //FIXME maybe remove
3d2e8cce 1569 /**
f5bccd85
DB
1570 * Global quality for codecs which cannot change it per frame.
1571 * This should be proportional to MPEG-1/2/4 qscale.
1572 * - encoding: Set by user.
3d2e8cce
MN
1573 * - decoding: unused
1574 */
1575 int global_quality;
115329f1 1576
bd446bb1
MN
1577#define FF_CODER_TYPE_VLC 0
1578#define FF_CODER_TYPE_AC 1
f87459e4
KN
1579#define FF_CODER_TYPE_RAW 2
1580#define FF_CODER_TYPE_RLE 3
1581#define FF_CODER_TYPE_DEFLATE 4
11e659c2
MN
1582 /**
1583 * coder type
f5bccd85 1584 * - encoding: Set by user.
11e659c2
MN
1585 * - decoding: unused
1586 */
1587 int coder_type;
1588
1589 /**
1590 * context model
f5bccd85 1591 * - encoding: Set by user.
11e659c2
MN
1592 * - decoding: unused
1593 */
1594 int context_model;
5639729b
MN
1595#if 0
1596 /**
1597 *
1598 * - encoding: unused
f5bccd85 1599 * - decoding: Set by user.
5639729b
MN
1600 */
1601 uint8_t * (*realloc)(struct AVCodecContext *s, uint8_t *buf, int buf_size);
1602#endif
115329f1 1603
3bb07d61
MN
1604 /**
1605 * slice flags
1606 * - encoding: unused
f5bccd85 1607 * - decoding: Set by user.
3bb07d61
MN
1608 */
1609 int slice_flags;
1610#define SLICE_FLAG_CODED_ORDER 0x0001 ///< draw_horiz_band() is called in coded order instead of display
1611#define SLICE_FLAG_ALLOW_FIELD 0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics)
1612#define SLICE_FLAG_ALLOW_PLANE 0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)
1613
fb364ada
IK
1614 /**
1615 * XVideo Motion Acceleration
1616 * - encoding: forbidden
1617 * - decoding: set by decoder
1618 */
1619 int xvmc_acceleration;
115329f1 1620
7d1c3fc1
MN
1621 /**
1622 * macroblock decision mode
f5bccd85 1623 * - encoding: Set by user.
7d1c3fc1
MN
1624 * - decoding: unused
1625 */
1626 int mb_decision;
1627#define FF_MB_DECISION_SIMPLE 0 ///< uses mb_cmp
1628#define FF_MB_DECISION_BITS 1 ///< chooses the one which needs the fewest bits
1629#define FF_MB_DECISION_RD 2 ///< rate distoration
d6eb3c50
MN
1630
1631 /**
1632 * custom intra quantization matrix
f5bccd85
DB
1633 * - encoding: Set by user, can be NULL.
1634 * - decoding: Set by libavcodec.
d6eb3c50
MN
1635 */
1636 uint16_t *intra_matrix;
1637
1638 /**
1639 * custom inter quantization matrix
f5bccd85
DB
1640 * - encoding: Set by user, can be NULL.
1641 * - decoding: Set by libavcodec.
d6eb3c50
MN
1642 */
1643 uint16_t *inter_matrix;
115329f1 1644
541ae140
MN
1645 /**
1646 * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
f5bccd85 1647 * This is used to work around some encoder bugs.
541ae140 1648 * - encoding: unused
f5bccd85 1649 * - decoding: Set by user, will be converted to uppercase by libavcodec during init.
541ae140
MN
1650 */
1651 unsigned int stream_codec_tag;
05fbd0a2
MN
1652
1653 /**
f5bccd85
DB
1654 * scene change detection threshold
1655 * 0 is default, larger means fewer detected scene changes.
1656 * - encoding: Set by user.
05fbd0a2
MN
1657 * - decoding: unused
1658 */
1659 int scenechange_threshold;
158c7f05
MN
1660
1661 /**
f5bccd85
DB
1662 * minimum Lagrange multipler
1663 * - encoding: Set by user.
158c7f05
MN
1664 * - decoding: unused
1665 */
1666 int lmin;
1667
1668 /**
f5bccd85
DB
1669 * maximum Lagrange multipler
1670 * - encoding: Set by user.
158c7f05
MN
1671 * - decoding: unused
1672 */
1673 int lmax;
2a2bbcb0
MM
1674
1675 /**
f5bccd85 1676 * palette control structure
2a2bbcb0 1677 * - encoding: ??? (no palette-enabled encoder yet)
f5bccd85 1678 * - decoding: Set by user.
2a2bbcb0
MM
1679 */
1680 struct AVPaletteControl *palctrl;
821cb11f
MN
1681
1682 /**
1683 * noise reduction strength
f5bccd85 1684 * - encoding: Set by user.
821cb11f
MN
1685 * - decoding: unused
1686 */
1687 int noise_reduction;
115329f1 1688
074c4ca7 1689 /**
f5bccd85
DB
1690 * Called at the beginning of a frame to get cr buffer for it.
1691 * Buffer type (size, hints) must be the same. libavcodec won't check it.
1692 * libavcodec will pass previous buffer in pic, function should return
e1c2a5a0 1693 * same buffer or new buffer with old frame "painted" into it.
f5bccd85 1694 * If pic.data[0] == NULL must behave like get_buffer().
074c4ca7 1695 * - encoding: unused
f5bccd85 1696 * - decoding: Set by libavcodec., user can override
074c4ca7 1697 */
e1c2a5a0 1698 int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic);
ba58dabc
MN
1699
1700 /**
f5bccd85
DB
1701 * Number of bits which should be loaded into the rc buffer before decoding starts.
1702 * - encoding: Set by user.
ba58dabc
MN
1703 * - decoding: unused
1704 */
1705 int rc_initial_buffer_occupancy;
1706
1707 /**
1708 *
f5bccd85 1709 * - encoding: Set by user.
ba58dabc
MN
1710 * - decoding: unused
1711 */
1712 int inter_threshold;
1713
1714 /**
f5bccd85
DB
1715 * CODEC_FLAG2_*
1716 * - encoding: Set by user.
1717 * - decoding: Set by user.
ba58dabc
MN
1718 */
1719 int flags2;
7ebfc0ea
MN
1720
1721 /**
f5bccd85
DB
1722 * Simulates errors in the bitstream to test error concealment.
1723 * - encoding: Set by user.
1724 * - decoding: unused
7ebfc0ea
MN
1725 */
1726 int error_rate;
115329f1 1727
a1e257b2
MN
1728 /**
1729 * MP3 antialias algorithm, see FF_AA_* below.
1730 * - encoding: unused
f5bccd85 1731 * - decoding: Set by user.
a1e257b2
MN
1732 */
1733 int antialias_algo;
1734#define FF_AA_AUTO 0
1735#define FF_AA_FASTINT 1 //not implemented yet
1736#define FF_AA_INT 2
1737#define FF_AA_FLOAT 3
77ea0d4b 1738 /**
f5bccd85
DB
1739 * quantizer noise shaping
1740 * - encoding: Set by user.
77ea0d4b
MN
1741 * - decoding: unused
1742 */
1743 int quantizer_noise_shaping;
9c3d33d6
MN
1744
1745 /**
f5bccd85 1746 * thread count
eafcac6a 1747 * is used to decide how many independent tasks should be passed to execute()
f5bccd85
DB
1748 * - encoding: Set by user.
1749 * - decoding: Set by user.
9c3d33d6
MN
1750 */
1751 int thread_count;
115329f1 1752
9c3d33d6 1753 /**
f5bccd85
DB
1754 * The codec may call this to execute several independent things.
1755 * It will return only after finishing all tasks.
1756 * The user may replace this with some multithreaded implementation,
1757 * the default implementation will execute the parts serially.
399cec2f 1758 * @param count the number of things to execute
f5bccd85
DB
1759 * - encoding: Set by libavcodec, user can override.
1760 * - decoding: Set by libavcodec, user can override.
9c3d33d6
MN
1761 */
1762 int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void **arg2, int *ret, int count);
115329f1 1763
9c3d33d6 1764 /**
f5bccd85
DB
1765 * thread opaque
1766 * Can be used by execute() to store some per AVCodecContext stuff.
9c3d33d6
MN
1767 * - encoding: set by execute()
1768 * - decoding: set by execute()
1769 */
1770 void *thread_opaque;
a4d36c11
MN
1771
1772 /**
f5bccd85
DB
1773 * Motion estimation threshold below which no motion estimation is
1774 * performed, but instead the user specified motion vectors are used.
115329f1 1775 *
f5bccd85 1776 * - encoding: Set by user.
f20f8a8b 1777 * - decoding: unused
a4d36c11 1778 */
2750b827 1779 int me_threshold;
f20f8a8b
MN
1780
1781 /**
f5bccd85
DB
1782 * Macroblock threshold below which the user specified macroblock types will be used.
1783 * - encoding: Set by user.
f20f8a8b
MN
1784 * - decoding: unused
1785 */
1786 int mb_threshold;
bf266e19
MN
1787
1788 /**
f5bccd85
DB
1789 * precision of the intra DC coefficient - 8
1790 * - encoding: Set by user.
bf266e19
MN
1791 * - decoding: unused
1792 */
1793 int intra_dc_precision;
d4c5d2ad
MN
1794
1795 /**
f5bccd85
DB
1796 * noise vs. sse weight for the nsse comparsion function
1797 * - encoding: Set by user.
d4c5d2ad
MN
1798 * - decoding: unused
1799 */
1800 int nsse_weight;
0dfd33c3
MN
1801
1802 /**
f5bccd85 1803 * Number of macroblock rows at the top which are skipped.
0dfd33c3 1804 * - encoding: unused
f5bccd85 1805 * - decoding: Set by user.
0dfd33c3
MN
1806 */
1807 int skip_top;
1808
1809 /**
f5bccd85 1810 * Number of macroblock rows at the bottom which are skipped.
0dfd33c3 1811 * - encoding: unused
f5bccd85 1812 * - decoding: Set by user.
0dfd33c3
MN
1813 */
1814 int skip_bottom;
baced9f5
MN
1815
1816 /**
1817 * profile
f5bccd85
DB
1818 * - encoding: Set by user.
1819 * - decoding: Set by libavcodec.
baced9f5
MN
1820 */
1821 int profile;
1822#define FF_PROFILE_UNKNOWN -99
4f2c36ac
NG
1823#define FF_PROFILE_AAC_MAIN 0
1824#define FF_PROFILE_AAC_LOW 1
1825#define FF_PROFILE_AAC_SSR 2
1826#define FF_PROFILE_AAC_LTP 3
baced9f5
MN
1827
1828 /**
1829 * level
f5bccd85
DB
1830 * - encoding: Set by user.
1831 * - decoding: Set by libavcodec.
baced9f5
MN
1832 */
1833 int level;
1834#define FF_LEVEL_UNKNOWN -99
178fcca8
MN
1835
1836 /**
f5bccd85 1837 * low resolution decoding, 1-> 1/2 size, 2->1/4 size
178fcca8 1838 * - encoding: unused
f5bccd85 1839 * - decoding: Set by user.
178fcca8
MN
1840 */
1841 int lowres;
21adafec
MN
1842
1843 /**
f5bccd85
DB
1844 * Bitstream width / height, may be different from width/height if lowres
1845 * or other things are used.
21adafec 1846 * - encoding: unused
f5bccd85 1847 * - decoding: Set by user before init if known. Codec should override / dynamically change if needed.
21adafec
MN
1848 */
1849 int coded_width, coded_height;
bbf18b21
MN
1850
1851 /**
1852 * frame skip threshold
f5bccd85 1853 * - encoding: Set by user.
bbf18b21
MN
1854 * - decoding: unused
1855 */
1856 int frame_skip_threshold;
1857
1858 /**
1859 * frame skip factor
f5bccd85 1860 * - encoding: Set by user.
bbf18b21
MN
1861 * - decoding: unused
1862 */
1863 int frame_skip_factor;
0fd6aea1
MN
1864
1865 /**
1866 * frame skip exponent
f5bccd85 1867 * - encoding: Set by user.
0fd6aea1
MN
1868 * - decoding: unused
1869 */
1870 int frame_skip_exp;
1871
1872 /**
f5bccd85
DB
1873 * frame skip comparison function
1874 * - encoding: Set by user.
0fd6aea1
MN
1875 * - decoding: unused
1876 */
1877 int frame_skip_cmp;
957c743a
CM
1878
1879 /**
f5bccd85 1880 * Border processing masking, raises the quantizer for mbs on the borders
957c743a 1881 * of the picture.
f5bccd85 1882 * - encoding: Set by user.
957c743a
CM
1883 * - decoding: unused
1884 */
1885 float border_masking;
6e0d8c06
MN
1886
1887 /**
f5bccd85
DB
1888 * minimum MB lagrange multipler
1889 * - encoding: Set by user.
6e0d8c06
MN
1890 * - decoding: unused
1891 */
1892 int mb_lmin;
1893
1894 /**
f5bccd85
DB
1895 * maximum MB lagrange multipler
1896 * - encoding: Set by user.
6e0d8c06
MN
1897 * - decoding: unused
1898 */
1899 int mb_lmax;
09c3e44e
MN
1900
1901 /**
115329f1 1902 *
f5bccd85 1903 * - encoding: Set by user.
09c3e44e
MN
1904 * - decoding: unused
1905 */
1906 int me_penalty_compensation;
8c3eba7c
MN
1907
1908 /**
115329f1 1909 *
8c3eba7c 1910 * - encoding: unused
f5bccd85 1911 * - decoding: Set by user.
8c3eba7c
MN
1912 */
1913 enum AVDiscard skip_loop_filter;
1914
1915 /**
115329f1 1916 *
8c3eba7c 1917 * - encoding: unused
f5bccd85 1918 * - decoding: Set by user.
8c3eba7c
MN
1919 */
1920 enum AVDiscard skip_idct;
1921
1922 /**
115329f1 1923 *
8c3eba7c 1924 * - encoding: unused
f5bccd85 1925 * - decoding: Set by user.
8c3eba7c
MN
1926 */
1927 enum AVDiscard skip_frame;
316a2ec8
MN
1928
1929 /**
1930 *
f5bccd85 1931 * - encoding: Set by user.
316a2ec8
MN
1932 * - decoding: unused
1933 */
1934 int bidir_refine;
e8501c93
MN
1935
1936 /**
1937 *
f5bccd85 1938 * - encoding: Set by user.
e8501c93
MN
1939 * - decoding: unused
1940 */
1941 int brd_scale;
58f7833e
RS
1942
1943 /**
1944 * constant rate factor - quality-based VBR - values ~correspond to qps
f5bccd85 1945 * - encoding: Set by user.
58f7833e
RS
1946 * - decoding: unused
1947 */
9f1c1c99 1948 float crf;
58f7833e
RS
1949
1950 /**
1951 * constant quantization parameter rate control method
f5bccd85 1952 * - encoding: Set by user.
58f7833e
RS
1953 * - decoding: unused
1954 */
1955 int cqp;
1956
1957 /**
f5bccd85
DB
1958 * minimum GOP size
1959 * - encoding: Set by user.
58f7833e
RS
1960 * - decoding: unused
1961 */
1962 int keyint_min;
1963
1964 /**
1965 * number of reference frames
f5bccd85 1966 * - encoding: Set by user.
58f7833e
RS
1967 * - decoding: unused
1968 */
1969 int refs;
1970
1971 /**
1972 * chroma qp offset from luma
f5bccd85 1973 * - encoding: Set by user.
58f7833e
RS
1974 * - decoding: unused
1975 */
1976 int chromaoffset;
1977
1978 /**
f5bccd85
DB
1979 * Influences how often B-frames are used.
1980 * - encoding: Set by user.
58f7833e
RS
1981 * - decoding: unused
1982 */
1983 int bframebias;
1984
1985 /**
1986 * trellis RD quantization
f5bccd85 1987 * - encoding: Set by user.
58f7833e
RS
1988 * - decoding: unused
1989 */
1990 int trellis;
1991
1992 /**
f5bccd85
DB
1993 * Reduce fluctuations in qp (before curve compression).
1994 * - encoding: Set by user.
58f7833e
RS
1995 * - decoding: unused
1996 */
1997 float complexityblur;
1998
1999 /**
2000 * in-loop deblocking filter alphac0 parameter
2001 * alpha is in the range -6...6
f5bccd85 2002 * - encoding: Set by user.
58f7833e
RS
2003 * - decoding: unused
2004 */
2005 int deblockalpha;
2006
2007 /**
2008 * in-loop deblocking filter beta parameter
2009 * beta is in the range -6...6
f5bccd85 2010 * - encoding: Set by user.
58f7833e
RS
2011 * - decoding: unused
2012 */
2013 int deblockbeta;
2014
2015 /**
2016 * macroblock subpartition sizes to consider - p8x8, p4x4, b8x8, i8x8, i4x4
f5bccd85 2017 * - encoding: Set by user.
58f7833e
RS
2018 * - decoding: unused
2019 */
2020 int partitions;
2021#define X264_PART_I4X4 0x001 /* Analyse i4x4 */
2022#define X264_PART_I8X8 0x002 /* Analyse i8x8 (requires 8x8 transform) */
2023#define X264_PART_P8X8 0x010 /* Analyse p16x8, p8x16 and p8x8 */
2024#define X264_PART_P4X4 0x020 /* Analyse p8x4, p4x8, p4x4 */
2025#define X264_PART_B8X8 0x100 /* Analyse b16x8, b8x16 and b8x8 */
2026
2027 /**
f5bccd85
DB
2028 * direct MV prediction mode - 0 (none), 1 (spatial), 2 (temporal)
2029 * - encoding: Set by user.
58f7833e
RS
2030 * - decoding: unused
2031 */
2032 int directpred;
4f59b684 2033
14f0c8e2 2034 /**
f5bccd85
DB
2035 * Audio cutoff bandwidth (0 means "automatic"), currently used only by FAAC.
2036 * - encoding: Set by user.
14f0c8e2
LA
2037 * - decoding: unused
2038 */
2039 int cutoff;
39a64e30
CH
2040
2041 /**
f5bccd85
DB
2042 * Multiplied by qscale for each frame and added to scene_change_score.
2043 * - encoding: Set by user.
39a64e30
CH
2044 * - decoding: unused
2045 */
2046 int scenechange_factor;
1dd509b1
MN
2047
2048 /**
2049 *
f5bccd85
DB
2050 * Note: Value depends upon the compare function used for fullpel ME.
2051 * - encoding: Set by user.
1dd509b1
MN
2052 * - decoding: unused
2053 */
2054 int mv0_threshold;
f9243d34
CH
2055
2056 /**
f5bccd85
DB
2057 * Adjusts sensitivity of b_frame_strategy 1.
2058 * - encoding: Set by user.
f9243d34
CH
2059 * - decoding: unused
2060 */
2061 int b_sensitivity;
a403fc03
JR
2062
2063 /**
f5bccd85 2064 * - encoding: Set by user.
a403fc03
JR
2065 * - decoding: unused
2066 */
2067 int compression_level;
2068#define FF_COMPRESSION_DEFAULT -1
2069
2070 /**
f5bccd85
DB
2071 * Sets whether to use LPC mode - used by FLAC encoder.
2072 * - encoding: Set by user.
2073 * - decoding: unused
a403fc03
JR
2074 */
2075 int use_lpc;
2076
2077 /**
2078 * LPC coefficient precision - used by FLAC encoder
f5bccd85
DB
2079 * - encoding: Set by user.
2080 * - decoding: unused
a403fc03
JR
2081 */
2082 int lpc_coeff_precision;
2083
2084 /**
f5bccd85
DB
2085 * - encoding: Set by user.
2086 * - decoding: unused
a403fc03
JR
2087 */
2088 int min_prediction_order;
2089
2090 /**
f5bccd85
DB
2091 * - encoding: Set by user.
2092 * - decoding: unused
a403fc03
JR
2093 */
2094 int max_prediction_order;
2095
2096 /**
2097 * search method for selecting prediction order
f5bccd85
DB
2098 * - encoding: Set by user.
2099 * - decoding: unused
a403fc03
JR
2100 */
2101 int prediction_order_method;
2102
2103 /**
f5bccd85
DB
2104 * - encoding: Set by user.
2105 * - decoding: unused
a403fc03
JR
2106 */
2107 int min_partition_order;
2108
2109 /**
f5bccd85
DB
2110 * - encoding: Set by user.
2111 * - decoding: unused
a403fc03
JR
2112 */
2113 int max_partition_order;
80d617f5
BC
2114
2115 /**
2116 * GOP timecode frame start number, in non drop frame format
f5bccd85
DB
2117 * - encoding: Set by user.
2118 * - decoding: unused
80d617f5
BC
2119 */
2120 int64_t timecode_frame_start;
de6d9b64
FB
2121} AVCodecContext;
2122
64863965
MN
2123/**
2124 * AVCodec.
2125 */
de6d9b64 2126typedef struct AVCodec {
18f77016 2127 const char *name;
5d234974 2128 enum CodecType type;
9297ddd3 2129 enum CodecID id;
de6d9b64
FB
2130 int priv_data_size;
2131 int (*init)(AVCodecContext *);
0c1a9eda 2132 int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
de6d9b64 2133 int (*close)(AVCodecContext *);
0fd90455 2134 int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
0c1a9eda 2135 uint8_t *buf, int buf_size);
bf89e6b1 2136 int capabilities;
de6d9b64 2137 struct AVCodec *next;
7a06ff14 2138 void (*flush)(AVCodecContext *);
b0df362b 2139 const AVRational *supported_framerates; ///array of supported framerates, or NULL if any, array is terminated by {0,0}
fcee0164 2140 const enum PixelFormat *pix_fmts; ///array of supported pixel formats, or NULL if unknown, array is terminanted by -1
de6d9b64
FB
2141} AVCodec;
2142
97d96aaa 2143/**
d7425f59
MN
2144 * four components are given, that's all.
2145 * the last component is alpha
2146 */
de6d9b64 2147typedef struct AVPicture {
0c1a9eda 2148 uint8_t *data[4];
cd394651 2149 int linesize[4]; ///< number of bytes per line
de6d9b64
FB
2150} AVPicture;
2151
ba118447
MM
2152/**
2153 * AVPaletteControl
2154 * This structure defines a method for communicating palette changes
2155 * between and demuxer and a decoder.
671adb17
MC
2156 *
2157 * @deprecated Use AVPacket to send palette changes instead.
2158 * This is totally broken.
ba118447 2159 */
2e99641b 2160#define AVPALETTE_SIZE 1024
432d84c3 2161#define AVPALETTE_COUNT 256
ba118447
MM
2162typedef struct AVPaletteControl {
2163
f5bccd85
DB
2164 /* Demuxer sets this to 1 to indicate the palette has changed;
2165 * decoder resets to 0. */
ba118447
MM
2166 int palette_changed;
2167
2a2bbcb0
MM
2168 /* 4-byte ARGB palette entries, stored in native byte order; note that
2169 * the individual palette components should be on a 8-bit scale; if
f5bccd85
DB
2170 * the palette data comes from an IBM VGA native format, the component
2171 * data is probably 6 bits in size and needs to be scaled. */
2e99641b 2172 unsigned int palette[AVPALETTE_COUNT];
ba118447 2173
18239edf 2174} AVPaletteControl attribute_deprecated;
ba118447 2175
c6ec28b1 2176typedef struct AVSubtitleRect {
240c1657
FB
2177 uint16_t x;
2178 uint16_t y;
2179 uint16_t w;
2180 uint16_t h;
2181 uint16_t nb_colors;
240c1657
FB
2182 int linesize;
2183 uint32_t *rgba_palette;
2184 uint8_t *bitmap;
c6ec28b1
MN
2185} AVSubtitleRect;
2186
2187typedef struct AVSubtitle {
2188 uint16_t format; /* 0 = graphics */
2189 uint32_t start_display_time; /* relative to packet pts, in ms */
2190 uint32_t end_display_time; /* relative to packet pts, in ms */
2191 uint32_t num_rects;
2192 AVSubtitleRect *rects;
240c1657
FB
2193} AVSubtitle;
2194
de6d9b64 2195extern AVCodec ac3_encoder;
7ce6a249
DB
2196extern AVCodec asv1_encoder;
2197extern AVCodec asv2_encoder;
52548eee 2198extern AVCodec bmp_encoder;
7ce6a249 2199extern AVCodec dvvideo_encoder;
7ce6a249
DB
2200extern AVCodec ffv1_encoder;
2201extern AVCodec ffvhuff_encoder;
9e96ab03 2202extern AVCodec flac_encoder;
7ce6a249
DB
2203extern AVCodec flashsv_encoder;
2204extern AVCodec flv_encoder;
93481fe5 2205extern AVCodec gif_encoder;
1c3990db 2206extern AVCodec h261_encoder;
de6d9b64
FB
2207extern AVCodec h263_encoder;
2208extern AVCodec h263p_encoder;
7ce6a249
DB
2209extern AVCodec h264_encoder;
2210extern AVCodec huffyuv_encoder;
5639729b 2211extern AVCodec jpegls_encoder;
7ce6a249
DB
2212extern AVCodec ljpeg_encoder;
2213extern AVCodec mdec_encoder;
2214extern AVCodec mjpeg_encoder;
2215extern AVCodec mp2_encoder;
7ce6a249
DB
2216extern AVCodec mpeg1video_encoder;
2217extern AVCodec mpeg2video_encoder;
bf89e6b1 2218extern AVCodec mpeg4_encoder;
84afee34
MN
2219extern AVCodec msmpeg4v1_encoder;
2220extern AVCodec msmpeg4v2_encoder;
2221extern AVCodec msmpeg4v3_encoder;
7ce6a249
DB
2222extern AVCodec pam_encoder;
2223extern AVCodec pbm_encoder;
2224extern AVCodec pgm_encoder;
2225extern AVCodec pgmyuv_encoder;
2226extern AVCodec png_encoder;
2227extern AVCodec ppm_encoder;
f025588b 2228extern AVCodec roq_dpcm_encoder;
7ce6a249
DB
2229extern AVCodec rv10_encoder;
2230extern AVCodec rv20_encoder;
2d99eed1 2231extern AVCodec sgi_encoder;
791e7b83 2232extern AVCodec snow_encoder;
54f5fd22
AB
2233extern AVCodec sonic_encoder;
2234extern AVCodec sonic_ls_encoder;
3b64893d 2235extern AVCodec svq1_encoder;
2c0c00cb 2236extern AVCodec targa_encoder;
716222db 2237extern AVCodec tiff_encoder;
7ce6a249
DB
2238extern AVCodec vcr1_encoder;
2239extern AVCodec vorbis_encoder;
59686073
MN
2240extern AVCodec wmav1_encoder;
2241extern AVCodec wmav2_encoder;
7ce6a249
DB
2242extern AVCodec wmv1_encoder;
2243extern AVCodec wmv2_encoder;
ec23a8cb 2244extern AVCodec zmbv_encoder;
de6d9b64 2245
7ce6a249
DB
2246extern AVCodec aasc_decoder;
2247extern AVCodec alac_decoder;
7ce6a249
DB
2248extern AVCodec asv1_decoder;
2249extern AVCodec asv2_decoder;
10e26bc7 2250extern AVCodec atrac3_decoder;
7ce6a249 2251extern AVCodec avs_decoder;
1e6c6759 2252extern AVCodec bethsoftvid_decoder;
7ce6a249 2253extern AVCodec bmp_decoder;
9a0ddd09 2254extern AVCodec c93_decoder;
7ce6a249
DB
2255extern AVCodec cavs_decoder;
2256extern AVCodec cinepak_decoder;
2257extern AVCodec cljr_decoder;
2258extern AVCodec cook_decoder;
2259extern AVCodec cscd_decoder;
2260extern AVCodec cyuv_decoder;
01ca9ac3 2261extern AVCodec dca_decoder;
52b6bad2 2262extern AVCodec dnxhd_decoder;
7ce6a249
DB
2263extern AVCodec dsicinaudio_decoder;
2264extern AVCodec dsicinvideo_decoder;
2265extern AVCodec dvvideo_decoder;
33a0dd37 2266extern AVCodec dxa_decoder;
7ce6a249
DB
2267extern AVCodec eightbps_decoder;
2268extern AVCodec ffv1_decoder;
2269extern AVCodec ffvhuff_decoder;
2270extern AVCodec flac_decoder;
2271extern AVCodec flashsv_decoder;
2272extern AVCodec flic_decoder;
2273extern AVCodec flv_decoder;
2274extern AVCodec fourxm_decoder;
2275extern AVCodec fraps_decoder;
06d392a7 2276extern AVCodec gif_decoder;
c6148de2 2277extern AVCodec h261_decoder;
7ce6a249 2278extern AVCodec h263_decoder;
de6d9b64 2279extern AVCodec h263i_decoder;
7ce6a249
DB
2280extern AVCodec h264_decoder;
2281extern AVCodec huffyuv_decoder;
2282extern AVCodec idcin_decoder;
2283extern AVCodec imc_decoder;
2284extern AVCodec indeo2_decoder;
2285extern AVCodec indeo3_decoder;
2286extern AVCodec interplay_dpcm_decoder;
2287extern AVCodec interplay_video_decoder;
2288extern AVCodec kmvc_decoder;
7ce6a249
DB
2289extern AVCodec loco_decoder;
2290extern AVCodec mace3_decoder;
2291extern AVCodec mace6_decoder;
2292extern AVCodec mdec_decoder;
4e66ab3b 2293extern AVCodec mjpeg_decoder;
b135d9fb 2294extern AVCodec mjpegb_decoder;
7ce6a249 2295extern AVCodec mmvideo_decoder;
4b1f4f23 2296extern AVCodec mp2_decoder;
a96b68b7 2297extern AVCodec mp3_decoder;
1ede228a 2298extern AVCodec mp3adu_decoder;
d2a7718d 2299extern AVCodec mp3on4_decoder;
7ce6a249
DB
2300extern AVCodec mpc7_decoder;
2301extern AVCodec mpeg1video_decoder;
2302extern AVCodec mpeg2video_decoder;
2303extern AVCodec mpeg4_decoder;
7ce6a249
DB
2304extern AVCodec mpeg_xvmc_decoder;
2305extern AVCodec mpegvideo_decoder;
2306extern AVCodec msmpeg4v1_decoder;
2307extern AVCodec msmpeg4v2_decoder;
2308extern AVCodec msmpeg4v3_decoder;
2fdf638b
MM
2309extern AVCodec msrle_decoder;
2310extern AVCodec msvideo1_decoder;
a273bbfb 2311extern AVCodec mszh_decoder;
7ce6a249 2312extern AVCodec nuv_decoder;
7ce6a249 2313extern AVCodec png_decoder;
b46d68c6 2314extern AVCodec ptx_decoder;
7ce6a249
DB
2315extern AVCodec qdm2_decoder;
2316extern AVCodec qdraw_decoder;
2317extern AVCodec qpeg_decoder;
2318extern AVCodec qtrle_decoder;
b8414bbd
NK
2319extern AVCodec ra_144_decoder;
2320extern AVCodec ra_288_decoder;
7ce6a249 2321extern AVCodec roq_decoder;
3ef8be2b 2322extern AVCodec roq_dpcm_decoder;
7ce6a249
DB
2323extern AVCodec rpza_decoder;
2324extern AVCodec rv10_decoder;
2325extern AVCodec rv20_decoder;
2326extern AVCodec rv30_decoder;
2327extern AVCodec rv40_decoder;
2d99eed1 2328extern AVCodec sgi_decoder;
7ce6a249
DB
2329extern AVCodec shorten_decoder;
2330extern AVCodec smackaud_decoder;
2331extern AVCodec smacker_decoder;
2332extern AVCodec smc_decoder;
2333extern AVCodec snow_decoder;
d08d7142 2334extern AVCodec sol_dpcm_decoder;
54f5fd22 2335extern AVCodec sonic_decoder;
7ce6a249
DB
2336extern AVCodec sp5x_decoder;
2337extern AVCodec svq1_decoder;
2338extern AVCodec svq3_decoder;
2339extern AVCodec targa_decoder;
2340extern AVCodec theora_decoder;
efb0c399 2341extern AVCodec thp_decoder;
7ce6a249
DB
2342extern AVCodec tiertexseqvideo_decoder;
2343extern AVCodec tiff_decoder;
2344extern AVCodec truemotion1_decoder;
2345extern AVCodec truemotion2_decoder;
2346extern AVCodec truespeech_decoder;
9d53d58e 2347extern AVCodec tscc_decoder;
7ce6a249 2348extern AVCodec tta_decoder;
d0a0bbd2 2349extern AVCodec ulti_decoder;
7ce6a249
DB
2350extern AVCodec vc1_decoder;
2351extern AVCodec vcr1_decoder;
2352extern AVCodec vmdaudio_decoder;
2353extern AVCodec vmdvideo_decoder;
2354extern AVCodec vmnc_decoder;
2355extern AVCodec vorbis_decoder;
2356extern AVCodec vp3_decoder;
2357extern AVCodec vp5_decoder;
2358extern AVCodec vp6_decoder;
2359extern AVCodec vp6f_decoder;
2360extern AVCodec vqa_decoder;
2361extern AVCodec wavpack_decoder;
2362extern AVCodec wmav1_decoder;
2363extern AVCodec wmav2_decoder;
2364extern AVCodec wmv1_decoder;
2365extern AVCodec wmv2_decoder;
2366extern AVCodec wmv3_decoder;
a8a15e9d 2367extern AVCodec wnv1_decoder;
034eeaa1 2368extern AVCodec ws_snd1_decoder;
7ce6a249
DB
2369extern AVCodec xan_dpcm_decoder;
2370extern AVCodec xan_wc3_decoder;
2371extern AVCodec xl_decoder;
9c8d8e84 2372extern AVCodec zmbv_decoder;
de6d9b64 2373
f5bccd85 2374/* PCM codecs */
a96b68b7
FB
2375#define PCM_CODEC(id, name) \
2376extern AVCodec name ## _decoder; \
f11d3f23 2377extern AVCodec name ## _encoder
a96b68b7 2378
7ce6a249
DB
2379PCM_CODEC(CODEC_ID_PCM_ALAW, pcm_alaw);
2380PCM_CODEC(CODEC_ID_PCM_MULAW, pcm_mulaw);
2381PCM_CODEC(CODEC_ID_PCM_S8, pcm_s8);
2382PCM_CODEC(CODEC_ID_PCM_S16BE, pcm_s16be);
2383PCM_CODEC(CODEC_ID_PCM_S16LE, pcm_s16le);
2384PCM_CODEC(CODEC_ID_PCM_S24BE, pcm_s24be);
b461b3bc 2385PCM_CODEC(CODEC_ID_PCM_S24DAUD, pcm_s24daud);
7ce6a249
DB
2386PCM_CODEC(CODEC_ID_PCM_S24LE, pcm_s24le);
2387PCM_CODEC(CODEC_ID_PCM_S32BE, pcm_s32be);
2388PCM_CODEC(CODEC_ID_PCM_S32LE, pcm_s32le);
2389PCM_CODEC(CODEC_ID_PCM_U8, pcm_u8);
2390PCM_CODEC(CODEC_ID_PCM_U16BE, pcm_u16be);
2391PCM_CODEC(CODEC_ID_PCM_U16LE, pcm_u16le);
2392PCM_CODEC(CODEC_ID_PCM_U24BE, pcm_u24be);
2393PCM_CODEC(CODEC_ID_PCM_U24LE, pcm_u24le);
2394PCM_CODEC(CODEC_ID_PCM_U32BE, pcm_u32be);
2395PCM_CODEC(CODEC_ID_PCM_U32LE, pcm_u32le);
a96b68b7 2396
f5bccd85 2397/* ADPCM codecs */
0147f198 2398
7ce6a249
DB
2399PCM_CODEC(CODEC_ID_ADPCM_4XM, adpcm_4xm);
2400PCM_CODEC(CODEC_ID_ADPCM_ADX, adpcm_adx);
2401PCM_CODEC(CODEC_ID_ADPCM_CT, adpcm_ct);
2402PCM_CODEC(CODEC_ID_ADPCM_EA, adpcm_ea);
2403PCM_CODEC(CODEC_ID_ADPCM_G726, adpcm_g726);
9937e686
MM
2404PCM_CODEC(CODEC_ID_ADPCM_IMA_DK3, adpcm_ima_dk3);
2405PCM_CODEC(CODEC_ID_ADPCM_IMA_DK4, adpcm_ima_dk4);
7ce6a249
DB
2406PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
2407PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
2408PCM_CODEC(CODEC_ID_ADPCM_IMA_WS, adpcm_ima_ws);
2409PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);
2433f24f 2410PCM_CODEC(CODEC_ID_ADPCM_SBPRO_2, adpcm_sbpro_2);
7ce6a249
DB
2411PCM_CODEC(CODEC_ID_ADPCM_SBPRO_3, adpcm_sbpro_3);
2412PCM_CODEC(CODEC_ID_ADPCM_SBPRO_4, adpcm_sbpro_4);
2413PCM_CODEC(CODEC_ID_ADPCM_SMJPEG, adpcm_ima_smjpeg);
2414PCM_CODEC(CODEC_ID_ADPCM_SWF, adpcm_swf);
d1e0d21f 2415PCM_CODEC(CODEC_ID_ADPCM_THP, adpcm_thp);
7ce6a249
DB
2416PCM_CODEC(CODEC_ID_ADPCM_XA, adpcm_xa);
2417PCM_CODEC(CODEC_ID_ADPCM_YAMAHA, adpcm_yamaha);
0147f198 2418
a96b68b7
FB
2419#undef PCM_CODEC
2420
2421/* dummy raw video codec */
63167088 2422extern AVCodec rawvideo_decoder;
7ce6a249 2423extern AVCodec rawvideo_encoder;
de6d9b64 2424
aa244b69
DB
2425/* the following codecs use external libs */
2426extern AVCodec aac_decoder;
aa244b69 2427extern AVCodec faac_encoder;
f4ca5079 2428extern AVCodec liba52_decoder;
f5a756ef
DB
2429extern AVCodec libamr_nb_decoder;
2430extern AVCodec libamr_nb_encoder;
2431extern AVCodec libamr_wb_decoder;
2432extern AVCodec libamr_wb_encoder;
23aee960 2433extern AVCodec libdts_decoder;
aa244b69
DB
2434extern AVCodec libgsm_decoder;
2435extern AVCodec libgsm_encoder;
2436extern AVCodec libgsm_ms_decoder;
2437extern AVCodec libgsm_ms_encoder;
2438extern AVCodec libtheora_encoder;
b0caf888
DB
2439extern AVCodec libvorbis_decoder;
2440extern AVCodec libvorbis_encoder;
aa244b69
DB
2441extern AVCodec mp3lame_encoder;
2442extern AVCodec mpeg4aac_decoder;
aa244b69
DB
2443extern AVCodec x264_encoder;
2444extern AVCodec xvid_encoder;
2445extern AVCodec zlib_decoder;
2446extern AVCodec zlib_encoder;
de6d9b64 2447
240c1657 2448/* subtitles */
c6ec28b1 2449extern AVCodec dvbsub_decoder;
7ce6a249
DB
2450extern AVCodec dvbsub_encoder;
2451extern AVCodec dvdsub_decoder;
2452extern AVCodec dvdsub_encoder;
240c1657 2453
de6d9b64
FB
2454/* resample.c */
2455
2456struct ReSampleContext;
aaaf1635 2457struct AVResampleContext;
de6d9b64
FB
2458
2459typedef struct ReSampleContext ReSampleContext;
2460
115329f1 2461ReSampleContext *audio_resample_init(int output_channels, int input_channels,
de6d9b64
FB
2462 int output_rate, int input_rate);
2463int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
2464void audio_resample_close(ReSampleContext *s);
2465
6e225de2 2466struct AVResampleContext *av_resample_init(int out_rate, int in_rate, int filter_length, int log2_phase_count, int linear, double cutoff);
aaaf1635 2467int av_resample(struct AVResampleContext *c, short *dst, short *src, int *consumed, int src_size, int dst_size, int update_ctx);
2d48eddd 2468void av_resample_compensate(struct AVResampleContext *c, int sample_delta, int compensation_distance);
d88443ae 2469void av_resample_close(struct AVResampleContext *c);
aaaf1635 2470
bc2ce35b 2471#if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
de6d9b64
FB
2472/* YUV420 format is assumed ! */
2473
671adb17
MC
2474/**
2475 * @deprecated Use the software scaler (swscale) instead.
2476 */
bc2ce35b 2477struct ImgReSampleContext attribute_deprecated;
de6d9b64 2478
671adb17
MC
2479/**
2480 * @deprecated Use the software scaler (swscale) instead.
2481 */
bc2ce35b 2482typedef struct ImgReSampleContext ImgReSampleContext attribute_deprecated;
de6d9b64 2483
671adb17
MC
2484/**
2485 * @deprecated Use the software scaler (swscale) instead.
2486 */
bc2ce35b 2487attribute_deprecated ImgReSampleContext *img_resample_init(int output_width, int output_height,
de6d9b64 2488 int input_width, int input_height);
ab6d194a 2489
671adb17
MC
2490/**
2491 * @deprecated Use the software scaler (swscale) instead.
2492 */
bc2ce35b 2493attribute_deprecated ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
ab6d194a
MN
2494 int iwidth, int iheight,
2495 int topBand, int bottomBand,
1ff93ffc
TK
2496 int leftBand, int rightBand,
2497 int padtop, int padbottom,
2498 int padleft, int padright);
2499
671adb17
MC
2500/**
2501 * @deprecated Use the software scaler (swscale) instead.
2502 */
bc2ce35b 2503attribute_deprecated void img_resample(ImgReSampleContext *s,
da64ecc3 2504 AVPicture *output, const AVPicture *input);
de6d9b64 2505
671adb17
MC
2506/**
2507 * @deprecated Use the software scaler (swscale) instead.
2508 */
bc2ce35b
MN
2509attribute_deprecated void img_resample_close(ImgReSampleContext *s);
2510
2511#endif
de6d9b64 2512
75917b88
DH
2513/**
2514 * Allocate memory for a picture. Call avpicture_free to free it.
2515 *
f5bccd85
DB
2516 * @param picture the picture to be filled in
2517 * @param pix_fmt the format of the picture
2518 * @param width the width of the picture
2519 * @param height the height of the picture
2520 * @return zero if successful, a negative value if not
75917b88
DH
2521 */
2522int avpicture_alloc(AVPicture *picture, int pix_fmt, int width, int height);
2523
8fc3d25c
PI
2524/**
2525 * Free a picture previously allocated by avpicture_alloc().
2526 *
f5bccd85 2527 * @param picture the AVPicture to be freed
8fc3d25c 2528 */
75917b88
DH
2529void avpicture_free(AVPicture *picture);
2530
392cf77a 2531/**
f5bccd85 2532 * Fill in the AVPicture fields.
392cf77a
PI
2533 * The fields of the given AVPicture are filled in by using the 'ptr' address
2534 * which points to the image data buffer. Depending on the specified picture
2535 * format, one or multiple image data pointers and line sizes will be set.
2536 * If a planar format is specified, several pointers will be set pointing to
2537 * the different picture planes and the line sizes of the different planes
2538 * will be stored in the lines_sizes array.
2539 *
f5bccd85 2540 * @param picture AVPicture whose fields are to be filled in
392cf77a 2541 * @param ptr Buffer which will contain or contains the actual image data
f5bccd85
DB
2542 * @param pix_fmt The format in which the picture data is stored.
2543 * @param width the width of the image in pixels
2544 * @param height the height of the image in pixels
2545 * @return size of the image data in bytes
392cf77a 2546 */
0c1a9eda 2547int avpicture_fill(AVPicture *picture, uint8_t *ptr,
2d1a4094 2548 int pix_fmt, int width, int height);
da64ecc3 2549int avpicture_layout(const AVPicture* src, int pix_fmt, int width, int height,
63167088 2550 unsigned char *dest, int dest_size);
392cf77a
PI
2551
2552/**
2553 * Calculate the size in bytes that a picture of the given width and height
2554 * would occupy if stored in the given picture format.
2555 *
f5bccd85
DB
2556 * @param pix_fmt the given picture format
2557 * @param width the width of the image
2558 * @param height the height of the image
392cf77a
PI
2559 * @return Image data size in bytes
2560 */
219b06c6 2561int avpicture_get_size(int pix_fmt, int width, int height);
dab64ebc
FB
2562void avcodec_get_chroma_sub_sample(int pix_fmt, int *h_shift, int *v_shift);
2563const char *avcodec_get_pix_fmt_name(int pix_fmt);
21adafec 2564void avcodec_set_dimensions(AVCodecContext *s, int width, int height);
63167088 2565enum PixelFormat avcodec_get_pix_fmt(const char* name);
d07730dd 2566unsigned int avcodec_pix_fmt_to_codec_tag(enum PixelFormat p);
219b06c6 2567
81299d42
PI
2568#define FF_LOSS_RESOLUTION 0x0001 /**< loss due to resolution change */
2569#define FF_LOSS_DEPTH 0x0002 /**< loss due to color depth change */
2570#define FF_LOSS_COLORSPACE 0x0004 /**< loss due to color space conversion */
2571#define FF_LOSS_ALPHA 0x0008 /**< loss of alpha bits */
2572#define FF_LOSS_COLORQUANT 0x0010 /**< loss due to color quantization */
2573#define FF_LOSS_CHROMA 0x0020 /**< loss of chroma (e.g. RGB to gray conversion) */
fab21997 2574
392cf77a 2575/**
81299d42
PI
2576 * Computes what kind of losses will occur when converting from one specific
2577 * pixel format to another.
2578 * When converting from one pixel format to another, information loss may occur.
2579 * For example, when converting from RGB24 to GRAY, the color information will
2580 * be lost. Similarly, other losses occur when converting from some formats to
2581 * other formats. These losses can involve loss of chroma, but also loss of
2582 * resolution, loss of color depth, loss due to the color space conversion, loss
2583 * of the alpha bits or loss due to color quantization.
f5bccd85
DB
2584 * avcodec_get_fix_fmt_loss() informs you about the various types of losses
2585 * which will occur when converting from one pixel format to another.
81299d42 2586 *
f5bccd85
DB
2587 * @param[in] dst_pix_fmt destination pixel format
2588 * @param[in] src_pix_fmt source pixel format
81299d42
PI
2589 * @param[in] has_alpha Whether the source pixel format alpha channel is used.
2590 * @return Combination of flags informing you what kind of losses will occur.
392cf77a 2591 */
fab21997
FB
2592int avcodec_get_pix_fmt_loss(int dst_pix_fmt, int src_pix_fmt,
2593 int has_alpha);
392cf77a
PI
2594
2595/**
81299d42
PI
2596 * Finds the best pixel format to convert to given a certain source pixel
2597 * format. When converting from one pixel format to another, information loss
2598 * may occur. For example, when converting from RGB24 to GRAY, the color
2599 * information will be lost. Similarly, other losses occur when converting from
2600 * some formats to other formats. avcodec_find_best_pix_fmt() searches which of
f5bccd85
DB
2601 * the given pixel formats should be used to suffer the least amount of loss.
2602 * The pixel formats from which it chooses one, are determined by the
81299d42
PI
2603 * \p pix_fmt_mask parameter.
2604 *
2605 * @code
2606 * src_pix_fmt = PIX_FMT_YUV420P;
2607 * pix_fmt_mask = (1 << PIX_FMT_YUV422P) || (1 << PIX_FMT_RGB24);
2608 * dst_pix_fmt = avcodec_find_best_pix_fmt(pix_fmt_mask, src_pix_fmt, alpha, &loss);
2609 * @endcode
2610 *
f5bccd85
DB
2611 * @param[in] pix_fmt_mask bitmask determining which pixel format to choose from
2612 * @param[in] src_pix_fmt source pixel format
81299d42
PI
2613 * @param[in] has_alpha Whether the source pixel format alpha channel is used.
2614 * @param[out] loss_ptr Combination of flags informing you what kind of losses will occur.
2615 * @return The best pixel format to convert to or -1 if none was found.
392cf77a 2616 */
fab21997
FB
2617int avcodec_find_best_pix_fmt(int pix_fmt_mask, int src_pix_fmt,
2618 int has_alpha, int *loss_ptr);
2619
0469baf1
FB
2620#define FF_ALPHA_TRANSP 0x0001 /* image has some totally transparent pixels */
2621#define FF_ALPHA_SEMI_TRANSP 0x0002 /* image has some transparent pixels */
392cf77a
PI
2622
2623/**
2624 * Tell if an image really has transparent alpha values.
2625 * @return ored mask of FF_ALPHA_xxx constants
2626 */
da64ecc3 2627int img_get_alpha_info(const AVPicture *src,
bb270c08 2628 int pix_fmt, int width, int height);
0469baf1 2629
bc2ce35b 2630#if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
671adb17
MC
2631/**
2632 * convert among pixel formats
2633 * @deprecated Use the software scaler (swscale) instead.
2634 */
bc2ce35b 2635attribute_deprecated int img_convert(AVPicture *dst, int dst_pix_fmt,
115329f1 2636 const AVPicture *src, int pix_fmt,
219b06c6 2637 int width, int height);
bc2ce35b 2638#endif
219b06c6
FB
2639
2640/* deinterlace a picture */
392cf77a 2641/* deinterlace - if not supported return -1 */
da64ecc3 2642int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
de6d9b64
FB
2643 int pix_fmt, int width, int height);
2644
2645/* external high level API */
2646
2647extern AVCodec *first_avcodec;
2648
156e5023 2649/* returns LIBAVCODEC_VERSION_INT constant */
51a49663 2650unsigned avcodec_version(void);
8bceb6af 2651/* returns LIBAVCODEC_BUILD constant */
51a49663 2652unsigned avcodec_build(void);
f9ec0aa1
PI
2653
2654/**
2655 * Initializes libavcodec.
2656 *
2657 * @warning This function \e must be called before any other libavcodec
2658 * function.
2659 */
de6d9b64
FB
2660void avcodec_init(void);
2661
2662void register_avcodec(AVCodec *format);
f9ec0aa1
PI
2663
2664/**
2665 * Finds an encoder with a matching codec ID.
2666 *
f5bccd85 2667 * @param id CodecID of the requested encoder
f9ec0aa1
PI
2668 * @return An encoder if one was found, NULL otherwise.
2669 */
de6d9b64 2670AVCodec *avcodec_find_encoder(enum CodecID id);
f9ec0aa1
PI
2671
2672/**
2673 * Finds an encoder with the specified name.
2674 *
f5bccd85 2675 * @param name name of the requested encoder
f9ec0aa1
PI
2676 * @return An encoder if one was found, NULL otherwise.
2677 */
98f3b098 2678AVCodec *avcodec_find_encoder_by_name(const char *name);
f9ec0aa1
PI
2679
2680/**
2681 * Finds a decoder with a matching codec ID.
2682 *
f5bccd85 2683 * @param id CodecID of the requested decoder
f9ec0aa1
PI
2684 * @return A decoder if one was found, NULL otherwise.
2685 */
de6d9b64 2686AVCodec *avcodec_find_decoder(enum CodecID id);
f9ec0aa1
PI
2687
2688/**
2689 * Finds an decoder with the specified name.
2690 *
f5bccd85 2691 * @param name name of the requested decoder
f9ec0aa1
PI
2692 * @return A decoder if one was found, NULL otherwise.
2693 */
de6d9b64
FB
2694AVCodec *avcodec_find_decoder_by_name(const char *name);
2695void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
2696
f9ec0aa1
PI
2697/**
2698 * Sets the fields of the given AVCodecContext to default values.
2699 *
2700 * @param s The AVCodecContext of which the fields should be set to default values.
2701 */
1e491e29 2702void avcodec_get_context_defaults(AVCodecContext *s);
f9ec0aa1 2703
29301573
MN
2704/** THIS FUNCTION IS NOT YET PART OF THE PUBLIC API!
2705 * we WILL change its arguments and name a few times! */
2706void avcodec_get_context_defaults2(AVCodecContext *s, enum CodecType);
2707
f9ec0aa1
PI
2708/**
2709 * Allocates an AVCodecContext and sets its fields to default values. The
2710 * resulting struct can be deallocated by simply calling av_free().
2711 *
2712 * @return An AVCodecContext filled with default values or NULL on failure.
2713 * @see avcodec_get_context_defaults
2714 */
7ffbb60e 2715AVCodecContext *avcodec_alloc_context(void);
f9ec0aa1 2716
29301573
MN
2717/** THIS FUNCTION IS NOT YET PART OF THE PUBLIC API!
2718 * we WILL change its arguments and name a few times! */
2719AVCodecContext *avcodec_alloc_context2(enum CodecType);
2720
f9ec0aa1
PI
2721/**
2722 * Sets the fields of the given AVFrame to default values.
2723 *
2724 * @param pic The AVFrame of which the fields should be set to default values.
2725 */
7906085f 2726void avcodec_get_frame_defaults(AVFrame *pic);
f9ec0aa1
PI
2727
2728/**
2729 * Allocates an AVFrame and sets its fields to default values. The resulting
2730 * struct can be deallocated by simply calling av_free().
2731 *
2732 * @return An AVFrame filled with default values or NULL on failure.
2733 * @see avcodec_get_frame_defaults
2734 */
492cd3a9 2735AVFrame *avcodec_alloc_frame(void);
1e491e29 2736
492cd3a9
MN
2737int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
2738void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
3a569751
MN
2739int avcodec_default_reget_buffer(AVCodecContext *s, AVFrame *pic);
2740void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height);
f9ec0aa1
PI
2741
2742/**
2743 * Checks if the given dimension of a picture is valid, meaning that all
2744 * bytes of the picture can be addressed with a signed int.
2745 *
2746 * @param[in] w Width of the picture.
2747 * @param[in] h Height of the picture.
2748 * @return Zero if valid, a negative value if invalid.
2749 */
0ecca7a4 2750int avcodec_check_dimensions(void *av_log_ctx, unsigned int w, unsigned int h);
3a569751 2751enum PixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum PixelFormat * fmt);
1e491e29 2752
5a815088
MN
2753int avcodec_thread_init(AVCodecContext *s, int thread_count);
2754void avcodec_thread_free(AVCodecContext *s);
2755int avcodec_thread_execute(AVCodecContext *s, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
3a569751 2756int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
9c3d33d6
MN
2757//FIXME func typedef
2758
7a06ff14 2759/**
f9ec0aa1
PI
2760 * Initializes the AVCodecContext to use the given AVCodec. Prior to using this
2761 * function the context has to be allocated.
2762 *
2763 * The functions avcodec_find_decoder_by_name(), avcodec_find_encoder_by_name(),
2764 * avcodec_find_decoder() and avcodec_find_encoder() provide an easy way for
2765 * retrieving a codec.
2766 *
f5bccd85 2767 * @warning This function is not thread safe!
f9ec0aa1
PI
2768 *
2769 * @code
2770 * codec = avcodec_find_decoder(CODEC_ID_H264);
2771 * if (!codec)
2772 * exit(1);
2773 *
2774 * context = avcodec_alloc_context();
2775 *
2776 * if (avcodec_open(context, codec) < 0)
2777 * exit(1);
2778 * @endcode
2779 *
f5bccd85 2780 * @param avctx The context which will be set up to use the given codec.
f9ec0aa1 2781 * @param codec The codec to use within the context.
f5bccd85 2782 * @return zero on success, a negative value on error
f9ec0aa1 2783 * @see avcodec_alloc_context, avcodec_find_decoder, avcodec_find_encoder
7a06ff14 2784 */
de6d9b64 2785int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
7a06ff14 2786
f9ec0aa1
PI
2787/**
2788 * @deprecated Use avcodec_decode_audio2() instead.
2789 */
ac66834c
MN
2790attribute_deprecated int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples,
2791 int *frame_size_ptr,
2792 uint8_t *buf, int buf_size);
f9ec0aa1 2793
98145875 2794/**
f9ec0aa1 2795 * Decodes an audio frame from \p buf into \p samples.
f5bccd85 2796 * The avcodec_decode_audio2() function decodes an audio frame from the input
f9ec0aa1 2797 * buffer \p buf of size \p buf_size. To decode it, it makes use of the
f5bccd85 2798 * audio codec which was coupled with \p avctx using avcodec_open(). The
f9ec0aa1
PI
2799 * resulting decoded frame is stored in output buffer \p samples. If no frame
2800 * could be decompressed, \p frame_size_ptr is zero. Otherwise, it is the
2801 * decompressed frame size in \e bytes.
2802 *
2803 * @warning You \e must set \p frame_size_ptr to the allocated size of the
2804 * output buffer before calling avcodec_decode_audio2().
2805 *
2806 * @warning The input buffer must be \c FF_INPUT_BUFFER_PADDING_SIZE larger than
2807 * the actual read bytes because some optimized bitstream readers read 32 or 64
2808 * bits at once and could read over the end.
2809 *
2810 * @warning The end of the input buffer \p buf should be set to 0 to ensure that
2811 * no overreading happens for damaged MPEG streams.
98145875 2812 *
f9ec0aa1 2813 * @note You might have to align the input buffer \p buf and output buffer \p
f5bccd85 2814 * samples. The alignment requirements depend on the CPU: On some CPUs it isn't
f9ec0aa1
PI
2815 * necessary at all, on others it won't work at all if not aligned and on others
2816 * it will work but it will have an impact on performance. In practice, the
2817 * bitstream should have 4 byte alignment at minimum and all sample data should
2818 * be 16 byte aligned unless the CPU doesn't need it (AltiVec and SSE do). If
2819 * the linesize is not a multiple of 16 then there's no sense in aligning the
2820 * start of the buffer to 16.
2821 *
f5bccd85
DB
2822 * @param avctx the codec context
2823 * @param[out] samples the output buffer
2824 * @param[in,out] frame_size_ptr the output buffer size in bytes
2825 * @param[in] buf the input buffer
2826 * @param[in] buf_size the input buffer size in bytes
f9ec0aa1
PI
2827 * @return On error a negative value is returned, otherwise the number of bytes
2828 * used or zero if no frame could be decompressed.
98145875 2829 */
ac66834c 2830int avcodec_decode_audio2(AVCodecContext *avctx, int16_t *samples,
de6d9b64 2831 int *frame_size_ptr,
0c1a9eda 2832 uint8_t *buf, int buf_size);
f9ec0aa1
PI
2833
2834/**
2835 * Decodes a video frame from \p buf into \p picture.
f5bccd85 2836 * The avcodec_decode_video() function decodes a video frame from the input
f9ec0aa1 2837 * buffer \p buf of size \p buf_size. To decode it, it makes use of the
f5bccd85 2838 * video codec which was coupled with \p avctx using avcodec_open(). The
f9ec0aa1
PI
2839 * resulting decoded frame is stored in \p picture.
2840 *
2841 * @warning The input buffer must be \c FF_INPUT_BUFFER_PADDING_SIZE larger than
2842 * the actual read bytes because some optimized bitstream readers read 32 or 64
2843 * bits at once and could read over the end.
2844 *
2845 * @warning The end of the input buffer \p buf should be set to 0 to ensure that
2846 * no overreading happens for damaged MPEG streams.
2847 *
2848 * @note You might have to align the input buffer \p buf and output buffer \p
2849 * samples. The alignment requirements depend on the CPU: on some CPUs it isn't
2850 * necessary at all, on others it won't work at all if not aligned and on others
2851 * it will work but it will have an impact on performance. In practice, the
2852 * bitstream should have 4 byte alignment at minimum and all sample data should
2853 * be 16 byte aligned unless the CPU doesn't need it (AltiVec and SSE do). If
2854 * the linesize is not a multiple of 16 then there's no sense in aligning the
2855 * start of the buffer to 16.
2856 *
f5bccd85 2857 * @param avctx the codec context
f9ec0aa1 2858 * @param[out] picture The AVFrame in which the decoded video frame will be stored.
f5bccd85
DB
2859 * @param[in] buf the input buffer
2860 * @param[in] buf_size the size of the input buffer in bytes
2861 * @param[in,out] got_picture_ptr Zero if no frame could be decompressed, otherwise, it is nonzero.
f9ec0aa1
PI
2862 * @return On error a negative value is returned, otherwise the number of bytes
2863 * used or zero if no frame could be decompressed.
2864 */
115329f1 2865int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture,
de6d9b64 2866 int *got_picture_ptr,
0c1a9eda 2867 uint8_t *buf, int buf_size);
8ab4861c 2868
f5bccd85
DB
2869/* Decode a subtitle message. Return -1 if error, otherwise return the
2870 * number of bytes used. If no subtitle could be decompressed,
2871 * got_sub_ptr is zero. Otherwise, the subtitle is stored in *sub. */
240c1657
FB
2872int avcodec_decode_subtitle(AVCodecContext *avctx, AVSubtitle *sub,
2873 int *got_sub_ptr,
2874 const uint8_t *buf, int buf_size);
115329f1 2875int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata,
917e06c8 2876 int *data_size_ptr,
0c1a9eda 2877 uint8_t *buf, int buf_size);
f9ec0aa1
PI
2878
2879/**
2880 * Encodes an audio frame from \p samples into \p buf.
f5bccd85
DB
2881 * The avcodec_encode_audio() function encodes an audio frame from the input
2882 * buffer \p samples. To encode it, it makes use of the audio codec which was
f9ec0aa1
PI
2883 * coupled with \p avctx using avcodec_open(). The resulting encoded frame is
2884 * stored in output buffer \p buf.
2885 *
2886 * @note The output buffer should be at least \c FF_MIN_BUFFER_SIZE bytes large.
2887 *
f5bccd85
DB
2888 * @param avctx the codec context
2889 * @param[out] buf the output buffer
2890 * @param[in] buf_size the output buffer size
2891 * @param[in] samples the input buffer containing the samples
f9ec0aa1
PI
2892 * @return On error a negative value is returned, on succes zero or the number
2893 * of bytes used from the input buffer.
2894 */
115329f1 2895int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size,
de6d9b64 2896 const short *samples);
f9ec0aa1
PI
2897
2898/**
2899 * Encodes a video frame from \p pict into \p buf.
f5bccd85
DB
2900 * The avcodec_encode_video() function encodes a video frame from the input
2901 * \p pict. To encode it, it makes use of the video codec which was coupled with
f9ec0aa1
PI
2902 * \p avctx using avcodec_open(). The resulting encoded bytes representing the
2903 * frame are stored in the output buffer \p buf. The input picture should be
2904 * stored using a specific format, namely \c avctx.pix_fmt.
2905 *
f5bccd85
DB
2906 * @param avctx the codec context
2907 * @param[out] buf the output buffer for the bitstream of encoded frame
2908 * @param[in] buf_size the size of the output buffer in bytes
2909 * @param[in] pict the input picture to encode
f9ec0aa1
PI
2910 * @return On error a negative value is returned, on success zero or the number
2911 * of bytes used from the input buffer.
2912 */
115329f1 2913int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size,
492cd3a9 2914 const AVFrame *pict);
115329f1 2915int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
240c1657 2916 const AVSubtitle *sub);
de6d9b64
FB
2917
2918int avcodec_close(AVCodecContext *avctx);
2919
2920void avcodec_register_all(void);
a96b68b7 2921
8ab4861c
PI
2922/**
2923 * Flush buffers, should be called when seeking or when switching to a different stream.
2924 */
1c2a8c7f
MN
2925void avcodec_flush_buffers(AVCodecContext *avctx);
2926
88730be6
MR
2927void avcodec_default_free_buffers(AVCodecContext *s);
2928
85975aa9 2929/* misc useful functions */
d8085ea7
MN
2930
2931/**
8f6260af
PI
2932 * Returns a single letter to describe the given picture type \p pict_type.
2933 *
f5bccd85 2934 * @param[in] pict_type the picture type
8f6260af 2935 * @return A single character representing the picture type.
d8085ea7
MN
2936 */
2937char av_get_pict_type_char(int pict_type);
2938
ac3e1834 2939/**
2fa378a7
PI
2940 * Returns codec bits per sample.
2941 *
f5bccd85 2942 * @param[in] codec_id the codec
2fa378a7 2943 * @return Number of bits per sample or zero if unknown for the given codec.
ac3e1834
BC
2944 */
2945int av_get_bits_per_sample(enum CodecID codec_id);
2e8f2c20 2946
8424cf50
FB
2947/* frame parsing */
2948typedef struct AVCodecParserContext {
2949 void *priv_data;
2950 struct AVCodecParser *parser;
2951 int64_t frame_offset; /* offset of the current frame */
115329f1 2952 int64_t cur_offset; /* current offset
8424cf50
FB
2953 (incremented by each av_parser_parse()) */
2954 int64_t last_frame_offset; /* offset of the last frame */
2955 /* video info */
f5bccd85
DB
2956 int pict_type; /* XXX: Put it back in AVCodecContext. */
2957 int repeat_pict; /* XXX: Put it back in AVCodecContext. */
b84f2a35
FB
2958 int64_t pts; /* pts of the current frame */
2959 int64_t dts; /* dts of the current frame */
2960
2961 /* private data */
2962 int64_t last_pts;
2963 int64_t last_dts;
a62aecce 2964 int fetch_timestamp;
b84f2a35
FB
2965
2966#define AV_PARSER_PTS_NB 4
2967 int cur_frame_start_index;
2968 int64_t cur_frame_offset[AV_PARSER_PTS_NB];
2969 int64_t cur_frame_pts[AV_PARSER_PTS_NB];
2970 int64_t cur_frame_dts[AV_PARSER_PTS_NB];
115329f1 2971
7cbaa7ba
MN
2972 int flags;
2973#define PARSER_FLAG_COMPLETE_FRAMES 0x0001
a74008a4
JP
2974
2975 int64_t offset; ///< byte offset from starting packet start
2976 int64_t last_offset;
8424cf50
FB
2977} AVCodecParserContext;
2978
2979typedef struct AVCodecParser {
99f06236 2980 int codec_ids[5]; /* several codec IDs are permitted */
8424cf50
FB
2981 int priv_data_size;
2982 int (*parser_init)(AVCodecParserContext *s);
115329f1 2983 int (*parser_parse)(AVCodecParserContext *s,
8424cf50 2984 AVCodecContext *avctx,
c53d2d90 2985 const uint8_t **poutbuf, int *poutbuf_size,
8424cf50
FB
2986 const uint8_t *buf, int buf_size);
2987 void (*parser_close)(AVCodecParserContext *s);
90ad92b3 2988 int (*split)(AVCodecContext *avctx, const uint8_t *buf, int buf_size);
8424cf50
FB
2989 struct AVCodecParser *next;
2990} AVCodecParser;
2991
2992extern AVCodecParser *av_first_parser;
2993
2994void av_register_codec_parser(AVCodecParser *parser);
2995AVCodecParserContext *av_parser_init(int codec_id);
115329f1 2996int av_parser_parse(AVCodecParserContext *s,
8424cf50 2997 AVCodecContext *avctx,
115329f1 2998 uint8_t **poutbuf, int *poutbuf_size,
b84f2a35
FB
2999 const uint8_t *buf, int buf_size,
3000 int64_t pts, int64_t dts);
90ad92b3
MN
3001int av_parser_change(AVCodecParserContext *s,
3002 AVCodecContext *avctx,
115329f1 3003 uint8_t **poutbuf, int *poutbuf_size,
90ad92b3 3004 const uint8_t *buf, int buf_size, int keyframe);
8424cf50
FB
3005void av_parser_close(AVCodecParserContext *s);
3006
7ce6a249
DB
3007extern AVCodecParser aac_parser;
3008extern AVCodecParser ac3_parser;
20ffddb9 3009extern AVCodecParser cavsvideo_parser;
01ca9ac3 3010extern AVCodecParser dca_parser;
7ce6a249
DB
3011extern AVCodecParser dvbsub_parser;
3012extern AVCodecParser dvdsub_parser;
c6148de2 3013extern AVCodecParser h261_parser;
8424cf50
FB
3014extern AVCodecParser h263_parser;
3015extern AVCodecParser h264_parser;
8e6325b9 3016extern AVCodecParser mjpeg_parser;
7ce6a249 3017extern AVCodecParser mpeg4video_parser;
8424cf50 3018extern AVCodecParser mpegaudio_parser;
7ce6a249
DB
3019extern AVCodecParser mpegvideo_parser;
3020extern AVCodecParser pnm_parser;
35bffd7f 3021extern AVCodecParser vc1_parser;
8424cf50 3022
748c2fca
MN
3023
3024typedef struct AVBitStreamFilterContext {
514e0831 3025 void *priv_data;
748c2fca
MN
3026 struct AVBitStreamFilter *filter;
3027 AVCodecParserContext *parser;
3028 struct AVBitStreamFilterContext *next;
3029} AVBitStreamFilterContext;
3030
3031
3032typedef struct AVBitStreamFilter {
3033 const char *name;
514e0831 3034 int priv_data_size;
748c2fca
MN
3035 int (*filter)(AVBitStreamFilterContext *bsfc,
3036 AVCodecContext *avctx, const char *args,
3037 uint8_t **poutbuf, int *poutbuf_size,
3038 const uint8_t *buf, int buf_size, int keyframe);
3039 struct AVBitStreamFilter *next;
3040} AVBitStreamFilter;
3041
3042extern AVBitStreamFilter *av_first_bitstream_filter;
3043
3044void av_register_bitstream_filter(AVBitStreamFilter *bsf);
3045AVBitStreamFilterContext *av_bitstream_filter_init(const char *name);
3046int av_bitstream_filter_filter(AVBitStreamFilterContext *bsfc,
3047 AVCodecContext *avctx, const char *args,
3048 uint8_t **poutbuf, int *poutbuf_size,
3049 const uint8_t *buf, int buf_size, int keyframe);
3050void av_bitstream_filter_close(AVBitStreamFilterContext *bsf);
3051
3052extern AVBitStreamFilter dump_extradata_bsf;
3053extern AVBitStreamFilter remove_extradata_bsf;
514e0831 3054extern AVBitStreamFilter noise_bsf;
eacb41b2
MN
3055extern AVBitStreamFilter mp3_header_compress_bsf;
3056extern AVBitStreamFilter mp3_header_decompress_bsf;
1a1c5385 3057extern AVBitStreamFilter mjpega_dump_header_bsf;
92d6b7fd 3058extern AVBitStreamFilter imx_dump_header_bsf;
748c2fca
MN
3059
3060
544eb99c 3061/* memory */
8ab4861c
PI
3062
3063/**
4267e90d
PI
3064 * Reallocates the given block if it is not large enough, otherwise it
3065 * does nothing.
3066 *
3067 * @see av_realloc
8ab4861c 3068 */
97d96aaa 3069void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
8ab4861c 3070
855ea723 3071/* for static data only */
8ab4861c
PI
3072
3073/**
f5bccd85