annotate avcodec.h @ 12461:25174028da0a libavcodec

Fix slice height for y position calculation for vp3_draw_horiz_band when the video uses 4:2:2 instead of 4:2:0 coding.
author reimar
date Mon, 06 Sep 2010 19:26:18 +0000
parents 4a425a99f543
children ffb3668ff7af
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3699
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
1 /*
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
2 * copyright (c) 2001 Fabrice Bellard
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
3 *
3947
c8c591fe26f8 Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents: 3930
diff changeset
4 * This file is part of FFmpeg.
c8c591fe26f8 Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents: 3930
diff changeset
5 *
c8c591fe26f8 Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents: 3930
diff changeset
6 * FFmpeg is free software; you can redistribute it and/or
3699
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
7 * modify it under the terms of the GNU Lesser General Public
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
8 * License as published by the Free Software Foundation; either
3947
c8c591fe26f8 Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents: 3930
diff changeset
9 * version 2.1 of the License, or (at your option) any later version.
3699
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
10 *
3947
c8c591fe26f8 Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents: 3930
diff changeset
11 * FFmpeg is distributed in the hope that it will be useful,
3699
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
14 * Lesser General Public License for more details.
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
15 *
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
16 * You should have received a copy of the GNU Lesser General Public
3947
c8c591fe26f8 Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents: 3930
diff changeset
17 * License along with FFmpeg; if not, write to the Free Software
5215
2b72f9bc4f06 license header consistency cosmetics
diego
parents: 5139
diff changeset
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
3699
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
19 */
c537a97eec66 Add official LGPL license headers to the files that were missing them.
diego
parents: 3695
diff changeset
20
7760
c4a4495715dd Globally rename the header inclusion guard names.
stefano
parents: 7736
diff changeset
21 #ifndef AVCODEC_AVCODEC_H
c4a4495715dd Globally rename the header inclusion guard names.
stefano
parents: 7736
diff changeset
22 #define AVCODEC_AVCODEC_H
92
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
23
1048
75a659fae7e0 divx503 decoding fix
michaelni
parents: 1041
diff changeset
24 /**
11644
7dd2a45249a9 Remove explicit filename from Doxygen @file commands.
diego
parents: 11567
diff changeset
25 * @file
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
26 * external API header
1048
75a659fae7e0 divx503 decoding fix
michaelni
parents: 1041
diff changeset
27 */
75a659fae7e0 divx503 decoding fix
michaelni
parents: 1041
diff changeset
28
8667
5690a6211e8c Directly #include some required headers.
diego
parents: 8619
diff changeset
29 #include <errno.h>
6395
9259af8a686b Install headers in $prefix/include/$libname
mru
parents: 6389
diff changeset
30 #include "libavutil/avutil.h"
12456
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
31 #include "libavutil/cpu.h"
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
32
7823
4525dcd81357 Bump Major version, this commit is almost just renaming bits_per_sample to
michael
parents: 7786
diff changeset
33 #define LIBAVCODEC_VERSION_MAJOR 52
12425
d23e48091c51 Implement avcodec_get_channel_layout().
stefano
parents: 12404
diff changeset
34 #define LIBAVCODEC_VERSION_MINOR 87
12456
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
35 #define LIBAVCODEC_VERSION_MICRO 1
6378
99823c80a93d Clean up lib* version definitions
mru
parents: 6364
diff changeset
36
6417
82b05580c400 less preprocessor magic in version number macros
mru
parents: 6407
diff changeset
37 #define LIBAVCODEC_VERSION_INT AV_VERSION_INT(LIBAVCODEC_VERSION_MAJOR, \
82b05580c400 less preprocessor magic in version number macros
mru
parents: 6407
diff changeset
38 LIBAVCODEC_VERSION_MINOR, \
82b05580c400 less preprocessor magic in version number macros
mru
parents: 6407
diff changeset
39 LIBAVCODEC_VERSION_MICRO)
82b05580c400 less preprocessor magic in version number macros
mru
parents: 6407
diff changeset
40 #define LIBAVCODEC_VERSION AV_VERSION(LIBAVCODEC_VERSION_MAJOR, \
82b05580c400 less preprocessor magic in version number macros
mru
parents: 6407
diff changeset
41 LIBAVCODEC_VERSION_MINOR, \
82b05580c400 less preprocessor magic in version number macros
mru
parents: 6407
diff changeset
42 LIBAVCODEC_VERSION_MICRO)
2979
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
43 #define LIBAVCODEC_BUILD LIBAVCODEC_VERSION_INT
2814
48fb350b0ec9 A.B.C versions
michael
parents: 2801
diff changeset
44
2979
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
45 #define LIBAVCODEC_IDENT "Lavc" AV_STRINGIFY(LIBAVCODEC_VERSION)
1118
8248e652d64e simplified
al3x
parents: 1116
diff changeset
46
12449
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
47 /**
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
48 * Those FF_API_* defines are not part of public API.
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
49 * They may change, break or disappear at any time.
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
50 */
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
51 #ifndef FF_API_PALETTE_CONTROL
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
52 #define FF_API_PALETTE_CONTROL (LIBAVCODEC_VERSION_MAJOR < 54)
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
53 #endif
12458
4a425a99f543 Add #ifndef around FF_API_MM_FLAGS.
stefano
parents: 12456
diff changeset
54 #ifndef FF_API_MM_FLAGS
12456
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
55 #define FF_API_MM_FLAGS (LIBAVCODEC_VERSION_MAJOR < 53)
12458
4a425a99f543 Add #ifndef around FF_API_MM_FLAGS.
stefano
parents: 12456
diff changeset
56 #endif
12449
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
57
4274
07625477adfa use the standard INT64_C() macro for 64-bit constants
mru
parents: 4273
diff changeset
58 #define AV_NOPTS_VALUE INT64_C(0x8000000000000000)
2979
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
59 #define AV_TIME_BASE 1000000
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
60 #define AV_TIME_BASE_Q (AVRational){1, AV_TIME_BASE}
1831
cd2d7fcfab7a use AVFrame.pts=AV_NOPTS_VALUE instead of AVFrame.pts=0
michael
parents: 1812
diff changeset
61
4743
6797f7088d00 codec id addition guidlines
michael
parents: 4738
diff changeset
62 /**
12051
3798d134f330 Grammar fixes
mru
parents: 12039
diff changeset
63 * Identify the syntax and semantics of the bitstream.
5139
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
64 * The principle is roughly:
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
65 * Two decoders with the same ID can decode the same streams.
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
66 * Two encoders with the same ID can encode compatible streams.
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
67 * There may be slight deviations from the principle due to implementation
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
68 * details.
4743
6797f7088d00 codec id addition guidlines
michael
parents: 4738
diff changeset
69 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
70 * If you add a codec ID to this list, add it so that
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
71 * 1. no value of a existing codec ID changes (that would break ABI),
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
72 * 2. it is as close as possible to similar codecs.
4743
6797f7088d00 codec id addition guidlines
michael
parents: 4738
diff changeset
73 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
74 enum CodecID {
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
75 CODEC_ID_NONE,
6587
66580b034818 Add explanatory comments to enum CodecID.
diego
parents: 6573
diff changeset
76
66580b034818 Add explanatory comments to enum CodecID.
diego
parents: 6573
diff changeset
77 /* video codecs */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
78 CODEC_ID_MPEG1VIDEO,
6037
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
79 CODEC_ID_MPEG2VIDEO, ///< preferred ID for MPEG-1/2 video decoding
1382
f23bc5ffb374 initial XvMC support
iive
parents: 1374
diff changeset
80 CODEC_ID_MPEG2VIDEO_XVMC,
2044
b6f2add2511e h261 decoder by (Maarten Daniels <maarten.daniels at student dot luc dot ac dot be>)
michael
parents: 2030
diff changeset
81 CODEC_ID_H261,
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
82 CODEC_ID_H263,
986e461dc072 Initial revision
glantau
parents:
diff changeset
83 CODEC_ID_RV10,
1639
3e2b774edce4 rv20 decoder
michael
parents: 1637
diff changeset
84 CODEC_ID_RV20,
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
85 CODEC_ID_MJPEG,
881
d326091dae9f mjpegb support (need more samples)
al3x
parents: 880
diff changeset
86 CODEC_ID_MJPEGB,
1315
6696d3bf4ff2 lossless mjpeg encoding (planar yuv & RGB) and somerelated bugfixes
michaelni
parents: 1306
diff changeset
87 CODEC_ID_LJPEG,
1519
b44267fc5ec4 Sunplus JPEG codec (SP5X) support
alex
parents: 1516
diff changeset
88 CODEC_ID_SP5X,
2970
583b6ac45c07 unfinished jpeg-ls codec (feel free to finish it ...)
michael
parents: 2967
diff changeset
89 CODEC_ID_JPEGLS,
67
cdd89f96cbe1 added draw_horiz_band test
glantau
parents: 49
diff changeset
90 CODEC_ID_MPEG4,
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
91 CODEC_ID_RAWVIDEO,
307
764aeec1320e msmpeg4v2 decoding (no encoding yet)
michaelni
parents: 298
diff changeset
92 CODEC_ID_MSMPEG4V1,
764aeec1320e msmpeg4v2 decoding (no encoding yet)
michaelni
parents: 298
diff changeset
93 CODEC_ID_MSMPEG4V2,
764aeec1320e msmpeg4v2 decoding (no encoding yet)
michaelni
parents: 298
diff changeset
94 CODEC_ID_MSMPEG4V3,
311
ac677a84d5df wmv1 header parser (unfinished)
michaelni
parents: 307
diff changeset
95 CODEC_ID_WMV1,
485
20108840b0e5 grayscale only decoding
michaelni
parents: 467
diff changeset
96 CODEC_ID_WMV2,
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
97 CODEC_ID_H263P,
986e461dc072 Initial revision
glantau
parents:
diff changeset
98 CODEC_ID_H263I,
1353
cfc80b3a4ada flash video (flv) support patch by (Garrick Meeker <gmeeker at theoryllc dot com>)
michaelni
parents: 1347
diff changeset
99 CODEC_ID_FLV1,
521
9c66b5183ab3 new codec: Sorenson v1
nickols_k
parents: 500
diff changeset
100 CODEC_ID_SVQ1,
1234
fc2a7eefa9cc svq3 decoder by anonymous
michaelni
parents: 1231
diff changeset
101 CODEC_ID_SVQ3,
724
caa4c757a47d added DV support
bellard
parents: 713
diff changeset
102 CODEC_ID_DVVIDEO,
866
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
103 CODEC_ID_HUFFYUV,
1054
f874e2122d45 Creative YUV (CYUV) decoder by (Mike Melanson <melanson at pcisys dot net>)
michaelni
parents: 1053
diff changeset
104 CODEC_ID_CYUV,
1168
5af9aeadbdc3 H264 decoder & demuxer
michaelni
parents: 1151
diff changeset
105 CODEC_ID_H264,
1190
60bd91a6e218 native Indeo3 decoder implementation
tmmm
parents: 1172
diff changeset
106 CODEC_ID_INDEO3,
1224
3fa9a3de913f first pass at a new VP3 video decoder
tmmm
parents: 1214
diff changeset
107 CODEC_ID_VP3,
1516
0f0e9dfa6723 theora decoding support (only keyframes for now, because by theora the frame isn't flipped so the motion vectors are getting screwed up)
alex
parents: 1510
diff changeset
108 CODEC_ID_THEORA,
1273
a979fab41ed8 ASV1 codec
michaelni
parents: 1266
diff changeset
109 CODEC_ID_ASV1,
1433
46d3fa8501cd ASV2 decoder
michaelni
parents: 1423
diff changeset
110 CODEC_ID_ASV2,
1300
e18667d1e94d FFV1 codec (our very simple lossless intra only codec, compresses much better then huffyuv)
michaelni
parents: 1299
diff changeset
111 CODEC_ID_FFV1,
1286
9e8cbd476f59 placeholder IDs for 4xm A/V codecs
tmmm
parents: 1273
diff changeset
112 CODEC_ID_4XM,
1374
f9b088451fb3 ATI VCR1 decoder
michaelni
parents: 1370
diff changeset
113 CODEC_ID_VCR1,
1385
a16990d50fce CLJR decoding support
al3x
parents: 1382
diff changeset
114 CODEC_ID_CLJR,
1410
524c904a66b8 PSX MDEC decoder, based upon some code from Sebastian Jedruszkiewicz <elf at frogger dot rules dot pl>
michaelni
parents: 1404
diff changeset
115 CODEC_ID_MDEC,
1439
a4d00b1f0271 initial commit for Id RoQ and Interplay MVE multimedia subsystems
tmmm
parents: 1433
diff changeset
116 CODEC_ID_ROQ,
a4d00b1f0271 initial commit for Id RoQ and Interplay MVE multimedia subsystems
tmmm
parents: 1433
diff changeset
117 CODEC_ID_INTERPLAY_VIDEO,
1443
47f4c8a5a7fc New fringe codecs: WC3/Xan video, Xan DPCM, DK3 & DK4 ADPCM
tmmm
parents: 1442
diff changeset
118 CODEC_ID_XAN_WC3,
47f4c8a5a7fc New fringe codecs: WC3/Xan video, Xan DPCM, DK3 & DK4 ADPCM
tmmm
parents: 1442
diff changeset
119 CODEC_ID_XAN_WC4,
1491
222643544cf1 New demuxers: Sega FILM/CPK, Westwood VQA & AUD; new decoders: MS RLE &
tmmm
parents: 1490
diff changeset
120 CODEC_ID_RPZA,
222643544cf1 New demuxers: Sega FILM/CPK, Westwood VQA & AUD; new decoders: MS RLE &
tmmm
parents: 1490
diff changeset
121 CODEC_ID_CINEPAK,
222643544cf1 New demuxers: Sega FILM/CPK, Westwood VQA & AUD; new decoders: MS RLE &
tmmm
parents: 1490
diff changeset
122 CODEC_ID_WS_VQA,
222643544cf1 New demuxers: Sega FILM/CPK, Westwood VQA & AUD; new decoders: MS RLE &
tmmm
parents: 1490
diff changeset
123 CODEC_ID_MSRLE,
222643544cf1 New demuxers: Sega FILM/CPK, Westwood VQA & AUD; new decoders: MS RLE &
tmmm
parents: 1490
diff changeset
124 CODEC_ID_MSVIDEO1,
1498
9eb9b77cf418 implemented Id Quake II CIN support
tmmm
parents: 1496
diff changeset
125 CODEC_ID_IDCIN,
1608
639972344c6f 8BPS decoder
rtognimp
parents: 1606
diff changeset
126 CODEC_ID_8BPS,
1610
b0fe2a0adf49 added Apple Graphics (SMC) decoder
melanson
parents: 1608
diff changeset
127 CODEC_ID_SMC,
1624
46dee16488ae yep, FLI support
melanson
parents: 1621
diff changeset
128 CODEC_ID_FLIC,
1650
bdade3baabfc initial support for Duck TrueMotion v1 (think of it as On2 VP1); only
melanson
parents: 1644
diff changeset
129 CODEC_ID_TRUEMOTION1,
1717
6a7e68899d8a first pass at Sierra VMD A/V decoders; video looks great, audio is not
melanson
parents: 1708
diff changeset
130 CODEC_ID_VMDVIDEO,
1741
f0c21b9a328e MSZH and ZLIB decoder support
rtognimp
parents: 1733
diff changeset
131 CODEC_ID_MSZH,
f0c21b9a328e MSZH and ZLIB decoder support
rtognimp
parents: 1733
diff changeset
132 CODEC_ID_ZLIB,
1783
66ae3c109d90 initial commit for Quicktime Animation (RLE) video decoder; bit depths
melanson
parents: 1782
diff changeset
133 CODEC_ID_QTRLE,
2138
1ac13c350369 my experimental wavelet codec
michael
parents: 2137
diff changeset
134 CODEC_ID_SNOW,
2170
51da590b31a3 TechSmith Camtasia (TSCC) video decoder, courtesy of Konstantin Shishkov
melanson
parents: 2167
diff changeset
135 CODEC_ID_TSCC,
2234
dff53892ff8a IBM Ultimotion video decoder, courtesy of Konstantin Shishkov
melanson
parents: 2201
diff changeset
136 CODEC_ID_ULTI,
2275
c443a6af19a7 support for Sierra Online audio files and Apple QuickDraw codec,
melanson
parents: 2272
diff changeset
137 CODEC_ID_QDRAW,
2325
1180a04d64c5 Miro VideoXL (VIXL) decoder, courtesy of Konstantin Shishkov
melanson
parents: 2322
diff changeset
138 CODEC_ID_VIXL,
2355
69fcdad5f7d5 native QPEG video decoder, courtesy of Konstantin Shishkov
melanson
parents: 2353
diff changeset
139 CODEC_ID_QPEG,
11479
59c11c1f3991 CODEC_ID_XVID is not used anywhere, remove it at next major bump
aurel
parents: 11478
diff changeset
140 #if LIBAVCODEC_VERSION_MAJOR < 53
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
141 CODEC_ID_XVID,
11479
59c11c1f3991 CODEC_ID_XVID is not used anywhere, remove it at next major bump
aurel
parents: 11478
diff changeset
142 #endif
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
143 CODEC_ID_PNG,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
144 CODEC_ID_PPM,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
145 CODEC_ID_PBM,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
146 CODEC_ID_PGM,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
147 CODEC_ID_PGMYUV,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
148 CODEC_ID_PAM,
2373
f977a8871c2c split ffhuffyuv into 2 codecs:
lorenm
parents: 2372
diff changeset
149 CODEC_ID_FFVHUFF,
2413
d0b4f62a63ae RV30/RV40 demuxing (untested)
michael
parents: 2397
diff changeset
150 CODEC_ID_RV30,
d0b4f62a63ae RV30/RV40 demuxing (untested)
michael
parents: 2397
diff changeset
151 CODEC_ID_RV40,
3359
87187ebe2c28 Rename VC9 to VC1 as there is no such thing as VC9
kostya
parents: 3356
diff changeset
152 CODEC_ID_VC1,
2445
96da66323faa preliminary vc9 bitstream decoder, committing to make syncing and team-work on it easier
alex
parents: 2432
diff changeset
153 CODEC_ID_WMV3,
2530
eace30b70601 go LOCO, courtesy of Kostya Shishkov
melanson
parents: 2525
diff changeset
154 CODEC_ID_LOCO,
2577
7d9997a69158 Winnov WNV1 video decoder, courtesy of Konstantin Shishkov
melanson
parents: 2572
diff changeset
155 CODEC_ID_WNV1,
2588
b6b618986f80 Autodesk Animator Studio Codec (AASC) video decoder, courtesy of
melanson
parents: 2585
diff changeset
156 CODEC_ID_AASC,
2618
fc91ca5b9066 Indeo 2 decoder by (Kostya <> kostya.shishkov gmail com)
michael
parents: 2588
diff changeset
157 CODEC_ID_INDEO2,
2700
485571c9182f Fraps FPS1 video decoder (v1 & v2), courtesy of Roine Gustafsson <roine
melanson
parents: 2697
diff changeset
158 CODEC_ID_FRAPS,
2906
e578b3572987 Duck TrueMotion 2 video decoder, courtesy of Konstantin Shishkov
melanson
parents: 2880
diff changeset
159 CODEC_ID_TRUEMOTION2,
2949
e5a10ae14ffb BMP image decoder
mru
parents: 2946
diff changeset
160 CODEC_ID_BMP,
3030
6bc2dc147ac5 CamStudio decoder, only 32 bit lzo mode is tested
reimar
parents: 3010
diff changeset
161 CODEC_ID_CSCD,
3119
09ae2e981d64 complete American Laser Games MM playback system, courtesy of Peter Ross
melanson
parents: 3118
diff changeset
162 CODEC_ID_MMVIDEO,
3120
1d184d61e714 dosbox native ZMBV decoder, courtesy of Kostya
melanson
parents: 3119
diff changeset
163 CODEC_ID_ZMBV,
3129
0ebbd476ba32 complete AVS playback system (from Creature Shock computer game),
melanson
parents: 3127
diff changeset
164 CODEC_ID_AVS,
3209
cc86ebc32143 Smacker demuxer and decoder.
kostya
parents: 3179
diff changeset
165 CODEC_ID_SMACKVIDEO,
3224
28aaf0a0135e NuppelVideo/MythTVVideo support, including rtjpeg decoder
reimar
parents: 3209
diff changeset
166 CODEC_ID_NUV,
3253
226ffbb6fd02 KMVC (used in Worms games) decoder. Works fine with samples from MPHQ
kostya
parents: 3251
diff changeset
167 CODEC_ID_KMVC,
3329
726ab1038351 Flash Screen Video decoder (fourcc:FSV1)
banan
parents: 3305
diff changeset
168 CODEC_ID_FLASHSV,
3392
11c9d7dad1c8 CODEC_ID_CAVS (part of the cavs patch by Stefan Gehrer stefan.gehrer gmx de)
michael
parents: 3385
diff changeset
169 CODEC_ID_CAVS,
3618
d2936fc9558c add codec id and tag for JPEG 2000
bcoudurier
parents: 3597
diff changeset
170 CODEC_ID_JPEG2000,
3677
18b13b923616 VMware Video decoder (fourcc: VMnc)
kostya
parents: 3660
diff changeset
171 CODEC_ID_VMNC,
3695
6795c9e5f983 VP5 and VP6 video decoder
aurel
parents: 3677
diff changeset
172 CODEC_ID_VP5,
6795c9e5f983 VP5 and VP6 video decoder
aurel
parents: 3677
diff changeset
173 CODEC_ID_VP6,
6795c9e5f983 VP5 and VP6 video decoder
aurel
parents: 3677
diff changeset
174 CODEC_ID_VP6F,
3986
54c7481b381e Targa image decoder
kostya
parents: 3947
diff changeset
175 CODEC_ID_TARGA,
3997
8ed26e786210 support for Delphine Software .cin files demuxing / audio and video decoding, by Gregory Montoir %cyx A users P sourceforge P net%
bcoudurier
parents: 3986
diff changeset
176 CODEC_ID_DSICINVIDEO,
4006
986d6651a452 support for Tiertex .seq files demuxing/video decoding, by Gregory Montoir %cyx A users P sourceforge P net%
bcoudurier
parents: 3998
diff changeset
177 CODEC_ID_TIERTEXSEQVIDEO,
4013
aace6b74fddc TIFF decoder
kostya
parents: 4006
diff changeset
178 CODEC_ID_TIFF,
4054
f20c7bb12103 change gif demuxer to gif decoder
bcoudurier
parents: 4030
diff changeset
179 CODEC_ID_GIF,
4278
730ffb021033 Add codec ID for a native H.264 encoder.
takis
parents: 4275
diff changeset
180 CODEC_ID_FFH264,
4671
97e3364d267a DXA demuxer and decoder
kostya
parents: 4654
diff changeset
181 CODEC_ID_DXA,
4687
5359a5ab01a8 dnxhd decoder
bcoudurier
parents: 4673
diff changeset
182 CODEC_ID_DNXHD,
4761
4effe3bde31b support for the THP game format by Marco Gerards, mgerards xs4all nl
diego
parents: 4743
diff changeset
183 CODEC_ID_THP,
4790
2b825cb391f2 SGI image decoder ported to the new image API.
diego
parents: 4776
diff changeset
184 CODEC_ID_SGI,
4797
12279b61177b Interplay C93 demuxer and video decoder
diego
parents: 4794
diff changeset
185 CODEC_ID_C93,
4803
35e47a6e01e2 Bethsoft VID demuxer and video decoder
diego
parents: 4800
diff changeset
186 CODEC_ID_BETHSOFTVID,
4884
b23051d2a676 add V.Flash PTX decoder
ivo
parents: 4864
diff changeset
187 CODEC_ID_PTX,
4934
feba7e1adac5 Renderware TXD decoder
ivo
parents: 4932
diff changeset
188 CODEC_ID_TXD,
5714
314be1cfdcb0 add a new vp6a codec (add alpha plan support to vp6)
aurel
parents: 5687
diff changeset
189 CODEC_ID_VP6A,
5736
810067f2c33d AMV video decoder.
vitor
parents: 5726
diff changeset
190 CODEC_ID_AMV,
5847
82ac47c0c6dd Beam Software SIFF demuxer and video decoder
kostya
parents: 5844
diff changeset
191 CODEC_ID_VB,
6073
60d30d88cf71 PC Paintbrush PCX image decoder
ivo
parents: 6055
diff changeset
192 CODEC_ID_PCX,
6084
d33520d1ca92 Sun Rasterfile decoder
ivo
parents: 6083
diff changeset
193 CODEC_ID_SUNRAST,
6422
e82ca9167c1f Add more riff IDs to support remuxing.
banan
parents: 6417
diff changeset
194 CODEC_ID_INDEO4,
e82ca9167c1f Add more riff IDs to support remuxing.
banan
parents: 6417
diff changeset
195 CODEC_ID_INDEO5,
6508
d9711ab4a934 Mimic decoder.
ramiro
parents: 6495
diff changeset
196 CODEC_ID_MIMIC,
6523
ae19192241c4 rl2 decoder
faust3
parents: 6521
diff changeset
197 CODEC_ID_RL2,
6547
ed204467a154 8SVX decoder
vitor
parents: 6541
diff changeset
198 CODEC_ID_8SVX_EXP,
ed204467a154 8SVX decoder
vitor
parents: 6541
diff changeset
199 CODEC_ID_8SVX_FIB,
6549
6b07b4eeabb9 Escape 124 (RPL) decoder
superdump
parents: 6547
diff changeset
200 CODEC_ID_ESCAPE124,
6573
43d2d2f27f92 add CODEC_ID_DIRAC
michael
parents: 6549
diff changeset
201 CODEC_ID_DIRAC,
6593
e47a04d636a7 BFI demuxer
vitor
parents: 6587
diff changeset
202 CODEC_ID_BFI,
7222
93e3382349fc Electronic Arts CMV decoder
pross
parents: 7194
diff changeset
203 CODEC_ID_CMV,
7231
21f5d934ccbd Motion Pixels Video Decoder.
ramiro
parents: 7227
diff changeset
204 CODEC_ID_MOTIONPIXELS,
7510
212e72dbb838 Electronic Arts TGV decoder
pross
parents: 7441
diff changeset
205 CODEC_ID_TGV,
8119
4c2893f962bb Electronic Arts TGQ video decoder
pross
parents: 8104
diff changeset
206 CODEC_ID_TGQ,
8745
9833a42260fc Electronic Arts TQI decoder
pross
parents: 8718
diff changeset
207 CODEC_ID_TQI,
9227
98f102ead3c6 Add AURA 1 and 2 codec IDs and register their FOURCCs
kostya
parents: 9222
diff changeset
208 CODEC_ID_AURA,
98f102ead3c6 Add AURA 1 and 2 codec IDs and register their FOURCCs
kostya
parents: 9222
diff changeset
209 CODEC_ID_AURA2,
9535
4a4929da4ddc Support reading packed YUV422 10bit samples from Sveriges Television AB (SVT)
michael
parents: 9502
diff changeset
210 CODEC_ID_V210X,
9616
fe6e82906aa8 Add 8088flex TMV video decoder.
stefano
parents: 9600
diff changeset
211 CODEC_ID_TMV,
9628
4b6766057548 V210 Uncompressed 4:2:2 10-bit encoder and decoder
bcoudurier
parents: 9626
diff changeset
212 CODEC_ID_V210,
9839
ee32274eb802 DPX (Digital Picture Exchange) image decoder
diego
parents: 9827
diff changeset
213 CODEC_ID_DPX,
9848
173ec947655f Electronic Arts Madcow decoder
pross
parents: 9839
diff changeset
214 CODEC_ID_MAD,
10394
81cf22a16ab3 Add decoder for "forward uncompressed".
reimar
parents: 10389
diff changeset
215 CODEC_ID_FRWU,
10547
8a2d04d5deb9 Add codec id for Flash screen codec v2 and hook it up in FLV demuxer
daniel
parents: 10536
diff changeset
216 CODEC_ID_FLASHSV2,
10692
e6cd0f36159b CD+G demuxer and decoder
vitor
parents: 10686
diff changeset
217 CODEC_ID_CDGRAPHICS,
10693
0aec5a890b83 Add decoder for R210 (uncompressed 10-bit RGB) codec.
reimar
parents: 10692
diff changeset
218 CODEC_ID_R210,
10835
d1115fb7e914 Deluxe Paint Animation decoder
pross
parents: 10765
diff changeset
219 CODEC_ID_ANM,
11055
dcb38ea8dad0 Add Bink codec IDs
daniel
parents: 11053
diff changeset
220 CODEC_ID_BINKVIDEO,
11074
9fe3b0dcd33d IFF PBM/ILBM bitmap decoder
pross
parents: 11068
diff changeset
221 CODEC_ID_IFF_ILBM,
9fe3b0dcd33d IFF PBM/ILBM bitmap decoder
pross
parents: 11068
diff changeset
222 CODEC_ID_IFF_BYTERUN1,
11425
599e717b0549 Kega Game Video (KGV1) decoder
daniel
parents: 11401
diff changeset
223 CODEC_ID_KGV1,
11553
d35c3095f96b Implement YOP demuxer and video decoder.
stefano
parents: 11545
diff changeset
224 CODEC_ID_YOP,
11744
a85d4655ad52 Add VP8 CODEC_ID
conrad
parents: 11741
diff changeset
225 CODEC_ID_VP8,
11855
677c51ca528d Pictor/PC Paint decoder
pross
parents: 11838
diff changeset
226 CODEC_ID_PICTOR,
12186
fb2f04f70afe ASCII/ANSI art decoder
pross
parents: 12139
diff changeset
227 CODEC_ID_ANSI,
12402
e1c8b2779d98 added codec-ids for the a64 codec
bindhammer
parents: 12386
diff changeset
228 CODEC_ID_A64_MULTI,
e1c8b2779d98 added codec-ids for the a64 codec
bindhammer
parents: 12386
diff changeset
229 CODEC_ID_A64_MULTI5,
e1c8b2779d98 added codec-ids for the a64 codec
bindhammer
parents: 12386
diff changeset
230
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
231 /* various PCM "codecs" */
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
232 CODEC_ID_PCM_S16LE= 0x10000,
92
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
233 CODEC_ID_PCM_S16BE,
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
234 CODEC_ID_PCM_U16LE,
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
235 CODEC_ID_PCM_U16BE,
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
236 CODEC_ID_PCM_S8,
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
237 CODEC_ID_PCM_U8,
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
238 CODEC_ID_PCM_MULAW,
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
239 CODEC_ID_PCM_ALAW,
2852
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
240 CODEC_ID_PCM_S32LE,
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
241 CODEC_ID_PCM_S32BE,
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
242 CODEC_ID_PCM_U32LE,
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
243 CODEC_ID_PCM_U32BE,
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
244 CODEC_ID_PCM_S24LE,
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
245 CODEC_ID_PCM_S24BE,
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
246 CODEC_ID_PCM_U24LE,
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
247 CODEC_ID_PCM_U24BE,
6f7428adc6ad Support de-/encoding of 24 and 32 bit PCM (from and to internal 16 bit).
reimar
parents: 2843
diff changeset
248 CODEC_ID_PCM_S24DAUD,
5422
ad384eda0cb7 support silly PCM variant used by zork nemesis
michael
parents: 5408
diff changeset
249 CODEC_ID_PCM_ZORK,
5940
d63186919b60 add pcm_s16le_planar support for electronicarts files
aurel
parents: 5922
diff changeset
250 CODEC_ID_PCM_S16LE_PLANAR,
6821
1b9c458d6d60 LPCM 24 bits support, patch by Lars T«£uber, lars.taeuber gmx net
diego
parents: 6776
diff changeset
251 CODEC_ID_PCM_DVD,
7409
21770337ff2d add CODEC_ID_PCM_F32BE (32-bit floating point PCM big endian decoder)
pross
parents: 7406
diff changeset
252 CODEC_ID_PCM_F32BE,
7613
ff395fe35161 Add F64BE, F64LE and F64BE PCM codecs.
pross
parents: 7612
diff changeset
253 CODEC_ID_PCM_F32LE,
ff395fe35161 Add F64BE, F64LE and F64BE PCM codecs.
pross
parents: 7612
diff changeset
254 CODEC_ID_PCM_F64BE,
ff395fe35161 Add F64BE, F64LE and F64BE PCM codecs.
pross
parents: 7612
diff changeset
255 CODEC_ID_PCM_F64LE,
10099
27eef2ead6ab Decoder for LPCM as used in Bluray discs.
cehoyos
parents: 10083
diff changeset
256 CODEC_ID_PCM_BLURAY,
573
b0f52172f4c5 beos/mov/adpcm patch by Fran«®ois Revol <revol at free dot fr>
michaelni
parents: 556
diff changeset
257
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
258 /* various ADPCM codecs */
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
259 CODEC_ID_ADPCM_IMA_QT= 0x11000,
573
b0f52172f4c5 beos/mov/adpcm patch by Fran«®ois Revol <revol at free dot fr>
michaelni
parents: 556
diff changeset
260 CODEC_ID_ADPCM_IMA_WAV,
1443
47f4c8a5a7fc New fringe codecs: WC3/Xan video, Xan DPCM, DK3 & DK4 ADPCM
tmmm
parents: 1442
diff changeset
261 CODEC_ID_ADPCM_IMA_DK3,
47f4c8a5a7fc New fringe codecs: WC3/Xan video, Xan DPCM, DK3 & DK4 ADPCM
tmmm
parents: 1442
diff changeset
262 CODEC_ID_ADPCM_IMA_DK4,
1491
222643544cf1 New demuxers: Sega FILM/CPK, Westwood VQA & AUD; new decoders: MS RLE &
tmmm
parents: 1490
diff changeset
263 CODEC_ID_ADPCM_IMA_WS,
1779
9848ca4ad861 added support for EA ADPCM and SMJPEG IMA ADPCM
melanson
parents: 1777
diff changeset
264 CODEC_ID_ADPCM_IMA_SMJPEG,
573
b0f52172f4c5 beos/mov/adpcm patch by Fran«®ois Revol <revol at free dot fr>
michaelni
parents: 556
diff changeset
265 CODEC_ID_ADPCM_MS,
1286
9e8cbd476f59 placeholder IDs for 4xm A/V codecs
tmmm
parents: 1273
diff changeset
266 CODEC_ID_ADPCM_4XM,
1535
bcb30ec7e86f activate the XA and ADX ADPCM codecs
melanson
parents: 1525
diff changeset
267 CODEC_ID_ADPCM_XA,
bcb30ec7e86f activate the XA and ADX ADPCM codecs
melanson
parents: 1525
diff changeset
268 CODEC_ID_ADPCM_ADX,
1779
9848ca4ad861 added support for EA ADPCM and SMJPEG IMA ADPCM
melanson
parents: 1777
diff changeset
269 CODEC_ID_ADPCM_EA,
1791
5e5c3d4a1e82 * Initial implementation of the G.726 ADPCM audio codec.
romansh
parents: 1783
diff changeset
270 CODEC_ID_ADPCM_G726,
2296
2b75dff01118 Creative ADPCM decoder, format 0x200, courtesy of Konstantin Shishkov
melanson
parents: 2279
diff changeset
271 CODEC_ID_ADPCM_CT,
2516
9f17dd9b80c6 macromedia flavour adpcm decoding (used in flv and swf)
alex
parents: 2507
diff changeset
272 CODEC_ID_ADPCM_SWF,
2794
ed1ab1566353 Add Yamaha ADPCM encoding/decoding patch by (Vidar Madsen: vidarino, gmail com)
michael
parents: 2792
diff changeset
273 CODEC_ID_ADPCM_YAMAHA,
3127
6bae70889b35 add Creative 8 bits ADPCM schemes support
aurel
parents: 3123
diff changeset
274 CODEC_ID_ADPCM_SBPRO_4,
6bae70889b35 add Creative 8 bits ADPCM schemes support
aurel
parents: 3123
diff changeset
275 CODEC_ID_ADPCM_SBPRO_3,
6bae70889b35 add Creative 8 bits ADPCM schemes support
aurel
parents: 3123
diff changeset
276 CODEC_ID_ADPCM_SBPRO_2,
4800
d6b2ddac2c5e THP PCM decoder, used on the Nintendo GameCube.
diego
parents: 4797
diff changeset
277 CODEC_ID_ADPCM_THP,
5726
6589b212f6b9 AMV audio decoder
vitor
parents: 5714
diff changeset
278 CODEC_ID_ADPCM_IMA_AMV,
5851
dea3ac1d4c67 EA ADPCM R1, R2 and R3 decoder
aurel
parents: 5847
diff changeset
279 CODEC_ID_ADPCM_EA_R1,
dea3ac1d4c67 EA ADPCM R1, R2 and R3 decoder
aurel
parents: 5847
diff changeset
280 CODEC_ID_ADPCM_EA_R3,
dea3ac1d4c67 EA ADPCM R1, R2 and R3 decoder
aurel
parents: 5847
diff changeset
281 CODEC_ID_ADPCM_EA_R2,
5853
286738ef0a4e EA IMA SEAD decoder
aurel
parents: 5851
diff changeset
282 CODEC_ID_ADPCM_IMA_EA_SEAD,
5854
29b36106bc9c EA IMA EACS decoder
aurel
parents: 5853
diff changeset
283 CODEC_ID_ADPCM_IMA_EA_EACS,
5870
b56df7a7204c add Electronic Arts XAS ADPCM decoder
aurel
parents: 5854
diff changeset
284 CODEC_ID_ADPCM_EA_XAS,
6596
372ad1fe174d Maxis XA demuxer and decoder.
benoit
parents: 6593
diff changeset
285 CODEC_ID_ADPCM_EA_MAXIS_XA,
8615
2a2318411d9d added demuxer for FunCom ISS audio files,
stefang
parents: 8610
diff changeset
286 CODEC_ID_ADPCM_IMA_ISS,
1258
802614404398 AMR-NB audio support patch by (<joca at rixmail dot se>)
michaelni
parents: 1245
diff changeset
287
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
288 /* AMR */
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
289 CODEC_ID_AMR_NB= 0x12000,
1486
f22010affdce AMR-WB support by (Johannes Carlsson <joca at rixmail dot se>)
michaelni
parents: 1471
diff changeset
290 CODEC_ID_AMR_WB,
f22010affdce AMR-WB support by (Johannes Carlsson <joca at rixmail dot se>)
michaelni
parents: 1471
diff changeset
291
1304
e8543aab0cc9 RealAudio 1.0 (14_4) and 2.0 (28_8) native decoders. Author unknown, code from a mplayerhq (originally from public domain player for Amiga
nickols_k
parents: 1300
diff changeset
292 /* RealAudio codecs*/
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
293 CODEC_ID_RA_144= 0x13000,
1304
e8543aab0cc9 RealAudio 1.0 (14_4) and 2.0 (28_8) native decoders. Author unknown, code from a mplayerhq (originally from public domain player for Amiga
nickols_k
parents: 1300
diff changeset
294 CODEC_ID_RA_288,
1439
a4d00b1f0271 initial commit for Id RoQ and Interplay MVE multimedia subsystems
tmmm
parents: 1433
diff changeset
295
a4d00b1f0271 initial commit for Id RoQ and Interplay MVE multimedia subsystems
tmmm
parents: 1433
diff changeset
296 /* various DPCM codecs */
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
297 CODEC_ID_ROQ_DPCM= 0x14000,
1439
a4d00b1f0271 initial commit for Id RoQ and Interplay MVE multimedia subsystems
tmmm
parents: 1433
diff changeset
298 CODEC_ID_INTERPLAY_DPCM,
1443
47f4c8a5a7fc New fringe codecs: WC3/Xan video, Xan DPCM, DK3 & DK4 ADPCM
tmmm
parents: 1442
diff changeset
299 CODEC_ID_XAN_DPCM,
2275
c443a6af19a7 support for Sierra Online audio files and Apple QuickDraw codec,
melanson
parents: 2272
diff changeset
300 CODEC_ID_SOL_DPCM,
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
301
6587
66580b034818 Add explanatory comments to enum CodecID.
diego
parents: 6573
diff changeset
302 /* audio codecs */
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
303 CODEC_ID_MP2= 0x15000,
6037
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
304 CODEC_ID_MP3, ///< preferred ID for decoding MPEG audio layer 1, 2 or 3
2372
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
305 CODEC_ID_AAC,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
306 CODEC_ID_AC3,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
307 CODEC_ID_DTS,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
308 CODEC_ID_VORBIS,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
309 CODEC_ID_DVAUDIO,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
310 CODEC_ID_WMAV1,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
311 CODEC_ID_WMAV2,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
312 CODEC_ID_MACE3,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
313 CODEC_ID_MACE6,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
314 CODEC_ID_VMDAUDIO,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
315 CODEC_ID_SONIC,
2d95a6cd757a fix some codec_id values so that new ones can be added at the end of the subsets without breaking binary compatibility
michael
parents: 2370
diff changeset
316 CODEC_ID_SONIC_LS,
1812
6d762acfff5d flac fixes:
michael
parents: 1799
diff changeset
317 CODEC_ID_FLAC,
2432
d9cf90e66883 Decode MP3 in ADU format
rtognimp
parents: 2422
diff changeset
318 CODEC_ID_MP3ADU,
2507
0334caf0f0ce Multichannel mp3 in mp4 support ISO/IEC 14496-3:2001/FPDAM 3 (MP3onMP4)
rtognimp
parents: 2501
diff changeset
319 CODEC_ID_MP3ON4,
2525
b47af698085e shorten decoder by (Jeff Muizelaar <jrmuizel gmail com>)
michael
parents: 2522
diff changeset
320 CODEC_ID_SHORTEN,
2550
8bf96ac84409 group audio codec ids
michael
parents: 2542
diff changeset
321 CODEC_ID_ALAC,
2585
1ef8fab234c8 Westwood SND1 decoder, courtesy of Kostya
melanson
parents: 2584
diff changeset
322 CODEC_ID_WESTWOOD_SND1,
6037
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
323 CODEC_ID_GSM, ///< as in Berlin toast format
2913
cc55bc1f8d92 QDM2 compatible decoder
rtognimp
parents: 2906
diff changeset
324 CODEC_ID_QDM2,
2956
5f51b1e0bed6 Cook compatibe decoder, patch by Benjamin Larsson
rtognimp
parents: 2949
diff changeset
325 CODEC_ID_COOK,
3006
4007989367bc TrueSpeech compatible audio decoder by Konstantin Shishkov
diego
parents: 2996
diff changeset
326 CODEC_ID_TRUESPEECH,
3118
01b58c3b8a91 tta decoder, tested with 44khz mono and stereo (for the latter use ffplay or change MAX_AUDIO_FRAME_SIZE)
alex
parents: 3100
diff changeset
327 CODEC_ID_TTA,
3209
cc86ebc32143 Smacker demuxer and decoder.
kostya
parents: 3179
diff changeset
328 CODEC_ID_SMACKAUDIO,
3597
19fafe90977a Added codec id for QCELP.
banan
parents: 3531
diff changeset
329 CODEC_ID_QCELP,
3764
6e7dc8fa5f70 WavPack lossless audio decoder
kostya
parents: 3758
diff changeset
330 CODEC_ID_WAVPACK,
3997
8ed26e786210 support for Delphine Software .cin files demuxing / audio and video decoding, by Gregory Montoir %cyx A users P sourceforge P net%
bcoudurier
parents: 3986
diff changeset
331 CODEC_ID_DSICINAUDIO,
4106
21aa7e801c7b IMC decoder
kostya
parents: 4080
diff changeset
332 CODEC_ID_IMC,
4328
a0cfbd6679c0 Musepack SV7 decoding support
kostya
parents: 4327
diff changeset
333 CODEC_ID_MUSEPACK7,
4489
27e74573b074 Revised patch for HD DVD .EVO demuxing by (Ian Caulfield <lowercase name seperated by . place at here gmail place a dot here com>)
michael
parents: 4477
diff changeset
334 CODEC_ID_MLP,
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
335 CODEC_ID_GSM_MS, /* as found in WAV */
4856
5af8895c2805 Atrac3 decoder.
banan
parents: 4846
diff changeset
336 CODEC_ID_ATRAC3,
5406
9d95fa2bd150 detect voxware (closes issue39)
michael
parents: 5291
diff changeset
337 CODEC_ID_VOXWARE,
5673
9810f0bbacb2 Monkey Audio decoder
kostya
parents: 5630
diff changeset
338 CODEC_ID_APE,
5823
4beef9d0e663 Nellymoser ASAO decoder
banan
parents: 5808
diff changeset
339 CODEC_ID_NELLYMOSER,
5879
ad73103623ab Musepack SV8 demuxer and decoder
kostya
parents: 5870
diff changeset
340 CODEC_ID_MUSEPACK8,
6337
ac94f0de338e Add support for speex in ogg
reimar
parents: 6318
diff changeset
341 CODEC_ID_SPEEX,
6389
dc8990727103 Riff ids for wmapro and wmavoice, this adds support for stream copy of these codecs between asf,avi and wav containers.
banan
parents: 6382
diff changeset
342 CODEC_ID_WMAVOICE,
dc8990727103 Riff ids for wmapro and wmavoice, this adds support for stream copy of these codecs between asf,avi and wav containers.
banan
parents: 6382
diff changeset
343 CODEC_ID_WMAPRO,
6422
e82ca9167c1f Add more riff IDs to support remuxing.
banan
parents: 6417
diff changeset
344 CODEC_ID_WMALOSSLESS,
7029
05a09fe93944 Oma demuxer
banan
parents: 7003
diff changeset
345 CODEC_ID_ATRAC3P,
7769
e5f7a43f63ae create a separate codec_id for E-AC-3
jbr
parents: 7760
diff changeset
346 CODEC_ID_EAC3,
7927
c6e9ff53dab4 Add support for Acelp.net fourcc and codecid, remuxing wav to avi should work
banan
parents: 7833
diff changeset
347 CODEC_ID_SIPR,
8585
2186f7c290dd Add CODEC_ID_MP1.
michael
parents: 8548
diff changeset
348 CODEC_ID_MP1,
9152
788aa0c09382 VQF demuxer
vitor
parents: 9140
diff changeset
349 CODEC_ID_TWINVQ,
9190
5b4f4d83431f Split TrueHD decoder from MLP
ramiro
parents: 9182
diff changeset
350 CODEC_ID_TRUEHD,
9492
bdb94921332a Introduce codec id for MPEG-4 ALS and associate it with corresponding
jai_menon
parents: 9415
diff changeset
351 CODEC_ID_MP4ALS,
10158
2fc1e93229ee Add ATRAC1 codec ID.
banan
parents: 10122
diff changeset
352 CODEC_ID_ATRAC1,
11055
dcb38ea8dad0 Add Bink codec IDs
daniel
parents: 11053
diff changeset
353 CODEC_ID_BINKAUDIO_RDFT,
dcb38ea8dad0 Add Bink codec IDs
daniel
parents: 11053
diff changeset
354 CODEC_ID_BINKAUDIO_DCT,
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
355
2756
d8874c8749ec subtitle codec type support
bellard
parents: 2734
diff changeset
356 /* subtitle codecs */
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
357 CODEC_ID_DVD_SUBTITLE= 0x17000,
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
358 CODEC_ID_DVB_SUBTITLE,
6037
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
359 CODEC_ID_TEXT, ///< raw UTF-8 text
5483
447409d8770f First version of xsub decoder, not yet tested
reimar
parents: 5422
diff changeset
360 CODEC_ID_XSUB,
6087
34abda474ff7 export raw SSA tracks with their own codec ID (patch by Evgeniy Stepanov)
aurel
parents: 6084
diff changeset
361 CODEC_ID_SSA,
6187
098f955eaec8 Add CODEC_ID_MOV_TEXT and use it instead of modifying the stream in the mov demuxer.
reimar
parents: 6184
diff changeset
362 CODEC_ID_MOV_TEXT,
10083
8071f8b68d05 Add Bluray Subtitle Support
cehoyos
parents: 9902
diff changeset
363 CODEC_ID_HDMV_PGS_SUBTITLE,
10480
bea92d25f53e Support demuxing teletext in DVB streams.
cehoyos
parents: 10451
diff changeset
364 CODEC_ID_DVB_TELETEXT,
12267
8de66be22d87 add SubRip muxer and demuxer
aurel
parents: 12197
diff changeset
365 CODEC_ID_SRT,
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
366
6486
3f96dc62c4b9 misc spelling fixes
diego
parents: 6464
diff changeset
367 /* other specific kind of codecs (generally used for attachments) */
6184
4ba171d6d84a Add support for Matroska attachments.
aurel
parents: 6087
diff changeset
368 CODEC_ID_TTF= 0x18000,
4ba171d6d84a Add support for Matroska attachments.
aurel
parents: 6087
diff changeset
369
7251
48dd72fdca91 New codec probing system try #1.
michael
parents: 7241
diff changeset
370 CODEC_ID_PROBE= 0x19000, ///< codec_id is not known (like CODEC_ID_NONE) but lavf should attempt to identify it
48dd72fdca91 New codec probing system try #1.
michael
parents: 7241
diff changeset
371
6037
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
372 CODEC_ID_MPEG2TS= 0x20000, /**< _FAKE_ codec to indicate a raw MPEG-2 TS
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
373 * stream (only used by libavformat) */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
374 };
1447
7c73537bc994 changed my mind about CODEC_ID_MPEGVIDEO - CODEC_ID_MP3LAME is absolete
bellard
parents: 1443
diff changeset
375
11560
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
376 #if LIBAVCODEC_VERSION_MAJOR < 53
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
377 #define CodecType AVMediaType
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
378
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
379 #define CODEC_TYPE_UNKNOWN AVMEDIA_TYPE_UNKNOWN
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
380 #define CODEC_TYPE_VIDEO AVMEDIA_TYPE_VIDEO
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
381 #define CODEC_TYPE_AUDIO AVMEDIA_TYPE_AUDIO
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
382 #define CODEC_TYPE_DATA AVMEDIA_TYPE_DATA
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
383 #define CODEC_TYPE_SUBTITLE AVMEDIA_TYPE_SUBTITLE
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
384 #define CODEC_TYPE_ATTACHMENT AVMEDIA_TYPE_ATTACHMENT
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
385 #define CODEC_TYPE_NB AVMEDIA_TYPE_NB
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
386 #endif
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
387
6037
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
388 /**
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
389 * all in native-endian format
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
390 */
92
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
391 enum SampleFormat {
3251
ef3ba591d0cc s/SAMPLT_FMT_NONE/SAMPLE_FMT_NONE/
mru
parents: 3236
diff changeset
392 SAMPLE_FMT_NONE = -1,
3136
ddf6d81a6369 added none/8bit/24bit audio formats and defaulting to s16 for now (once the system works like pix_fmt, the defaulting should be changed to SAMPLE_FMT_NONE)
alex
parents: 3132
diff changeset
393 SAMPLE_FMT_U8, ///< unsigned 8 bits
ddf6d81a6369 added none/8bit/24bit audio formats and defaulting to s16 for now (once the system works like pix_fmt, the defaulting should be changed to SAMPLE_FMT_NONE)
alex
parents: 3132
diff changeset
394 SAMPLE_FMT_S16, ///< signed 16 bits
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
395 SAMPLE_FMT_S32, ///< signed 32 bits
2479
dfdb6bf4b90f support 32bit output for the mpeg audio decoder
michael
parents: 2453
diff changeset
396 SAMPLE_FMT_FLT, ///< float
7612
1302ec81afc0 Add SAMPLE_FMT_DBL.
pross
parents: 7607
diff changeset
397 SAMPLE_FMT_DBL, ///< double
7410
4c68f77c49ee add sample_fmts infrastructure: AVCodec->sample_fmts and SAMPLE_FMT_NB enum.
pross
parents: 7409
diff changeset
398 SAMPLE_FMT_NB ///< Number of sample formats. DO NOT USE if dynamically linking to libavcodec
92
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
399 };
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
400
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
401 /* Audio channel masks */
8102
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
402 #define CH_FRONT_LEFT 0x00000001
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
403 #define CH_FRONT_RIGHT 0x00000002
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
404 #define CH_FRONT_CENTER 0x00000004
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
405 #define CH_LOW_FREQUENCY 0x00000008
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
406 #define CH_BACK_LEFT 0x00000010
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
407 #define CH_BACK_RIGHT 0x00000020
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
408 #define CH_FRONT_LEFT_OF_CENTER 0x00000040
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
409 #define CH_FRONT_RIGHT_OF_CENTER 0x00000080
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
410 #define CH_BACK_CENTER 0x00000100
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
411 #define CH_SIDE_LEFT 0x00000200
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
412 #define CH_SIDE_RIGHT 0x00000400
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
413 #define CH_TOP_CENTER 0x00000800
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
414 #define CH_TOP_FRONT_LEFT 0x00001000
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
415 #define CH_TOP_FRONT_CENTER 0x00002000
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
416 #define CH_TOP_FRONT_RIGHT 0x00004000
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
417 #define CH_TOP_BACK_LEFT 0x00008000
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
418 #define CH_TOP_BACK_CENTER 0x00010000
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
419 #define CH_TOP_BACK_RIGHT 0x00020000
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
420 #define CH_STEREO_LEFT 0x20000000 ///< Stereo downmix.
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
421 #define CH_STEREO_RIGHT 0x40000000 ///< See CH_STEREO_LEFT.
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
422
10515
0655a0dd3c74 Add CH_LAYOUT_NATIVE channel mask value to allow user to request native codec
jbr
parents: 10480
diff changeset
423 /** Channel mask value used for AVCodecContext.request_channel_layout
0655a0dd3c74 Add CH_LAYOUT_NATIVE channel mask value to allow user to request native codec
jbr
parents: 10480
diff changeset
424 to indicate that the user requests the channel order of the decoder output
0655a0dd3c74 Add CH_LAYOUT_NATIVE channel mask value to allow user to request native codec
jbr
parents: 10480
diff changeset
425 to be the native codec channel order. */
0655a0dd3c74 Add CH_LAYOUT_NATIVE channel mask value to allow user to request native codec
jbr
parents: 10480
diff changeset
426 #define CH_LAYOUT_NATIVE 0x8000000000000000LL
0655a0dd3c74 Add CH_LAYOUT_NATIVE channel mask value to allow user to request native codec
jbr
parents: 10480
diff changeset
427
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
428 /* Audio channel convenience macros */
8102
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
429 #define CH_LAYOUT_MONO (CH_FRONT_CENTER)
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
430 #define CH_LAYOUT_STEREO (CH_FRONT_LEFT|CH_FRONT_RIGHT)
9502
56f844aec27b Add 3 channel layout convenience macros.
jbr
parents: 9492
diff changeset
431 #define CH_LAYOUT_2_1 (CH_LAYOUT_STEREO|CH_BACK_CENTER)
8102
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
432 #define CH_LAYOUT_SURROUND (CH_LAYOUT_STEREO|CH_FRONT_CENTER)
9502
56f844aec27b Add 3 channel layout convenience macros.
jbr
parents: 9492
diff changeset
433 #define CH_LAYOUT_4POINT0 (CH_LAYOUT_SURROUND|CH_BACK_CENTER)
56f844aec27b Add 3 channel layout convenience macros.
jbr
parents: 9492
diff changeset
434 #define CH_LAYOUT_2_2 (CH_LAYOUT_STEREO|CH_SIDE_LEFT|CH_SIDE_RIGHT)
8102
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
435 #define CH_LAYOUT_QUAD (CH_LAYOUT_STEREO|CH_BACK_LEFT|CH_BACK_RIGHT)
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
436 #define CH_LAYOUT_5POINT0 (CH_LAYOUT_SURROUND|CH_SIDE_LEFT|CH_SIDE_RIGHT)
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
437 #define CH_LAYOUT_5POINT1 (CH_LAYOUT_5POINT0|CH_LOW_FREQUENCY)
9351
4b801f9ae493 Add convenience macros for 5.0/5.1 back speaker configurations.
jbr
parents: 9342
diff changeset
438 #define CH_LAYOUT_5POINT0_BACK (CH_LAYOUT_SURROUND|CH_BACK_LEFT|CH_BACK_RIGHT)
4b801f9ae493 Add convenience macros for 5.0/5.1 back speaker configurations.
jbr
parents: 9342
diff changeset
439 #define CH_LAYOUT_5POINT1_BACK (CH_LAYOUT_5POINT0_BACK|CH_LOW_FREQUENCY)
10099
27eef2ead6ab Decoder for LPCM as used in Bluray discs.
cehoyos
parents: 10083
diff changeset
440 #define CH_LAYOUT_7POINT0 (CH_LAYOUT_5POINT0|CH_BACK_LEFT|CH_BACK_RIGHT)
8102
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
441 #define CH_LAYOUT_7POINT1 (CH_LAYOUT_5POINT1|CH_BACK_LEFT|CH_BACK_RIGHT)
9351
4b801f9ae493 Add convenience macros for 5.0/5.1 back speaker configurations.
jbr
parents: 9342
diff changeset
442 #define CH_LAYOUT_7POINT1_WIDE (CH_LAYOUT_5POINT1_BACK|\
8102
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
443 CH_FRONT_LEFT_OF_CENTER|CH_FRONT_RIGHT_OF_CENTER)
04295cbc0e9b Change multichannel API define prefix from "CHANNEL_" to "CH_".
andoma
parents: 8098
diff changeset
444 #define CH_LAYOUT_STEREO_DOWNMIX (CH_STEREO_LEFT|CH_STEREO_RIGHT)
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
445
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
446 /* in bytes */
3123
fc43390719fc increase audio buffer to 1second of 48khz float audio
alex
parents: 3120
diff changeset
447 #define AVCODEC_MAX_AUDIO_FRAME_SIZE 192000 // 1 second of 48khz 32bit audio
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
448
842
e460775adb38 cleanup (breaks compatibility, requested by fabrice)
michaelni
parents: 831
diff changeset
449 /**
1289
57172377849a fix mpeg1/2 decoding if there are no 0 bytes after the bitstream
michaelni
parents: 1286
diff changeset
450 * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
11438
db5623d197a3 Revert r22288 "Increase FF_INPUT_BUFFER_PADDING_SIZE to 64."
alexc
parents: 11426
diff changeset
451 * This is mainly needed because some optimized bitstream readers read
db5623d197a3 Revert r22288 "Increase FF_INPUT_BUFFER_PADDING_SIZE to 64."
alexc
parents: 11426
diff changeset
452 * 32 or 64 bit at once and could read over the end.<br>
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
453 * Note: If the first 23 bits of the additional bytes are not 0, then damaged
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
454 * MPEG bitstreams could cause overread and segfault.
842
e460775adb38 cleanup (breaks compatibility, requested by fabrice)
michaelni
parents: 831
diff changeset
455 */
11438
db5623d197a3 Revert r22288 "Increase FF_INPUT_BUFFER_PADDING_SIZE to 64."
alexc
parents: 11426
diff changeset
456 #define FF_INPUT_BUFFER_PADDING_SIZE 8
842
e460775adb38 cleanup (breaks compatibility, requested by fabrice)
michaelni
parents: 831
diff changeset
457
2422
18b8b2dcc037 various security fixes and precautionary checks
michael
parents: 2413
diff changeset
458 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
459 * minimum encoding buffer size
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
460 * Used to avoid some checks during header writing.
2422
18b8b2dcc037 various security fixes and precautionary checks
michael
parents: 2413
diff changeset
461 */
18b8b2dcc037 various security fixes and precautionary checks
michael
parents: 2413
diff changeset
462 #define FF_MIN_BUFFER_SIZE 16384
18b8b2dcc037 various security fixes and precautionary checks
michael
parents: 2413
diff changeset
463
8520
a0164882aa38 Generic metadata API.
michael
parents: 8518
diff changeset
464
6037
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
465 /**
6038
afbdd9fe32c5 ME default does not belong to the ME type enum.
michael
parents: 6037
diff changeset
466 * motion estimation type.
6037
e0e55a5a74c0 change some normal comments to doxy ones
michael
parents: 6011
diff changeset
467 */
320
cda7d0857baf - ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents: 317
diff changeset
468 enum Motion_Est_ID {
6043
823e6b273ea2 Document Motion_Est_IDs.
michael
parents: 6042
diff changeset
469 ME_ZERO = 1, ///< no search, that is use 0,0 vector whenever one is needed
320
cda7d0857baf - ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents: 317
diff changeset
470 ME_FULL,
cda7d0857baf - ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents: 317
diff changeset
471 ME_LOG,
cda7d0857baf - ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents: 317
diff changeset
472 ME_PHODS,
6043
823e6b273ea2 Document Motion_Est_IDs.
michael
parents: 6042
diff changeset
473 ME_EPZS, ///< enhanced predictive zonal search
823e6b273ea2 Document Motion_Est_IDs.
michael
parents: 6042
diff changeset
474 ME_X1, ///< reserved for experiments
823e6b273ea2 Document Motion_Est_IDs.
michael
parents: 6042
diff changeset
475 ME_HEX, ///< hexagon based search
823e6b273ea2 Document Motion_Est_IDs.
michael
parents: 6042
diff changeset
476 ME_UMH, ///< uneven multi-hexagon search
823e6b273ea2 Document Motion_Est_IDs.
michael
parents: 6042
diff changeset
477 ME_ITER, ///< iterative search
7003
c29f78dbe1bd rename me=tesa
lorenm
parents: 7002
diff changeset
478 ME_TESA, ///< transformed exhaustive search algorithm
320
cda7d0857baf - ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents: 317
diff changeset
479 };
cda7d0857baf - ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents: 317
diff changeset
480
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
481 enum AVDiscard{
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
482 /* We leave some space between them for extensions (drop some
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
483 * keyframes for intra-only or drop just some bidir frames). */
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
484 AVDISCARD_NONE =-16, ///< discard nothing
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
485 AVDISCARD_DEFAULT= 0, ///< discard useless packets like 0 size packets in avi
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
486 AVDISCARD_NONREF = 8, ///< discard all non reference
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
487 AVDISCARD_BIDIR = 16, ///< discard all bidirectional frames
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
488 AVDISCARD_NONKEY = 32, ///< discard all frames except keyframes
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
489 AVDISCARD_ALL = 48, ///< discard all
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
490 };
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
491
9600
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
492 enum AVColorPrimaries{
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
493 AVCOL_PRI_BT709 =1, ///< also ITU-R BT1361 / IEC 61966-2-4 / SMPTE RP177 Annex B
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
494 AVCOL_PRI_UNSPECIFIED=2,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
495 AVCOL_PRI_BT470M =4,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
496 AVCOL_PRI_BT470BG =5, ///< also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
497 AVCOL_PRI_SMPTE170M =6, ///< also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
498 AVCOL_PRI_SMPTE240M =7, ///< functionally identical to above
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
499 AVCOL_PRI_FILM =8,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
500 AVCOL_PRI_NB , ///< Not part of ABI
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
501 };
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
502
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
503 enum AVColorTransferCharacteristic{
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
504 AVCOL_TRC_BT709 =1, ///< also ITU-R BT1361
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
505 AVCOL_TRC_UNSPECIFIED=2,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
506 AVCOL_TRC_GAMMA22 =4, ///< also ITU-R BT470M / ITU-R BT1700 625 PAL & SECAM
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
507 AVCOL_TRC_GAMMA28 =5, ///< also ITU-R BT470BG
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
508 AVCOL_TRC_NB , ///< Not part of ABI
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
509 };
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
510
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
511 enum AVColorSpace{
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
512 AVCOL_SPC_RGB =0,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
513 AVCOL_SPC_BT709 =1, ///< also ITU-R BT1361 / IEC 61966-2-4 xvYCC709 / SMPTE RP177 Annex B
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
514 AVCOL_SPC_UNSPECIFIED=2,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
515 AVCOL_SPC_FCC =4,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
516 AVCOL_SPC_BT470BG =5, ///< also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM / IEC 61966-2-4 xvYCC601
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
517 AVCOL_SPC_SMPTE170M =6, ///< also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC / functionally identical to above
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
518 AVCOL_SPC_SMPTE240M =7,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
519 AVCOL_SPC_NB , ///< Not part of ABI
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
520 };
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
521
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
522 enum AVColorRange{
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
523 AVCOL_RANGE_UNSPECIFIED=0,
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
524 AVCOL_RANGE_MPEG =1, ///< the normal 219*2^(n-8) "MPEG" YUV ranges
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
525 AVCOL_RANGE_JPEG =2, ///< the normal 2^n-1 "JPEG" YUV ranges
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
526 AVCOL_RANGE_NB , ///< Not part of ABI
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
527 };
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
528
9626
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
529 /**
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
530 * X X 3 4 X X are luma samples,
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
531 * 1 2 1-6 are possible chroma positions
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
532 * X X 5 6 X 0 is undefined/unknown position
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
533 */
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
534 enum AVChromaLocation{
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
535 AVCHROMA_LOC_UNSPECIFIED=0,
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
536 AVCHROMA_LOC_LEFT =1, ///< mpeg2/4, h264 default
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
537 AVCHROMA_LOC_CENTER =2, ///< mpeg1, jpeg, h263
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
538 AVCHROMA_LOC_TOPLEFT =3, ///< DV
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
539 AVCHROMA_LOC_TOP =4,
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
540 AVCHROMA_LOC_BOTTOMLEFT =5,
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
541 AVCHROMA_LOC_BOTTOM =6,
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
542 AVCHROMA_LOC_NB , ///< Not part of ABI
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
543 };
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
544
12139
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
545 /**
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
546 * LPC analysis type
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
547 */
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
548 enum AVLPCType {
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
549 AV_LPC_TYPE_DEFAULT = -1, ///< use the codec default LPC type
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
550 AV_LPC_TYPE_NONE = 0, ///< do not use LPC prediction or use all zero coefficients
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
551 AV_LPC_TYPE_FIXED = 1, ///< fixed LPC coefficients
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
552 AV_LPC_TYPE_LEVINSON = 2, ///< Levinson-Durbin recursion
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
553 AV_LPC_TYPE_CHOLESKY = 3, ///< Cholesky factorization
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
554 AV_LPC_TYPE_NB , ///< Not part of ABI
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
555 };
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
556
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
557 typedef struct RcOverride{
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
558 int start_frame;
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
559 int end_frame;
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
560 int qscale; // If this is 0 then quality_factor will be used instead.
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
561 float quality_factor;
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
562 } RcOverride;
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
563
3132
f16ccfe674cc Increase maximum number of B-frames, necessary for H.264 encoding.
diego
parents: 3129
diff changeset
564 #define FF_MAX_B_FRAMES 16
324
9c6f056f0e41 fixed mpeg4 time stuff on encoding
michaelni
parents: 322
diff changeset
565
681
b3869ffff47a avcodec_alloc_context()
michaelni
parents: 669
diff changeset
566 /* encoding support
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
567 These flags can be passed in AVCodecContext.flags before initialization.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
568 Note: Not everything is supported yet.
681
b3869ffff47a avcodec_alloc_context()
michaelni
parents: 669
diff changeset
569 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
570
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
571 #define CODEC_FLAG_QSCALE 0x0002 ///< Use fixed qscale.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
572 #define CODEC_FLAG_4MV 0x0004 ///< 4 MV per MB allowed / advanced prediction for H.263.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
573 #define CODEC_FLAG_QPEL 0x0010 ///< Use qpel MC.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
574 #define CODEC_FLAG_GMC 0x0020 ///< Use GMC.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
575 #define CODEC_FLAG_MV0 0x0040 ///< Always try a MB with MV=<0,0>.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
576 #define CODEC_FLAG_PART 0x0080 ///< Use data partitioning.
6039
b4d22e42528c another comment ->doxy
michael
parents: 6038
diff changeset
577 /**
b4d22e42528c another comment ->doxy
michael
parents: 6038
diff changeset
578 * The parent program guarantees that the input for B-frames containing
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
579 * streams is not written to for at least s->max_b_frames+1 frames, if
6039
b4d22e42528c another comment ->doxy
michael
parents: 6038
diff changeset
580 * this is not set the input will be copied.
b4d22e42528c another comment ->doxy
michael
parents: 6038
diff changeset
581 */
329
5cc47d0ba53e fixed ratecontrol & b-frames
michaelni
parents: 328
diff changeset
582 #define CODEC_FLAG_INPUT_PRESERVED 0x0100
5590
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
583 #define CODEC_FLAG_PASS1 0x0200 ///< Use internal 2pass ratecontrol in first pass mode.
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
584 #define CODEC_FLAG_PASS2 0x0400 ///< Use internal 2pass ratecontrol in second pass mode.
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
585 #define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< Use external Huffman table (for MJPEG).
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
586 #define CODEC_FLAG_GRAY 0x2000 ///< Only decode/encode grayscale.
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
587 #define CODEC_FLAG_EMU_EDGE 0x4000 ///< Don't draw edges.
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
588 #define CODEC_FLAG_PSNR 0x8000 ///< error[?] variables will be set during encoding.
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
589 #define CODEC_FLAG_TRUNCATED 0x00010000 /** Input bitstream might be truncated at a random
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
590 location instead of only at frame boundaries. */
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
591 #define CODEC_FLAG_NORMALIZE_AQP 0x00020000 ///< Normalize adaptive quantization.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
592 #define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< Use interlaced DCT.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
593 #define CODEC_FLAG_LOW_DELAY 0x00080000 ///< Force low delay.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
594 #define CODEC_FLAG_ALT_SCAN 0x00100000 ///< Use alternate scan.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
595 #define CODEC_FLAG_GLOBAL_HEADER 0x00400000 ///< Place global headers in extradata instead of every keyframe.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
596 #define CODEC_FLAG_BITEXACT 0x00800000 ///< Use only bitexact stuff (except (I)DCT).
1095
c7604e6291c5 extended option for h263+ patch by (fixounet at free dot fr) with some minor modifications
michaelni
parents: 1092
diff changeset
597 /* Fx : Flag for h263+ extra options */
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
598 #define CODEC_FLAG_AC_PRED 0x01000000 ///< H.263 advanced intra coding / MPEG-4 AC prediction
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
599 #define CODEC_FLAG_H263P_UMV 0x02000000 ///< unlimited motion vector
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
600 #define CODEC_FLAG_CBP_RD 0x04000000 ///< Use rate distortion optimization for cbp.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
601 #define CODEC_FLAG_QP_RD 0x08000000 ///< Use rate distortion optimization for qp selectioon.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
602 #define CODEC_FLAG_H263P_AIV 0x00000008 ///< H.263 alternative inter VLC
1644
835cf346975e h263 loop filter
michael
parents: 1639
diff changeset
603 #define CODEC_FLAG_OBMC 0x00000001 ///< OBMC
835cf346975e h263 loop filter
michael
parents: 1639
diff changeset
604 #define CODEC_FLAG_LOOP_FILTER 0x00000800 ///< loop filter
1708
dea5b2946999 interlaced motion estimation
michael
parents: 1706
diff changeset
605 #define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000
dea5b2946999 interlaced motion estimation
michael
parents: 1706
diff changeset
606 #define CODEC_FLAG_INTERLACED_ME 0x20000000 ///< interlaced motion estimation
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
607 #define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< Will reserve space for SVCD scan offset user data.
6541
fb6109c5f08b Fix closed gop flag disapearence.
michael
parents: 6523
diff changeset
608 #define CODEC_FLAG_CLOSED_GOP 0x80000000
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
609 #define CODEC_FLAG2_FAST 0x00000001 ///< Allow non spec compliant speedup tricks.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
610 #define CODEC_FLAG2_STRICT_GOP 0x00000002 ///< Strictly enforce GOP size.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
611 #define CODEC_FLAG2_NO_OUTPUT 0x00000004 ///< Skip bitstream encoding.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
612 #define CODEC_FLAG2_LOCAL_HEADER 0x00000008 ///< Place global headers at every keyframe instead of in extradata.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
613 #define CODEC_FLAG2_BPYRAMID 0x00000010 ///< H.264 allow B-frames to be used as references.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
614 #define CODEC_FLAG2_WPRED 0x00000020 ///< H.264 weighted biprediction for B-frames
4273
73abe5df48ea Add "mixed_refs" description suggested by Loren Merritt and update accompanying
takis
parents: 4263
diff changeset
615 #define CODEC_FLAG2_MIXED_REFS 0x00000040 ///< H.264 one reference per partition, as opposed to one reference per macroblock
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
616 #define CODEC_FLAG2_8X8DCT 0x00000080 ///< H.264 high profile 8x8 transform
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
617 #define CODEC_FLAG2_FASTPSKIP 0x00000100 ///< H.264 fast pskip
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
618 #define CODEC_FLAG2_AUD 0x00000200 ///< H.264 access unit delimiters
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
619 #define CODEC_FLAG2_BRDO 0x00000400 ///< B-frame rate-distortion optimization
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
620 #define CODEC_FLAG2_INTRA_VLC 0x00000800 ///< Use MPEG-2 intra VLC table.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
621 #define CODEC_FLAG2_MEMC_ONLY 0x00001000 ///< Only do ME/MC (I frames -> ref, P frame -> ME+MC).
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
622 #define CODEC_FLAG2_DROP_FRAME_TIMECODE 0x00002000 ///< timecode is in drop frame format.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
623 #define CODEC_FLAG2_SKIP_RD 0x00004000 ///< RD optimal MB level residual skipping
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
624 #define CODEC_FLAG2_CHUNKS 0x00008000 ///< Input bitstream might be truncated at a packet boundaries instead of only at frame boundaries.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
625 #define CODEC_FLAG2_NON_LINEAR_QUANT 0x00010000 ///< Use MPEG-2 nonlinear quantizer.
6346
11a44fc273a5 Add 'reservoir' flag to lavc's flags2 controlling whether or not codes may
andoma
parents: 6337
diff changeset
626 #define CODEC_FLAG2_BIT_RESERVOIR 0x00020000 ///< Use a bit reservoir when encoding if possible
10658
8a7d79132993 Add MBtree support for libx264
darkshikari
parents: 10566
diff changeset
627 #define CODEC_FLAG2_MBTREE 0x00040000 ///< Use macroblock tree ratecontrol (x264 only)
11538
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
628 #define CODEC_FLAG2_PSY 0x00080000 ///< Use psycho visual optimizations.
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
629 #define CODEC_FLAG2_SSIM 0x00100000 ///< Compute SSIM during encoding, error[] values are undefined.
11689
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
630 #define CODEC_FLAG2_INTRA_REFRESH 0x00200000 ///< Use periodic insertion of intra blocks instead of keyframes.
2201
ccff80bb955f optional non spec compliant optimizations
michael
parents: 2184
diff changeset
631
1095
c7604e6291c5 extended option for h263+ patch by (fixounet at free dot fr) with some minor modifications
michaelni
parents: 1092
diff changeset
632 /* Unsupported options :
2979
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
633 * Syntax Arithmetic coding (SAC)
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
634 * Reference Picture Selection
4588
fc155ff94878 cosmetics: Fix another common typo, dependAnt --> dependEnt.
diego
parents: 4583
diff changeset
635 * Independent Segment Decoding */
1095
c7604e6291c5 extended option for h263+ patch by (fixounet at free dot fr) with some minor modifications
michaelni
parents: 1092
diff changeset
636 /* /Fx */
67
cdd89f96cbe1 added draw_horiz_band test
glantau
parents: 49
diff changeset
637 /* codec capabilities */
cdd89f96cbe1 added draw_horiz_band test
glantau
parents: 49
diff changeset
638
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
639 #define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< Decoder can use draw_horiz_band callback.
1192
f1054743bc56 meanigfull dr1 comment
michaelni
parents: 1190
diff changeset
640 /**
11545
c7084c69abcc Clearer CODEC_CAP_DR1 documentation.
reimar
parents: 11538
diff changeset
641 * Codec uses get_buffer() for allocating buffers and supports custom allocators.
c7084c69abcc Clearer CODEC_CAP_DR1 documentation.
reimar
parents: 11538
diff changeset
642 * If not set, it might not use get_buffer() at all or use operations that
c7084c69abcc Clearer CODEC_CAP_DR1 documentation.
reimar
parents: 11538
diff changeset
643 * assume the buffer was allocated by avcodec_default_get_buffer.
1192
f1054743bc56 meanigfull dr1 comment
michaelni
parents: 1190
diff changeset
644 */
f1054743bc56 meanigfull dr1 comment
michaelni
parents: 1190
diff changeset
645 #define CODEC_CAP_DR1 0x0002
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
646 /* If 'parse_only' field is true, then avcodec_parse_frame() can be used. */
581
8adda0af04e2 added proposed API for parse_only mode to extract compressed frames from compressed streams
bellard
parents: 573
diff changeset
647 #define CODEC_CAP_PARSE_ONLY 0x0004
842
e460775adb38 cleanup (breaks compatibility, requested by fabrice)
michaelni
parents: 831
diff changeset
648 #define CODEC_CAP_TRUNCATED 0x0008
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
649 /* Codec can export data for HW decoding (XvMC). */
1848
c72589baee53 initial chroma_format changes,xvmc tweaks and codec_cap
iive
parents: 1840
diff changeset
650 #define CODEC_CAP_HWACCEL 0x0010
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
651 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
652 * Codec has a nonzero delay and needs to be fed with NULL at the end to get the delayed data.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
653 * If this is not set, the codec is guaranteed to never be fed with NULL data.
2453
f67b63ed036d avoid buf_size == 0 checks in every decoder
michael
parents: 2445
diff changeset
654 */
2091
02a4fd7c606c flush audio encoder buffers at the end
michael
parents: 2082
diff changeset
655 #define CODEC_CAP_DELAY 0x0020
3352
608659b58523 CODEC_CAP_SMALL_LAST_FRAME patch by Justin Ruggles jruggle earthlink net
michael
parents: 3349
diff changeset
656 /**
608659b58523 CODEC_CAP_SMALL_LAST_FRAME patch by Justin Ruggles jruggle earthlink net
michael
parents: 3349
diff changeset
657 * Codec can be fed a final frame with a smaller size.
608659b58523 CODEC_CAP_SMALL_LAST_FRAME patch by Justin Ruggles jruggle earthlink net
michael
parents: 3349
diff changeset
658 * This can be used to prevent truncation of the last audio samples.
608659b58523 CODEC_CAP_SMALL_LAST_FRAME patch by Justin Ruggles jruggle earthlink net
michael
parents: 3349
diff changeset
659 */
608659b58523 CODEC_CAP_SMALL_LAST_FRAME patch by Justin Ruggles jruggle earthlink net
michael
parents: 3349
diff changeset
660 #define CODEC_CAP_SMALL_LAST_FRAME 0x0040
8522
f8c091bb5779 Add VDPAU hardware accelerated decoding for H264 which can be used by
cehoyos
parents: 8521
diff changeset
661 /**
f8c091bb5779 Add VDPAU hardware accelerated decoding for H264 which can be used by
cehoyos
parents: 8521
diff changeset
662 * Codec can export data for HW decoding (VDPAU).
f8c091bb5779 Add VDPAU hardware accelerated decoding for H264 which can be used by
cehoyos
parents: 8521
diff changeset
663 */
f8c091bb5779 Add VDPAU hardware accelerated decoding for H264 which can be used by
cehoyos
parents: 8521
diff changeset
664 #define CODEC_CAP_HWACCEL_VDPAU 0x0080
10180
a514a601bf26 Add CODEC_CAP_SUBFRAMES for codecs that output multiple subframes
faust3
parents: 10158
diff changeset
665 /**
a514a601bf26 Add CODEC_CAP_SUBFRAMES for codecs that output multiple subframes
faust3
parents: 10158
diff changeset
666 * Codec can output multiple frames per AVPacket
10957
0c50a3c33c03 Clarify CODEC_CAP_SUBFRAMES.
michael
parents: 10891
diff changeset
667 * Normally demuxers return one frame at a time, demuxers which do not do
0c50a3c33c03 Clarify CODEC_CAP_SUBFRAMES.
michael
parents: 10891
diff changeset
668 * are connected to a parser to split what they return into proper frames.
0c50a3c33c03 Clarify CODEC_CAP_SUBFRAMES.
michael
parents: 10891
diff changeset
669 * This flag is reserved to the very rare category of codecs which have a
0c50a3c33c03 Clarify CODEC_CAP_SUBFRAMES.
michael
parents: 10891
diff changeset
670 * bitstream that cannot be split into frames without timeconsuming
0c50a3c33c03 Clarify CODEC_CAP_SUBFRAMES.
michael
parents: 10891
diff changeset
671 * operations like full decoding. Demuxers carring such bitstreams thus
0c50a3c33c03 Clarify CODEC_CAP_SUBFRAMES.
michael
parents: 10891
diff changeset
672 * may return multiple frames in a packet. This has many disadvantages like
0c50a3c33c03 Clarify CODEC_CAP_SUBFRAMES.
michael
parents: 10891
diff changeset
673 * prohibiting stream copy in many cases thus it should only be considered
0c50a3c33c03 Clarify CODEC_CAP_SUBFRAMES.
michael
parents: 10891
diff changeset
674 * as a last resort.
10180
a514a601bf26 Add CODEC_CAP_SUBFRAMES for codecs that output multiple subframes
faust3
parents: 10158
diff changeset
675 */
a514a601bf26 Add CODEC_CAP_SUBFRAMES for codecs that output multiple subframes
faust3
parents: 10158
diff changeset
676 #define CODEC_CAP_SUBFRAMES 0x0100
11771
3c0dffc64d86 Add CODEC_CAP_EXPERIMENTAL and prefer encoders without it.
cehoyos
parents: 11770
diff changeset
677 /**
3c0dffc64d86 Add CODEC_CAP_EXPERIMENTAL and prefer encoders without it.
cehoyos
parents: 11770
diff changeset
678 * Codec is experimental and is thus avoided in favor of non experimental
3c0dffc64d86 Add CODEC_CAP_EXPERIMENTAL and prefer encoders without it.
cehoyos
parents: 11770
diff changeset
679 * encoders
3c0dffc64d86 Add CODEC_CAP_EXPERIMENTAL and prefer encoders without it.
cehoyos
parents: 11770
diff changeset
680 */
3c0dffc64d86 Add CODEC_CAP_EXPERIMENTAL and prefer encoders without it.
cehoyos
parents: 11770
diff changeset
681 #define CODEC_CAP_EXPERIMENTAL 0x0200
67
cdd89f96cbe1 added draw_horiz_band test
glantau
parents: 49
diff changeset
682
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
683 //The following defines may change, don't expect compatibility if you use them.
1668
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
684 #define MB_TYPE_INTRA4x4 0x0001
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
685 #define MB_TYPE_INTRA16x16 0x0002 //FIXME H.264-specific
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
686 #define MB_TYPE_INTRA_PCM 0x0004 //FIXME H.264-specific
1668
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
687 #define MB_TYPE_16x16 0x0008
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
688 #define MB_TYPE_16x8 0x0010
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
689 #define MB_TYPE_8x16 0x0020
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
690 #define MB_TYPE_8x8 0x0040
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
691 #define MB_TYPE_INTERLACED 0x0080
5590
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
692 #define MB_TYPE_DIRECT2 0x0100 //FIXME
1668
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
693 #define MB_TYPE_ACPRED 0x0200
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
694 #define MB_TYPE_GMC 0x0400
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
695 #define MB_TYPE_SKIP 0x0800
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
696 #define MB_TYPE_P0L0 0x1000
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
697 #define MB_TYPE_P1L0 0x2000
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
698 #define MB_TYPE_P0L1 0x4000
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
699 #define MB_TYPE_P1L1 0x8000
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
700 #define MB_TYPE_L0 (MB_TYPE_P0L0 | MB_TYPE_P1L0)
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
701 #define MB_TYPE_L1 (MB_TYPE_P0L1 | MB_TYPE_P1L1)
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
702 #define MB_TYPE_L0L1 (MB_TYPE_L0 | MB_TYPE_L1)
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
703 #define MB_TYPE_QUANT 0x00010000
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
704 #define MB_TYPE_CBP 0x00020000
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
705 //Note bits 24-31 are reserved for codec specific use (h264 ref0, mpeg1 0mv, ...)
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
706
1546
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
707 /**
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
708 * Pan Scan area.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
709 * This specifies the area which should be displayed.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
710 * Note there may be multiple such areas for one frame.
1546
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
711 */
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
712 typedef struct AVPanScan{
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
713 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
714 * id
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
715 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
716 * - decoding: Set by libavcodec.
1546
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
717 */
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
718 int id;
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
719
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
720 /**
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
721 * width and height in 1/16 pel
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
722 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
723 * - decoding: Set by libavcodec.
1546
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
724 */
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
725 int width;
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
726 int height;
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
727
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
728 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
729 * position of the top left corner in 1/16 pel for up to 3 fields/frames
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
730 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
731 * - decoding: Set by libavcodec.
1546
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
732 */
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
733 int16_t position[3][2];
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
734 }AVPanScan;
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
735
925
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
736 #define FF_COMMON_FRAME \
1138
e10e841c9bf0 field pic decoding cleanup
michaelni
parents: 1137
diff changeset
737 /**\
e10e841c9bf0 field pic decoding cleanup
michaelni
parents: 1137
diff changeset
738 * pointer to the picture planes.\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
739 * This might be different from the first allocated byte\
1138
e10e841c9bf0 field pic decoding cleanup
michaelni
parents: 1137
diff changeset
740 * - encoding: \
e10e841c9bf0 field pic decoding cleanup
michaelni
parents: 1137
diff changeset
741 * - decoding: \
e10e841c9bf0 field pic decoding cleanup
michaelni
parents: 1137
diff changeset
742 */\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
743 uint8_t *data[4];\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
744 int linesize[4];\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
745 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
746 * pointer to the first allocated byte of the picture. Can be used in get_buffer/release_buffer.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
747 * This isn't used by libavcodec unless the default get/release_buffer() is used.\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
748 * - encoding: \
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
749 * - decoding: \
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
750 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
751 uint8_t *base[4];\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
752 /**\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
753 * 1 -> keyframe, 0-> not\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
754 * - encoding: Set by libavcodec.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
755 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
756 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
757 int key_frame;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
758 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
759 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
760 * Picture type of the frame, see ?_TYPE below.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
761 * - encoding: Set by libavcodec. for coded_picture (and set by user for input).\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
762 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
763 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
764 int pict_type;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
765 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
766 /**\
2637
ef44d24680d1 switch to native time bases
michael
parents: 2635
diff changeset
767 * presentation timestamp in time_base units (time when frame should be shown to user)\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
768 * If AV_NOPTS_VALUE then frame_rate = 1/time_base will be assumed.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
769 * - encoding: MUST be set by user.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
770 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
771 */\
1172
9d257357ce07 fix pts type in avcodec.h for WIN32 patch by (Richard Hodges <rh at matriplex dot com>)
michaelni
parents: 1168
diff changeset
772 int64_t pts;\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
773 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
774 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
775 * picture number in bitstream order\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
776 * - encoding: set by\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
777 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
778 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
779 int coded_picture_number;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
780 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
781 * picture number in display order\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
782 * - encoding: set by\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
783 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
784 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
785 int display_picture_number;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
786 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
787 /**\
1505
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
788 * quality (between 1 (good) and FF_LAMBDA_MAX (bad)) \
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
789 * - encoding: Set by libavcodec. for coded_picture (and set by user for input).\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
790 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
791 */\
1505
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
792 int quality; \
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
793 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
794 /**\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
795 * buffer age (1->was last buffer and dint change, 2->..., ...).\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
796 * Set to INT_MAX if the buffer has not been used yet.\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
797 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
798 * - decoding: MUST be set by get_buffer().\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
799 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
800 int age;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
801 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
802 /**\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
803 * is this picture used as reference\
6514
77de2a1737d4 More complete documentation for AVFrame.reference.
michael
parents: 6508
diff changeset
804 * The values for this are the same as the MpegEncContext.picture_structure\
77de2a1737d4 More complete documentation for AVFrame.reference.
michael
parents: 6508
diff changeset
805 * variable, that is 1->top field, 2->bottom field, 3->frame/both fields.\
9050
9653d4585183 Completed documentation of reference field.
cehoyos
parents: 9038
diff changeset
806 * Set to 4 for delayed, non-reference frames.\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
807 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
808 * - decoding: Set by libavcodec. (before get_buffer() call)).\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
809 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
810 int reference;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
811 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
812 /**\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
813 * QP table\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
814 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
815 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
816 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
817 int8_t *qscale_table;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
818 /**\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
819 * QP store stride\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
820 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
821 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
822 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
823 int qstride;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
824 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
825 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
826 * mbskip_table[mb]>=1 if MB didn't change\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
827 * stride= mb_width = (width+15)>>4\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
828 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
829 * - decoding: Set by libavcodec.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
830 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
831 uint8_t *mbskip_table;\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
832 \
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
833 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
834 * motion vector table\
2397
a579ef4a4f4a motion_val doxy
michael
parents: 2394
diff changeset
835 * @code\
a579ef4a4f4a motion_val doxy
michael
parents: 2394
diff changeset
836 * example:\
a579ef4a4f4a motion_val doxy
michael
parents: 2394
diff changeset
837 * int mv_sample_log2= 4 - motion_subsample_log2;\
a579ef4a4f4a motion_val doxy
michael
parents: 2394
diff changeset
838 * int mb_width= (width+15)>>4;\
a579ef4a4f4a motion_val doxy
michael
parents: 2394
diff changeset
839 * int mv_stride= (mb_width << mv_sample_log2) + 1;\
a579ef4a4f4a motion_val doxy
michael
parents: 2394
diff changeset
840 * motion_val[direction][x + y*mv_stride][0->mv_x, 1->mv_y];\
a579ef4a4f4a motion_val doxy
michael
parents: 2394
diff changeset
841 * @endcode\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
842 * - encoding: Set by user.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
843 * - decoding: Set by libavcodec.\
1668
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
844 */\
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
845 int16_t (*motion_val[2])[2];\
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
846 \
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
847 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
848 * macroblock type table\
1668
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
849 * mb_type_base + mb_width + 2\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
850 * - encoding: Set by user.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
851 * - decoding: Set by libavcodec.\
1668
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
852 */\
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
853 uint32_t *mb_type;\
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
854 \
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
855 /**\
2394
776e37360171 better motion_subsample_log2 docs
michael
parents: 2388
diff changeset
856 * log2 of the size of the block which a single vector in motion_val represents: \
776e37360171 better motion_subsample_log2 docs
michael
parents: 2388
diff changeset
857 * (4->16x16, 3->8x8, 2-> 4x4, 1-> 2x2)\
1668
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
858 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
859 * - decoding: Set by libavcodec.\
1668
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
860 */\
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
861 uint8_t motion_subsample_log2;\
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
862 \
30746f429df6 move motion_val & mb_type to AVFrame patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1661
diff changeset
863 /**\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
864 * for some private data of the user\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
865 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
866 * - decoding: Set by user.\
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
867 */\
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
868 void *opaque;\
909
8ae1e4c24e91 new PSNR code (now works with chroma, b frames, ...)
michaelni
parents: 906
diff changeset
869 \
8ae1e4c24e91 new PSNR code (now works with chroma, b frames, ...)
michaelni
parents: 906
diff changeset
870 /**\
8ae1e4c24e91 new PSNR code (now works with chroma, b frames, ...)
michaelni
parents: 906
diff changeset
871 * error\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
872 * - encoding: Set by libavcodec. if flags&CODEC_FLAG_PSNR.\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
873 * - decoding: unused\
909
8ae1e4c24e91 new PSNR code (now works with chroma, b frames, ...)
michaelni
parents: 906
diff changeset
874 */\
8ae1e4c24e91 new PSNR code (now works with chroma, b frames, ...)
michaelni
parents: 906
diff changeset
875 uint64_t error[4];\
924
3814e9115672 cleanup / messup?
michaelni
parents: 914
diff changeset
876 \
3814e9115672 cleanup / messup?
michaelni
parents: 914
diff changeset
877 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
878 * type of the buffer (to keep track of who has to deallocate data[*])\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
879 * - encoding: Set by the one who allocates it.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
880 * - decoding: Set by the one who allocates it.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
881 * Note: User allocated (direct rendering) & internal buffers cannot coexist currently.\
924
3814e9115672 cleanup / messup?
michaelni
parents: 914
diff changeset
882 */\
3814e9115672 cleanup / messup?
michaelni
parents: 914
diff changeset
883 int type;\
1085
9acf4b552047 move repeat_pict field from AVCodecContext -> AVFrame (closes bug #683536)
michaelni
parents: 1084
diff changeset
884 \
9acf4b552047 move repeat_pict field from AVCodecContext -> AVFrame (closes bug #683536)
michaelni
parents: 1084
diff changeset
885 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
886 * When decoding, this signals how much the picture must be delayed.\
1085
9acf4b552047 move repeat_pict field from AVCodecContext -> AVFrame (closes bug #683536)
michaelni
parents: 1084
diff changeset
887 * extra_delay = repeat_pict / (2*fps)\
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
888 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
889 * - decoding: Set by libavcodec.\
1085
9acf4b552047 move repeat_pict field from AVCodecContext -> AVFrame (closes bug #683536)
michaelni
parents: 1084
diff changeset
890 */\
1196
2e06398e4647 mpeg2 qscale flag
michaelni
parents: 1192
diff changeset
891 int repeat_pict;\
2e06398e4647 mpeg2 qscale flag
michaelni
parents: 1192
diff changeset
892 \
2e06398e4647 mpeg2 qscale flag
michaelni
parents: 1192
diff changeset
893 /**\
2e06398e4647 mpeg2 qscale flag
michaelni
parents: 1192
diff changeset
894 * \
2e06398e4647 mpeg2 qscale flag
michaelni
parents: 1192
diff changeset
895 */\
2e06398e4647 mpeg2 qscale flag
michaelni
parents: 1192
diff changeset
896 int qscale_type;\
1543
7542cb99b950 * providing MPEG codecs with a generic fields in AVFrame to use.
romansh
parents: 1535
diff changeset
897 \
7542cb99b950 * providing MPEG codecs with a generic fields in AVFrame to use.
romansh
parents: 1535
diff changeset
898 /**\
7542cb99b950 * providing MPEG codecs with a generic fields in AVFrame to use.
romansh
parents: 1535
diff changeset
899 * The content of the picture is interlaced.\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
900 * - encoding: Set by user.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
901 * - decoding: Set by libavcodec. (default 0)\
1543
7542cb99b950 * providing MPEG codecs with a generic fields in AVFrame to use.
romansh
parents: 1535
diff changeset
902 */\
7542cb99b950 * providing MPEG codecs with a generic fields in AVFrame to use.
romansh
parents: 1535
diff changeset
903 int interlaced_frame;\
7542cb99b950 * providing MPEG codecs with a generic fields in AVFrame to use.
romansh
parents: 1535
diff changeset
904 \
7542cb99b950 * providing MPEG codecs with a generic fields in AVFrame to use.
romansh
parents: 1535
diff changeset
905 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
906 * If the content is interlaced, is top field displayed first.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
907 * - encoding: Set by user.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
908 * - decoding: Set by libavcodec.\
1543
7542cb99b950 * providing MPEG codecs with a generic fields in AVFrame to use.
romansh
parents: 1535
diff changeset
909 */\
1547
0183874861fd bottom_field_first -> top_field_first
michael
parents: 1546
diff changeset
910 int top_field_first;\
1546
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
911 \
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
912 /**\
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
913 * Pan scan.\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
914 * - encoding: Set by user.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
915 * - decoding: Set by libavcodec.\
1546
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
916 */\
5d06823e2ee9 export mpeg2 active display area / pan scan
michael
parents: 1545
diff changeset
917 AVPanScan *pan_scan;\
1585
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
918 \
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
919 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
920 * Tell user application that palette has changed from previous frame.\
1585
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
921 * - encoding: ??? (no palette-enabled encoder yet)\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
922 * - decoding: Set by libavcodec. (default 0).\
1585
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
923 */\
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
924 int palette_has_changed;\
1606
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
925 \
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
926 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
927 * codec suggestion on buffer type if != 0\
1606
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
928 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
929 * - decoding: Set by libavcodec. (before get_buffer() call)).\
1606
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
930 */\
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
931 int buffer_hints;\
1833
ba27ce284d07 export DCT coefficients patch by (Wolfgang Hesseler <wolfgang.hesseler at imk dot fraunhofer dot de>)
michael
parents: 1832
diff changeset
932 \
ba27ce284d07 export DCT coefficients patch by (Wolfgang Hesseler <wolfgang.hesseler at imk dot fraunhofer dot de>)
michael
parents: 1832
diff changeset
933 /**\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
934 * DCT coefficients\
1833
ba27ce284d07 export DCT coefficients patch by (Wolfgang Hesseler <wolfgang.hesseler at imk dot fraunhofer dot de>)
michael
parents: 1832
diff changeset
935 * - encoding: unused\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
936 * - decoding: Set by libavcodec.\
1833
ba27ce284d07 export DCT coefficients patch by (Wolfgang Hesseler <wolfgang.hesseler at imk dot fraunhofer dot de>)
michael
parents: 1832
diff changeset
937 */\
ba27ce284d07 export DCT coefficients patch by (Wolfgang Hesseler <wolfgang.hesseler at imk dot fraunhofer dot de>)
michael
parents: 1832
diff changeset
938 short *dct_coeff;\
1945
32f68745c431 passing AVFrame instead of AVPicture around in ffmpeg, that way stuff like motion vectors can be passed from the decoder to the encoder
michael
parents: 1934
diff changeset
939 \
32f68745c431 passing AVFrame instead of AVPicture around in ffmpeg, that way stuff like motion vectors can be passed from the decoder to the encoder
michael
parents: 1934
diff changeset
940 /**\
11299
14535f3deafb Fix typos in ref_index documentation.
benoit
parents: 11295
diff changeset
941 * motion reference frame index\
14535f3deafb Fix typos in ref_index documentation.
benoit
parents: 11295
diff changeset
942 * the order in which these are stored can depend on the codec.\
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
943 * - encoding: Set by user.\
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
944 * - decoding: Set by libavcodec.\
1945
32f68745c431 passing AVFrame instead of AVPicture around in ffmpeg, that way stuff like motion vectors can be passed from the decoder to the encoder
michael
parents: 1934
diff changeset
945 */\
7631
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
946 int8_t *ref_index[2];\
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
947 \
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
948 /**\
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
949 * reordered opaque 64bit number (generally a PTS) from AVCodecContext.reordered_opaque\
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
950 * output in AVFrame.reordered_opaque\
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
951 * - encoding: unused\
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
952 * - decoding: Read by user.\
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
953 */\
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
954 int64_t reordered_opaque;\
9155
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
955 \
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
956 /**\
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
957 * hardware accelerator private data (FFmpeg allocated)\
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
958 * - encoding: unused\
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
959 * - decoding: Set by libavcodec\
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
960 */\
9200
7b62de9c383d Rename hwaccel_data_private to hwaccel_picture_private.
gb
parents: 9190
diff changeset
961 void *hwaccel_picture_private;\
7631
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
962
1085
9acf4b552047 move repeat_pict field from AVCodecContext -> AVFrame (closes bug #683536)
michaelni
parents: 1084
diff changeset
963
2979
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
964 #define FF_QSCALE_TYPE_MPEG1 0
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
965 #define FF_QSCALE_TYPE_MPEG2 1
bfabfdf9ce55 COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 2971
diff changeset
966 #define FF_QSCALE_TYPE_H264 2
11053
c57e72227d7d Make VP5 and VP6 decoders output a qscale table to allow for more automatic
reimar
parents: 11047
diff changeset
967 #define FF_QSCALE_TYPE_VP56 3
924
3814e9115672 cleanup / messup?
michaelni
parents: 914
diff changeset
968
3814e9115672 cleanup / messup?
michaelni
parents: 914
diff changeset
969 #define FF_BUFFER_TYPE_INTERNAL 1
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
970 #define FF_BUFFER_TYPE_USER 2 ///< direct rendering buffers (image is (de)allocated by user)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
971 #define FF_BUFFER_TYPE_SHARED 4 ///< Buffer from somewhere else; don't deallocate image (data/base), all other tables are not shared.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
972 #define FF_BUFFER_TYPE_COPY 8 ///< Just a (modified) copy of some other buffer, don't deallocate anything.
924
3814e9115672 cleanup / messup?
michaelni
parents: 914
diff changeset
973
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
974
6457
f88fc47e8e46 doxyfy frame type comments and add some more comments
aurel
parents: 6456
diff changeset
975 #define FF_I_TYPE 1 ///< Intra
f88fc47e8e46 doxyfy frame type comments and add some more comments
aurel
parents: 6456
diff changeset
976 #define FF_P_TYPE 2 ///< Predicted
f88fc47e8e46 doxyfy frame type comments and add some more comments
aurel
parents: 6456
diff changeset
977 #define FF_B_TYPE 3 ///< Bi-dir predicted
f88fc47e8e46 doxyfy frame type comments and add some more comments
aurel
parents: 6456
diff changeset
978 #define FF_S_TYPE 4 ///< S(GMC)-VOP MPEG4
f88fc47e8e46 doxyfy frame type comments and add some more comments
aurel
parents: 6456
diff changeset
979 #define FF_SI_TYPE 5 ///< Switching Intra
f88fc47e8e46 doxyfy frame type comments and add some more comments
aurel
parents: 6456
diff changeset
980 #define FF_SP_TYPE 6 ///< Switching Predicted
6456
ff4fa36b555e define BI frame type along with other frame types
aurel
parents: 6422
diff changeset
981 #define FF_BI_TYPE 7
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
982
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
983 #define FF_BUFFER_HINTS_VALID 0x01 // Buffer hints value is meaningful (if 0 ignore).
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
984 #define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
985 #define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
986 #define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update).
1606
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
987
9354
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
988 typedef struct AVPacket {
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
989 /**
9359
f978e4a699c5 Clarify which time_base the relevant members of AVPacket use
superdump
parents: 9357
diff changeset
990 * Presentation timestamp in AVStream->time_base units; the time at which
f978e4a699c5 Clarify which time_base the relevant members of AVPacket use
superdump
parents: 9357
diff changeset
991 * the decompressed packet will be presented to the user.
9354
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
992 * Can be AV_NOPTS_VALUE if it is not stored in the file.
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
993 * pts MUST be larger or equal to dts as presentation cannot happen before
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
994 * decompression, unless one wants to view hex dumps. Some formats misuse
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
995 * the terms dts and pts/cts to mean something different. Such timestamps
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
996 * must be converted to true pts/dts before they are stored in AVPacket.
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
997 */
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
998 int64_t pts;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
999 /**
9359
f978e4a699c5 Clarify which time_base the relevant members of AVPacket use
superdump
parents: 9357
diff changeset
1000 * Decompression timestamp in AVStream->time_base units; the time at which
f978e4a699c5 Clarify which time_base the relevant members of AVPacket use
superdump
parents: 9357
diff changeset
1001 * the packet is decompressed.
9354
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1002 * Can be AV_NOPTS_VALUE if it is not stored in the file.
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1003 */
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1004 int64_t dts;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1005 uint8_t *data;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1006 int size;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1007 int stream_index;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1008 int flags;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1009 /**
9359
f978e4a699c5 Clarify which time_base the relevant members of AVPacket use
superdump
parents: 9357
diff changeset
1010 * Duration of this packet in AVStream->time_base units, 0 if unknown.
9354
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1011 * Equals next_pts - this_pts in presentation order.
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1012 */
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1013 int duration;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1014 void (*destruct)(struct AVPacket *);
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1015 void *priv;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1016 int64_t pos; ///< byte position in stream, -1 if unknown
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1017
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1018 /**
9359
f978e4a699c5 Clarify which time_base the relevant members of AVPacket use
superdump
parents: 9357
diff changeset
1019 * Time difference in AVStream->time_base units from the pts of this
9354
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1020 * packet to the point at which the output from the decoder has converged
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1021 * independent from the availability of previous frames. That is, the
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1022 * frames are virtually identical no matter if decoding started from
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1023 * the very first frame or from this keyframe.
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1024 * Is AV_NOPTS_VALUE if unknown.
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1025 * This field is not the display duration of the current packet.
12080
7e6a8ce19977 fix comment grammar
aurel
parents: 12077
diff changeset
1026 * This field has no meaning if the packet does not have AV_PKT_FLAG_KEY
7e6a8ce19977 fix comment grammar
aurel
parents: 12077
diff changeset
1027 * set.
9354
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1028 *
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1029 * The purpose of this field is to allow seeking in streams that have no
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1030 * keyframes in the conventional sense. It corresponds to the
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1031 * recovery point SEI in H.264 and match_time_delta in NUT. It is also
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1032 * essential for some types of subtitle streams to ensure that all
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1033 * subtitles are correctly displayed after seeking.
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1034 */
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1035 int64_t convergence_duration;
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1036 } AVPacket;
9786
798d6520c7f4 Add AV_PKT_FLAG_KEY and deprecate PKT_FLAG_KEY.
reimar
parents: 9785
diff changeset
1037 #define AV_PKT_FLAG_KEY 0x0001
798d6520c7f4 Add AV_PKT_FLAG_KEY and deprecate PKT_FLAG_KEY.
reimar
parents: 9785
diff changeset
1038 #if LIBAVCODEC_VERSION_MAJOR < 53
798d6520c7f4 Add AV_PKT_FLAG_KEY and deprecate PKT_FLAG_KEY.
reimar
parents: 9785
diff changeset
1039 #define PKT_FLAG_KEY AV_PKT_FLAG_KEY
798d6520c7f4 Add AV_PKT_FLAG_KEY and deprecate PKT_FLAG_KEY.
reimar
parents: 9785
diff changeset
1040 #endif
9354
174309386512 Move AVPacket up a bit, so that structs/functions that include AVPacket can
rbultje
parents: 9351
diff changeset
1041
1168
5af9aeadbdc3 H264 decoder & demuxer
michaelni
parents: 1151
diff changeset
1042 /**
5af9aeadbdc3 H264 decoder & demuxer
michaelni
parents: 1151
diff changeset
1043 * Audio Video Frame.
6049
7fb5a3652990 Document a few more structure change rules with relation to ABI/API.
michael
parents: 6048
diff changeset
1044 * New fields can be added to the end of FF_COMMON_FRAME with minor version
7fb5a3652990 Document a few more structure change rules with relation to ABI/API.
michael
parents: 6048
diff changeset
1045 * bumps.
6055
bc22d052c6e5 comment typo fixes
diego
parents: 6050
diff changeset
1046 * Removal, reordering and changes to existing fields require a major
6049
7fb5a3652990 Document a few more structure change rules with relation to ABI/API.
michael
parents: 6048
diff changeset
1047 * version bump. No fields should be added into AVFrame before or after
7fb5a3652990 Document a few more structure change rules with relation to ABI/API.
michael
parents: 6048
diff changeset
1048 * FF_COMMON_FRAME!
6055
bc22d052c6e5 comment typo fixes
diego
parents: 6050
diff changeset
1049 * sizeof(AVFrame) must not be used outside libav*.
1168
5af9aeadbdc3 H264 decoder & demuxer
michaelni
parents: 1151
diff changeset
1050 */
925
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
1051 typedef struct AVFrame {
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
1052 FF_COMMON_FRAME
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
1053 } AVFrame;
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
1054
1105
michaelni
parents: 1095
diff changeset
1055 /**
6048
0277500fe13d Document structure change rules with relation to ABI/API.
michael
parents: 6047
diff changeset
1056 * main external API structure.
0277500fe13d Document structure change rules with relation to ABI/API.
michael
parents: 6047
diff changeset
1057 * New fields can be added to the end with minor version bumps.
6055
bc22d052c6e5 comment typo fixes
diego
parents: 6050
diff changeset
1058 * Removal, reordering and changes to existing fields require a major
6048
0277500fe13d Document structure change rules with relation to ABI/API.
michael
parents: 6047
diff changeset
1059 * version bump.
6055
bc22d052c6e5 comment typo fixes
diego
parents: 6050
diff changeset
1060 * sizeof(AVCodecContext) must not be used outside libav*.
1105
michaelni
parents: 1095
diff changeset
1061 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1062 typedef struct AVCodecContext {
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1063 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1064 * information on struct for av_log
1855
bafde44145f9 av_log() patch by (Michel Bardiaux <mbardiaux at peaktime dot be>)
michael
parents: 1854
diff changeset
1065 * - set by avcodec_alloc_context
bafde44145f9 av_log() patch by (Michel Bardiaux <mbardiaux at peaktime dot be>)
michael
parents: 1854
diff changeset
1066 */
6464
0c3cc1d7a0b3 Make av_class a pointer to a const AVClass. Addresses one warning in
takis
parents: 6461
diff changeset
1067 const AVClass *av_class;
1855
bafde44145f9 av_log() patch by (Michel Bardiaux <mbardiaux at peaktime dot be>)
michael
parents: 1854
diff changeset
1068 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1069 * the average bitrate
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1070 * - encoding: Set by user; unused for constant quantizer encoding.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1071 * - decoding: Set by libavcodec. 0 or some bitrate if this info is available in the stream.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1072 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1073 int bit_rate;
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1074
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1075 /**
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1076 * number of bits the bitstream is allowed to diverge from the reference.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1077 * the reference can be CBR (for CBR pass1) or VBR (for pass2)
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1078 * - encoding: Set by user; unused for constant quantizer encoding.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1079 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1080 */
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1081 int bit_rate_tolerance;
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1082
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1083 /**
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1084 * CODEC_FLAG_*.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1085 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1086 * - decoding: Set by user.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1087 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1088 int flags;
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1089
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1090 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1091 * Some codecs need additional format info. It is stored here.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1092 * If any muxer uses this then ALL demuxers/parsers AND encoders for the
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1093 * specific codec MUST set it correctly otherwise stream copy breaks.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1094 * In general use of this field by muxers is not recommanded.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1095 * - encoding: Set by libavcodec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1096 * - decoding: Set by libavcodec. (FIXME: Is this OK?)
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1097 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1098 int sub_id;
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1099
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1100 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1101 * Motion estimation algorithm used for video coding.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
1102 * 1 (zero), 2 (full), 3 (log), 4 (phods), 5 (epzs), 6 (x1), 7 (hex),
7002
92c74bbdf4fb add esa/dia compat me options and new tesa for libx264
bcoudurier
parents: 6993
diff changeset
1103 * 8 (umh), 9 (iter), 10 (tesa) [7, 8, 10 are x264 specific, 9 is snow specific]
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1104 * - encoding: MUST be set by user.
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1105 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1106 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1107 int me_method;
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1108
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1109 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1110 * some codecs need / can use extradata like Huffman tables.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1111 * mjpeg: Huffman tables
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1112 * rv10: additional flags
747
3d4377531f6c mpeg4 header parser clenup (needed for parsing of VOL header in avctx->extradata)
michaelni
parents: 745
diff changeset
1113 * mpeg4: global headers (they can be in the bitstream or here)
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1114 * The allocated memory should be FF_INPUT_BUFFER_PADDING_SIZE bytes larger
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1115 * than extradata_size to avoid prolems if it is read with the bitstream reader.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1116 * The bytewise contents of extradata must not depend on the architecture or CPU endianness.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1117 * - encoding: Set/allocated/freed by libavcodec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1118 * - decoding: Set/allocated/freed by user.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1119 */
3930
50b819e8f2cc change extradata type to uint8_t *
bcoudurier
parents: 3914
diff changeset
1120 uint8_t *extradata;
349
34f6c77ff01a Support for external huffman table and various fixes by Alex Beregszaszi <alex@naxine.org>
arpi_esp
parents: 345
diff changeset
1121 int extradata_size;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1122
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1123 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1124 * This is the fundamental unit of time (in seconds) in terms
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1125 * of which frame timestamps are represented. For fixed-fps content,
2843
ea05470188e4 time_base description by Rich Felker | dalias, aerifal cx
michael
parents: 2838
diff changeset
1126 * timebase should be 1/framerate and timestamp increments should be
ea05470188e4 time_base description by Rich Felker | dalias, aerifal cx
michael
parents: 2838
diff changeset
1127 * identically 1.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1128 * - encoding: MUST be set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1129 * - decoding: Set by libavcodec.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1130 */
2637
ef44d24680d1 switch to native time bases
michael
parents: 2635
diff changeset
1131 AVRational time_base;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1132
2843
ea05470188e4 time_base description by Rich Felker | dalias, aerifal cx
michael
parents: 2838
diff changeset
1133 /* video only */
1126
77ccf7fe3bd0 per context frame_rate_base, this should finally fix frame_rate related av sync issues
michaelni
parents: 1118
diff changeset
1134 /**
2270
21f450be6cb5 lowres width/height cleanup 3rd try
michael
parents: 2266
diff changeset
1135 * picture width / height.
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1136 * - encoding: MUST be set by user.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1137 * - decoding: Set by libavcodec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1138 * Note: For compatibility it is possible to set this instead of
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1139 * coded_width/height before decoding.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1140 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1141 int width, height;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1142
618
4f3d4a07d374 added aspected_width/height for EXTENDED_PAR
al3x
parents: 613
diff changeset
1143 #define FF_ASPECT_EXTENDED 15
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1144
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1145 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1146 * the number of pictures in a group of pictures, or 0 for intra_only
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1147 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1148 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1149 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1150 int gop_size;
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1151
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1152 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1153 * Pixel format, see PIX_FMT_xxx.
11861
f6a2af58f3e0 avcodec.h: Clarify AVCodecContext::pix_fmt documentation since its value may be set by the demuxer
thardin
parents: 11855
diff changeset
1154 * May be set by the demuxer if known from headers.
f6a2af58f3e0 avcodec.h: Clarify AVCodecContext::pix_fmt documentation since its value may be set by the demuxer
thardin
parents: 11855
diff changeset
1155 * May be overriden by the decoder if it knows better.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1156 * - encoding: Set by user.
11861
f6a2af58f3e0 avcodec.h: Clarify AVCodecContext::pix_fmt documentation since its value may be set by the demuxer
thardin
parents: 11855
diff changeset
1157 * - decoding: Set by user if known, overridden by libavcodec if known
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1158 */
1422
efeed6e29f9b oooooops, having 2 Eterms open and doing cvs diff in one and cvs commit in the other sucks, especially if they are in different directories (MPlayer/main/libavcodec vs. ffmpeg/libavcodec)
michaelni
parents: 1421
diff changeset
1159 enum PixelFormat pix_fmt;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1160
1113
bbcb4fda2b86 Frame rate emulation patch by (Max Krasnyansky <maxk at qualcomm dot com>)
michaelni
parents: 1112
diff changeset
1161 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1162 * Frame rate emulation. If not zero, the lower layer (i.e. format handler)
1113
bbcb4fda2b86 Frame rate emulation patch by (Max Krasnyansky <maxk at qualcomm dot com>)
michaelni
parents: 1112
diff changeset
1163 * has to read frames at native frame rate.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1164 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1165 * - decoding: unused
1113
bbcb4fda2b86 Frame rate emulation patch by (Max Krasnyansky <maxk at qualcomm dot com>)
michaelni
parents: 1112
diff changeset
1166 */
bbcb4fda2b86 Frame rate emulation patch by (Max Krasnyansky <maxk at qualcomm dot com>)
michaelni
parents: 1112
diff changeset
1167 int rate_emu;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1168
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1169 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1170 * If non NULL, 'draw_horiz_band' is called by the libavcodec
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1171 * decoder to draw a horizontal band. It improves cache usage. Not
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1172 * all codecs can do that. You must check the codec capabilities
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1173 * beforehand.
8890
21e7e2e89379 Another attempt to clarify draw_horiz_band() usage.
iive
parents: 8883
diff changeset
1174 * The function is also used by hardware acceleration APIs.
21e7e2e89379 Another attempt to clarify draw_horiz_band() usage.
iive
parents: 8883
diff changeset
1175 * It is called at least once during frame decoding to pass
21e7e2e89379 Another attempt to clarify draw_horiz_band() usage.
iive
parents: 8883
diff changeset
1176 * the data needed for hardware render.
21e7e2e89379 Another attempt to clarify draw_horiz_band() usage.
iive
parents: 8883
diff changeset
1177 * In that mode instead of pixel data, AVFrame points to
21e7e2e89379 Another attempt to clarify draw_horiz_band() usage.
iive
parents: 8883
diff changeset
1178 * a structure specific to the acceleration API. The application
21e7e2e89379 Another attempt to clarify draw_horiz_band() usage.
iive
parents: 8883
diff changeset
1179 * reads the structure and can change some fields to indicate progress
21e7e2e89379 Another attempt to clarify draw_horiz_band() usage.
iive
parents: 8883
diff changeset
1180 * or mark state.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1181 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1182 * - decoding: Set by user.
1370
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1183 * @param height the height of the slice
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1184 * @param y the y position of the slice
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1185 * @param type 1->top field, 2->bottom field, 3->frame
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1186 * @param offset offset into the AVFrame.data from which the slice should be read
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1187 */
67
cdd89f96cbe1 added draw_horiz_band test
glantau
parents: 49
diff changeset
1188 void (*draw_horiz_band)(struct AVCodecContext *s,
1488
766a2f4edbea avcodec const correctness patch by (Drew Hess <dhess at ilm dot com>)
michaelni
parents: 1486
diff changeset
1189 const AVFrame *src, int offset[4],
1370
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1190 int y, int type, int height);
67
cdd89f96cbe1 added draw_horiz_band test
glantau
parents: 49
diff changeset
1191
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1192 /* audio only */
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1193 int sample_rate; ///< samples per second
6776
4b9f28275b14 Document AVCodecContext channels field.
diego
parents: 6719
diff changeset
1194 int channels; ///< number of audio channels
2479
dfdb6bf4b90f support 32bit output for the mpeg audio decoder
michael
parents: 2453
diff changeset
1195
dfdb6bf4b90f support 32bit output for the mpeg audio decoder
michael
parents: 2453
diff changeset
1196 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1197 * audio sample format
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1198 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1199 * - decoding: Set by libavcodec.
2479
dfdb6bf4b90f support 32bit output for the mpeg audio decoder
michael
parents: 2453
diff changeset
1200 */
9882
7b58b1410f48 Make documentation better match the code. Now AVCodecContext.sample_fmt
vitor
parents: 9866
diff changeset
1201 enum SampleFormat sample_fmt; ///< sample format
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1202
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1203 /* The following data should not be initialized. */
2768
d2b3f948599d tiny docs improvement which i apparebtly forgot to commit
michael
parents: 2764
diff changeset
1204 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1205 * Samples per packet, initialized when calling 'init'.
2768
d2b3f948599d tiny docs improvement which i apparebtly forgot to commit
michael
parents: 2764
diff changeset
1206 */
d2b3f948599d tiny docs improvement which i apparebtly forgot to commit
michael
parents: 2764
diff changeset
1207 int frame_size;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1208 int frame_number; ///< audio or video frame number
9722
0bfb23c7633d remove apparently unused real_pict_num from AVCodecContext
bcoudurier
parents: 9628
diff changeset
1209 #if LIBAVCODEC_VERSION_MAJOR < 53
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1210 int real_pict_num; ///< Returns the real picture number of previous encoded frame.
9722
0bfb23c7633d remove apparently unused real_pict_num from AVCodecContext
bcoudurier
parents: 9628
diff changeset
1211 #endif
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1212
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1213 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1214 * Number of frames the decoded output will be delayed relative to
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1215 * the encoded input.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1216 * - encoding: Set by libavcodec.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1217 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1218 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1219 int delay;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1220
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1221 /* - encoding parameters */
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1222 float qcompress; ///< amount of qscale change between easy & hard scenes (0.0-1.0)
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1223 float qblur; ///< amount of qscale smoothing over time (0.0-1.0)
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1224
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1225 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1226 * minimum quantizer
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1227 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1228 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1229 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1230 int qmin;
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1231
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1232 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1233 * maximum quantizer
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1234 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1235 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1236 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1237 int qmax;
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1238
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1239 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1240 * maximum quantizer difference between frames
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1241 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1242 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1243 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1244 int max_qdiff;
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1245
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1246 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1247 * maximum number of B-frames between non-B-frames
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1248 * Note: The output will be delayed by max_b_frames+1 relative to the input.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1249 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1250 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1251 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1252 int max_b_frames;
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1253
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1254 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1255 * qscale factor between IP and B-frames
7342
8c4e0043c068 Correct b_quant offset comment in avcodec.h, it is the description for
diego
parents: 7324
diff changeset
1256 * If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset).
8c4e0043c068 Correct b_quant offset comment in avcodec.h, it is the description for
diego
parents: 7324
diff changeset
1257 * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1258 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1259 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1260 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1261 float b_quant_factor;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1262
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1263 /** obsolete FIXME remove */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1264 int rc_strategy;
3064
a5e0b58b4471 xvid ratecontrol support
michael
parents: 3063
diff changeset
1265 #define FF_RC_STRATEGY_XVID 1
a5e0b58b4471 xvid ratecontrol support
michael
parents: 3063
diff changeset
1266
329
5cc47d0ba53e fixed ratecontrol & b-frames
michaelni
parents: 328
diff changeset
1267 int b_frame_strategy;
324
9c6f056f0e41 fixed mpeg4 time stuff on encoding
michaelni
parents: 322
diff changeset
1268
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1269 /**
9578
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
1270 * hurry up amount
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
1271 * - encoding: unused
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
1272 * - decoding: Set by user. 1-> Skip B-frames, 2-> Skip IDCT/dequant too, 5-> Skip everything except header
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
1273 * @deprecated Deprecated in favor of skip_idct and skip_frame.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1274 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1275 int hurry_up;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1276
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1277 struct AVCodec *codec;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1278
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1279 void *priv_data;
986e461dc072 Initial revision
glantau
parents:
diff changeset
1280
2764
2b37bcabe608 spelling fixes
diego
parents: 2756
diff changeset
1281 int rtp_payload_size; /* The size of the RTP payload: the coder will */
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1282 /* do its best to deliver a chunk with size */
162
de80712db90b - Preliminary RTP friendly mode for H.263.
pulento
parents: 146
diff changeset
1283 /* below rtp_payload_size, the chunk will start */
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1284 /* with a start code on some codecs like H.263. */
162
de80712db90b - Preliminary RTP friendly mode for H.263.
pulento
parents: 146
diff changeset
1285 /* This doesn't take account of any particular */
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1286 /* headers inside the transmitted RTP payload. */
231
840cd25bf259 - Fixes on RTP and GOB headers for H.263.
pulento
parents: 177
diff changeset
1287
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1288
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1289 /* The RTP callback: This function is called */
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1290 /* every time the encoder has a packet to send. */
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1291 /* It depends on the encoder if the data starts */
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1292 /* with a Start Code (it should). H.263 does. */
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1293 /* mb_nb contains the number of macroblocks */
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1294 /* encoded in the RTP payload. */
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1295 void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb);
231
840cd25bf259 - Fixes on RTP and GOB headers for H.263.
pulento
parents: 177
diff changeset
1296
286
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1297 /* statistics, used for 2-pass encoding */
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1298 int mv_bits;
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1299 int header_bits;
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1300 int i_tex_bits;
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1301 int p_tex_bits;
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1302 int i_count;
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1303 int p_count;
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1304 int skip_count;
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1305 int misc_bits;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1306
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1307 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1308 * number of bits used for the previously encoded frame
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1309 * - encoding: Set by libavcodec.
1116
86a5d0ce86bf merging fourcc with codec_tag
michaelni
parents: 1114
diff changeset
1310 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1311 */
286
91f7c38f5f37 statistics for 2-pass encoding
michaelni
parents: 282
diff changeset
1312 int frame_bits;
1116
86a5d0ce86bf merging fourcc with codec_tag
michaelni
parents: 1114
diff changeset
1313
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1314 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1315 * Private data of the user, can be used to carry app specific stuff.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1316 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1317 * - decoding: Set by user.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1318 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1319 void *opaque;
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1320
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
1321 char codec_name[32];
11560
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
1322 enum AVMediaType codec_type; /* see AVMEDIA_TYPE_xxx */
371
8187bb132d85 * Start using enumerated types (makes debugging much easier)
philipjsg
parents: 367
diff changeset
1323 enum CodecID codec_id; /* see CODEC_ID_xxx */
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1324
1116
86a5d0ce86bf merging fourcc with codec_tag
michaelni
parents: 1114
diff changeset
1325 /**
86a5d0ce86bf merging fourcc with codec_tag
michaelni
parents: 1114
diff changeset
1326 * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1327 * This is used to work around some encoder bugs.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1328 * A demuxer should set this to what is stored in the field used to identify the codec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1329 * If there are multiple such fields in a container then the demuxer should choose the one
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1330 * which maximizes the information about the used codec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1331 * If the codec tag field in a container is larger then 32 bits then the demuxer should
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1332 * remap the longer ID to 32 bits with a table or other structure. Alternatively a new
4711
21aad2a2b725 clarify codec_tag
michael
parents: 4710
diff changeset
1333 * extra_codec_tag + size could be added but for this a clear advantage must be demonstrated
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1334 * first.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1335 * - encoding: Set by user, if not then the default based on codec_id will be used.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1336 * - decoding: Set by user, will be converted to uppercase by libavcodec during init.
1116
86a5d0ce86bf merging fourcc with codec_tag
michaelni
parents: 1114
diff changeset
1337 */
86a5d0ce86bf merging fourcc with codec_tag
michaelni
parents: 1114
diff changeset
1338 unsigned int codec_tag;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1339
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1340 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1341 * Work around bugs in encoders which sometimes cannot be detected automatically.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1342 * - encoding: Set by user
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1343 * - decoding: Set by user
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1344 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1345 int workaround_bugs;
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1346 #define FF_BUG_AUTODETECT 1 ///< autodetection
745
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1347 #define FF_BUG_OLD_MSMPEG4 2
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1348 #define FF_BUG_XVID_ILACE 4
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1349 #define FF_BUG_UMP4 8
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1350 #define FF_BUG_NO_PADDING 16
1997
7bd3932bc918 AMV bug workaround
michael
parents: 1994
diff changeset
1351 #define FF_BUG_AMV 32
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1352 #define FF_BUG_AC_VLC 0 ///< Will be removed, libavcodec can now handle these non-compliant files by default.
760
e858fe220ce0 xvid qpel bug workaround
michaelni
parents: 747
diff changeset
1353 #define FF_BUG_QPEL_CHROMA 64
984
e162c09efbe7 qpel fix
michaelni
parents: 962
diff changeset
1354 #define FF_BUG_STD_QPEL 128
1048
75a659fae7e0 divx503 decoding fix
michaelni
parents: 1041
diff changeset
1355 #define FF_BUG_QPEL_CHROMA2 256
1053
f07fd48c23d4 direct blocksize in bframes fix (might fix qpel+bframe bug)
michaelni
parents: 1048
diff changeset
1356 #define FF_BUG_DIRECT_BLOCKSIZE 512
1137
7fb0b38ab5a3 cleaner & more flexible edge bug workaround
michaelni
parents: 1129
diff changeset
1357 #define FF_BUG_EDGE 1024
1916
f2d134308a70 interlaced chroma MC divx-bug workaround
michael
parents: 1904
diff changeset
1358 #define FF_BUG_HPEL_CHROMA 2048
2004
ec6bfd8d92fc support decoding mpeg4 with buggy dc clipping
michael
parents: 2002
diff changeset
1359 #define FF_BUG_DC_CLIP 4096
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1360 #define FF_BUG_MS 8192 ///< Work around various bugs in Microsoft's broken decoders.
11125
1f13ac0e696b Try to support truncated h264 frames mixed with mpeg pes headers in mkv.
michael
parents: 11123
diff changeset
1361 #define FF_BUG_TRUNCATED 16384
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1362 //#define FF_BUG_FAKE_SCALABILITY 16 //Autodetection should work 100%.
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1363
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1364 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1365 * luma single coefficient elimination threshold
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1366 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1367 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1368 */
460
2ae7a98300b7 single coefficient elimination
michaelni
parents: 411
diff changeset
1369 int luma_elim_threshold;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1370
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1371 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1372 * chroma single coeff elimination threshold
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1373 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1374 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1375 */
460
2ae7a98300b7 single coefficient elimination
michaelni
parents: 411
diff changeset
1376 int chroma_elim_threshold;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1377
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1378 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1379 * strictly follow the standard (MPEG4, ...).
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1380 * - encoding: Set by user.
7324
3f49e04bcbe1 Make strict_std_compliance available to decoders.
michael
parents: 7251
diff changeset
1381 * - decoding: Set by user.
3f49e04bcbe1 Make strict_std_compliance available to decoders.
michael
parents: 7251
diff changeset
1382 * Setting this to STRICT or higher means the encoder and decoder will
12084
b6cf19580e47 Change all occurences of "inofficial" to "unofficial" in code, comments
cehoyos
parents: 12080
diff changeset
1383 * generally do stupid things, whereas setting it to unofficial or lower
11838
9a18fa62aa52 Improve grammar and readability
mstorsjo
parents: 11832
diff changeset
1384 * will mean the encoder might produce output that is not supported by all
9a18fa62aa52 Improve grammar and readability
mstorsjo
parents: 11832
diff changeset
1385 * spec-compliant decoders. Decoders don't differentiate between normal,
12084
b6cf19580e47 Change all occurences of "inofficial" to "unofficial" in code, comments
cehoyos
parents: 12080
diff changeset
1386 * unofficial and experimental (that is, they always try to decode things
11838
9a18fa62aa52 Improve grammar and readability
mstorsjo
parents: 11832
diff changeset
1387 * when they can) unless they are explicitly asked to behave stupidly
7324
3f49e04bcbe1 Make strict_std_compliance available to decoders.
michael
parents: 7251
diff changeset
1388 * (=strictly conform to the specs)
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1389 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1390 int strict_std_compliance;
11838
9a18fa62aa52 Improve grammar and readability
mstorsjo
parents: 11832
diff changeset
1391 #define FF_COMPLIANCE_VERY_STRICT 2 ///< Strictly conform to an older more strict version of the spec or reference software.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1392 #define FF_COMPLIANCE_STRICT 1 ///< Strictly conform to all the things in the spec no matter what consequences.
2658
d1609cfeb1d0 #defines for strict_std_compliance and split between inofficial extensions and non standarized things
michael
parents: 2637
diff changeset
1393 #define FF_COMPLIANCE_NORMAL 0
12084
b6cf19580e47 Change all occurences of "inofficial" to "unofficial" in code, comments
cehoyos
parents: 12080
diff changeset
1394 #if LIBAVCODEC_VERSION_MAJOR < 53
b6cf19580e47 Change all occurences of "inofficial" to "unofficial" in code, comments
cehoyos
parents: 12080
diff changeset
1395 #define FF_COMPLIANCE_INOFFICIAL -1 ///< Allow inofficial extensions (deprecated - use FF_COMPLIANCE_UNOFFICIAL instead).
b6cf19580e47 Change all occurences of "inofficial" to "unofficial" in code, comments
cehoyos
parents: 12080
diff changeset
1396 #endif
b6cf19580e47 Change all occurences of "inofficial" to "unofficial" in code, comments
cehoyos
parents: 12080
diff changeset
1397 #define FF_COMPLIANCE_UNOFFICIAL -1 ///< Allow unofficial extensions
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1398 #define FF_COMPLIANCE_EXPERIMENTAL -2 ///< Allow nonstandardized experimental things.
2658
d1609cfeb1d0 #defines for strict_std_compliance and split between inofficial extensions and non standarized things
michael
parents: 2637
diff changeset
1399
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1400 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1401 * qscale offset between IP and B-frames
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1402 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1403 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1404 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1405 float b_quant_offset;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1406
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1407 /**
7831
8195c970d077 Rename error_resilience to error_recognition.
michael
parents: 7826
diff changeset
1408 * Error recognization; higher values will detect more errors but may
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1409 * misdetect some more or less valid parts as errors.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1410 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1411 * - decoding: Set by user.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1412 */
7831
8195c970d077 Rename error_resilience to error_recognition.
michael
parents: 7826
diff changeset
1413 int error_recognition;
2879
d0b61801ea47 CAREFULL --> CAREFUL typo fix
diego
parents: 2874
diff changeset
1414 #define FF_ER_CAREFUL 1
905
2b93dc762f9a fixing illegal 3. esc bug (the mpeg4 std only requires encoders to use unescaped symbols but not esc1 or esc2 if they are shorter than esc3, andjust beause its logical to use the shortest possible vlc doesnt mean encoders do that)
michaelni
parents: 903
diff changeset
1415 #define FF_ER_COMPLIANT 2
2b93dc762f9a fixing illegal 3. esc bug (the mpeg4 std only requires encoders to use unescaped symbols but not esc1 or esc2 if they are shorter than esc3, andjust beause its logical to use the shortest possible vlc doesnt mean encoders do that)
michaelni
parents: 903
diff changeset
1416 #define FF_ER_AGGRESSIVE 3
2b93dc762f9a fixing illegal 3. esc bug (the mpeg4 std only requires encoders to use unescaped symbols but not esc1 or esc2 if they are shorter than esc3, andjust beause its logical to use the shortest possible vlc doesnt mean encoders do that)
michaelni
parents: 903
diff changeset
1417 #define FF_ER_VERY_AGGRESSIVE 4
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1418
803
08423289ec57 exporting the internal qscale table, this allso fixes the ordering
michaelni
parents: 783
diff changeset
1419 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1420 * Called at the beginning of each frame to get a buffer for it.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1421 * If pic.reference is set then the frame will be read later by libavcodec.
11311
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
1422 * avcodec_align_dimensions2() should be used to find the required width and
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1423 * height, as they normally need to be rounded up to the next multiple of 16.
9827
bca8ee90e5eb Clarify (re)get_buffer() and CODEC_CAP_DR1 relation.
michael
parents: 9825
diff changeset
1424 * if CODEC_CAP_DR1 is not set then get_buffer() must call
bca8ee90e5eb Clarify (re)get_buffer() and CODEC_CAP_DR1 relation.
michael
parents: 9825
diff changeset
1425 * avcodec_default_get_buffer() instead of providing buffers allocated by
bca8ee90e5eb Clarify (re)get_buffer() and CODEC_CAP_DR1 relation.
michael
parents: 9825
diff changeset
1426 * some other means.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1427 * - encoding: unused
12131
2d51a2375ddf Fix trivial punctuation error
pross
parents: 12130
diff changeset
1428 * - decoding: Set by libavcodec, user can override.
803
08423289ec57 exporting the internal qscale table, this allso fixes the ordering
michaelni
parents: 783
diff changeset
1429 */
925
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
1430 int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1431
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1432 /**
6495
ramiro
parents: 6491
diff changeset
1433 * Called to release buffers which were allocated with get_buffer.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1434 * A released buffer can be reused in get_buffer().
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1435 * pic.data[*] must be set to NULL.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1436 * - encoding: unused
12131
2d51a2375ddf Fix trivial punctuation error
pross
parents: 12130
diff changeset
1437 * - decoding: Set by libavcodec, user can override.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1438 */
925
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
1439 void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
556
762c67fd4078 uvlinesize
michaelni
parents: 553
diff changeset
1440
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1441 /**
8761
2a43b46067c4 Clarify has_b_frames doxy.
michael
parents: 8752
diff changeset
1442 * Size of the frame reordering buffer in the decoder.
8883
62342da1ec78 Attempt to clarify draw_horiz_band description and fix two random typos.
diego
parents: 8882
diff changeset
1443 * For MPEG-2 it is 1 IPB or 0 low delay IP.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1444 * - encoding: Set by libavcodec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1445 * - decoding: Set by libavcodec.
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1446 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1447 int has_b_frames;
2768
d2b3f948599d tiny docs improvement which i apparebtly forgot to commit
michael
parents: 2764
diff changeset
1448
d2b3f948599d tiny docs improvement which i apparebtly forgot to commit
michael
parents: 2764
diff changeset
1449 /**
d2b3f948599d tiny docs improvement which i apparebtly forgot to commit
michael
parents: 2764
diff changeset
1450 * number of bytes per packet if constant and known or 0
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1451 * Used by some WAV based audio codecs.
2768
d2b3f948599d tiny docs improvement which i apparebtly forgot to commit
michael
parents: 2764
diff changeset
1452 */
d2b3f948599d tiny docs improvement which i apparebtly forgot to commit
michael
parents: 2764
diff changeset
1453 int block_align;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1454
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1455 int parse_only; /* - decoding only: If true, only parsing is done
581
8adda0af04e2 added proposed API for parse_only mode to extract compressed frames from compressed streams
bellard
parents: 573
diff changeset
1456 (function avcodec_parse_frame()). The frame
8adda0af04e2 added proposed API for parse_only mode to extract compressed frames from compressed streams
bellard
parents: 573
diff changeset
1457 data is returned. Only MPEG codecs support this now. */
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1458
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1459 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1460 * 0-> h263 quant 1-> mpeg quant
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1461 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1462 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1463 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1464 int mpeg_quant;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1465
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1466 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1467 * pass1 encoding statistics output buffer
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1468 * - encoding: Set by libavcodec.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1469 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1470 */
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1471 char *stats_out;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1472
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1473 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1474 * pass2 encoding statistics input buffer
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1475 * Concatenated stuff from stats_out of pass1 should be placed here.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1476 * - encoding: Allocated/set/freed by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1477 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1478 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1479 char *stats_in;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1480
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1481 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1482 * ratecontrol qmin qmax limiting method
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1483 * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1484 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1485 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1486 */
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1487 float rc_qsquish;
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1488
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1489 float rc_qmod_amp;
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1490 int rc_qmod_freq;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1491
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1492 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1493 * ratecontrol override, see RcOverride
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1494 * - encoding: Allocated/set/freed by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1495 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1496 */
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1497 RcOverride *rc_override;
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1498 int rc_override_count;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1499
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1500 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1501 * rate control equation
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1502 * - encoding: Set by user
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1503 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1504 */
6354
lucabe
parents: 6346
diff changeset
1505 const char *rc_eq;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1506
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1507 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1508 * maximum bitrate
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1509 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1510 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1511 */
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1512 int rc_max_rate;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1513
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1514 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1515 * minimum bitrate
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1516 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1517 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1518 */
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1519 int rc_min_rate;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1520
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1521 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1522 * decoder bitstream buffer size
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1523 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1524 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1525 */
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1526 int rc_buffer_size;
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1527 float rc_buffer_aggressivity;
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1528
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1529 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1530 * qscale factor between P and I-frames
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1531 * If > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset).
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1532 * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1533 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1534 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1535 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1536 float i_quant_factor;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1537
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1538 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1539 * qscale offset between P and I-frames
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1540 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1541 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1542 */
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1543 float i_quant_offset;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1544
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1545 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1546 * initial complexity for pass1 ratecontrol
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1547 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1548 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1549 */
613
9bb356b23dd9 new ratecontrol code
michaelni
parents: 599
diff changeset
1550 float rc_initial_cplx;
581
8adda0af04e2 added proposed API for parse_only mode to extract compressed frames from compressed streams
bellard
parents: 573
diff changeset
1551
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1552 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1553 * DCT algorithm, see FF_DCT_* below
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1554 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1555 * - decoding: unused
684
581678112a5d documenting most stuff in AVCodecContext
michaelni
parents: 681
diff changeset
1556 */
625
bb6a69f9d409 slow but accurate integer dct from IJG (should be ok with the LGPL as the old DCT is the fast integer DCT from IJG)
michaelni
parents: 618
diff changeset
1557 int dct_algo;
628
f596db4aa871 sun solaris compilation bugfix, patch by (Martin Olschewski <olschewski at zpr dot uni-koeln dot de>)
michaelni
parents: 625
diff changeset
1558 #define FF_DCT_AUTO 0
625
bb6a69f9d409 slow but accurate integer dct from IJG (should be ok with the LGPL as the old DCT is the fast integer DCT from IJG)
michaelni
parents: 618
diff changeset
1559 #define FF_DCT_FASTINT 1
628
f596db4aa871 sun solaris compilation bugfix, patch by (Martin Olschewski <olschewski at zpr dot uni-koeln dot de>)
michaelni
parents: 625
diff changeset
1560 #define FF_DCT_INT 2
f596db4aa871 sun solaris compilation bugfix, patch by (Martin Olschewski <olschewski at zpr dot uni-koeln dot de>)
michaelni
parents: 625
diff changeset
1561 #define FF_DCT_MMX 3
f596db4aa871 sun solaris compilation bugfix, patch by (Martin Olschewski <olschewski at zpr dot uni-koeln dot de>)
michaelni
parents: 625
diff changeset
1562 #define FF_DCT_MLIB 4
828
ace3ccd18dd2 Altivec Patch (Mark III) by (Dieter Shirley <dieters at schemasoft dot com>)
michaelni
parents: 827
diff changeset
1563 #define FF_DCT_ALTIVEC 5
1557
5d53c03186a1 floating point AAN DCT
michael
parents: 1548
diff changeset
1564 #define FF_DCT_FAAN 6
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1565
690
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1566 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1567 * luminance masking (0-> disabled)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1568 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1569 * - decoding: unused
690
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1570 */
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1571 float lumi_masking;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1572
690
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1573 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1574 * temporary complexity masking (0-> disabled)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1575 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1576 * - decoding: unused
690
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1577 */
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1578 float temporal_cplx_masking;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1579
690
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1580 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1581 * spatial complexity masking (0-> disabled)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1582 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1583 * - decoding: unused
690
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1584 */
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1585 float spatial_cplx_masking;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1586
690
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1587 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1588 * p block masking (0-> disabled)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1589 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1590 * - decoding: unused
690
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1591 */
a1c69cb685b3 adaptive quantization (lumi/temporal & spatial complexity masking)
michaelni
parents: 686
diff changeset
1592 float p_masking;
654
850098147a3c export pts from stream if available
michaelni
parents: 652
diff changeset
1593
693
b6a7ff92df57 darkness masking (lumi masking does only bright stuff now)
michaelni
parents: 690
diff changeset
1594 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1595 * darkness masking (0-> disabled)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1596 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1597 * - decoding: unused
693
b6a7ff92df57 darkness masking (lumi masking does only bright stuff now)
michaelni
parents: 690
diff changeset
1598 */
b6a7ff92df57 darkness masking (lumi masking does only bright stuff now)
michaelni
parents: 690
diff changeset
1599 float dark_masking;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1600
700
0fb4c66527e1 autodetect UMP4 (by adding a fourcc field to AVCodecContext)
michaelni
parents: 697
diff changeset
1601 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1602 * IDCT algorithm, see FF_IDCT_* below.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1603 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1604 * - decoding: Set by user.
706
e65798d228ea idct permutation cleanup, idct can be selected per context now
michaelni
parents: 703
diff changeset
1605 */
e65798d228ea idct permutation cleanup, idct can be selected per context now
michaelni
parents: 703
diff changeset
1606 int idct_algo;
5590
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1607 #define FF_IDCT_AUTO 0
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1608 #define FF_IDCT_INT 1
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1609 #define FF_IDCT_SIMPLE 2
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1610 #define FF_IDCT_SIMPLEMMX 3
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1611 #define FF_IDCT_LIBMPEG2MMX 4
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1612 #define FF_IDCT_PS2 5
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1613 #define FF_IDCT_MLIB 6
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1614 #define FF_IDCT_ARM 7
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1615 #define FF_IDCT_ALTIVEC 8
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1616 #define FF_IDCT_SH4 9
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1617 #define FF_IDCT_SIMPLEARM 10
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1618 #define FF_IDCT_H264 11
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1619 #define FF_IDCT_VP3 12
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1620 #define FF_IDCT_IPP 13
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1621 #define FF_IDCT_XVIDMMX 14
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1622 #define FF_IDCT_CAVS 15
3769
cf04e15a72ac ARMv5TE optimized IDCT
mru
parents: 3764
diff changeset
1623 #define FF_IDCT_SIMPLEARMV5TE 16
5590
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1624 #define FF_IDCT_SIMPLEARMV6 17
5618
ad0ab0eebd69 add simple_idct implemented in Sparc VIS
gpoirier
parents: 5590
diff changeset
1625 #define FF_IDCT_SIMPLEVIS 18
5887
83ac4620c6ed intrax8 decoder patch by "someone"
michael
parents: 5879
diff changeset
1626 #define FF_IDCT_WMV2 19
6407
7f9e2b5893fc floating point AAN IDCT
michael
parents: 6395
diff changeset
1627 #define FF_IDCT_FAAN 20
8119
4c2893f962bb Electronic Arts TGQ video decoder
pross
parents: 8104
diff changeset
1628 #define FF_IDCT_EA 21
8335
f19fe0cade86 ARM: NEON optimised simple_idct
mru
parents: 8328
diff changeset
1629 #define FF_IDCT_SIMPLENEON 22
8619
ce9b3d6a0abf Alpha: proper IDCT selection
mru
parents: 8615
diff changeset
1630 #define FF_IDCT_SIMPLEALPHA 23
11231
0fc1cdd984b7 Bink video decoder
kostya
parents: 11125
diff changeset
1631 #define FF_IDCT_BINK 24
706
e65798d228ea idct permutation cleanup, idct can be selected per context now
michaelni
parents: 703
diff changeset
1632
713
e74a563eb643 rv10 cleanup (de)muxer still needs to be cleaned up (still searching volunteer for that ;) )
michaelni
parents: 706
diff changeset
1633 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1634 * slice count
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1635 * - encoding: Set by libavcodec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1636 * - decoding: Set by user (or 0).
713
e74a563eb643 rv10 cleanup (de)muxer still needs to be cleaned up (still searching volunteer for that ;) )
michaelni
parents: 706
diff changeset
1637 */
e74a563eb643 rv10 cleanup (de)muxer still needs to be cleaned up (still searching volunteer for that ;) )
michaelni
parents: 706
diff changeset
1638 int slice_count;
e74a563eb643 rv10 cleanup (de)muxer still needs to be cleaned up (still searching volunteer for that ;) )
michaelni
parents: 706
diff changeset
1639 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1640 * slice offsets in the frame in bytes
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1641 * - encoding: Set/allocated by libavcodec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1642 * - decoding: Set/allocated by user (or NULL).
713
e74a563eb643 rv10 cleanup (de)muxer still needs to be cleaned up (still searching volunteer for that ;) )
michaelni
parents: 706
diff changeset
1643 */
e74a563eb643 rv10 cleanup (de)muxer still needs to be cleaned up (still searching volunteer for that ;) )
michaelni
parents: 706
diff changeset
1644 int *slice_offset;
e74a563eb643 rv10 cleanup (de)muxer still needs to be cleaned up (still searching volunteer for that ;) )
michaelni
parents: 706
diff changeset
1645
745
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1646 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1647 * error concealment flags
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1648 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1649 * - decoding: Set by user.
745
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1650 */
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1651 int error_concealment;
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1652 #define FF_EC_GUESS_MVS 1
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1653 #define FF_EC_DEBLOCK 2
25d7fb7c89be better/cleaner error resilience (done in a 2nd pass after decoding)
michaelni
parents: 733
diff changeset
1654
803
08423289ec57 exporting the internal qscale table, this allso fixes the ordering
michaelni
parents: 783
diff changeset
1655 /**
1114
e4762efc3617 * more generic avoption_parse
kabi
parents: 1113
diff changeset
1656 * dsp_mask could be add used to disable unwanted CPU features
849
a6ed9b34a650 * added dsp_mask
kabi
parents: 846
diff changeset
1657 * CPU features (i.e. MMX, SSE. ...)
1114
e4762efc3617 * more generic avoption_parse
kabi
parents: 1113
diff changeset
1658 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1659 * With the FORCE flag you may instead enable given CPU features.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1660 * (Dangerous: Usable in case of misdetection, improper usage however will
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1661 * result into program crash.)
849
a6ed9b34a650 * added dsp_mask
kabi
parents: 846
diff changeset
1662 */
1114
e4762efc3617 * more generic avoption_parse
kabi
parents: 1113
diff changeset
1663 unsigned dsp_mask;
12456
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1664
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1665 #if FF_API_MM_FLAGS
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1666 #define FF_MM_FORCE AV_CPU_FLAG_FORCE
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1667 #define FF_MM_MMX AV_CPU_FLAG_MMX
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1668 #define FF_MM_3DNOW AV_CPU_FLAG_3DNOW
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1669 #define FF_MM_MMXEXT AV_CPU_FLAG_MMX2
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1670 #define FF_MM_MMX2 AV_CPU_FLAG_MMX2
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1671 #define FF_MM_SSE AV_CPU_FLAG_SSE
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1672 #define FF_MM_SSE2 AV_CPU_FLAG_SSE2
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1673 #define FF_MM_SSE2SLOW AV_CPU_FLAG_SSE2SLOW
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1674 #define FF_MM_3DNOWEXT AV_CPU_FLAG_3DNOWEXT
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1675 #define FF_MM_SSE3 AV_CPU_FLAG_SSE3
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1676 #define FF_MM_SSE3SLOW AV_CPU_FLAG_SSE3SLOW
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1677 #define FF_MM_SSSE3 AV_CPU_FLAG_SSSE3
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1678 #define FF_MM_SSE4 AV_CPU_FLAG_SSE4
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1679 #define FF_MM_SSE42 AV_CPU_FLAG_SSE42
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1680 #define FF_MM_IWMMXT AV_CPU_FLAG_IWMMXT
a5ddb39627fd Rename FF_MM_ symbols related to CPU features flags as AV_CPU_FLAG_
stefano
parents: 12449
diff changeset
1681 #define FF_MM_ALTIVEC AV_CPU_FLAG_ALTIVEC
9342
7f594601d5e9 Rename FF_MM_MMXEXT to FF_MM_MMX2, for both clarity and consistency
stefano
parents: 9336
diff changeset
1682 #endif
866
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1683
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1684 /**
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1685 * bits per sample/pixel from the demuxer (needed for huffyuv).
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1686 * - encoding: Set by libavcodec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1687 * - decoding: Set by user.
866
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1688 */
7720
b1cacb2f48a0 Change AVCodecContext.bits_per_sample to bits_per_coded_sample.
pross
parents: 7632
diff changeset
1689 int bits_per_coded_sample;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1690
866
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1691 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1692 * prediction method (needed for huffyuv)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1693 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1694 * - decoding: unused
866
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1695 */
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1696 int prediction_method;
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1697 #define FF_PRED_LEFT 0
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1698 #define FF_PRED_PLANE 1
725ef4ea3ecc huffyuv
michaelni
parents: 862
diff changeset
1699 #define FF_PRED_MEDIAN 2
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1700
880
1c32039e7215 aspect ratio cleanup
michaelni
parents: 867
diff changeset
1701 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1702 * sample aspect ratio (0 if unknown)
7786
0251b288a4a0 Clarify sample_aspect_ratio.
michael
parents: 7769
diff changeset
1703 * That is the width of a pixel divided by the height of the pixel.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1704 * Numerator and denominator must be relatively prime and smaller than 256 for some video standards.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1705 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1706 * - decoding: Set by libavcodec.
880
1c32039e7215 aspect ratio cleanup
michaelni
parents: 867
diff changeset
1707 */
1548
dd544554ed42 AVRational
michael
parents: 1547
diff changeset
1708 AVRational sample_aspect_ratio;
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
1709
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
1710 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1711 * the picture in the bitstream
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1712 * - encoding: Set by libavcodec.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1713 * - decoding: Set by libavcodec.
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
1714 */
925
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
1715 AVFrame *coded_frame;
906
bbe0c99231a7 specific debug output support
michaelni
parents: 905
diff changeset
1716
bbe0c99231a7 specific debug output support
michaelni
parents: 905
diff changeset
1717 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1718 * debug
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1719 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1720 * - decoding: Set by user.
906
bbe0c99231a7 specific debug output support
michaelni
parents: 905
diff changeset
1721 */
bbe0c99231a7 specific debug output support
michaelni
parents: 905
diff changeset
1722 int debug;
5590
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1723 #define FF_DEBUG_PICT_INFO 1
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1724 #define FF_DEBUG_RC 2
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1725 #define FF_DEBUG_BITSTREAM 4
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1726 #define FF_DEBUG_MB_TYPE 8
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1727 #define FF_DEBUG_QP 16
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1728 #define FF_DEBUG_MV 32
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1729 #define FF_DEBUG_DCT_COEFF 0x00000040
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1730 #define FF_DEBUG_SKIP 0x00000080
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1731 #define FF_DEBUG_STARTCODE 0x00000100
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1732 #define FF_DEBUG_PTS 0x00000200
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1733 #define FF_DEBUG_ER 0x00000400
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1734 #define FF_DEBUG_MMCO 0x00000800
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1735 #define FF_DEBUG_BUGS 0x00001000
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1736 #define FF_DEBUG_VIS_QP 0x00002000
1685
cb09cf265a87 mb type & qp vissualization
michael
parents: 1668
diff changeset
1737 #define FF_DEBUG_VIS_MB_TYPE 0x00004000
7406
7b2819083061 Add a new -debug option for tracing calls to the default get/release_buffer functions.
astrange
parents: 7342
diff changeset
1738 #define FF_DEBUG_BUFFERS 0x00008000
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1739
909
8ae1e4c24e91 new PSNR code (now works with chroma, b frames, ...)
michaelni
parents: 906
diff changeset
1740 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1741 * debug
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1742 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1743 * - decoding: Set by user.
1706
3ba5c493db6f motion vector vissualization improvements patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1696
diff changeset
1744 */
3ba5c493db6f motion vector vissualization improvements patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1696
diff changeset
1745 int debug_mv;
3ba5c493db6f motion vector vissualization improvements patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1696
diff changeset
1746 #define FF_DEBUG_VIS_MV_P_FOR 0x00000001 //visualize forward predicted MVs of P frames
3ba5c493db6f motion vector vissualization improvements patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1696
diff changeset
1747 #define FF_DEBUG_VIS_MV_B_FOR 0x00000002 //visualize forward predicted MVs of B frames
3ba5c493db6f motion vector vissualization improvements patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1696
diff changeset
1748 #define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames
3ba5c493db6f motion vector vissualization improvements patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1696
diff changeset
1749
3ba5c493db6f motion vector vissualization improvements patch by (Wolfgang Hesseler <qv at multimediaware dot com>)
michael
parents: 1696
diff changeset
1750 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1751 * error
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1752 * - encoding: Set by libavcodec if flags&CODEC_FLAG_PSNR.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1753 * - decoding: unused
909
8ae1e4c24e91 new PSNR code (now works with chroma, b frames, ...)
michaelni
parents: 906
diff changeset
1754 */
8ae1e4c24e91 new PSNR code (now works with chroma, b frames, ...)
michaelni
parents: 906
diff changeset
1755 uint64_t error[4];
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1756
932
176fd8c8e8a8 mb qp limits
michaelni
parents: 925
diff changeset
1757 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1758 * minimum MB quantizer
2494
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
1759 * - encoding: unused
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1760 * - decoding: unused
932
176fd8c8e8a8 mb qp limits
michaelni
parents: 925
diff changeset
1761 */
176fd8c8e8a8 mb qp limits
michaelni
parents: 925
diff changeset
1762 int mb_qmin;
176fd8c8e8a8 mb qp limits
michaelni
parents: 925
diff changeset
1763
176fd8c8e8a8 mb qp limits
michaelni
parents: 925
diff changeset
1764 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1765 * maximum MB quantizer
2494
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
1766 * - encoding: unused
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1767 * - decoding: unused
932
176fd8c8e8a8 mb qp limits
michaelni
parents: 925
diff changeset
1768 */
176fd8c8e8a8 mb qp limits
michaelni
parents: 925
diff changeset
1769 int mb_qmax;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1770
936
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1771 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1772 * motion estimation comparison function
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1773 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1774 * - decoding: unused
936
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1775 */
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1776 int me_cmp;
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1777 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1778 * subpixel motion estimation comparison function
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1779 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1780 * - decoding: unused
936
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1781 */
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1782 int me_sub_cmp;
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1783 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1784 * macroblock comparison function (not supported yet)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1785 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1786 * - decoding: unused
936
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1787 */
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1788 int mb_cmp;
1729
a4a5e7521339 interlaced dct decision cleanup
michael
parents: 1721
diff changeset
1789 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1790 * interlaced DCT comparison function
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1791 * - encoding: Set by user.
1729
a4a5e7521339 interlaced dct decision cleanup
michael
parents: 1721
diff changeset
1792 * - decoding: unused
a4a5e7521339 interlaced dct decision cleanup
michael
parents: 1721
diff changeset
1793 */
a4a5e7521339 interlaced dct decision cleanup
michael
parents: 1721
diff changeset
1794 int ildct_cmp;
5590
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1795 #define FF_CMP_SAD 0
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1796 #define FF_CMP_SSE 1
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1797 #define FF_CMP_SATD 2
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1798 #define FF_CMP_DCT 3
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1799 #define FF_CMP_PSNR 4
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1800 #define FF_CMP_BIT 5
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1801 #define FF_CMP_RD 6
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1802 #define FF_CMP_ZERO 7
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1803 #define FF_CMP_VSAD 8
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1804 #define FF_CMP_VSSE 9
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1805 #define FF_CMP_NSSE 10
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1806 #define FF_CMP_W53 11
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
1807 #define FF_CMP_W97 12
2382
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
1808 #define FF_CMP_DCTMAX 13
3010
533c6386eca9 8x8 integer dct from x264 as cmp function (under CONFIG_GPL)
michael
parents: 3006
diff changeset
1809 #define FF_CMP_DCT264 14
936
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1810 #define FF_CMP_CHROMA 256
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1811
936
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1812 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1813 * ME diamond size & shape
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1814 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1815 * - decoding: unused
936
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1816 */
caa77cd960c0 qpel encoding
michaelni
parents: 932
diff changeset
1817 int dia_size;
948
371bc36a9c5c shape adaptive diamonds for EPZS
michaelni
parents: 945
diff changeset
1818
371bc36a9c5c shape adaptive diamonds for EPZS
michaelni
parents: 945
diff changeset
1819 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1820 * amount of previous MV predictors (2a+1 x 2a+1 square)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1821 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1822 * - decoding: unused
948
371bc36a9c5c shape adaptive diamonds for EPZS
michaelni
parents: 945
diff changeset
1823 */
371bc36a9c5c shape adaptive diamonds for EPZS
michaelni
parents: 945
diff changeset
1824 int last_predictor_count;
953
9eb066d6e0db mpeg4 header encoding bugfix
michaelni
parents: 951
diff changeset
1825
951
ad264a7d4f94 motion estimation pre pass
michaelni
parents: 948
diff changeset
1826 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1827 * prepass for motion estimation
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1828 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1829 * - decoding: unused
951
ad264a7d4f94 motion estimation pre pass
michaelni
parents: 948
diff changeset
1830 */
ad264a7d4f94 motion estimation pre pass
michaelni
parents: 948
diff changeset
1831 int pre_me;
948
371bc36a9c5c shape adaptive diamonds for EPZS
michaelni
parents: 945
diff changeset
1832
953
9eb066d6e0db mpeg4 header encoding bugfix
michaelni
parents: 951
diff changeset
1833 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1834 * motion estimation prepass comparison function
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1835 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1836 * - decoding: unused
953
9eb066d6e0db mpeg4 header encoding bugfix
michaelni
parents: 951
diff changeset
1837 */
9eb066d6e0db mpeg4 header encoding bugfix
michaelni
parents: 951
diff changeset
1838 int me_pre_cmp;
954
13aec7e50c52 qpel in mmx2/3dnow
michaelni
parents: 953
diff changeset
1839
953
9eb066d6e0db mpeg4 header encoding bugfix
michaelni
parents: 951
diff changeset
1840 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1841 * ME prepass diamond size & shape
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1842 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1843 * - decoding: unused
953
9eb066d6e0db mpeg4 header encoding bugfix
michaelni
parents: 951
diff changeset
1844 */
9eb066d6e0db mpeg4 header encoding bugfix
michaelni
parents: 951
diff changeset
1845 int pre_dia_size;
9eb066d6e0db mpeg4 header encoding bugfix
michaelni
parents: 951
diff changeset
1846
954
13aec7e50c52 qpel in mmx2/3dnow
michaelni
parents: 953
diff changeset
1847 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1848 * subpel ME quality
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1849 * - encoding: Set by user.
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1850 * - decoding: unused
954
13aec7e50c52 qpel in mmx2/3dnow
michaelni
parents: 953
diff changeset
1851 */
13aec7e50c52 qpel in mmx2/3dnow
michaelni
parents: 953
diff changeset
1852 int me_subpel_quality;
13aec7e50c52 qpel in mmx2/3dnow
michaelni
parents: 953
diff changeset
1853
998
6129c88a6393 get_format()
michaelni
parents: 991
diff changeset
1854 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1855 * callback to negotiate the pixelFormat
998
6129c88a6393 get_format()
michaelni
parents: 991
diff changeset
1856 * @param fmt is the list of formats which are supported by the codec,
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1857 * it is terminated by -1 as 0 is a valid format, the formats are ordered by quality.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1858 * The first is always the native one.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1859 * @return the chosen format
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
1860 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1861 * - decoding: Set by user, if not set the native format will be chosen.
998
6129c88a6393 get_format()
michaelni
parents: 991
diff changeset
1862 */
1858
ea2a4058441c silence warnings
iive
parents: 1857
diff changeset
1863 enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt);
1084
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1864
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1865 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1866 * DTG active format information (additional aspect ratio
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1867 * information only used in DVB MPEG-2 transport streams)
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1868 * 0 if not set.
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1869 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1870 * - encoding: unused
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1871 * - decoding: Set by decoder.
1084
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1872 */
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1873 int dtg_active_format;
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1874 #define FF_DTG_AFD_SAME 8
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1875 #define FF_DTG_AFD_4_3 9
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1876 #define FF_DTG_AFD_16_9 10
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1877 #define FF_DTG_AFD_14_9 11
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1878 #define FF_DTG_AFD_4_3_SP_14_9 13
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1879 #define FF_DTG_AFD_16_9_SP_14_9 14
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1880 #define FF_DTG_AFD_SP_4_3 15
01154fced380 added DTG active format information
bellard
parents: 1064
diff changeset
1881
1086
d3b93dc997a3 user specified motion estimation range limit
michaelni
parents: 1085
diff changeset
1882 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1883 * maximum motion estimation search range in subpel units
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1884 * If 0 then no limit.
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1885 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1886 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1887 * - decoding: unused
1086
d3b93dc997a3 user specified motion estimation range limit
michaelni
parents: 1085
diff changeset
1888 */
1129
c54b6c2a62c7 * cosmetic doc fix
kabi
parents: 1127
diff changeset
1889 int me_range;
1086
d3b93dc997a3 user specified motion estimation range limit
michaelni
parents: 1085
diff changeset
1890
1149
b48bf370ff44 binary compatibility fix
michaelni
parents: 1144
diff changeset
1891 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1892 * intra quantizer bias
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1893 * - encoding: Set by user.
1150
dde68a430ba9 user setable quantizer bias
michaelni
parents: 1149
diff changeset
1894 * - decoding: unused
dde68a430ba9 user setable quantizer bias
michaelni
parents: 1149
diff changeset
1895 */
dde68a430ba9 user setable quantizer bias
michaelni
parents: 1149
diff changeset
1896 int intra_quant_bias;
dde68a430ba9 user setable quantizer bias
michaelni
parents: 1149
diff changeset
1897 #define FF_DEFAULT_QUANT_BIAS 999999
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1898
1150
dde68a430ba9 user setable quantizer bias
michaelni
parents: 1149
diff changeset
1899 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1900 * inter quantizer bias
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1901 * - encoding: Set by user.
1150
dde68a430ba9 user setable quantizer bias
michaelni
parents: 1149
diff changeset
1902 * - decoding: unused
dde68a430ba9 user setable quantizer bias
michaelni
parents: 1149
diff changeset
1903 */
dde68a430ba9 user setable quantizer bias
michaelni
parents: 1149
diff changeset
1904 int inter_quant_bias;
1210
ede882dd601f * fixed initialization and some memleak
kabi
parents: 1208
diff changeset
1905
ede882dd601f * fixed initialization and some memleak
kabi
parents: 1208
diff changeset
1906 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1907 * color table ID
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1908 * - encoding: unused
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1909 * - decoding: Which clrtable should be used for 8bit RGB images.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1910 * Tables have to be stored somewhere. FIXME
1210
ede882dd601f * fixed initialization and some memleak
kabi
parents: 1208
diff changeset
1911 */
ede882dd601f * fixed initialization and some memleak
kabi
parents: 1208
diff changeset
1912 int color_table_id;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1913
1214
327c5a36dfe7 fixing mixed dr1 + internal buffers
michaelni
parents: 1212
diff changeset
1914 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1915 * internal_buffer count
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1916 * Don't touch, used by libavcodec default_get_buffer().
1214
327c5a36dfe7 fixing mixed dr1 + internal buffers
michaelni
parents: 1212
diff changeset
1917 */
327c5a36dfe7 fixing mixed dr1 + internal buffers
michaelni
parents: 1212
diff changeset
1918 int internal_buffer_count;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1919
1214
327c5a36dfe7 fixing mixed dr1 + internal buffers
michaelni
parents: 1212
diff changeset
1920 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1921 * internal_buffers
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1922 * Don't touch, used by libavcodec default_get_buffer().
1214
327c5a36dfe7 fixing mixed dr1 + internal buffers
michaelni
parents: 1212
diff changeset
1923 */
327c5a36dfe7 fixing mixed dr1 + internal buffers
michaelni
parents: 1212
diff changeset
1924 void *internal_buffer;
1505
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
1925
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
1926 #define FF_LAMBDA_SHIFT 7
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
1927 #define FF_LAMBDA_SCALE (1<<FF_LAMBDA_SHIFT)
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
1928 #define FF_QP2LAMBDA 118 ///< factor to convert from H.263 QP to lambda
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
1929 #define FF_LAMBDA_MAX (256*128-1)
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
1930
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
1931 #define FF_QUALITY_SCALE FF_LAMBDA_SCALE //FIXME maybe remove
1273
a979fab41ed8 ASV1 codec
michaelni
parents: 1266
diff changeset
1932 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1933 * Global quality for codecs which cannot change it per frame.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1934 * This should be proportional to MPEG-1/2/4 qscale.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1935 * - encoding: Set by user.
1273
a979fab41ed8 ASV1 codec
michaelni
parents: 1266
diff changeset
1936 * - decoding: unused
a979fab41ed8 ASV1 codec
michaelni
parents: 1266
diff changeset
1937 */
a979fab41ed8 ASV1 codec
michaelni
parents: 1266
diff changeset
1938 int global_quality;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1939
4776
edac3f77dcfa cosmetic
michael
parents: 4775
diff changeset
1940 #define FF_CODER_TYPE_VLC 0
edac3f77dcfa cosmetic
michael
parents: 4775
diff changeset
1941 #define FF_CODER_TYPE_AC 1
4775
14e7131344b3 FF_CODER_TYPE_RAW / RLE / DEFLATE extracted from a patch by Kamil Nowosad
michael
parents: 4774
diff changeset
1942 #define FF_CODER_TYPE_RAW 2
14e7131344b3 FF_CODER_TYPE_RAW / RLE / DEFLATE extracted from a patch by Kamil Nowosad
michael
parents: 4774
diff changeset
1943 #define FF_CODER_TYPE_RLE 3
14e7131344b3 FF_CODER_TYPE_RAW / RLE / DEFLATE extracted from a patch by Kamil Nowosad
michael
parents: 4774
diff changeset
1944 #define FF_CODER_TYPE_DEFLATE 4
1306
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1945 /**
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1946 * coder type
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1947 * - encoding: Set by user.
1306
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1948 * - decoding: unused
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1949 */
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1950 int coder_type;
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1951
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1952 /**
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1953 * context model
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1954 * - encoding: Set by user.
1306
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1955 * - decoding: unused
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1956 */
799839d1e2e1 golomb rice codes
michaelni
parents: 1304
diff changeset
1957 int context_model;
2970
583b6ac45c07 unfinished jpeg-ls codec (feel free to finish it ...)
michael
parents: 2967
diff changeset
1958 #if 0
583b6ac45c07 unfinished jpeg-ls codec (feel free to finish it ...)
michael
parents: 2967
diff changeset
1959 /**
583b6ac45c07 unfinished jpeg-ls codec (feel free to finish it ...)
michael
parents: 2967
diff changeset
1960 *
583b6ac45c07 unfinished jpeg-ls codec (feel free to finish it ...)
michael
parents: 2967
diff changeset
1961 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1962 * - decoding: Set by user.
2970
583b6ac45c07 unfinished jpeg-ls codec (feel free to finish it ...)
michael
parents: 2967
diff changeset
1963 */
583b6ac45c07 unfinished jpeg-ls codec (feel free to finish it ...)
michael
parents: 2967
diff changeset
1964 uint8_t * (*realloc)(struct AVCodecContext *s, uint8_t *buf, int buf_size);
583b6ac45c07 unfinished jpeg-ls codec (feel free to finish it ...)
michael
parents: 2967
diff changeset
1965 #endif
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1966
1370
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1967 /**
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1968 * slice flags
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1969 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1970 * - decoding: Set by user.
1370
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1971 */
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1972 int slice_flags;
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1973 #define SLICE_FLAG_CODED_ORDER 0x0001 ///< draw_horiz_band() is called in coded order instead of display
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1974 #define SLICE_FLAG_ALLOW_FIELD 0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics)
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1975 #define SLICE_FLAG_ALLOW_PLANE 0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)
45d761c387cd default for slices is display order again
michaelni
parents: 1368
diff changeset
1976
1382
f23bc5ffb374 initial XvMC support
iive
parents: 1374
diff changeset
1977 /**
f23bc5ffb374 initial XvMC support
iive
parents: 1374
diff changeset
1978 * XVideo Motion Acceleration
f23bc5ffb374 initial XvMC support
iive
parents: 1374
diff changeset
1979 * - encoding: forbidden
f23bc5ffb374 initial XvMC support
iive
parents: 1374
diff changeset
1980 * - decoding: set by decoder
f23bc5ffb374 initial XvMC support
iive
parents: 1374
diff changeset
1981 */
f23bc5ffb374 initial XvMC support
iive
parents: 1374
diff changeset
1982 int xvmc_acceleration;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
1983
1389
da0b3a50d209 rate distortion mb decision support
michaelni
parents: 1385
diff changeset
1984 /**
da0b3a50d209 rate distortion mb decision support
michaelni
parents: 1385
diff changeset
1985 * macroblock decision mode
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1986 * - encoding: Set by user.
1389
da0b3a50d209 rate distortion mb decision support
michaelni
parents: 1385
diff changeset
1987 * - decoding: unused
da0b3a50d209 rate distortion mb decision support
michaelni
parents: 1385
diff changeset
1988 */
da0b3a50d209 rate distortion mb decision support
michaelni
parents: 1385
diff changeset
1989 int mb_decision;
da0b3a50d209 rate distortion mb decision support
michaelni
parents: 1385
diff changeset
1990 #define FF_MB_DECISION_SIMPLE 0 ///< uses mb_cmp
da0b3a50d209 rate distortion mb decision support
michaelni
parents: 1385
diff changeset
1991 #define FF_MB_DECISION_BITS 1 ///< chooses the one which needs the fewest bits
6719
e88e719b5e77 Typo: distoration -> distortion.
ramiro
parents: 6664
diff changeset
1992 #define FF_MB_DECISION_RD 2 ///< rate distortion
1411
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
1993
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
1994 /**
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
1995 * custom intra quantization matrix
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1996 * - encoding: Set by user, can be NULL.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
1997 * - decoding: Set by libavcodec.
1411
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
1998 */
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
1999 uint16_t *intra_matrix;
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
2000
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
2001 /**
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
2002 * custom inter quantization matrix
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2003 * - encoding: Set by user, can be NULL.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2004 * - decoding: Set by libavcodec.
1411
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
2005 */
c2e63cb94d06 custom quant matrix encoding support
michaelni
parents: 1410
diff changeset
2006 uint16_t *inter_matrix;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2007
1458
40b69d238beb AVI stream header FCC / more reliable detection of old xvid files
michaelni
parents: 1457
diff changeset
2008 /**
40b69d238beb AVI stream header FCC / more reliable detection of old xvid files
michaelni
parents: 1457
diff changeset
2009 * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2010 * This is used to work around some encoder bugs.
1458
40b69d238beb AVI stream header FCC / more reliable detection of old xvid files
michaelni
parents: 1457
diff changeset
2011 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2012 * - decoding: Set by user, will be converted to uppercase by libavcodec during init.
1458
40b69d238beb AVI stream header FCC / more reliable detection of old xvid files
michaelni
parents: 1457
diff changeset
2013 */
40b69d238beb AVI stream header FCC / more reliable detection of old xvid files
michaelni
parents: 1457
diff changeset
2014 unsigned int stream_codec_tag;
1471
dcb784544ec6 scenechange_threshold
michaelni
parents: 1464
diff changeset
2015
dcb784544ec6 scenechange_threshold
michaelni
parents: 1464
diff changeset
2016 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2017 * scene change detection threshold
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2018 * 0 is default, larger means fewer detected scene changes.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2019 * - encoding: Set by user.
1471
dcb784544ec6 scenechange_threshold
michaelni
parents: 1464
diff changeset
2020 * - decoding: unused
dcb784544ec6 scenechange_threshold
michaelni
parents: 1464
diff changeset
2021 */
dcb784544ec6 scenechange_threshold
michaelni
parents: 1464
diff changeset
2022 int scenechange_threshold;
1505
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2023
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2024 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2025 * minimum Lagrange multipler
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2026 * - encoding: Set by user.
1505
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2027 * - decoding: unused
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2028 */
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2029 int lmin;
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2030
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2031 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2032 * maximum Lagrange multipler
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2033 * - encoding: Set by user.
1505
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2034 * - decoding: unused
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2035 */
010f76d07a27 use lagrange multipler instead of qp for ratecontrol, this may break some things, tell me ASAP if u notice anything broken
michaelni
parents: 1500
diff changeset
2036 int lmax;
1585
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
2037
12449
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
2038 #if FF_API_PALETTE_CONTROL
1585
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
2039 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2040 * palette control structure
1585
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
2041 * - encoding: ??? (no palette-enabled encoder yet)
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2042 * - decoding: Set by user.
1585
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
2043 */
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
2044 struct AVPaletteControl *palctrl;
12449
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
2045 #endif
1597
4c9165372ab3 noise reduction of dct coefficients
michael
parents: 1596
diff changeset
2046
4c9165372ab3 noise reduction of dct coefficients
michael
parents: 1596
diff changeset
2047 /**
4c9165372ab3 noise reduction of dct coefficients
michael
parents: 1596
diff changeset
2048 * noise reduction strength
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2049 * - encoding: Set by user.
1597
4c9165372ab3 noise reduction of dct coefficients
michael
parents: 1596
diff changeset
2050 * - decoding: unused
4c9165372ab3 noise reduction of dct coefficients
michael
parents: 1596
diff changeset
2051 */
4c9165372ab3 noise reduction of dct coefficients
michael
parents: 1596
diff changeset
2052 int noise_reduction;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2053
1606
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
2054 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2055 * Called at the beginning of a frame to get cr buffer for it.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2056 * Buffer type (size, hints) must be the same. libavcodec won't check it.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2057 * libavcodec will pass previous buffer in pic, function should return
1630
586b5c08863c - Add reget_buffer() function to AVCodecContext
rtognimp
parents: 1624
diff changeset
2058 * same buffer or new buffer with old frame "painted" into it.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2059 * If pic.data[0] == NULL must behave like get_buffer().
9827
bca8ee90e5eb Clarify (re)get_buffer() and CODEC_CAP_DR1 relation.
michael
parents: 9825
diff changeset
2060 * if CODEC_CAP_DR1 is not set then reget_buffer() must call
bca8ee90e5eb Clarify (re)get_buffer() and CODEC_CAP_DR1 relation.
michael
parents: 9825
diff changeset
2061 * avcodec_default_reget_buffer() instead of providing buffers allocated by
bca8ee90e5eb Clarify (re)get_buffer() and CODEC_CAP_DR1 relation.
michael
parents: 9825
diff changeset
2062 * some other means.
1606
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
2063 * - encoding: unused
12131
2d51a2375ddf Fix trivial punctuation error
pross
parents: 12130
diff changeset
2064 * - decoding: Set by libavcodec, user can override.
1606
a1ac8e675b95 Add cr codec capability and buffer hints
rtognimp
parents: 1598
diff changeset
2065 */
1630
586b5c08863c - Add reget_buffer() function to AVCodecContext
rtognimp
parents: 1624
diff changeset
2066 int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic);
1661
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2067
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2068 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2069 * Number of bits which should be loaded into the rc buffer before decoding starts.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2070 * - encoding: Set by user.
1661
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2071 * - decoding: unused
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2072 */
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2073 int rc_initial_buffer_occupancy;
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2074
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2075 /**
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2076 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2077 * - encoding: Set by user.
1661
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2078 * - decoding: unused
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2079 */
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2080 int inter_threshold;
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2081
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2082 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2083 * CODEC_FLAG2_*
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2084 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2085 * - decoding: Set by user.
1661
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2086 */
4c9fd29f1606 h263 slice structured mode
michael
parents: 1650
diff changeset
2087 int flags2;
1688
04b759af8bd4 error concealment regression test
michael
parents: 1685
diff changeset
2088
04b759af8bd4 error concealment regression test
michael
parents: 1685
diff changeset
2089 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2090 * Simulates errors in the bitstream to test error concealment.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2091 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2092 * - decoding: unused
1688
04b759af8bd4 error concealment regression test
michael
parents: 1685
diff changeset
2093 */
04b759af8bd4 error concealment regression test
michael
parents: 1685
diff changeset
2094 int error_rate;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2095
1733
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2096 /**
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2097 * MP3 antialias algorithm, see FF_AA_* below.
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2098 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2099 * - decoding: Set by user.
1733
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2100 */
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2101 int antialias_algo;
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2102 #define FF_AA_AUTO 0
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2103 #define FF_AA_FASTINT 1 //not implemented yet
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2104 #define FF_AA_INT 2
b47d56b1a049 optimize compute_antialias() and add a floating point based alternative (2x faster)
michael
parents: 1729
diff changeset
2105 #define FF_AA_FLOAT 3
1777
d183026acdfa quantizer noise shaping
michael
parents: 1754
diff changeset
2106 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2107 * quantizer noise shaping
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2108 * - encoding: Set by user.
1777
d183026acdfa quantizer noise shaping
michael
parents: 1754
diff changeset
2109 * - decoding: unused
d183026acdfa quantizer noise shaping
michael
parents: 1754
diff changeset
2110 */
d183026acdfa quantizer noise shaping
michael
parents: 1754
diff changeset
2111 int quantizer_noise_shaping;
1799
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2112
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2113 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2114 * thread count
4588
fc155ff94878 cosmetics: Fix another common typo, dependAnt --> dependEnt.
diego
parents: 4583
diff changeset
2115 * is used to decide how many independent tasks should be passed to execute()
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2116 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2117 * - decoding: Set by user.
1799
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2118 */
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2119 int thread_count;
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2120
1799
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2121 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2122 * The codec may call this to execute several independent things.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2123 * It will return only after finishing all tasks.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2124 * The user may replace this with some multithreaded implementation,
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2125 * the default implementation will execute the parts serially.
1857
00a6bfc81010 count > thread_count for execute()
michael
parents: 1856
diff changeset
2126 * @param count the number of things to execute
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2127 * - encoding: Set by libavcodec, user can override.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2128 * - decoding: Set by libavcodec, user can override.
1799
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2129 */
8129
a9734fe0811e Making it easier to send arbitrary structures as work orders to MT workers
romansh
parents: 8119
diff changeset
2130 int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void *arg2, int *ret, int count, int size);
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2131
1799
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2132 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2133 * thread opaque
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2134 * Can be used by execute() to store some per AVCodecContext stuff.
1799
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2135 * - encoding: set by execute()
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2136 * - decoding: set by execute()
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2137 */
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
2138 void *thread_opaque;
1945
32f68745c431 passing AVFrame instead of AVPicture around in ffmpeg, that way stuff like motion vectors can be passed from the decoder to the encoder
michael
parents: 1934
diff changeset
2139
32f68745c431 passing AVFrame instead of AVPicture around in ffmpeg, that way stuff like motion vectors can be passed from the decoder to the encoder
michael
parents: 1934
diff changeset
2140 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2141 * Motion estimation threshold below which no motion estimation is
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2142 * performed, but instead the user specified motion vectors are used.
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2143 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2144 * - encoding: Set by user.
1968
19c2344e800a support reusing mb types and field select values of the source file, but use motion vectors just as additional predictors
michael
parents: 1950
diff changeset
2145 * - decoding: unused
1945
32f68745c431 passing AVFrame instead of AVPicture around in ffmpeg, that way stuff like motion vectors can be passed from the decoder to the encoder
michael
parents: 1934
diff changeset
2146 */
1950
a3c60fa850dc motion estimation cleanup
michael
parents: 1945
diff changeset
2147 int me_threshold;
1968
19c2344e800a support reusing mb types and field select values of the source file, but use motion vectors just as additional predictors
michael
parents: 1950
diff changeset
2148
19c2344e800a support reusing mb types and field select values of the source file, but use motion vectors just as additional predictors
michael
parents: 1950
diff changeset
2149 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2150 * Macroblock threshold below which the user specified macroblock types will be used.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2151 * - encoding: Set by user.
1968
19c2344e800a support reusing mb types and field select values of the source file, but use motion vectors just as additional predictors
michael
parents: 1950
diff changeset
2152 * - decoding: unused
19c2344e800a support reusing mb types and field select values of the source file, but use motion vectors just as additional predictors
michael
parents: 1950
diff changeset
2153 */
19c2344e800a support reusing mb types and field select values of the source file, but use motion vectors just as additional predictors
michael
parents: 1950
diff changeset
2154 int mb_threshold;
1992
938e47c809b0 intra_dc_precission>0 encoding support
michael
parents: 1968
diff changeset
2155
938e47c809b0 intra_dc_precission>0 encoding support
michael
parents: 1968
diff changeset
2156 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2157 * precision of the intra DC coefficient - 8
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2158 * - encoding: Set by user.
1992
938e47c809b0 intra_dc_precission>0 encoding support
michael
parents: 1968
diff changeset
2159 * - decoding: unused
938e47c809b0 intra_dc_precission>0 encoding support
michael
parents: 1968
diff changeset
2160 */
938e47c809b0 intra_dc_precission>0 encoding support
michael
parents: 1968
diff changeset
2161 int intra_dc_precision;
2066
4bfb146e701b nsse weight
michael
parents: 2065
diff changeset
2162
4bfb146e701b nsse weight
michael
parents: 2065
diff changeset
2163 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2164 * noise vs. sse weight for the nsse comparsion function
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2165 * - encoding: Set by user.
2066
4bfb146e701b nsse weight
michael
parents: 2065
diff changeset
2166 * - decoding: unused
4bfb146e701b nsse weight
michael
parents: 2065
diff changeset
2167 */
4bfb146e701b nsse weight
michael
parents: 2065
diff changeset
2168 int nsse_weight;
2095
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2169
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2170 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2171 * Number of macroblock rows at the top which are skipped.
2095
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2172 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2173 * - decoding: Set by user.
2095
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2174 */
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2175 int skip_top;
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2176
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2177 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2178 * Number of macroblock rows at the bottom which are skipped.
2095
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2179 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2180 * - decoding: Set by user.
2095
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2181 */
5ab35105671a support skiping of mb rows during decoding
michael
parents: 2091
diff changeset
2182 int skip_bottom;
2167
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2183
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2184 /**
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2185 * profile
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2186 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2187 * - decoding: Set by libavcodec.
2167
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2188 */
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2189 int profile;
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2190 #define FF_PROFILE_UNKNOWN -99
11047
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2191
4891
8cd8fd35b6aa add the possibility to choose aac profile
benoit
parents: 4890
diff changeset
2192 #define FF_PROFILE_AAC_MAIN 0
5590
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
2193 #define FF_PROFILE_AAC_LOW 1
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
2194 #define FF_PROFILE_AAC_SSR 2
027c48595fa1 prettyprinting cosmetics
diego
parents: 5576
diff changeset
2195 #define FF_PROFILE_AAC_LTP 3
2167
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2196
11047
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2197 #define FF_PROFILE_H264_BASELINE 66
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2198 #define FF_PROFILE_H264_MAIN 77
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2199 #define FF_PROFILE_H264_EXTENDED 88
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2200 #define FF_PROFILE_H264_HIGH 100
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2201 #define FF_PROFILE_H264_HIGH_10 110
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2202 #define FF_PROFILE_H264_HIGH_422 122
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2203 #define FF_PROFILE_H264_HIGH_444 244
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2204 #define FF_PROFILE_H264_CAVLC_444 44
ec682347e19e Export H264 profile and level in AVCodecContext.
cehoyos
parents: 10957
diff changeset
2205
2167
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2206 /**
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2207 * level
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2208 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2209 * - decoding: Set by libavcodec.
2167
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2210 */
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2211 int level;
76334bbb5038 user overrideable level & profile
michael
parents: 2154
diff changeset
2212 #define FF_LEVEL_UNKNOWN -99
2256
7e0b2e86afa9 1/2 resolution decoding
michael
parents: 2242
diff changeset
2213
7e0b2e86afa9 1/2 resolution decoding
michael
parents: 2242
diff changeset
2214 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2215 * low resolution decoding, 1-> 1/2 size, 2->1/4 size
2256
7e0b2e86afa9 1/2 resolution decoding
michael
parents: 2242
diff changeset
2216 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2217 * - decoding: Set by user.
2256
7e0b2e86afa9 1/2 resolution decoding
michael
parents: 2242
diff changeset
2218 */
7e0b2e86afa9 1/2 resolution decoding
michael
parents: 2242
diff changeset
2219 int lowres;
2270
21f450be6cb5 lowres width/height cleanup 3rd try
michael
parents: 2266
diff changeset
2220
21f450be6cb5 lowres width/height cleanup 3rd try
michael
parents: 2266
diff changeset
2221 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2222 * Bitstream width / height, may be different from width/height if lowres
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2223 * or other things are used.
2270
21f450be6cb5 lowres width/height cleanup 3rd try
michael
parents: 2266
diff changeset
2224 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2225 * - decoding: Set by user before init if known. Codec should override / dynamically change if needed.
2270
21f450be6cb5 lowres width/height cleanup 3rd try
michael
parents: 2266
diff changeset
2226 */
21f450be6cb5 lowres width/height cleanup 3rd try
michael
parents: 2266
diff changeset
2227 int coded_width, coded_height;
2381
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2228
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2229 /**
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2230 * frame skip threshold
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2231 * - encoding: Set by user.
2381
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2232 * - decoding: unused
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2233 */
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2234 int frame_skip_threshold;
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2235
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2236 /**
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2237 * frame skip factor
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2238 * - encoding: Set by user.
2381
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2239 * - decoding: unused
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2240 */
cfc9e0489859 frame skip support
michael
parents: 2373
diff changeset
2241 int frame_skip_factor;
2382
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2242
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2243 /**
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2244 * frame skip exponent
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2245 * - encoding: Set by user.
2382
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2246 * - decoding: unused
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2247 */
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2248 int frame_skip_exp;
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2249
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2250 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2251 * frame skip comparison function
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2252 * - encoding: Set by user.
2382
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2253 * - decoding: unused
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2254 */
23e7af611c34 more flexible frame skip decission
michael
parents: 2381
diff changeset
2255 int frame_skip_cmp;
2493
258120c61eea Border processing adaptive quant patch by (Christophe Massiot |cmassiot freebox fr)
michael
parents: 2492
diff changeset
2256
258120c61eea Border processing adaptive quant patch by (Christophe Massiot |cmassiot freebox fr)
michael
parents: 2492
diff changeset
2257 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2258 * Border processing masking, raises the quantizer for mbs on the borders
2493
258120c61eea Border processing adaptive quant patch by (Christophe Massiot |cmassiot freebox fr)
michael
parents: 2492
diff changeset
2259 * of the picture.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2260 * - encoding: Set by user.
2493
258120c61eea Border processing adaptive quant patch by (Christophe Massiot |cmassiot freebox fr)
michael
parents: 2492
diff changeset
2261 * - decoding: unused
258120c61eea Border processing adaptive quant patch by (Christophe Massiot |cmassiot freebox fr)
michael
parents: 2492
diff changeset
2262 */
258120c61eea Border processing adaptive quant patch by (Christophe Massiot |cmassiot freebox fr)
michael
parents: 2492
diff changeset
2263 float border_masking;
2494
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2264
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2265 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2266 * minimum MB lagrange multipler
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2267 * - encoding: Set by user.
2494
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2268 * - decoding: unused
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2269 */
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2270 int mb_lmin;
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2271
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2272 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2273 * maximum MB lagrange multipler
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2274 * - encoding: Set by user.
2494
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2275 * - decoding: unused
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2276 */
36d70fbb31c5 mb_lmin/max to limit the per mb quality for the ratecontrol independant from the frame limits
michael
parents: 2493
diff changeset
2277 int mb_lmax;
2584
c07be5590462 motion estimation bitrate penalty compensation
michael
parents: 2577
diff changeset
2278
c07be5590462 motion estimation bitrate penalty compensation
michael
parents: 2577
diff changeset
2279 /**
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2280 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2281 * - encoding: Set by user.
2584
c07be5590462 motion estimation bitrate penalty compensation
michael
parents: 2577
diff changeset
2282 * - decoding: unused
c07be5590462 motion estimation bitrate penalty compensation
michael
parents: 2577
diff changeset
2283 */
c07be5590462 motion estimation bitrate penalty compensation
michael
parents: 2577
diff changeset
2284 int me_penalty_compensation;
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2285
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2286 /**
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2287 *
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2288 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2289 * - decoding: Set by user.
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2290 */
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2291 enum AVDiscard skip_loop_filter;
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2292
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2293 /**
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2294 *
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2295 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2296 * - decoding: Set by user.
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2297 */
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2298 enum AVDiscard skip_idct;
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2299
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2300 /**
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
2301 *
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2302 * - encoding: unused
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2303 * - decoding: Set by user.
2792
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2304 */
0a8c847ad5e7 skip_idct
michael
parents: 2790
diff changeset
2305 enum AVDiscard skip_frame;
2983
9d7d2bb70fd6 bidir refine support
michael
parents: 2979
diff changeset
2306
9d7d2bb70fd6 bidir refine support
michael
parents: 2979
diff changeset
2307 /**
9d7d2bb70fd6 bidir refine support
michael
parents: 2979
diff changeset
2308 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2309 * - encoding: Set by user.
2983
9d7d2bb70fd6 bidir refine support
michael
parents: 2979
diff changeset
2310 * - decoding: unused
9d7d2bb70fd6 bidir refine support
michael
parents: 2979
diff changeset
2311 */
9d7d2bb70fd6 bidir refine support
michael
parents: 2979
diff changeset
2312 int bidir_refine;
2990
0300c2647bc3 support downscaling frames for dynamic b frame decission
michael
parents: 2983
diff changeset
2313
0300c2647bc3 support downscaling frames for dynamic b frame decission
michael
parents: 2983
diff changeset
2314 /**
0300c2647bc3 support downscaling frames for dynamic b frame decission
michael
parents: 2983
diff changeset
2315 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2316 * - encoding: Set by user.
2990
0300c2647bc3 support downscaling frames for dynamic b frame decission
michael
parents: 2983
diff changeset
2317 * - decoding: unused
0300c2647bc3 support downscaling frames for dynamic b frame decission
michael
parents: 2983
diff changeset
2318 */
0300c2647bc3 support downscaling frames for dynamic b frame decission
michael
parents: 2983
diff changeset
2319 int brd_scale;
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2320
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2321 /**
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2322 * constant rate factor - quality-based VBR - values ~correspond to qps
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2323 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2324 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2325 */
4030
ffe1b004ecc7 Make ffmpeg work with x264 r592
lu_zero
parents: 4013
diff changeset
2326 float crf;
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2327
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2328 /**
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2329 * constant quantization parameter rate control method
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2330 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2331 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2332 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2333 int cqp;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2334
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2335 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2336 * minimum GOP size
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2337 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2338 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2339 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2340 int keyint_min;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2341
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2342 /**
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2343 * number of reference frames
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2344 * - encoding: Set by user.
8455
aedda304862c Allow decoders to set AVCodecContext.refs.
michael
parents: 8410
diff changeset
2345 * - decoding: Set by lavc.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2346 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2347 int refs;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2348
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2349 /**
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2350 * chroma qp offset from luma
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2351 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2352 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2353 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2354 int chromaoffset;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2355
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2356 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2357 * Influences how often B-frames are used.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2358 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2359 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2360 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2361 int bframebias;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2362
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2363 /**
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2364 * trellis RD quantization
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2365 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2366 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2367 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2368 int trellis;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2369
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2370 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2371 * Reduce fluctuations in qp (before curve compression).
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2372 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2373 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2374 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2375 float complexityblur;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2376
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2377 /**
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2378 * in-loop deblocking filter alphac0 parameter
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2379 * alpha is in the range -6...6
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2380 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2381 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2382 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2383 int deblockalpha;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2384
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2385 /**
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2386 * in-loop deblocking filter beta parameter
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2387 * beta is in the range -6...6
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2388 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2389 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2390 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2391 int deblockbeta;
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2392
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2393 /**
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2394 * macroblock subpartition sizes to consider - p8x8, p4x4, b8x8, i8x8, i4x4
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2395 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2396 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2397 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2398 int partitions;
5967
15ed47af1838 Misc spelling fixes, prefer American over British English.
diego
parents: 5961
diff changeset
2399 #define X264_PART_I4X4 0x001 /* Analyze i4x4 */
15ed47af1838 Misc spelling fixes, prefer American over British English.
diego
parents: 5961
diff changeset
2400 #define X264_PART_I8X8 0x002 /* Analyze i8x8 (requires 8x8 transform) */
15ed47af1838 Misc spelling fixes, prefer American over British English.
diego
parents: 5961
diff changeset
2401 #define X264_PART_P8X8 0x010 /* Analyze p16x8, p8x16 and p8x8 */
15ed47af1838 Misc spelling fixes, prefer American over British English.
diego
parents: 5961
diff changeset
2402 #define X264_PART_P4X4 0x020 /* Analyze p8x4, p4x8, p4x4 */
15ed47af1838 Misc spelling fixes, prefer American over British English.
diego
parents: 5961
diff changeset
2403 #define X264_PART_B8X8 0x100 /* Analyze b16x8, b8x16 and b8x8 */
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2404
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2405 /**
7934
9daf67c7e880 Document the directpred auto value.
stefano
parents: 7927
diff changeset
2406 * direct MV prediction mode - 0 (none), 1 (spatial), 2 (temporal), 3 (auto)
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2407 * - encoding: Set by user.
2996
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2408 * - decoding: unused
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2409 */
bf34de4233a0 update x264 wrapper.
lorenm
parents: 2993
diff changeset
2410 int directpred;
3063
f02d0b59279c Remove all stray tabs and trailing whitespace, this time for good.
diego
parents: 3061
diff changeset
2411
3031
0f5f311f2f94 Parameter added for user to set the cutoff frequency when encoding with faac.
banan
parents: 3030
diff changeset
2412 /**
6083
77d27412c35d use cutoff frequency to adjust bandwidth in ac3 encoder
jbr
parents: 6073
diff changeset
2413 * Audio cutoff bandwidth (0 means "automatic")
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2414 * - encoding: Set by user.
3031
0f5f311f2f94 Parameter added for user to set the cutoff frequency when encoding with faac.
banan
parents: 3030
diff changeset
2415 * - decoding: unused
0f5f311f2f94 Parameter added for user to set the cutoff frequency when encoding with faac.
banan
parents: 3030
diff changeset
2416 */
0f5f311f2f94 Parameter added for user to set the cutoff frequency when encoding with faac.
banan
parents: 3030
diff changeset
2417 int cutoff;
3061
259fed5adf5d sc_factor support for encoding.
corey
parents: 3039
diff changeset
2418
259fed5adf5d sc_factor support for encoding.
corey
parents: 3039
diff changeset
2419 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2420 * Multiplied by qscale for each frame and added to scene_change_score.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2421 * - encoding: Set by user.
3061
259fed5adf5d sc_factor support for encoding.
corey
parents: 3039
diff changeset
2422 * - decoding: unused
259fed5adf5d sc_factor support for encoding.
corey
parents: 3039
diff changeset
2423 */
259fed5adf5d sc_factor support for encoding.
corey
parents: 3039
diff changeset
2424 int scenechange_factor;
3293
f1bcb9ae510b make zero motion vector threshold user setable
michael
parents: 3257
diff changeset
2425
f1bcb9ae510b make zero motion vector threshold user setable
michael
parents: 3257
diff changeset
2426 /**
f1bcb9ae510b make zero motion vector threshold user setable
michael
parents: 3257
diff changeset
2427 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2428 * Note: Value depends upon the compare function used for fullpel ME.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2429 * - encoding: Set by user.
3293
f1bcb9ae510b make zero motion vector threshold user setable
michael
parents: 3257
diff changeset
2430 * - decoding: unused
f1bcb9ae510b make zero motion vector threshold user setable
michael
parents: 3257
diff changeset
2431 */
f1bcb9ae510b make zero motion vector threshold user setable
michael
parents: 3257
diff changeset
2432 int mv0_threshold;
3335
97af1b315f59 Make B-frame reduction sensitivity by b_strategy/vb_strategy = 1
corey
parents: 3329
diff changeset
2433
97af1b315f59 Make B-frame reduction sensitivity by b_strategy/vb_strategy = 1
corey
parents: 3329
diff changeset
2434 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2435 * Adjusts sensitivity of b_frame_strategy 1.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2436 * - encoding: Set by user.
3335
97af1b315f59 Make B-frame reduction sensitivity by b_strategy/vb_strategy = 1
corey
parents: 3329
diff changeset
2437 * - decoding: unused
97af1b315f59 Make B-frame reduction sensitivity by b_strategy/vb_strategy = 1
corey
parents: 3329
diff changeset
2438 */
97af1b315f59 Make B-frame reduction sensitivity by b_strategy/vb_strategy = 1
corey
parents: 3329
diff changeset
2439 int b_sensitivity;
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2440
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2441 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2442 * - encoding: Set by user.
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2443 * - decoding: unused
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2444 */
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2445 int compression_level;
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2446 #define FF_COMPRESSION_DEFAULT -1
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2447
12139
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2448 #if LIBAVCODEC_VERSION_MAJOR < 53
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2449 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2450 * Sets whether to use LPC mode - used by FLAC encoder.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2451 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2452 * - decoding: unused
12139
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2453 * @deprecated Deprecated in favor of lpc_type and lpc_passes.
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2454 */
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2455 int use_lpc;
12139
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2456 #endif
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2457
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2458 /**
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2459 * LPC coefficient precision - used by FLAC encoder
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2460 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2461 * - decoding: unused
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2462 */
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2463 int lpc_coeff_precision;
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2464
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2465 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2466 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2467 * - decoding: unused
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2468 */
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2469 int min_prediction_order;
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2470
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2471 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2472 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2473 * - decoding: unused
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2474 */
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2475 int max_prediction_order;
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2476
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2477 /**
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2478 * search method for selecting prediction order
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2479 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2480 * - decoding: unused
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2481 */
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2482 int prediction_order_method;
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2483
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2484 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2485 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2486 * - decoding: unused
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2487 */
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2488 int min_partition_order;
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2489
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2490 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2491 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2492 * - decoding: unused
3385
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2493 */
340e5d35b326 flac-lpc patch by (Justin Ruggles jruggle earthlink net)
michael
parents: 3359
diff changeset
2494 int max_partition_order;
4158
47d1b5261f17 add option to set mpeg1/2 gop timecode start, and drop frame flag timecode flag
bcoudurier
parents: 4154
diff changeset
2495
47d1b5261f17 add option to set mpeg1/2 gop timecode start, and drop frame flag timecode flag
bcoudurier
parents: 4154
diff changeset
2496 /**
47d1b5261f17 add option to set mpeg1/2 gop timecode start, and drop frame flag timecode flag
bcoudurier
parents: 4154
diff changeset
2497 * GOP timecode frame start number, in non drop frame format
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2498 * - encoding: Set by user.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2499 * - decoding: unused
4158
47d1b5261f17 add option to set mpeg1/2 gop timecode start, and drop frame flag timecode flag
bcoudurier
parents: 4154
diff changeset
2500 */
47d1b5261f17 add option to set mpeg1/2 gop timecode start, and drop frame flag timecode flag
bcoudurier
parents: 4154
diff changeset
2501 int64_t timecode_frame_start;
5576
1a92e129a679 Add request_channels member to AVCodecContext so we now have a proper
reimar
parents: 5566
diff changeset
2502
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2503 #if LIBAVCODEC_VERSION_MAJOR < 53
5576
1a92e129a679 Add request_channels member to AVCodecContext so we now have a proper
reimar
parents: 5566
diff changeset
2504 /**
9578
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
2505 * Decoder should decode to this many channels if it can (0 for default)
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
2506 * - encoding: unused
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
2507 * - decoding: Set by user.
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2508 * @deprecated Deprecated in favor of request_channel_layout.
5576
1a92e129a679 Add request_channels member to AVCodecContext so we now have a proper
reimar
parents: 5566
diff changeset
2509 */
1a92e129a679 Add request_channels member to AVCodecContext so we now have a proper
reimar
parents: 5566
diff changeset
2510 int request_channels;
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2511 #endif
6047
2f9c17454842 Add option for user to scale the amount of dynamic range compression which is
jbr
parents: 6044
diff changeset
2512
2f9c17454842 Add option for user to scale the amount of dynamic range compression which is
jbr
parents: 6044
diff changeset
2513 /**
2f9c17454842 Add option for user to scale the amount of dynamic range compression which is
jbr
parents: 6044
diff changeset
2514 * Percentage of dynamic range compression to be applied by the decoder.
2f9c17454842 Add option for user to scale the amount of dynamic range compression which is
jbr
parents: 6044
diff changeset
2515 * The default value is 1.0, corresponding to full compression.
2f9c17454842 Add option for user to scale the amount of dynamic range compression which is
jbr
parents: 6044
diff changeset
2516 * - encoding: unused
2f9c17454842 Add option for user to scale the amount of dynamic range compression which is
jbr
parents: 6044
diff changeset
2517 * - decoding: Set by user.
2f9c17454842 Add option for user to scale the amount of dynamic range compression which is
jbr
parents: 6044
diff changeset
2518 */
2f9c17454842 Add option for user to scale the amount of dynamic range compression which is
jbr
parents: 6044
diff changeset
2519 float drc_scale;
7631
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
2520
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
2521 /**
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
2522 * opaque 64bit number (generally a PTS) that will be reordered and
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
2523 * output in AVFrame.reordered_opaque
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
2524 * - encoding: unused
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
2525 * - decoding: Set by user.
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
2526 */
b5b4bf0944b8 Provide a simpler way for the user to reorder her timestamps.
michael
parents: 7621
diff changeset
2527 int64_t reordered_opaque;
7721
198421b7dbc0 Add AVCodecContext.bits_per_raw_sample field.
pross
parents: 7720
diff changeset
2528
198421b7dbc0 Add AVCodecContext.bits_per_raw_sample field.
pross
parents: 7720
diff changeset
2529 /**
198421b7dbc0 Add AVCodecContext.bits_per_raw_sample field.
pross
parents: 7720
diff changeset
2530 * Bits per sample/pixel of internal libavcodec pixel/sample format.
198421b7dbc0 Add AVCodecContext.bits_per_raw_sample field.
pross
parents: 7720
diff changeset
2531 * This field is applicable only when sample_fmt is SAMPLE_FMT_S32.
198421b7dbc0 Add AVCodecContext.bits_per_raw_sample field.
pross
parents: 7720
diff changeset
2532 * - encoding: set by user.
198421b7dbc0 Add AVCodecContext.bits_per_raw_sample field.
pross
parents: 7720
diff changeset
2533 * - decoding: set by libavcodec.
198421b7dbc0 Add AVCodecContext.bits_per_raw_sample field.
pross
parents: 7720
diff changeset
2534 */
198421b7dbc0 Add AVCodecContext.bits_per_raw_sample field.
pross
parents: 7720
diff changeset
2535 int bits_per_raw_sample;
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2536
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2537 /**
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2538 * Audio channel layout.
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2539 * - encoding: set by user.
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2540 * - decoding: set by libavcodec.
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2541 */
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2542 int64_t channel_layout;
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2543
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2544 /**
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2545 * Request decoder to use this channel layout if it can (0 for default)
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2546 * - encoding: unused
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2547 * - decoding: Set by user.
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2548 */
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2549 int64_t request_channel_layout;
8227
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2550
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2551 /**
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2552 * Ratecontrol attempt to use, at maximum, <value> of what can be used without an underflow.
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2553 * - encoding: Set by user.
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2554 * - decoding: unused.
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2555 */
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2556 float rc_max_available_vbv_use;
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2557
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2558 /**
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2559 * Ratecontrol attempt to use, at least, <value> times the amount needed to prevent a vbv overflow.
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2560 * - encoding: Set by user.
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2561 * - decoding: unused.
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2562 */
596677256482 Implement the fields rc_max_available_vbv_use and
stefano
parents: 8129
diff changeset
2563 float rc_min_vbv_overflow_use;
9012
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2564
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2565 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2566 * Hardware accelerator in use
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2567 * - encoding: unused.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2568 * - decoding: Set by libavcodec
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2569 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2570 struct AVHWAccel *hwaccel;
9059
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2571
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2572 /**
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2573 * For some codecs, the time base is closer to the field rate than the frame rate.
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2574 * Most notably, H.264 and MPEG-2 specify time_base as half of frame duration
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2575 * if no telecine is used ...
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2576 *
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2577 * Set to time_base ticks per frame. Default 1, e.g., H.264/MPEG-2 set it to 2.
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2578 */
3c5920f57063 Add ticks_per_frame, this should hopefully fix the regressions caused
michael
parents: 9050
diff changeset
2579 int ticks_per_frame;
9182
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2580
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2581 /**
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2582 * Hardware accelerator context.
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2583 * For some hardware accelerators, a global context needs to be
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2584 * provided by the user. In that case, this holds display-dependent
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2585 * data FFmpeg cannot instantiate itself. Please refer to the
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2586 * FFmpeg HW accelerator documentation to know how to fill this
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2587 * is. e.g. for VA API, this is a struct vaapi_context.
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2588 * - encoding: unused
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2589 * - decoding: Set by user
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2590 */
12f23f37664b Amend AVCodecContext with hwaccel_context (HW accelerator context).
gb
parents: 9161
diff changeset
2591 void *hwaccel_context;
9600
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2592
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2593 /**
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2594 * Chromaticity coordinates of the source primaries.
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2595 * - encoding: Set by user
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2596 * - decoding: Set by libavcodec
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2597 */
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2598 enum AVColorPrimaries color_primaries;
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2599
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2600 /**
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2601 * Color Transfer Characteristic.
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2602 * - encoding: Set by user
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2603 * - decoding: Set by libavcodec
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2604 */
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2605 enum AVColorTransferCharacteristic color_trc;
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2606
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2607 /**
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2608 * YUV colorspace type.
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2609 * - encoding: Set by user
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2610 * - decoding: Set by libavcodec
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2611 */
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2612 enum AVColorSpace colorspace;
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2613
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2614 /**
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2615 * MPEG vs JPEG YUV range.
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2616 * - encoding: Set by user
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2617 * - decoding: Set by libavcodec
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2618 */
b59a8ed50f36 Add colorspace fields to AVCodecContext.
michael
parents: 9584
diff changeset
2619 enum AVColorRange color_range;
9626
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
2620
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
2621 /**
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
2622 * This defines the location of chroma samples.
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
2623 * - encoding: Set by user
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
2624 * - decoding: Set by libavcodec
bd3e11b60ccd Add a chroma_sample_location field to define positioning of chroma samples
conrad
parents: 9616
diff changeset
2625 */
10318
6a21c6ca346f Fix indentation in avcodec.h
darkshikari
parents: 10226
diff changeset
2626 enum AVChromaLocation chroma_sample_location;
10386
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2627
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2628 /**
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2629 * The codec may call this to execute several independent things.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2630 * It will return only after finishing all tasks.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2631 * The user may replace this with some multithreaded implementation,
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2632 * the default implementation will execute the parts serially.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2633 * Also see avcodec_thread_init and e.g. the --enable-pthread configure option.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2634 * @param c context passed also to func
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2635 * @param count the number of things to execute
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2636 * @param arg2 argument passed unchanged to func
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2637 * @param ret return values of executed functions, must have space for "count" values. May be NULL.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2638 * @param func function that will be called count times, with jobnr from 0 to count-1.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2639 * threadnr will be in the range 0 to c->thread_count-1 < MAX_THREADS and so that no
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2640 * two instances of func executing at the same time will have the same threadnr.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2641 * @return always 0 currently, but code should handle a future improvement where when any call to func
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2642 * returns < 0 no further calls to func may be done and < 0 is returned.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2643 * - encoding: Set by libavcodec, user can override.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2644 * - decoding: Set by libavcodec, user can override.
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2645 */
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
2646 int (*execute2)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg, int jobnr, int threadnr), void *arg2, int *ret, int count);
10566
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2647
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2648 /**
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2649 * explicit P-frame weighted prediction analysis method
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2650 * 0: off
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2651 * 1: fast blind weighting (one reference duplicate with -1 offset)
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2652 * 2: smart weighting (full fade detection analysis)
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2653 * - encoding: Set by user.
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2654 * - decoding: unused
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2655 */
7ca185b4bc42 Add weightp support in API for libx264.
darkshikari
parents: 10547
diff changeset
2656 int weighted_p_pred;
11538
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2657
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2658 /**
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2659 * AQ mode
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2660 * 0: Disabled
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2661 * 1: Variance AQ (complexity mask)
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2662 * 2: Auto-variance AQ (experimental)
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2663 * - encoding: Set by user
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2664 * - decoding: unused
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2665 */
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2666 int aq_mode;
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2667
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2668 /**
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2669 * AQ strength
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2670 * Reduces blocking and blurring in flat and textured areas.
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2671 * - encoding: Set by user
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2672 * - decoding: unused
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2673 */
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2674 float aq_strength;
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2675
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2676 /**
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2677 * PSY RD
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2678 * Strength of psychovisual optimization
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2679 * - encoding: Set by user
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2680 * - decoding: unused
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2681 */
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2682 float psy_rd;
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2683
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2684 /**
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2685 * PSY trellis
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2686 * Strength of psychovisual optimization
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2687 * - encoding: Set by user
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2688 * - decoding: unused
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2689 */
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2690 float psy_trellis;
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2691
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2692 /**
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2693 * RC lookahead
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2694 * Number of frames for frametype and ratecontrol lookahead
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2695 * - encoding: Set by user
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2696 * - decoding: unused
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2697 */
9beb570426f4 Enable more libx264 options, aq, psy, rc lookahead and ssim
bcoudurier
parents: 11536
diff changeset
2698 int rc_lookahead;
11689
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2699
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2700 /**
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2701 * Constant rate factor maximum
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2702 * With CRF encoding mode and VBV restrictions enabled, prevents quality from being worse
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2703 * than crf_max, even if doing so would violate VBV restrictions.
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2704 * - encoding: Set by user.
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2705 * - decoding: unused
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2706 */
2312dfbe9251 Add intra refresh and crf-max support to the libavcodec libx264 wrapper.
darkshikari
parents: 11674
diff changeset
2707 float crf_max;
11741
872971445121 Add log_level_offset to AVCodecContext.
stefano
parents: 11739
diff changeset
2708
872971445121 Add log_level_offset to AVCodecContext.
stefano
parents: 11739
diff changeset
2709 int log_level_offset;
12139
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2710
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2711 /**
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2712 * Determines which LPC analysis algorithm to use.
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2713 * - encoding: Set by user
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2714 * - decoding: unused
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2715 */
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2716 enum AVLPCType lpc_type;
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2717
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2718 /**
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2719 * Number of passes to use for Cholesky factorization during LPC analysis
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2720 * - encoding: Set by user
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2721 * - decoding: unused
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2722 */
e59926e2c50c Add AVCodecContext.lpc_type and Add AVCodecContext.lpc_passes fields.
jbr
parents: 12134
diff changeset
2723 int lpc_passes;
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2724 } AVCodecContext;
986e461dc072 Initial revision
glantau
parents:
diff changeset
2725
1112
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
2726 /**
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
2727 * AVCodec.
54be6aece1be more cosmetics so that doxygen output is readable ...
michaelni
parents: 1105
diff changeset
2728 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2729 typedef struct AVCodec {
5139
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
2730 /**
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
2731 * Name of the codec implementation.
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
2732 * The name is globally unique among encoders and among decoders (but an
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
2733 * encoder and a decoder can share the same name).
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
2734 * This is the primary way to find a codec from the user perspective.
f3d9859953c1 More detailed documentation
benoit
parents: 5137
diff changeset
2735 */
862
058194d7ade6 * fixing some minor const warnings
kabi
parents: 849
diff changeset
2736 const char *name;
11560
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
2737 enum AVMediaType type;
2322
4140f2e78ebc type fix
michael
parents: 2319
diff changeset
2738 enum CodecID id;
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2739 int priv_data_size;
986e461dc072 Initial revision
glantau
parents:
diff changeset
2740 int (*init)(AVCodecContext *);
1064
b32afefe7d33 * UINTX -> uintx_t INTX -> intx_t
kabi
parents: 1058
diff changeset
2741 int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2742 int (*close)(AVCodecContext *);
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
2743 int (*decode)(AVCodecContext *, void *outdata, int *outdata_size, AVPacket *avpkt);
6520
c7b922e9477e Document AVCodec.capabilities.
michael
parents: 6518
diff changeset
2744 /**
c7b922e9477e Document AVCodec.capabilities.
michael
parents: 6518
diff changeset
2745 * Codec capabilities.
c7b922e9477e Document AVCodec.capabilities.
michael
parents: 6518
diff changeset
2746 * see CODEC_CAP_*
c7b922e9477e Document AVCodec.capabilities.
michael
parents: 6518
diff changeset
2747 */
67
cdd89f96cbe1 added draw_horiz_band test
glantau
parents: 49
diff changeset
2748 int capabilities;
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2749 struct AVCodec *next;
6521
bac421a6c4da Document AVCodec.flush()
michael
parents: 6520
diff changeset
2750 /**
bac421a6c4da Document AVCodec.flush()
michael
parents: 6520
diff changeset
2751 * Flush buffers.
bac421a6c4da Document AVCodec.flush()
michael
parents: 6520
diff changeset
2752 * Will be called when seeking
bac421a6c4da Document AVCodec.flush()
michael
parents: 6520
diff changeset
2753 */
1368
0fd38b711f06 AVCodec.flush()
michaelni
parents: 1353
diff changeset
2754 void (*flush)(AVCodecContext *);
6629
74bbf65fd0cd Make two comments doxygen compatible.
benoit
parents: 6628
diff changeset
2755 const AVRational *supported_framerates; ///< array of supported framerates, or NULL if any, array is terminated by {0,0}
6630
b3b9616561cc fix a typo
benoit
parents: 6629
diff changeset
2756 const enum PixelFormat *pix_fmts; ///< array of supported pixel formats, or NULL if unknown, array is terminated by -1
7040
e943e1409077 Make AVCodec long_names definition conditional depending on CONFIG_SMALL.
stefano
parents: 7034
diff changeset
2757 /**
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
2758 * Descriptive name for the codec, meant to be more human readable than name.
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
2759 * You should use the NULL_IF_CONFIG_SMALL() macro to define it.
7040
e943e1409077 Make AVCodec long_names definition conditional depending on CONFIG_SMALL.
stefano
parents: 7034
diff changeset
2760 */
e943e1409077 Make AVCodec long_names definition conditional depending on CONFIG_SMALL.
stefano
parents: 7034
diff changeset
2761 const char *long_name;
6664
646a886bafe2 Add supported_samplerates field to AVCodec
superdump
parents: 6630
diff changeset
2762 const int *supported_samplerates; ///< array of supported audio samplerates, or NULL if unknown, array is terminated by 0
7410
4c68f77c49ee add sample_fmts infrastructure: AVCodec->sample_fmts and SAMPLE_FMT_NB enum.
pross
parents: 7409
diff changeset
2763 const enum SampleFormat *sample_fmts; ///< array of supported sample formats, or NULL if unknown, array is terminated by -1
8098
c2ab7a8958ed Add audio channel layout API to libavcodec.
pross
parents: 8045
diff changeset
2764 const int64_t *channel_layouts; ///< array of support channel layouts, or NULL if unknown. array is terminated by 0
12108
c35d7bc64882 Add new decoder property max_lowres and do not init decoder if requested value is higher.
cehoyos
parents: 12084
diff changeset
2765 uint8_t max_lowres; ///< maximum value for lowres supported by the decoder
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2766 } AVCodec;
986e461dc072 Initial revision
glantau
parents:
diff changeset
2767
1058
3c3da6edc9a1 * still unfinished code for Options
kabi
parents: 1055
diff changeset
2768 /**
9012
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2769 * AVHWAccel.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2770 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2771 typedef struct AVHWAccel {
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2772 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2773 * Name of the hardware accelerated codec.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2774 * The name is globally unique among encoders and among decoders (but an
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2775 * encoder and a decoder can share the same name).
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2776 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2777 const char *name;
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2778
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2779 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2780 * Type of codec implemented by the hardware accelerator.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2781 *
11560
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
2782 * See AVMEDIA_TYPE_xxx
9012
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2783 */
11560
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
2784 enum AVMediaType type;
9012
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2785
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2786 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2787 * Codec implemented by the hardware accelerator.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2788 *
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2789 * See CODEC_ID_xxx
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2790 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2791 enum CodecID id;
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2792
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2793 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2794 * Supported pixel format.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2795 *
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2796 * Only hardware accelerated formats are supported here.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2797 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2798 enum PixelFormat pix_fmt;
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2799
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2800 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2801 * Hardware accelerated codec capabilities.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2802 * see FF_HWACCEL_CODEC_CAP_*
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2803 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2804 int capabilities;
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2805
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2806 struct AVHWAccel *next;
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2807
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2808 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2809 * Called at the beginning of each frame or field picture.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2810 *
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2811 * Meaningful frame information (codec specific) is guaranteed to
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2812 * be parsed at this point. This function is mandatory.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2813 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
2814 * Note that buf can be NULL along with buf_size set to 0.
9012
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2815 * Otherwise, this means the whole frame is available at this point.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2816 *
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2817 * @param avctx the codec context
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2818 * @param buf the frame data buffer base
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2819 * @param buf_size the size of the frame in bytes
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2820 * @return zero if successful, a negative value otherwise
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2821 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2822 int (*start_frame)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size);
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2823
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2824 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2825 * Callback for each slice.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2826 *
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2827 * Meaningful slice information (codec specific) is guaranteed to
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2828 * be parsed at this point. This function is mandatory.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2829 *
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2830 * @param avctx the codec context
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2831 * @param buf the slice data buffer base
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2832 * @param buf_size the size of the slice in bytes
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2833 * @return zero if successful, a negative value otherwise
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2834 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2835 int (*decode_slice)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size);
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2836
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2837 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2838 * Called at the end of each frame or field picture.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2839 *
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2840 * The whole picture is parsed at this point and can now be sent
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2841 * to the hardware accelerator. This function is mandatory.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2842 *
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2843 * @param avctx the codec context
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2844 * @return zero if successful, a negative value otherwise
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2845 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2846 int (*end_frame)(AVCodecContext *avctx);
9155
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
2847
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
2848 /**
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
2849 * Size of HW accelerator private data.
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
2850 *
9161
3a54ad453dbf Use av_mallocz() to initialize hwaccel_data_private.
gb
parents: 9155
diff changeset
2851 * Private data is allocated with av_mallocz() before
3a54ad453dbf Use av_mallocz() to initialize hwaccel_data_private.
gb
parents: 9155
diff changeset
2852 * AVCodecContext.get_buffer() and deallocated after
3a54ad453dbf Use av_mallocz() to initialize hwaccel_data_private.
gb
parents: 9155
diff changeset
2853 * AVCodecContext.release_buffer().
9155
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
2854 */
9e66ada64b76 Add private HW accel data infrastructure.
gb
parents: 9152
diff changeset
2855 int priv_data_size;
9012
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2856 } AVHWAccel;
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2857
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
2858 /**
842
e460775adb38 cleanup (breaks compatibility, requested by fabrice)
michaelni
parents: 831
diff changeset
2859 * four components are given, that's all.
e460775adb38 cleanup (breaks compatibility, requested by fabrice)
michaelni
parents: 831
diff changeset
2860 * the last component is alpha
e460775adb38 cleanup (breaks compatibility, requested by fabrice)
michaelni
parents: 831
diff changeset
2861 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2862 typedef struct AVPicture {
1064
b32afefe7d33 * UINTX -> uintx_t INTX -> intx_t
kabi
parents: 1058
diff changeset
2863 uint8_t *data[4];
1299
9c3bfa79631f more comments
michaelni
parents: 1297
diff changeset
2864 int linesize[4]; ///< number of bytes per line
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2865 } AVPicture;
986e461dc072 Initial revision
glantau
parents:
diff changeset
2866
12449
3bca212d6f51 add FF_API_PALETTE_CONTROL define to drop usage of AVPaletteControl
aurel
parents: 12425
diff changeset
2867 #if FF_API_PALETTE_CONTROL
1462
eabd6b8f83ed deploy palette control API
tmmm
parents: 1461
diff changeset
2868 /**
9578
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
2869 * AVPaletteControl
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
2870 * This structure defines a method for communicating palette changes
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
2871 * between and demuxer and a decoder.
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
2872 *
4889
beeb03aad909 patch so that the deprecated items show up correctly
benoit
parents: 4884
diff changeset
2873 * @deprecated Use AVPacket to send palette changes instead.
9578
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
2874 * This is totally broken.
1462
eabd6b8f83ed deploy palette control API
tmmm
parents: 1461
diff changeset
2875 */
1594
6d37b161cf85 Fix some palette related defines, bump build number
rtognimp
parents: 1585
diff changeset
2876 #define AVPALETTE_SIZE 1024
1596
c1d5491f144a 10l ...
michael
parents: 1594
diff changeset
2877 #define AVPALETTE_COUNT 256
1462
eabd6b8f83ed deploy palette control API
tmmm
parents: 1461
diff changeset
2878 typedef struct AVPaletteControl {
eabd6b8f83ed deploy palette control API
tmmm
parents: 1461
diff changeset
2879
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2880 /* Demuxer sets this to 1 to indicate the palette has changed;
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2881 * decoder resets to 0. */
1462
eabd6b8f83ed deploy palette control API
tmmm
parents: 1461
diff changeset
2882 int palette_changed;
eabd6b8f83ed deploy palette control API
tmmm
parents: 1461
diff changeset
2883
1585
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
2884 /* 4-byte ARGB palette entries, stored in native byte order; note that
6b224ca24033 revised palette API, courtesy of Roberto Togni (rtogni at freemail.it)
melanson
parents: 1582
diff changeset
2885 * the individual palette components should be on a 8-bit scale; if
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2886 * the palette data comes from an IBM VGA native format, the component
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
2887 * data is probably 6 bits in size and needs to be scaled. */
1594
6d37b161cf85 Fix some palette related defines, bump build number
rtognimp
parents: 1585
diff changeset
2888 unsigned int palette[AVPALETTE_COUNT];
1462
eabd6b8f83ed deploy palette control API
tmmm
parents: 1461
diff changeset
2889
3797
0596dbc4f858 marking AVPaletteControl as deprecated due to thread saftey amongth other issues (it doesnt work if theres any delay between demuxer and decoder)
michael
parents: 3772
diff changeset
2890 } AVPaletteControl attribute_deprecated;
9218
18dffa8f2382 Remove deprecated functions and structures on next version bump.
diego
parents: 9217
diff changeset
2891 #endif
1462
eabd6b8f83ed deploy palette control API
tmmm
parents: 1461
diff changeset
2892
8511
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2893 enum AVSubtitleType {
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2894 SUBTITLE_NONE,
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2895
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2896 SUBTITLE_BITMAP, ///< A bitmap, pict will be set
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2897
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2898 /**
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2899 * Plain text, the text field must be set by the decoder and is
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2900 * authoritative. ass and pict fields may contain approximations.
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2901 */
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2902 SUBTITLE_TEXT,
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2903
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2904 /**
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2905 * Formatted text, the ass field must be set by the decoder and is
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2906 * authoritative. pict and text fields may contain approximations.
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2907 */
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2908 SUBTITLE_ASS,
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2909 };
531ddfe8a832 Add enum AVSubtitleType
michael
parents: 8493
diff changeset
2910
2796
95c35706acbb DVB subtitle decoder by (Ian Caulfield: imc25, cam ac uk)
michael
parents: 2794
diff changeset
2911 typedef struct AVSubtitleRect {
8515
45506d633cdc Replace some fixed width variable from AVSubtitle* by normal int.
michael
parents: 8513
diff changeset
2912 int x; ///< top left corner of pict, undefined when pict is not set
45506d633cdc Replace some fixed width variable from AVSubtitle* by normal int.
michael
parents: 8513
diff changeset
2913 int y; ///< top left corner of pict, undefined when pict is not set
45506d633cdc Replace some fixed width variable from AVSubtitle* by normal int.
michael
parents: 8513
diff changeset
2914 int w; ///< width of pict, undefined when pict is not set
45506d633cdc Replace some fixed width variable from AVSubtitle* by normal int.
michael
parents: 8513
diff changeset
2915 int h; ///< height of pict, undefined when pict is not set
45506d633cdc Replace some fixed width variable from AVSubtitle* by normal int.
michael
parents: 8513
diff changeset
2916 int nb_colors; ///< number of colors in pict, undefined when pict is not set
8516
315b302fcd1d Replace AVSubtitleRect.rgba_palette and bitmap by AVPicture.
michael
parents: 8515
diff changeset
2917
315b302fcd1d Replace AVSubtitleRect.rgba_palette and bitmap by AVPicture.
michael
parents: 8515
diff changeset
2918 /**
315b302fcd1d Replace AVSubtitleRect.rgba_palette and bitmap by AVPicture.
michael
parents: 8515
diff changeset
2919 * data+linesize for the bitmap of this subtitle.
315b302fcd1d Replace AVSubtitleRect.rgba_palette and bitmap by AVPicture.
michael
parents: 8515
diff changeset
2920 * can be set for text/ass as well once they where rendered
315b302fcd1d Replace AVSubtitleRect.rgba_palette and bitmap by AVPicture.
michael
parents: 8515
diff changeset
2921 */
315b302fcd1d Replace AVSubtitleRect.rgba_palette and bitmap by AVPicture.
michael
parents: 8515
diff changeset
2922 AVPicture pict;
8517
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2923 enum AVSubtitleType type;
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2924
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2925 char *text; ///< 0 terminated plain UTF-8 text
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2926
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2927 /**
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2928 * 0 terminated ASS/SSA compatible event line.
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2929 * The pressentation of this is unaffected by the other values in this
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2930 * struct.
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2931 */
7e6cf3ff61d3 Add type, text and ass to AVSubtitleRect.
michael
parents: 8516
diff changeset
2932 char *ass;
2796
95c35706acbb DVB subtitle decoder by (Ian Caulfield: imc25, cam ac uk)
michael
parents: 2794
diff changeset
2933 } AVSubtitleRect;
95c35706acbb DVB subtitle decoder by (Ian Caulfield: imc25, cam ac uk)
michael
parents: 2794
diff changeset
2934
95c35706acbb DVB subtitle decoder by (Ian Caulfield: imc25, cam ac uk)
michael
parents: 2794
diff changeset
2935 typedef struct AVSubtitle {
95c35706acbb DVB subtitle decoder by (Ian Caulfield: imc25, cam ac uk)
michael
parents: 2794
diff changeset
2936 uint16_t format; /* 0 = graphics */
95c35706acbb DVB subtitle decoder by (Ian Caulfield: imc25, cam ac uk)
michael
parents: 2794
diff changeset
2937 uint32_t start_display_time; /* relative to packet pts, in ms */
95c35706acbb DVB subtitle decoder by (Ian Caulfield: imc25, cam ac uk)
michael
parents: 2794
diff changeset
2938 uint32_t end_display_time; /* relative to packet pts, in ms */
8515
45506d633cdc Replace some fixed width variable from AVSubtitle* by normal int.
michael
parents: 8513
diff changeset
2939 unsigned num_rects;
8512
aa45029f5cd7 Change AVSubtitle.rects to an array of pointers so ABI does not break
michael
parents: 8511
diff changeset
2940 AVSubtitleRect **rects;
9866
876dc7d26ec1 Add pts field to AVSubtitle, for use by future XSUB encoder (and XSUB decoder
reimar
parents: 9848
diff changeset
2941 int64_t pts; ///< Same as packet pts, in AV_TIME_BASE
2756
d8874c8749ec subtitle codec type support
bellard
parents: 2734
diff changeset
2942 } AVSubtitle;
d8874c8749ec subtitle codec type support
bellard
parents: 2734
diff changeset
2943
9357
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2944 /* packet functions */
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2945
9394
d322325fc00e Get rid of av_destruct_packet_nofree and use NULL instead.
reimar
parents: 9360
diff changeset
2946 /**
d322325fc00e Get rid of av_destruct_packet_nofree and use NULL instead.
reimar
parents: 9360
diff changeset
2947 * @deprecated use NULL instead
d322325fc00e Get rid of av_destruct_packet_nofree and use NULL instead.
reimar
parents: 9360
diff changeset
2948 */
d322325fc00e Get rid of av_destruct_packet_nofree and use NULL instead.
reimar
parents: 9360
diff changeset
2949 attribute_deprecated void av_destruct_packet_nofree(AVPacket *pkt);
9357
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2950
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2951 /**
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2952 * Default packet destructor.
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2953 */
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2954 void av_destruct_packet(AVPacket *pkt);
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2955
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2956 /**
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2957 * Initialize optional fields of a packet with default values.
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2958 *
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2959 * @param pkt packet
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2960 */
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2961 void av_init_packet(AVPacket *pkt);
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2962
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2963 /**
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2964 * Allocate the payload of a packet and initialize its fields with
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2965 * default values.
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2966 *
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2967 * @param pkt packet
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2968 * @param size wanted payload size
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2969 * @return 0 if OK, AVERROR_xxx otherwise
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2970 */
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2971 int av_new_packet(AVPacket *pkt, int size);
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2972
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2973 /**
9360
66e270967340 Add av_shrink_packet function for use in av_get_packet that reduces pkt->size
reimar
parents: 9359
diff changeset
2974 * Reduce packet size, correctly zeroing padding
66e270967340 Add av_shrink_packet function for use in av_get_packet that reduces pkt->size
reimar
parents: 9359
diff changeset
2975 *
66e270967340 Add av_shrink_packet function for use in av_get_packet that reduces pkt->size
reimar
parents: 9359
diff changeset
2976 * @param pkt packet
66e270967340 Add av_shrink_packet function for use in av_get_packet that reduces pkt->size
reimar
parents: 9359
diff changeset
2977 * @param size new size
66e270967340 Add av_shrink_packet function for use in av_get_packet that reduces pkt->size
reimar
parents: 9359
diff changeset
2978 */
66e270967340 Add av_shrink_packet function for use in av_get_packet that reduces pkt->size
reimar
parents: 9359
diff changeset
2979 void av_shrink_packet(AVPacket *pkt, int size);
66e270967340 Add av_shrink_packet function for use in av_get_packet that reduces pkt->size
reimar
parents: 9359
diff changeset
2980
66e270967340 Add av_shrink_packet function for use in av_get_packet that reduces pkt->size
reimar
parents: 9359
diff changeset
2981 /**
9357
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2982 * @warning This is a hack - the packet memory allocation stuff is broken. The
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2983 * packet is allocated if it was not really allocated.
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2984 */
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2985 int av_dup_packet(AVPacket *pkt);
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2986
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2987 /**
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2988 * Free a packet.
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2989 *
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2990 * @param pkt packet to free
2108342734cc Move av_packet_*() functions from libavformat/ to libavcodec/, where the
rbultje
parents: 9355
diff changeset
2991 */
9584
e30999f7a631 Export av_free_packet().
ramiro
parents: 9578
diff changeset
2992 void av_free_packet(AVPacket *pkt);
2756
d8874c8749ec subtitle codec type support
bellard
parents: 2734
diff changeset
2993
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2994 /* resample.c */
986e461dc072 Initial revision
glantau
parents:
diff changeset
2995
986e461dc072 Initial revision
glantau
parents:
diff changeset
2996 struct ReSampleContext;
2082
3dc9bbe1b152 polyphase kaiser windowed sinc and blackman nuttall windowed sinc audio resample filters
michael
parents: 2066
diff changeset
2997 struct AVResampleContext;
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
2998
986e461dc072 Initial revision
glantau
parents:
diff changeset
2999 typedef struct ReSampleContext ReSampleContext;
986e461dc072 Initial revision
glantau
parents:
diff changeset
3000
8806
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3001 #if LIBAVCODEC_VERSION_MAJOR < 53
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3002 /**
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3003 * @deprecated Use av_audio_resample_init() instead.
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3004 */
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3005 attribute_deprecated ReSampleContext *audio_resample_init(int output_channels, int input_channels,
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3006 int output_rate, int input_rate);
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3007 #endif
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3008 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3009 * Initialize audio resampling context
8806
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3010 *
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3011 * @param output_channels number of output channels
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3012 * @param input_channels number of input channels
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3013 * @param output_rate output sample rate
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3014 * @param input_rate input sample rate
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3015 * @param sample_fmt_out requested output sample format
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3016 * @param sample_fmt_in input sample format
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3017 * @param filter_length length of each FIR filter in the filterbank relative to the cutoff freq
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3018 * @param log2_phase_count log2 of the number of entries in the polyphase filterbank
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3019 * @param linear If 1 then the used FIR filter will be linearly interpolated
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3020 between the 2 closest, if 0 the closest will be used
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3021 * @param cutoff cutoff frequency, 1.0 corresponds to half the output sampling rate
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3022 * @return allocated ReSampleContext, NULL if error occured
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3023 */
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3024 ReSampleContext *av_audio_resample_init(int output_channels, int input_channels,
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3025 int output_rate, int input_rate,
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3026 enum SampleFormat sample_fmt_out,
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3027 enum SampleFormat sample_fmt_in,
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3028 int filter_length, int log2_phase_count,
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3029 int linear, double cutoff);
cbeaa8c0fe4f extend resampling API, add S16 internal conversion
bcoudurier
parents: 8779
diff changeset
3030
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3031 int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
986e461dc072 Initial revision
glantau
parents:
diff changeset
3032 void audio_resample_close(ReSampleContext *s);
986e461dc072 Initial revision
glantau
parents:
diff changeset
3033
8778
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3034
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3035 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3036 * Initialize an audio resampler.
8778
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3037 * Note, if either rate is not an integer then simply scale both rates up so they are.
8779
062adf954a56 Try to doxyfy av_resample_init(). I hope I did not misremember anything as I
michael
parents: 8778
diff changeset
3038 * @param filter_length length of each FIR filter in the filterbank relative to the cutoff freq
062adf954a56 Try to doxyfy av_resample_init(). I hope I did not misremember anything as I
michael
parents: 8778
diff changeset
3039 * @param log2_phase_count log2 of the number of entries in the polyphase filterbank
062adf954a56 Try to doxyfy av_resample_init(). I hope I did not misremember anything as I
michael
parents: 8778
diff changeset
3040 * @param linear If 1 then the used FIR filter will be linearly interpolated
062adf954a56 Try to doxyfy av_resample_init(). I hope I did not misremember anything as I
michael
parents: 8778
diff changeset
3041 between the 2 closest, if 0 the closest will be used
062adf954a56 Try to doxyfy av_resample_init(). I hope I did not misremember anything as I
michael
parents: 8778
diff changeset
3042 * @param cutoff cutoff frequency, 1.0 corresponds to half the output sampling rate
8778
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3043 */
2308
de38526a1f3f user selectble cutoff frequency
michael
parents: 2306
diff changeset
3044 struct AVResampleContext *av_resample_init(int out_rate, int in_rate, int filter_length, int log2_phase_count, int linear, double cutoff);
8778
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3045
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3046 /**
12025
2d730a4acc77 Improve av_resample() documentation
mru
parents: 12024
diff changeset
3047 * Resample an array of samples using a previously configured context.
8778
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3048 * @param src an array of unconsumed samples
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3049 * @param consumed the number of samples of src which have been consumed are returned here
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3050 * @param src_size the number of unconsumed samples available
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3051 * @param dst_size the amount of space in samples available in dst
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3052 * @param update_ctx If this is 0 then the context will not be modified, that way several channels can be resampled with the same context.
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3053 * @return the number of samples written in dst or -1 if an error occurred
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3054 */
2082
3dc9bbe1b152 polyphase kaiser windowed sinc and blackman nuttall windowed sinc audio resample filters
michael
parents: 2066
diff changeset
3055 int av_resample(struct AVResampleContext *c, short *dst, short *src, int *consumed, int src_size, int dst_size, int update_ctx);
8778
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3056
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3057
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3058 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3059 * Compensate samplerate/timestamp drift. The compensation is done by changing
8778
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3060 * the resampler parameters, so no audible clicks or similar distortions occur
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3061 * @param compensation_distance distance in output samples over which the compensation should be performed
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3062 * @param sample_delta number of output samples which should be output less
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3063 *
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3064 * example: av_resample_compensate(c, 10, 500)
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3065 * here instead of 510 samples only 500 samples would be output
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3066 *
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3067 * note, due to rounding the actual compensation might be slightly different,
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3068 * especially if the compensation_distance is large and the in_rate used during init is small
bdb11e2330d1 Move doxy for public resample2 functions to the public header.
michael
parents: 8761
diff changeset
3069 */
2108
ce669c39e3d5 forgotten
michael
parents: 2095
diff changeset
3070 void av_resample_compensate(struct AVResampleContext *c, int sample_delta, int compensation_distance);
2117
a21b80c71d88 av_resample_close in avcodec.h patch by ("William Juwono" <william.juwono at sensestream dot com>)
michael
parents: 2108
diff changeset
3071 void av_resample_close(struct AVResampleContext *c);
2082
3dc9bbe1b152 polyphase kaiser windowed sinc and blackman nuttall windowed sinc audio resample filters
michael
parents: 2066
diff changeset
3072
1508
5a43bc31c2eb recommit of
michael
parents: 1505
diff changeset
3073 /**
5a43bc31c2eb recommit of
michael
parents: 1505
diff changeset
3074 * Allocate memory for a picture. Call avpicture_free to free it.
5a43bc31c2eb recommit of
michael
parents: 1505
diff changeset
3075 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3076 * @param picture the picture to be filled in
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3077 * @param pix_fmt the format of the picture
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3078 * @param width the width of the picture
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3079 * @param height the height of the picture
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3080 * @return zero if successful, a negative value if not
1508
5a43bc31c2eb recommit of
michael
parents: 1505
diff changeset
3081 */
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3082 int avpicture_alloc(AVPicture *picture, enum PixelFormat pix_fmt, int width, int height);
1508
5a43bc31c2eb recommit of
michael
parents: 1505
diff changeset
3083
4568
ad50768a5b57 Doxygenize the comments for the avpicture_free() function.
takis
parents: 4567
diff changeset
3084 /**
ad50768a5b57 Doxygenize the comments for the avpicture_free() function.
takis
parents: 4567
diff changeset
3085 * Free a picture previously allocated by avpicture_alloc().
ad50768a5b57 Doxygenize the comments for the avpicture_free() function.
takis
parents: 4567
diff changeset
3086 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3087 * @param picture the AVPicture to be freed
4568
ad50768a5b57 Doxygenize the comments for the avpicture_free() function.
takis
parents: 4567
diff changeset
3088 */
1508
5a43bc31c2eb recommit of
michael
parents: 1505
diff changeset
3089 void avpicture_free(AVPicture *picture);
5a43bc31c2eb recommit of
michael
parents: 1505
diff changeset
3090
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3091 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3092 * Fill in the AVPicture fields.
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3093 * The fields of the given AVPicture are filled in by using the 'ptr' address
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3094 * which points to the image data buffer. Depending on the specified picture
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3095 * format, one or multiple image data pointers and line sizes will be set.
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3096 * If a planar format is specified, several pointers will be set pointing to
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3097 * the different picture planes and the line sizes of the different planes
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3098 * will be stored in the lines_sizes array.
9217
53ec03e7ba40 Fix avpicture_get_size for non-paletted formats with a helper palette
reimar
parents: 9200
diff changeset
3099 * Call with ptr == NULL to get the required size for the ptr buffer.
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3100 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3101 * @param picture AVPicture whose fields are to be filled in
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3102 * @param ptr Buffer which will contain or contains the actual image data
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3103 * @param pix_fmt The format in which the picture data is stored.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3104 * @param width the width of the image in pixels
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3105 * @param height the height of the image in pixels
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3106 * @return size of the image data in bytes
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3107 */
1064
b32afefe7d33 * UINTX -> uintx_t INTX -> intx_t
kabi
parents: 1058
diff changeset
3108 int avpicture_fill(AVPicture *picture, uint8_t *ptr,
9902
9bdf9fe9018c Fix argument type mismatches for av_picture_crop and av_picture_fill
mru
parents: 9893
diff changeset
3109 enum PixelFormat pix_fmt, int width, int height);
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3110 int avpicture_layout(const AVPicture* src, enum PixelFormat pix_fmt, int width, int height,
1231
b88dfc4bbf8c * introducing new public interface in imgconvert.c
romansh
parents: 1224
diff changeset
3111 unsigned char *dest, int dest_size);
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3112
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3113 /**
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3114 * Calculate the size in bytes that a picture of the given width and height
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3115 * would occupy if stored in the given picture format.
9217
53ec03e7ba40 Fix avpicture_get_size for non-paletted formats with a helper palette
reimar
parents: 9200
diff changeset
3116 * Note that this returns the size of a compact representation as generated
53ec03e7ba40 Fix avpicture_get_size for non-paletted formats with a helper palette
reimar
parents: 9200
diff changeset
3117 * by avpicture_layout, which can be smaller than the size required for e.g.
53ec03e7ba40 Fix avpicture_get_size for non-paletted formats with a helper palette
reimar
parents: 9200
diff changeset
3118 * avpicture_fill.
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3119 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3120 * @param pix_fmt the given picture format
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3121 * @param width the width of the image
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3122 * @param height the height of the image
9217
53ec03e7ba40 Fix avpicture_get_size for non-paletted formats with a helper palette
reimar
parents: 9200
diff changeset
3123 * @return Image data size in bytes or -1 on error (e.g. too large dimensions).
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3124 */
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3125 int avpicture_get_size(enum PixelFormat pix_fmt, int width, int height);
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3126 void avcodec_get_chroma_sub_sample(enum PixelFormat pix_fmt, int *h_shift, int *v_shift);
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3127 const char *avcodec_get_pix_fmt_name(enum PixelFormat pix_fmt);
2270
21f450be6cb5 lowres width/height cleanup 3rd try
michael
parents: 2266
diff changeset
3128 void avcodec_set_dimensions(AVCodecContext *s, int width, int height);
9222
e314914641bc Extend the behavior of avcodec_get_pix_fmt(), if it cannot find a
stefano
parents: 9221
diff changeset
3129
11059
e1bc53867092 Implement av_get_pix_fmt(), and deprecate avcodec_get_pix_fmt().
stefano
parents: 11055
diff changeset
3130 #if LIBAVCODEC_VERSION_MAJOR < 53
9222
e314914641bc Extend the behavior of avcodec_get_pix_fmt(), if it cannot find a
stefano
parents: 9221
diff changeset
3131 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3132 * Return the pixel format corresponding to the name name.
9222
e314914641bc Extend the behavior of avcodec_get_pix_fmt(), if it cannot find a
stefano
parents: 9221
diff changeset
3133 *
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3134 * If there is no pixel format with name name, then look for a
9222
e314914641bc Extend the behavior of avcodec_get_pix_fmt(), if it cannot find a
stefano
parents: 9221
diff changeset
3135 * pixel format with the name corresponding to the native endian
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3136 * format of name.
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3137 * For example in a little-endian system, first look for "gray16",
9222
e314914641bc Extend the behavior of avcodec_get_pix_fmt(), if it cannot find a
stefano
parents: 9221
diff changeset
3138 * then for "gray16le".
e314914641bc Extend the behavior of avcodec_get_pix_fmt(), if it cannot find a
stefano
parents: 9221
diff changeset
3139 *
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3140 * Finally if no pixel format has been found, return PIX_FMT_NONE.
11059
e1bc53867092 Implement av_get_pix_fmt(), and deprecate avcodec_get_pix_fmt().
stefano
parents: 11055
diff changeset
3141 *
e1bc53867092 Implement av_get_pix_fmt(), and deprecate avcodec_get_pix_fmt().
stefano
parents: 11055
diff changeset
3142 * @deprecated Deprecated in favor of av_get_pix_fmt().
9222
e314914641bc Extend the behavior of avcodec_get_pix_fmt(), if it cannot find a
stefano
parents: 9221
diff changeset
3143 */
11059
e1bc53867092 Implement av_get_pix_fmt(), and deprecate avcodec_get_pix_fmt().
stefano
parents: 11055
diff changeset
3144 attribute_deprecated enum PixelFormat avcodec_get_pix_fmt(const char* name);
e1bc53867092 Implement av_get_pix_fmt(), and deprecate avcodec_get_pix_fmt().
stefano
parents: 11055
diff changeset
3145 #endif
10765
8963dc7bb923 Document avcodec_pix_fmt_to_codec_tag().
stefano
parents: 10764
diff changeset
3146
8963dc7bb923 Document avcodec_pix_fmt_to_codec_tag().
stefano
parents: 10764
diff changeset
3147 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3148 * Return a value representing the fourCC code associated to the
10765
8963dc7bb923 Document avcodec_pix_fmt_to_codec_tag().
stefano
parents: 10764
diff changeset
3149 * pixel format pix_fmt, or 0 if no associated fourCC code can be
8963dc7bb923 Document avcodec_pix_fmt_to_codec_tag().
stefano
parents: 10764
diff changeset
3150 * found.
8963dc7bb923 Document avcodec_pix_fmt_to_codec_tag().
stefano
parents: 10764
diff changeset
3151 */
8963dc7bb923 Document avcodec_pix_fmt_to_codec_tag().
stefano
parents: 10764
diff changeset
3152 unsigned int avcodec_pix_fmt_to_codec_tag(enum PixelFormat pix_fmt);
49
0d1f70657c73 new img_convert API - added deinterlacing filter
glantau
parents: 27
diff changeset
3153
11809
867d82f512df Implement av_get_codec_tag_string() and use it in ffprobe.
stefano
parents: 11801
diff changeset
3154 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3155 * Put a string representing the codec tag codec_tag in buf.
11809
867d82f512df Implement av_get_codec_tag_string() and use it in ffprobe.
stefano
parents: 11801
diff changeset
3156 *
867d82f512df Implement av_get_codec_tag_string() and use it in ffprobe.
stefano
parents: 11801
diff changeset
3157 * @param buf_size size in bytes of buf
867d82f512df Implement av_get_codec_tag_string() and use it in ffprobe.
stefano
parents: 11801
diff changeset
3158 * @return the length of the string that would have been generated if
867d82f512df Implement av_get_codec_tag_string() and use it in ffprobe.
stefano
parents: 11801
diff changeset
3159 * enough space had been available, excluding the trailing null
867d82f512df Implement av_get_codec_tag_string() and use it in ffprobe.
stefano
parents: 11801
diff changeset
3160 */
867d82f512df Implement av_get_codec_tag_string() and use it in ffprobe.
stefano
parents: 11801
diff changeset
3161 size_t av_get_codec_tag_string(char *buf, size_t buf_size, unsigned int codec_tag);
867d82f512df Implement av_get_codec_tag_string() and use it in ffprobe.
stefano
parents: 11801
diff changeset
3162
4612
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3163 #define FF_LOSS_RESOLUTION 0x0001 /**< loss due to resolution change */
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3164 #define FF_LOSS_DEPTH 0x0002 /**< loss due to color depth change */
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3165 #define FF_LOSS_COLORSPACE 0x0004 /**< loss due to color space conversion */
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3166 #define FF_LOSS_ALPHA 0x0008 /**< loss of alpha bits */
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3167 #define FF_LOSS_COLORQUANT 0x0010 /**< loss due to color quantization */
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3168 #define FF_LOSS_CHROMA 0x0020 /**< loss of chroma (e.g. RGB to gray conversion) */
1200
b448d7c17215 new YUV formats for correct JPEG YUV support - added automatic pixel format conversion guessing (minimize loss and size)
bellard
parents: 1196
diff changeset
3169
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3170 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3171 * Compute what kind of losses will occur when converting from one specific
4612
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3172 * pixel format to another.
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3173 * When converting from one pixel format to another, information loss may occur.
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3174 * For example, when converting from RGB24 to GRAY, the color information will
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3175 * be lost. Similarly, other losses occur when converting from some formats to
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3176 * other formats. These losses can involve loss of chroma, but also loss of
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3177 * resolution, loss of color depth, loss due to the color space conversion, loss
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3178 * of the alpha bits or loss due to color quantization.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3179 * avcodec_get_fix_fmt_loss() informs you about the various types of losses
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3180 * which will occur when converting from one pixel format to another.
4612
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3181 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3182 * @param[in] dst_pix_fmt destination pixel format
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3183 * @param[in] src_pix_fmt source pixel format
4612
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3184 * @param[in] has_alpha Whether the source pixel format alpha channel is used.
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3185 * @return Combination of flags informing you what kind of losses will occur.
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3186 */
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3187 int avcodec_get_pix_fmt_loss(enum PixelFormat dst_pix_fmt, enum PixelFormat src_pix_fmt,
1200
b448d7c17215 new YUV formats for correct JPEG YUV support - added automatic pixel format conversion guessing (minimize loss and size)
bellard
parents: 1196
diff changeset
3188 int has_alpha);
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3189
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3190 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3191 * Find the best pixel format to convert to given a certain source pixel
4612
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3192 * format. When converting from one pixel format to another, information loss
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3193 * may occur. For example, when converting from RGB24 to GRAY, the color
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3194 * information will be lost. Similarly, other losses occur when converting from
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3195 * some formats to other formats. avcodec_find_best_pix_fmt() searches which of
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3196 * the given pixel formats should be used to suffer the least amount of loss.
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3197 * The pixel formats from which it chooses one, are determined by the
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3198 * pix_fmt_mask parameter.
4612
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3199 *
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3200 * @code
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3201 * src_pix_fmt = PIX_FMT_YUV420P;
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3202 * pix_fmt_mask = (1 << PIX_FMT_YUV422P) || (1 << PIX_FMT_RGB24);
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3203 * dst_pix_fmt = avcodec_find_best_pix_fmt(pix_fmt_mask, src_pix_fmt, alpha, &loss);
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3204 * @endcode
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3205 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3206 * @param[in] pix_fmt_mask bitmask determining which pixel format to choose from
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3207 * @param[in] src_pix_fmt source pixel format
4612
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3208 * @param[in] has_alpha Whether the source pixel format alpha channel is used.
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3209 * @param[out] loss_ptr Combination of flags informing you what kind of losses will occur.
5f3e6c177bac Add documentation to some avcodec.h's pix_fmt related functions and defines.
takis
parents: 4610
diff changeset
3210 * @return The best pixel format to convert to or -1 if none was found.
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3211 */
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3212 enum PixelFormat avcodec_find_best_pix_fmt(int64_t pix_fmt_mask, enum PixelFormat src_pix_fmt,
1200
b448d7c17215 new YUV formats for correct JPEG YUV support - added automatic pixel format conversion guessing (minimize loss and size)
bellard
parents: 1196
diff changeset
3213 int has_alpha, int *loss_ptr);
b448d7c17215 new YUV formats for correct JPEG YUV support - added automatic pixel format conversion guessing (minimize loss and size)
bellard
parents: 1196
diff changeset
3214
5084
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3215
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3216 /**
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3217 * Print in buf the string corresponding to the pixel format with
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3218 * number pix_fmt, or an header if pix_fmt is negative.
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3219 *
5922
b731c1f3d806 Attribute for specifying direction should come right after @param.
takis
parents: 5887
diff changeset
3220 * @param[in] buf the buffer where to write the string
b731c1f3d806 Attribute for specifying direction should come right after @param.
takis
parents: 5887
diff changeset
3221 * @param[in] buf_size the size of buf
b731c1f3d806 Attribute for specifying direction should come right after @param.
takis
parents: 5887
diff changeset
3222 * @param[in] pix_fmt the number of the pixel format to print the corresponding info string, or
5084
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3223 * a negative value to print the corresponding header.
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3224 * Meaningful values for obtaining a pixel format info vary from 0 to PIX_FMT_NB -1.
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3225 */
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3226 void avcodec_pix_fmt_string (char *buf, int buf_size, enum PixelFormat pix_fmt);
5084
9930b7031cb2 Add support for listing the supported pixel formats using the option
benoit
parents: 5041
diff changeset
3227
1208
0f37976aa436 added img_get_alpha_info()
bellard
parents: 1200
diff changeset
3228 #define FF_ALPHA_TRANSP 0x0001 /* image has some totally transparent pixels */
0f37976aa436 added img_get_alpha_info()
bellard
parents: 1200
diff changeset
3229 #define FF_ALPHA_SEMI_TRANSP 0x0002 /* image has some transparent pixels */
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3230
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3231 /**
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3232 * Tell if an image really has transparent alpha values.
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3233 * @return ored mask of FF_ALPHA_xxx constants
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3234 */
1488
766a2f4edbea avcodec const correctness patch by (Drew Hess <dhess at ilm dot com>)
michaelni
parents: 1486
diff changeset
3235 int img_get_alpha_info(const AVPicture *src,
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3236 enum PixelFormat pix_fmt, int width, int height);
1208
0f37976aa436 added img_get_alpha_info()
bellard
parents: 1200
diff changeset
3237
49
0d1f70657c73 new img_convert API - added deinterlacing filter
glantau
parents: 27
diff changeset
3238 /* deinterlace a picture */
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3239 /* deinterlace - if not supported return -1 */
1488
766a2f4edbea avcodec const correctness patch by (Drew Hess <dhess at ilm dot com>)
michaelni
parents: 1486
diff changeset
3240 int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3241 enum PixelFormat pix_fmt, int width, int height);
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3242
986e461dc072 Initial revision
glantau
parents:
diff changeset
3243 /* external high level API */
986e461dc072 Initial revision
glantau
parents:
diff changeset
3244
8921
233fda721f1b Document av_codec_next().
stefano
parents: 8890
diff changeset
3245 /**
233fda721f1b Document av_codec_next().
stefano
parents: 8890
diff changeset
3246 * If c is NULL, returns the first registered codec,
8933
678fc8612787 Improve grammar: "X next after Y" -> "next X after Y".
stefano
parents: 8921
diff changeset
3247 * if c is non-NULL, returns the next registered codec after c,
8921
233fda721f1b Document av_codec_next().
stefano
parents: 8890
diff changeset
3248 * or NULL if c is the last one.
233fda721f1b Document av_codec_next().
stefano
parents: 8890
diff changeset
3249 */
6011
b1fe945d73f9 av_*_next() API for libavcodec
michael
parents: 6010
diff changeset
3250 AVCodec *av_codec_next(AVCodec *c);
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3251
7521
560ebb4bca76 Doxygenate avcodec_version().
stefano
parents: 7510
diff changeset
3252 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3253 * Return the LIBAVCODEC_VERSION_INT constant.
7521
560ebb4bca76 Doxygenate avcodec_version().
stefano
parents: 7510
diff changeset
3254 */
399
64247fd53524 added avcodec_set_bit_exact() for testing
glantau
parents: 383
diff changeset
3255 unsigned avcodec_version(void);
7521
560ebb4bca76 Doxygenate avcodec_version().
stefano
parents: 7510
diff changeset
3256
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3257 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3258 * Return the libavcodec build-time configuration.
10536
046dcf7aa19c Add functions to return library license and library configuration.
diego
parents: 10527
diff changeset
3259 */
10764
4546d91de818 Prefer "*FUNC_NAME(" over "* FUNC_NAME(" for XXX_configuration() and
stefano
parents: 10707
diff changeset
3260 const char *avcodec_configuration(void);
10536
046dcf7aa19c Add functions to return library license and library configuration.
diego
parents: 10527
diff changeset
3261
046dcf7aa19c Add functions to return library license and library configuration.
diego
parents: 10527
diff changeset
3262 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3263 * Return the libavcodec license.
10536
046dcf7aa19c Add functions to return library license and library configuration.
diego
parents: 10527
diff changeset
3264 */
10764
4546d91de818 Prefer "*FUNC_NAME(" over "* FUNC_NAME(" for XXX_configuration() and
stefano
parents: 10707
diff changeset
3265 const char *avcodec_license(void);
10536
046dcf7aa19c Add functions to return library license and library configuration.
diego
parents: 10527
diff changeset
3266
046dcf7aa19c Add functions to return library license and library configuration.
diego
parents: 10527
diff changeset
3267 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3268 * Initialize libavcodec.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3269 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3270 * @warning This function must be called before any other libavcodec
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3271 * function.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3272 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3273 void avcodec_init(void);
986e461dc072 Initial revision
glantau
parents:
diff changeset
3274
8752
7fd1422a8703 Drop the deprecated function register_avcodec() at the next major
stefano
parents: 8751
diff changeset
3275 #if LIBAVCODEC_VERSION_MAJOR < 53
8326
678c7604463e Document register_avcodec().
stefano
parents: 8325
diff changeset
3276 /**
8750
2528b6a2b5d3 Rename register_avcodec() as avcodec_register() and deprecate the old
stefano
parents: 8747
diff changeset
3277 * @deprecated Deprecated in favor of avcodec_register().
2528b6a2b5d3 Rename register_avcodec() as avcodec_register() and deprecate the old
stefano
parents: 8747
diff changeset
3278 */
2528b6a2b5d3 Rename register_avcodec() as avcodec_register() and deprecate the old
stefano
parents: 8747
diff changeset
3279 attribute_deprecated void register_avcodec(AVCodec *codec);
8752
7fd1422a8703 Drop the deprecated function register_avcodec() at the next major
stefano
parents: 8751
diff changeset
3280 #endif
8750
2528b6a2b5d3 Rename register_avcodec() as avcodec_register() and deprecate the old
stefano
parents: 8747
diff changeset
3281
2528b6a2b5d3 Rename register_avcodec() as avcodec_register() and deprecate the old
stefano
parents: 8747
diff changeset
3282 /**
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3283 * Register the codec codec and initialize libavcodec.
8326
678c7604463e Document register_avcodec().
stefano
parents: 8325
diff changeset
3284 *
678c7604463e Document register_avcodec().
stefano
parents: 8325
diff changeset
3285 * @see avcodec_init()
678c7604463e Document register_avcodec().
stefano
parents: 8325
diff changeset
3286 */
8750
2528b6a2b5d3 Rename register_avcodec() as avcodec_register() and deprecate the old
stefano
parents: 8747
diff changeset
3287 void avcodec_register(AVCodec *codec);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3288
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3289 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3290 * Find a registered encoder with a matching codec ID.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3291 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3292 * @param id CodecID of the requested encoder
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3293 * @return An encoder if one was found, NULL otherwise.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3294 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3295 AVCodec *avcodec_find_encoder(enum CodecID id);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3296
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3297 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3298 * Find a registered encoder with the specified name.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3299 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3300 * @param name name of the requested encoder
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3301 * @return An encoder if one was found, NULL otherwise.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3302 */
177
53da914d6f46 avcodec_find_encoder_by_name() patch by Alex
arpi_esp
parents: 162
diff changeset
3303 AVCodec *avcodec_find_encoder_by_name(const char *name);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3304
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3305 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3306 * Find a registered decoder with a matching codec ID.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3307 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3308 * @param id CodecID of the requested decoder
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3309 * @return A decoder if one was found, NULL otherwise.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3310 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3311 AVCodec *avcodec_find_decoder(enum CodecID id);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3312
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3313 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3314 * Find a registered decoder with the specified name.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3315 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3316 * @param name name of the requested decoder
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3317 * @return A decoder if one was found, NULL otherwise.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3318 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3319 AVCodec *avcodec_find_decoder_by_name(const char *name);
986e461dc072 Initial revision
glantau
parents:
diff changeset
3320 void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
986e461dc072 Initial revision
glantau
parents:
diff changeset
3321
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3322 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3323 * Set the fields of the given AVCodecContext to default values.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3324 *
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3325 * @param s The AVCodecContext of which the fields should be set to default values.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3326 */
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
3327 void avcodec_get_context_defaults(AVCodecContext *s);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3328
4630
1416371d4a6c add avcodec_get_context_defaults2() / avcodec_alloc_context2() which take CodecType as an additional parameter
michael
parents: 4624
diff changeset
3329 /** THIS FUNCTION IS NOT YET PART OF THE PUBLIC API!
1416371d4a6c add avcodec_get_context_defaults2() / avcodec_alloc_context2() which take CodecType as an additional parameter
michael
parents: 4624
diff changeset
3330 * we WILL change its arguments and name a few times! */
11560
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
3331 void avcodec_get_context_defaults2(AVCodecContext *s, enum AVMediaType);
4630
1416371d4a6c add avcodec_get_context_defaults2() / avcodec_alloc_context2() which take CodecType as an additional parameter
michael
parents: 4624
diff changeset
3332
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3333 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3334 * Allocate an AVCodecContext and set its fields to default values. The
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3335 * resulting struct can be deallocated by simply calling av_free().
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3336 *
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3337 * @return An AVCodecContext filled with default values or NULL on failure.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3338 * @see avcodec_get_context_defaults
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3339 */
703
65f9e32225ba Minor warning fix.
mellum
parents: 701
diff changeset
3340 AVCodecContext *avcodec_alloc_context(void);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3341
4630
1416371d4a6c add avcodec_get_context_defaults2() / avcodec_alloc_context2() which take CodecType as an additional parameter
michael
parents: 4624
diff changeset
3342 /** THIS FUNCTION IS NOT YET PART OF THE PUBLIC API!
1416371d4a6c add avcodec_get_context_defaults2() / avcodec_alloc_context2() which take CodecType as an additional parameter
michael
parents: 4624
diff changeset
3343 * we WILL change its arguments and name a few times! */
11560
8a4984c5cacc Define AVMediaType enum, and use it instead of enum CodecType, which
stefano
parents: 11559
diff changeset
3344 AVCodecContext *avcodec_alloc_context2(enum AVMediaType);
4630
1416371d4a6c add avcodec_get_context_defaults2() / avcodec_alloc_context2() which take CodecType as an additional parameter
michael
parents: 4624
diff changeset
3345
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3346 /**
11565
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3347 * Copy the settings of the source AVCodecContext into the destination
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3348 * AVCodecContext. The resulting destination codec context will be
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3349 * unopened, i.e. you are required to call avcodec_open() before you
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3350 * can use this AVCodecContext to decode/encode video/audio data.
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3351 *
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3352 * @param dest target codec context, should be initialized with
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3353 * avcodec_alloc_context(), but otherwise uninitialized
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3354 * @param src source codec context
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3355 * @return AVERROR() on error (e.g. memory allocation error), 0 on success
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3356 */
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3357 int avcodec_copy_context(AVCodecContext *dest, const AVCodecContext *src);
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3358
2baae9246958 Add avcodec_copy_context().
rbultje
parents: 11563
diff changeset
3359 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3360 * Set the fields of the given AVFrame to default values.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3361 *
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3362 * @param pic The AVFrame of which the fields should be set to default values.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3363 */
1904
129236143f2e warning patrol
mellum
parents: 1900
diff changeset
3364 void avcodec_get_frame_defaults(AVFrame *pic);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3365
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3366 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3367 * Allocate an AVFrame and set its fields to default values. The resulting
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3368 * struct can be deallocated by simply calling av_free().
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3369 *
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3370 * @return An AVFrame filled with default values or NULL on failure.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3371 * @see avcodec_get_frame_defaults
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3372 */
925
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
3373 AVFrame *avcodec_alloc_frame(void);
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
3374
925
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
3375 int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
3376 void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
2026
b7f43fc816db forgotten prototypes
michael
parents: 2025
diff changeset
3377 int avcodec_default_reget_buffer(AVCodecContext *s, AVFrame *pic);
11567
1025297f5624 Add function to export EDGE_WIDTH from libavcodec.
koorogi
parents: 11566
diff changeset
3378
1025297f5624 Add function to export EDGE_WIDTH from libavcodec.
koorogi
parents: 11566
diff changeset
3379 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3380 * Return the amount of padding in pixels which the get_buffer callback must
11567
1025297f5624 Add function to export EDGE_WIDTH from libavcodec.
koorogi
parents: 11566
diff changeset
3381 * provide around the edge of the image for codecs which do not have the
1025297f5624 Add function to export EDGE_WIDTH from libavcodec.
koorogi
parents: 11566
diff changeset
3382 * CODEC_FLAG_EMU_EDGE flag.
1025297f5624 Add function to export EDGE_WIDTH from libavcodec.
koorogi
parents: 11566
diff changeset
3383 *
1025297f5624 Add function to export EDGE_WIDTH from libavcodec.
koorogi
parents: 11566
diff changeset
3384 * @return Required padding in pixels.
1025297f5624 Add function to export EDGE_WIDTH from libavcodec.
koorogi
parents: 11566
diff changeset
3385 */
1025297f5624 Add function to export EDGE_WIDTH from libavcodec.
koorogi
parents: 11566
diff changeset
3386 unsigned avcodec_get_edge_width(void);
11311
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3387 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3388 * Modify width and height values so that they will result in a memory
11311
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3389 * buffer that is acceptable for the codec if you do not use any horizontal
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3390 * padding.
11754
0ec1a0299e2d Document CODEC_FLAG_EMU_EDGE and avcodec_align_dimensions interaction.
reimar
parents: 11751
diff changeset
3391 *
0ec1a0299e2d Document CODEC_FLAG_EMU_EDGE and avcodec_align_dimensions interaction.
reimar
parents: 11751
diff changeset
3392 * May only be used if a codec with CODEC_CAP_DR1 has been opened.
0ec1a0299e2d Document CODEC_FLAG_EMU_EDGE and avcodec_align_dimensions interaction.
reimar
parents: 11751
diff changeset
3393 * If CODEC_FLAG_EMU_EDGE is not set, the dimensions must have been increased
0ec1a0299e2d Document CODEC_FLAG_EMU_EDGE and avcodec_align_dimensions interaction.
reimar
parents: 11751
diff changeset
3394 * according to avcodec_get_edge_width() before.
11311
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3395 */
2026
b7f43fc816db forgotten prototypes
michael
parents: 2025
diff changeset
3396 void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height);
11311
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3397 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3398 * Modify width and height values so that they will result in a memory
11311
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3399 * buffer that is acceptable for the codec if you also ensure that all
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3400 * line sizes are a multiple of the respective linesize_align[i].
11754
0ec1a0299e2d Document CODEC_FLAG_EMU_EDGE and avcodec_align_dimensions interaction.
reimar
parents: 11751
diff changeset
3401 *
0ec1a0299e2d Document CODEC_FLAG_EMU_EDGE and avcodec_align_dimensions interaction.
reimar
parents: 11751
diff changeset
3402 * May only be used if a codec with CODEC_CAP_DR1 has been opened.
0ec1a0299e2d Document CODEC_FLAG_EMU_EDGE and avcodec_align_dimensions interaction.
reimar
parents: 11751
diff changeset
3403 * If CODEC_FLAG_EMU_EDGE is not set, the dimensions must have been increased
0ec1a0299e2d Document CODEC_FLAG_EMU_EDGE and avcodec_align_dimensions interaction.
reimar
parents: 11751
diff changeset
3404 * according to avcodec_get_edge_width() before.
11311
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3405 */
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3406 void avcodec_align_dimensions2(AVCodecContext *s, int *width, int *height,
ee2e050815be Fix avcodec_align_dimensions to return values suitably aligned for FLV decoding
reimar
parents: 11299
diff changeset
3407 int linesize_align[4]);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3408
12371
5dffb531b1cc Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents: 12298
diff changeset
3409 #if LIBAVCODEC_VERSION_MAJOR < 53
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3410 /**
12371
5dffb531b1cc Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents: 12298
diff changeset
3411 * @deprecated Deprecated in favor of av_check_image_size().
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3412 */
12371
5dffb531b1cc Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents: 12298
diff changeset
3413 attribute_deprecated
2422
18b8b2dcc037 various security fixes and precautionary checks
michael
parents: 2413
diff changeset
3414 int avcodec_check_dimensions(void *av_log_ctx, unsigned int w, unsigned int h);
12371
5dffb531b1cc Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents: 12298
diff changeset
3415 #endif
5dffb531b1cc Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents: 12298
diff changeset
3416
2026
b7f43fc816db forgotten prototypes
michael
parents: 2025
diff changeset
3417 enum PixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum PixelFormat * fmt);
903
22ee74da2cd3 cleanup
michaelni
parents: 902
diff changeset
3418
1832
michael
parents: 1831
diff changeset
3419 int avcodec_thread_init(AVCodecContext *s, int thread_count);
michael
parents: 1831
diff changeset
3420 void avcodec_thread_free(AVCodecContext *s);
8129
a9734fe0811e Making it easier to send arbitrary structures as work orders to MT workers
romansh
parents: 8119
diff changeset
3421 int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void *arg, int *ret, int count, int size);
10386
98501365c3aa Add an execute2 function that is more flexible and allows to use parallel
reimar
parents: 10318
diff changeset
3422 int avcodec_default_execute2(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2, int, int),void *arg, int *ret, int count);
1799
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
3423 //FIXME func typedef
95612d423fde multithreaded/SMP motion estimation
michael
parents: 1791
diff changeset
3424
1368
0fd38b711f06 AVCodec.flush()
michaelni
parents: 1353
diff changeset
3425 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3426 * Initialize the AVCodecContext to use the given AVCodec. Prior to using this
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3427 * function the context has to be allocated.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3428 *
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3429 * The functions avcodec_find_decoder_by_name(), avcodec_find_encoder_by_name(),
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3430 * avcodec_find_decoder() and avcodec_find_encoder() provide an easy way for
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3431 * retrieving a codec.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3432 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3433 * @warning This function is not thread safe!
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3434 *
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3435 * @code
5137
0134da1737d0 Improve understanding ofavcodec_find_decoder()
benoit
parents: 5127
diff changeset
3436 * avcodec_register_all();
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3437 * codec = avcodec_find_decoder(CODEC_ID_H264);
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3438 * if (!codec)
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3439 * exit(1);
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3440 *
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3441 * context = avcodec_alloc_context();
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3442 *
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3443 * if (avcodec_open(context, codec) < 0)
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3444 * exit(1);
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3445 * @endcode
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3446 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3447 * @param avctx The context which will be set up to use the given codec.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3448 * @param codec The codec to use within the context.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3449 * @return zero on success, a negative value on error
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3450 * @see avcodec_alloc_context, avcodec_find_decoder, avcodec_find_encoder
1368
0fd38b711f06 AVCodec.flush()
michaelni
parents: 1353
diff changeset
3451 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3452 int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
1368
0fd38b711f06 AVCodec.flush()
michaelni
parents: 1353
diff changeset
3453
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3454 #if LIBAVCODEC_VERSION_MAJOR < 53
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3455 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3456 * Decode an audio frame from buf into samples.
9578
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3457 * Wrapper function which calls avcodec_decode_audio3.
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3458 *
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3459 * @deprecated Use avcodec_decode_audio3 instead.
9578
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3460 * @param avctx the codec context
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3461 * @param[out] samples the output buffer
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3462 * @param[in,out] frame_size_ptr the output buffer size in bytes
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3463 * @param[in] buf the input buffer
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3464 * @param[in] buf_size the input buffer size in bytes
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3465 * @return On error a negative value is returned, otherwise the number of bytes
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3466 * used or zero if no frame could be decompressed.
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3467 */
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3468 attribute_deprecated int avcodec_decode_audio2(AVCodecContext *avctx, int16_t *samples,
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3469 int *frame_size_ptr,
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3470 const uint8_t *buf, int buf_size);
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3471 #endif
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3472
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3473 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3474 * Decode the audio frame of size avpkt->size from avpkt->data into samples.
9571
e54c83a838a9 Cleanup first paragraph of doxy of avcodec_decode_audio3().
michael
parents: 9570
diff changeset
3475 * Some decoders may support multiple frames in a single AVPacket, such
10389
c857cd6b77b6 extend description of avcodec_decode_audio3:
faust3
parents: 10386
diff changeset
3476 * decoders would then just decode the first frame. In this case,
c857cd6b77b6 extend description of avcodec_decode_audio3:
faust3
parents: 10386
diff changeset
3477 * avcodec_decode_audio3 has to be called again with an AVPacket that contains
c857cd6b77b6 extend description of avcodec_decode_audio3:
faust3
parents: 10386
diff changeset
3478 * the remaining data in order to decode the second frame etc.
9571
e54c83a838a9 Cleanup first paragraph of doxy of avcodec_decode_audio3().
michael
parents: 9570
diff changeset
3479 * If no frame
10389
c857cd6b77b6 extend description of avcodec_decode_audio3:
faust3
parents: 10386
diff changeset
3480 * could be outputted, frame_size_ptr is zero. Otherwise, it is the
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3481 * decompressed frame size in bytes.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3482 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3483 * @warning You must set frame_size_ptr to the allocated size of the
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3484 * output buffer before calling avcodec_decode_audio3().
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3485 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3486 * @warning The input buffer must be FF_INPUT_BUFFER_PADDING_SIZE larger than
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3487 * the actual read bytes because some optimized bitstream readers read 32 or 64
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3488 * bits at once and could read over the end.
3660
7e1ee254a3ee Align the input buffer in ffplay, introduce a public macro for aligned declarations
lu_zero
parents: 3618
diff changeset
3489 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3490 * @warning The end of the input buffer avpkt->data should be set to 0 to ensure that
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3491 * no overreading happens for damaged MPEG streams.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3492 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3493 * @note You might have to align the input buffer avpkt->data and output buffer
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3494 * samples. The alignment requirements depend on the CPU: On some CPUs it isn't
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3495 * necessary at all, on others it won't work at all if not aligned and on others
9825
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3496 * it will work but it will have an impact on performance.
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3497 *
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3498 * In practice, avpkt->data should have 4 byte alignment at minimum and
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3499 * samples should be 16 byte aligned unless the CPU doesn't need it
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3500 * (AltiVec and SSE do).
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3501 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3502 * @param avctx the codec context
9882
7b58b1410f48 Make documentation better match the code. Now AVCodecContext.sample_fmt
vitor
parents: 9866
diff changeset
3503 * @param[out] samples the output buffer, sample type in avctx->sample_fmt
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3504 * @param[in,out] frame_size_ptr the output buffer size in bytes
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3505 * @param[in] avpkt The input AVPacket containing the input buffer.
9785
48572d70c95f Clarify the input AVPacket for avcodec_decode*()
michael
parents: 9742
diff changeset
3506 * You can create such packet with av_init_packet() and by then setting
48572d70c95f Clarify the input AVPacket for avcodec_decode*()
michael
parents: 9742
diff changeset
3507 * data and size, some decoders might in addition need other fields.
48572d70c95f Clarify the input AVPacket for avcodec_decode*()
michael
parents: 9742
diff changeset
3508 * All decoders are designed to use the least fields possible though.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3509 * @return On error a negative value is returned, otherwise the number of bytes
10389
c857cd6b77b6 extend description of avcodec_decode_audio3:
faust3
parents: 10386
diff changeset
3510 * used or zero if no frame data was decompressed (used) from the input AVPacket.
3660
7e1ee254a3ee Align the input buffer in ffplay, introduce a public macro for aligned declarations
lu_zero
parents: 3618
diff changeset
3511 */
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3512 int avcodec_decode_audio3(AVCodecContext *avctx, int16_t *samples,
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3513 int *frame_size_ptr,
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3514 AVPacket *avpkt);
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3515
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3516 #if LIBAVCODEC_VERSION_MAJOR < 53
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3517 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3518 * Decode a video frame from buf into picture.
9578
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3519 * Wrapper function which calls avcodec_decode_video2.
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3520 *
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3521 * @deprecated Use avcodec_decode_video2 instead.
9578
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3522 * @param avctx the codec context
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3523 * @param[out] picture The AVFrame in which the decoded video frame will be stored.
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3524 * @param[in] buf the input buffer
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3525 * @param[in] buf_size the size of the input buffer in bytes
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3526 * @param[in,out] got_picture_ptr Zero if no frame could be decompressed, otherwise, it is nonzero.
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3527 * @return On error a negative value is returned, otherwise the number of bytes
14b9819158a8 Revert r18700, documentation of deprecated functions might be useful for
vitor
parents: 9575
diff changeset
3528 * used or zero if no frame could be decompressed.
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3529 */
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3530 attribute_deprecated int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture,
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3531 int *got_picture_ptr,
6318
73c09e922744 Make avcodec_decode_* functions take const input buffers.
michael
parents: 6215
diff changeset
3532 const uint8_t *buf, int buf_size);
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3533 #endif
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3534
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3535 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3536 * Decode the video frame of size avpkt->size from avpkt->data into picture.
9572
b3074f49b078 Add multiframe note to avcodec_decode_video() too.
michael
parents: 9571
diff changeset
3537 * Some decoders may support multiple frames in a single AVPacket, such
b3074f49b078 Add multiframe note to avcodec_decode_video() too.
michael
parents: 9571
diff changeset
3538 * decoders would then just decode the first frame.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3539 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3540 * @warning The input buffer must be FF_INPUT_BUFFER_PADDING_SIZE larger than
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3541 * the actual read bytes because some optimized bitstream readers read 32 or 64
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3542 * bits at once and could read over the end.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3543 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3544 * @warning The end of the input buffer buf should be set to 0 to ensure that
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3545 * no overreading happens for damaged MPEG streams.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3546 *
9825
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3547 * @note You might have to align the input buffer avpkt->data.
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3548 * The alignment requirements depend on the CPU: on some CPUs it isn't
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3549 * necessary at all, on others it won't work at all if not aligned and on others
9825
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3550 * it will work but it will have an impact on performance.
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3551 *
37558edc9df2 clarify avcodec_decode_audio3 and avcodec_decode_video2 doxygen
bcoudurier
parents: 9822
diff changeset
3552 * In practice, avpkt->data should have 4 byte alignment at minimum.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3553 *
8548
3586e03586a0 Document the need of buf=NULL buf_size=0 at the end to obtain all frames.
michael
parents: 8522
diff changeset
3554 * @note Some codecs have a delay between input and output, these need to be
10686
7fd8e33acaab Fix a typo in documentation.
ramiro
parents: 10661
diff changeset
3555 * fed with avpkt->data=NULL, avpkt->size=0 at the end to return the remaining frames.
8548
3586e03586a0 Document the need of buf=NULL buf_size=0 at the end to obtain all frames.
michael
parents: 8522
diff changeset
3556 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3557 * @param avctx the codec context
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3558 * @param[out] picture The AVFrame in which the decoded video frame will be stored.
11690
56a2ead12502 Another try for fixing/improving decode_video documentation.
reimar
parents: 11689
diff changeset
3559 * Use avcodec_alloc_frame to get an AVFrame, the codec will
56a2ead12502 Another try for fixing/improving decode_video documentation.
reimar
parents: 11689
diff changeset
3560 * allocate memory for the actual bitmap.
11822
8cd526e30b06 Document the frames returned by the decoder better.
michael
parents: 11821
diff changeset
3561 * with default get/release_buffer(), the decoder frees/reuses the bitmap as it sees fit.
11823
c9ef45275db0 Clarify that get/release_buffer() overriding only works with CODEC_CAP_DR1 codecs.
michael
parents: 11822
diff changeset
3562 * with overridden get/release_buffer() (needs CODEC_CAP_DR1) the user decides into what buffer the decoder
11822
8cd526e30b06 Document the frames returned by the decoder better.
michael
parents: 11821
diff changeset
3563 * decodes and the decoder tells the user once it does not need the data anymore,
8cd526e30b06 Document the frames returned by the decoder better.
michael
parents: 11821
diff changeset
3564 * the user app can at this point free/reuse/keep the memory as it sees fit.
8cd526e30b06 Document the frames returned by the decoder better.
michael
parents: 11821
diff changeset
3565 *
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3566 * @param[in] avpkt The input AVpacket containing the input buffer.
9785
48572d70c95f Clarify the input AVPacket for avcodec_decode*()
michael
parents: 9742
diff changeset
3567 * You can create such packet with av_init_packet() and by then setting
48572d70c95f Clarify the input AVPacket for avcodec_decode*()
michael
parents: 9742
diff changeset
3568 * data and size, some decoders might in addition need other fields like
11563
5111783be6ad Replace all occurences of PKT_FLAG_KEY with AV_PKT_FLAG_KEY.
cehoyos
parents: 11561
diff changeset
3569 * flags&AV_PKT_FLAG_KEY. All decoders are designed to use the least
9785
48572d70c95f Clarify the input AVPacket for avcodec_decode*()
michael
parents: 9742
diff changeset
3570 * fields possible.
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3571 * @param[in,out] got_picture_ptr Zero if no frame could be decompressed, otherwise, it is nonzero.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3572 * @return On error a negative value is returned, otherwise the number of bytes
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3573 * used or zero if no frame could be decompressed.
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3574 */
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3575 int avcodec_decode_video2(AVCodecContext *avctx, AVFrame *picture,
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3576 int *got_picture_ptr,
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3577 AVPacket *avpkt);
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3578
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3579 #if LIBAVCODEC_VERSION_MAJOR < 53
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3580 /* Decode a subtitle message. Return -1 if error, otherwise return the
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3581 * number of bytes used. If no subtitle could be decompressed,
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3582 * got_sub_ptr is zero. Otherwise, the subtitle is stored in *sub. */
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3583 attribute_deprecated int avcodec_decode_subtitle(AVCodecContext *avctx, AVSubtitle *sub,
2756
d8874c8749ec subtitle codec type support
bellard
parents: 2734
diff changeset
3584 int *got_sub_ptr,
d8874c8749ec subtitle codec type support
bellard
parents: 2734
diff changeset
3585 const uint8_t *buf, int buf_size);
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3586 #endif
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3587
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3588 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3589 * Decode a subtitle message.
12051
3798d134f330 Grammar fixes
mru
parents: 12039
diff changeset
3590 * Return a negative value on error, otherwise return the number of bytes used.
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3591 * If no subtitle could be decompressed, got_sub_ptr is zero.
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3592 * Otherwise, the subtitle is stored in *sub.
12130
917a70cf7681 Document that and why subtitle decoders do not support direct-rendering.
reimar
parents: 12124
diff changeset
3593 * Note that CODEC_CAP_DR1 is not available for subtitle codecs. This is for
917a70cf7681 Document that and why subtitle decoders do not support direct-rendering.
reimar
parents: 12124
diff changeset
3594 * simplicity, because the performance difference is expect to be negligible
917a70cf7681 Document that and why subtitle decoders do not support direct-rendering.
reimar
parents: 12124
diff changeset
3595 * and reusing a get_buffer written for video codecs would probably perform badly
917a70cf7681 Document that and why subtitle decoders do not support direct-rendering.
reimar
parents: 12124
diff changeset
3596 * due to a potentially very different allocation pattern.
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3597 *
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3598 * @param avctx the codec context
12134
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3599 * @param[out] sub The AVSubtitle in which the decoded subtitle will be stored, must be
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3600 freed with avsubtitle_free if *got_sub_ptr is set.
9355
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3601 * @param[in,out] got_sub_ptr Zero if no subtitle could be decompressed, otherwise, it is nonzero.
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3602 * @param[in] avpkt The input AVPacket containing the input buffer.
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3603 */
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3604 int avcodec_decode_subtitle2(AVCodecContext *avctx, AVSubtitle *sub,
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3605 int *got_sub_ptr,
54bc8a2727b0 Implement avcodec_decode_video2(), _audio3() and _subtitle2() which takes an
rbultje
parents: 9354
diff changeset
3606 AVPacket *avpkt);
12134
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3607
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3608 /**
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3609 * Frees all allocated data in the given subtitle struct.
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3610 *
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3611 * @param sub AVSubtitle to free.
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3612 */
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3613 void avsubtitle_free(AVSubtitle *sub);
cb3eb3a2fc96 Add avsubtitle_free function.
reimar
parents: 12131
diff changeset
3614
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3615 int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata,
581
8adda0af04e2 added proposed API for parse_only mode to extract compressed frames from compressed streams
bellard
parents: 573
diff changeset
3616 int *data_size_ptr,
1064
b32afefe7d33 * UINTX -> uintx_t INTX -> intx_t
kabi
parents: 1058
diff changeset
3617 uint8_t *buf, int buf_size);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3618
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3619 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3620 * Encode an audio frame from samples into buf.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3621 *
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3622 * @note The output buffer should be at least FF_MIN_BUFFER_SIZE bytes large.
9409
e6ade5c8a750 Fix documentation for avcodec_encode_audio(), in the case of PCM audio
stefano
parents: 9394
diff changeset
3623 * However, for PCM audio the user will know how much space is needed
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3624 * because it depends on the value passed in buf_size as described
9409
e6ade5c8a750 Fix documentation for avcodec_encode_audio(), in the case of PCM audio
stefano
parents: 9394
diff changeset
3625 * below. In that case a lower value can be used.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3626 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3627 * @param avctx the codec context
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3628 * @param[out] buf the output buffer
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3629 * @param[in] buf_size the output buffer size
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3630 * @param[in] samples the input buffer containing the samples
5953
402833508709 Clarify documentation for avcodec_encode_audio.
diego
parents: 5940
diff changeset
3631 * The number of samples read from this buffer is frame_size*channels,
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3632 * both of which are defined in avctx.
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3633 * For PCM audio the number of samples read from samples is equal to
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3634 * buf_size * input_sample_size / output_sample_size.
5961
74e314bb31c4 succes --> success typo
diego
parents: 5953
diff changeset
3635 * @return On error a negative value is returned, on success zero or the number
5953
402833508709 Clarify documentation for avcodec_encode_audio.
diego
parents: 5940
diff changeset
3636 * of bytes used to encode the data read from the input buffer.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3637 */
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3638 int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size,
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3639 const short *samples);
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3640
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3641 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3642 * Encode a video frame from pict into buf.
9575
cb2eaa883d4f Remove useless and outright wrong chatter from avcodec_encode_video().
michael
parents: 9574
diff changeset
3643 * The input picture should be
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
3644 * stored using a specific format, namely avctx.pix_fmt.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3645 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3646 * @param avctx the codec context
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3647 * @param[out] buf the output buffer for the bitstream of encoded frame
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3648 * @param[in] buf_size the size of the output buffer in bytes
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3649 * @param[in] pict the input picture to encode
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3650 * @return On error a negative value is returned, on success zero or the number
8700
ebb66d91b011 Fix documentation of the return value of avcodec_encode_video().
michael
parents: 8667
diff changeset
3651 * of bytes used from the output buffer.
4566
1cb0cac7b19d Add more Doxygen documentation.
takis
parents: 4559
diff changeset
3652 */
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3653 int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size,
925
7fccaa0d699d AVVideoFrame -> AVFrame
michaelni
parents: 924
diff changeset
3654 const AVFrame *pict);
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3655 int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
2756
d8874c8749ec subtitle codec type support
bellard
parents: 2734
diff changeset
3656 const AVSubtitle *sub);
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3657
986e461dc072 Initial revision
glantau
parents:
diff changeset
3658 int avcodec_close(AVCodecContext *avctx);
986e461dc072 Initial revision
glantau
parents:
diff changeset
3659
8328
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3660 /**
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3661 * Register all the codecs, parsers and bitstream filters which were enabled at
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3662 * configuration time. If you do not call this function you can select exactly
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3663 * which formats you want to support, by using the individual registration
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3664 * functions.
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3665 *
8751
303929f52007 Replace the calls to the deprecated function register_avcodec() with
stefano
parents: 8750
diff changeset
3666 * @see avcodec_register
8328
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3667 * @see av_register_codec_parser
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3668 * @see av_register_bitstream_filter
2e654989814e Move documentation of avcodec_register_all() from allcodecs.c to
stefano
parents: 8327
diff changeset
3669 */
0
986e461dc072 Initial revision
glantau
parents:
diff changeset
3670 void avcodec_register_all(void);
92
1d3eb6cdc6b5 added pcm codecs
glantau
parents: 67
diff changeset
3671
4567
f0138063c568 Move the Doxygen function documentation unaltered from libavcodec/utils.c to
takis
parents: 4566
diff changeset
3672 /**
f0138063c568 Move the Doxygen function documentation unaltered from libavcodec/utils.c to
takis
parents: 4566
diff changeset
3673 * Flush buffers, should be called when seeking or when switching to a different stream.
f0138063c568 Move the Doxygen function documentation unaltered from libavcodec/utils.c to
takis
parents: 4566
diff changeset
3674 */
341
bf26081c373c avcodec_flush_buffers()
michaelni
parents: 336
diff changeset
3675 void avcodec_flush_buffers(AVCodecContext *avctx);
bf26081c373c avcodec_flush_buffers()
michaelni
parents: 336
diff changeset
3676
2522
e25782262d7d kill warnings patch by (M«©ns Rullg«©rd <mru inprovide com>)
michael
parents: 2520
diff changeset
3677 void avcodec_default_free_buffers(AVCodecContext *s);
e25782262d7d kill warnings patch by (M«©ns Rullg«©rd <mru inprovide com>)
michael
parents: 2520
diff changeset
3678
4559
53ed3a394b4b Correct typo.
takis
parents: 4555
diff changeset
3679 /* misc useful functions */
1264
2fa34e615c76 cleanup
michaelni
parents: 1260
diff changeset
3680
2fa34e615c76 cleanup
michaelni
parents: 1260
diff changeset
3681 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3682 * Return a single letter to describe the given picture type pict_type.
4569
dcf43f64d80d Doxygenize the comments for the av_get_pict_type_char() function.
takis
parents: 4568
diff changeset
3683 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3684 * @param[in] pict_type the picture type
4569
dcf43f64d80d Doxygenize the comments for the av_get_pict_type_char() function.
takis
parents: 4568
diff changeset
3685 * @return A single character representing the picture type.
1264
2fa34e615c76 cleanup
michaelni
parents: 1260
diff changeset
3686 */
2fa34e615c76 cleanup
michaelni
parents: 1260
diff changeset
3687 char av_get_pict_type_char(int pict_type);
2fa34e615c76 cleanup
michaelni
parents: 1260
diff changeset
3688
3433
e1906b2f1daf av_get_bits_per_sample and due simplifications
bcoudurier
parents: 3423
diff changeset
3689 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3690 * Return codec bits per sample.
4570
58be423405db Doxygenize the comments for the av_get_bits_per_sample() function.
takis
parents: 4569
diff changeset
3691 *
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3692 * @param[in] codec_id the codec
4570
58be423405db Doxygenize the comments for the av_get_bits_per_sample() function.
takis
parents: 4569
diff changeset
3693 * @return Number of bits per sample or zero if unknown for the given codec.
3433
e1906b2f1daf av_get_bits_per_sample and due simplifications
bcoudurier
parents: 3423
diff changeset
3694 */
e1906b2f1daf av_get_bits_per_sample and due simplifications
bcoudurier
parents: 3423
diff changeset
3695 int av_get_bits_per_sample(enum CodecID codec_id);
2801
747f816cee69 portable IEEE float/double read/write functions
michael
parents: 2796
diff changeset
3696
5537
3d10c3e84f96 Add av_get_bits_per_sample_format()
conrad
parents: 5483
diff changeset
3697 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3698 * Return sample format bits per sample.
5537
3d10c3e84f96 Add av_get_bits_per_sample_format()
conrad
parents: 5483
diff changeset
3699 *
3d10c3e84f96 Add av_get_bits_per_sample_format()
conrad
parents: 5483
diff changeset
3700 * @param[in] sample_fmt the sample format
3d10c3e84f96 Add av_get_bits_per_sample_format()
conrad
parents: 5483
diff changeset
3701 * @return Number of bits per sample or zero if unknown for the given sample format.
3d10c3e84f96 Add av_get_bits_per_sample_format()
conrad
parents: 5483
diff changeset
3702 */
3d10c3e84f96 Add av_get_bits_per_sample_format()
conrad
parents: 5483
diff changeset
3703 int av_get_bits_per_sample_format(enum SampleFormat sample_fmt);
3d10c3e84f96 Add av_get_bits_per_sample_format()
conrad
parents: 5483
diff changeset
3704
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3705 /* frame parsing */
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3706 typedef struct AVCodecParserContext {
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3707 void *priv_data;
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3708 struct AVCodecParser *parser;
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3709 int64_t frame_offset; /* offset of the current frame */
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3710 int64_t cur_offset; /* current offset
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3711 (incremented by each av_parser_parse()) */
6979
4257fdcf664e Rename last_frame_offset to next_frame_offset.
michael
parents: 6977
diff changeset
3712 int64_t next_frame_offset; /* offset of the next frame */
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3713 /* video info */
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3714 int pict_type; /* XXX: Put it back in AVCodecContext. */
9000
78afc2990d00 Use context variable repeat_pict for frame duration computation and
cehoyos
parents: 8989
diff changeset
3715 /**
78afc2990d00 Use context variable repeat_pict for frame duration computation and
cehoyos
parents: 8989
diff changeset
3716 * This field is used for proper frame duration computation in lavf.
78afc2990d00 Use context variable repeat_pict for frame duration computation and
cehoyos
parents: 8989
diff changeset
3717 * It signals, how much longer the frame duration of the current frame
78afc2990d00 Use context variable repeat_pict for frame duration computation and
cehoyos
parents: 8989
diff changeset
3718 * is compared to normal frame duration.
78afc2990d00 Use context variable repeat_pict for frame duration computation and
cehoyos
parents: 8989
diff changeset
3719 *
9034
96731d42ca82 Change duration computation to use time_base instead of TB/2.
cehoyos
parents: 9012
diff changeset
3720 * frame_duration = (1 + repeat_pict) * time_base
9000
78afc2990d00 Use context variable repeat_pict for frame duration computation and
cehoyos
parents: 8989
diff changeset
3721 *
78afc2990d00 Use context variable repeat_pict for frame duration computation and
cehoyos
parents: 8989
diff changeset
3722 * It is used by codecs like H.264 to display telecined material.
78afc2990d00 Use context variable repeat_pict for frame duration computation and
cehoyos
parents: 8989
diff changeset
3723 */
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3724 int repeat_pict; /* XXX: Put it back in AVCodecContext. */
1696
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3725 int64_t pts; /* pts of the current frame */
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3726 int64_t dts; /* dts of the current frame */
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3727
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3728 /* private data */
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3729 int64_t last_pts;
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3730 int64_t last_dts;
2030
f796043935f3 mpeg audio timestamp fix
michael
parents: 2026
diff changeset
3731 int fetch_timestamp;
1696
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3732
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3733 #define AV_PARSER_PTS_NB 4
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3734 int cur_frame_start_index;
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3735 int64_t cur_frame_offset[AV_PARSER_PTS_NB];
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3736 int64_t cur_frame_pts[AV_PARSER_PTS_NB];
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3737 int64_t cur_frame_dts[AV_PARSER_PTS_NB];
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3738
2837
45ccf6842c34 parse pict_type for streams in avi
michael
parents: 2817
diff changeset
3739 int flags;
45ccf6842c34 parse pict_type for streams in avi
michael
parents: 2817
diff changeset
3740 #define PARSER_FLAG_COMPLETE_FRAMES 0x0001
11770
6d58a4f5e455 Add an AVSTREAM_PARSE_FULL_ONCE parsing mode to parse headers and combine packets once and only once.
alexc
parents: 11756
diff changeset
3741 #define PARSER_FLAG_ONCE 0x0002
4846
841ecebff8c8 timestamps generation improvement when parsing avi
benoit
parents: 4803
diff changeset
3742
841ecebff8c8 timestamps generation improvement when parsing avi
benoit
parents: 4803
diff changeset
3743 int64_t offset; ///< byte offset from starting packet start
6987
2dde03056bd6 Move new field to the end to avoid ABI breakage, I thought this struct
michael
parents: 6979
diff changeset
3744 int64_t cur_frame_end[AV_PARSER_PTS_NB];
8973
34f2c7189710 Add key_frame to AVCodecParserContext, used in libavformat.
cehoyos
parents: 8933
diff changeset
3745
34f2c7189710 Add key_frame to AVCodecParserContext, used in libavformat.
cehoyos
parents: 8933
diff changeset
3746 /*!
34f2c7189710 Add key_frame to AVCodecParserContext, used in libavformat.
cehoyos
parents: 8933
diff changeset
3747 * Set by parser to 1 for key frames and 0 for non-key frames.
34f2c7189710 Add key_frame to AVCodecParserContext, used in libavformat.
cehoyos
parents: 8933
diff changeset
3748 * It is initialized to -1, so if the parser doesn't set this flag,
34f2c7189710 Add key_frame to AVCodecParserContext, used in libavformat.
cehoyos
parents: 8933
diff changeset
3749 * old-style fallback using FF_I_TYPE picture type as key frames
34f2c7189710 Add key_frame to AVCodecParserContext, used in libavformat.
cehoyos
parents: 8933
diff changeset
3750 * will be used.
34f2c7189710 Add key_frame to AVCodecParserContext, used in libavformat.
cehoyos
parents: 8933
diff changeset
3751 */
34f2c7189710 Add key_frame to AVCodecParserContext, used in libavformat.
cehoyos
parents: 8933
diff changeset
3752 int key_frame;
8989
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3753
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3754 /**
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3755 * Time difference in stream time base units from the pts of this
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3756 * packet to the point at which the output from the decoder has converged
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3757 * independent from the availability of previous frames. That is, the
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3758 * frames are virtually identical no matter if decoding started from
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3759 * the very first frame or from this keyframe.
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3760 * Is AV_NOPTS_VALUE if unknown.
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3761 * This field is not the display duration of the current frame.
12080
7e6a8ce19977 fix comment grammar
aurel
parents: 12077
diff changeset
3762 * This field has no meaning if the packet does not have AV_PKT_FLAG_KEY
7e6a8ce19977 fix comment grammar
aurel
parents: 12077
diff changeset
3763 * set.
8989
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3764 *
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3765 * The purpose of this field is to allow seeking in streams that have no
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3766 * keyframes in the conventional sense. It corresponds to the
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3767 * recovery point SEI in H.264 and match_time_delta in NUT. It is also
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3768 * essential for some types of subtitle streams to ensure that all
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3769 * subtitles are correctly displayed after seeking.
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3770 */
cdd8fa4a362a Add convergence_duration to AVCodecParserContext.
cehoyos
parents: 8984
diff changeset
3771 int64_t convergence_duration;
9038
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3772
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3773 // Timestamp generation support:
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3774 /**
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3775 * Synchronization point for start of timestamp generation.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3776 *
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3777 * Set to >0 for sync point, 0 for no sync point and <0 for undefined
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3778 * (default).
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3779 *
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3780 * For example, this corresponds to presence of H.264 buffering period
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3781 * SEI message.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3782 */
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3783 int dts_sync_point;
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3784
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3785 /**
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3786 * Offset of the current timestamp against last timestamp sync point in
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3787 * units of AVCodecContext.time_base.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3788 *
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3789 * Set to INT_MIN when dts_sync_point unused. Otherwise, it must
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3790 * contain a valid timestamp offset.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3791 *
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3792 * Note that the timestamp of sync point has usually a nonzero
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3793 * dts_ref_dts_delta, which refers to the previous sync point. Offset of
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3794 * the next frame after timestamp sync point will be usually 1.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3795 *
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3796 * For example, this corresponds to H.264 cpb_removal_delay.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3797 */
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3798 int dts_ref_dts_delta;
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3799
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3800 /**
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3801 * Presentation delay of current frame in units of AVCodecContext.time_base.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3802 *
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3803 * Set to INT_MIN when dts_sync_point unused. Otherwise, it must
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3804 * contain valid non-negative timestamp delta (presentation time of a frame
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3805 * must not lie in the past).
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3806 *
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3807 * This delay represents the difference between decoding and presentation
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3808 * time of the frame.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3809 *
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3810 * For example, this corresponds to H.264 dpb_output_delay.
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3811 */
d4c12f2d226b Add timestamp computation if values are exported by decoder.
cehoyos
parents: 9034
diff changeset
3812 int pts_dts_delta;
9140
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3813
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3814 /**
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3815 * Position of the packet in file.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3816 *
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3817 * Analogous to cur_frame_pts/dts
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3818 */
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3819 int64_t cur_frame_pos[AV_PARSER_PTS_NB];
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3820
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3821 /**
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3822 * Byte position of currently parsed frame in stream.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3823 */
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3824 int64_t pos;
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3825
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3826 /**
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3827 * Previous frame byte position.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3828 */
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3829 int64_t last_pos;
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3830 } AVCodecParserContext;
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3831
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3832 typedef struct AVCodecParser {
2348
d02fb928ca44 pnm parser
michael
parents: 2344
diff changeset
3833 int codec_ids[5]; /* several codec IDs are permitted */
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3834 int priv_data_size;
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3835 int (*parser_init)(AVCodecParserContext *s);
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3836 int (*parser_parse)(AVCodecParserContext *s,
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3837 AVCodecContext *avctx,
4931
0d1cc37d9430 make some parser parameters const to avoid casting const to non-const
aurel
parents: 4901
diff changeset
3838 const uint8_t **poutbuf, int *poutbuf_size,
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3839 const uint8_t *buf, int buf_size);
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3840 void (*parser_close)(AVCodecParserContext *s);
2769
1394b45a7bf4 support changing in bitstream global headers into extradata style and back
michael
parents: 2768
diff changeset
3841 int (*split)(AVCodecContext *avctx, const uint8_t *buf, int buf_size);
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3842 struct AVCodecParser *next;
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3843 } AVCodecParser;
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3844
6011
b1fe945d73f9 av_*_next() API for libavcodec
michael
parents: 6010
diff changeset
3845 AVCodecParser *av_parser_next(AVCodecParser *c);
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3846
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3847 void av_register_codec_parser(AVCodecParser *parser);
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3848 AVCodecParserContext *av_parser_init(int codec_id);
9140
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3849
9218
18dffa8f2382 Remove deprecated functions and structures on next version bump.
diego
parents: 9217
diff changeset
3850 #if LIBAVCODEC_VERSION_MAJOR < 53
9140
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3851 attribute_deprecated
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3852 int av_parser_parse(AVCodecParserContext *s,
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3853 AVCodecContext *avctx,
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3854 uint8_t **poutbuf, int *poutbuf_size,
1696
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3855 const uint8_t *buf, int buf_size,
f5af91b8be17 pts and dts support in parser API
bellard
parents: 1688
diff changeset
3856 int64_t pts, int64_t dts);
9218
18dffa8f2382 Remove deprecated functions and structures on next version bump.
diego
parents: 9217
diff changeset
3857 #endif
9140
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3858
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3859 /**
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3860 * Parse a packet.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3861 *
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3862 * @param s parser context.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3863 * @param avctx codec context.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3864 * @param poutbuf set to pointer to parsed buffer or NULL if not yet finished.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3865 * @param poutbuf_size set to size of parsed buffer or zero if not yet finished.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3866 * @param buf input buffer.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3867 * @param buf_size input length, to signal EOF, this should be 0 (so that the last frame can be output).
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3868 * @param pts input presentation timestamp.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3869 * @param dts input decoding timestamp.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3870 * @param pos input byte position in stream.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3871 * @return the number of bytes of the input bitstream used.
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3872 *
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3873 * Example:
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3874 * @code
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3875 * while(in_len){
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3876 * len = av_parser_parse2(myparser, AVCodecContext, &data, &size,
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3877 * in_data, in_len,
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3878 * pts, dts, pos);
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3879 * in_data += len;
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3880 * in_len -= len;
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3881 *
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3882 * if(size)
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3883 * decode_frame(data, size);
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3884 * }
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3885 * @endcode
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3886 */
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3887 int av_parser_parse2(AVCodecParserContext *s,
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3888 AVCodecContext *avctx,
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3889 uint8_t **poutbuf, int *poutbuf_size,
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3890 const uint8_t *buf, int buf_size,
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3891 int64_t pts, int64_t dts,
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3892 int64_t pos);
322fa07fd397 Add handling of frame position in the parser.
schreter
parents: 9059
diff changeset
3893
2769
1394b45a7bf4 support changing in bitstream global headers into extradata style and back
michael
parents: 2768
diff changeset
3894 int av_parser_change(AVCodecParserContext *s,
1394b45a7bf4 support changing in bitstream global headers into extradata style and back
michael
parents: 2768
diff changeset
3895 AVCodecContext *avctx,
2967
ef2149182f1c COSMETICS: Remove all trailing whitespace.
diego
parents: 2956
diff changeset
3896 uint8_t **poutbuf, int *poutbuf_size,
2769
1394b45a7bf4 support changing in bitstream global headers into extradata style and back
michael
parents: 2768
diff changeset
3897 const uint8_t *buf, int buf_size, int keyframe);
1613
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3898 void av_parser_close(AVCodecParserContext *s);
0279c6c61f11 new audio/video parser API
bellard
parents: 1610
diff changeset
3899
3421
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3900
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3901 typedef struct AVBitStreamFilterContext {
3422
6ce5ece8e2ea noise bitstream filter
michael
parents: 3421
diff changeset
3902 void *priv_data;
3421
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3903 struct AVBitStreamFilter *filter;
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3904 AVCodecParserContext *parser;
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3905 struct AVBitStreamFilterContext *next;
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3906 } AVBitStreamFilterContext;
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3907
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3908
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3909 typedef struct AVBitStreamFilter {
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3910 const char *name;
3422
6ce5ece8e2ea noise bitstream filter
michael
parents: 3421
diff changeset
3911 int priv_data_size;
3421
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3912 int (*filter)(AVBitStreamFilterContext *bsfc,
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3913 AVCodecContext *avctx, const char *args,
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3914 uint8_t **poutbuf, int *poutbuf_size,
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3915 const uint8_t *buf, int buf_size, int keyframe);
5630
327f714d69c0 add a close function to bitstream filter
benoit
parents: 5618
diff changeset
3916 void (*close)(AVBitStreamFilterContext *bsfc);
3421
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3917 struct AVBitStreamFilter *next;
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3918 } AVBitStreamFilter;
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3919
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3920 void av_register_bitstream_filter(AVBitStreamFilter *bsf);
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3921 AVBitStreamFilterContext *av_bitstream_filter_init(const char *name);
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3922 int av_bitstream_filter_filter(AVBitStreamFilterContext *bsfc,
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3923 AVCodecContext *avctx, const char *args,
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3924 uint8_t **poutbuf, int *poutbuf_size,
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3925 const uint8_t *buf, int buf_size, int keyframe);
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3926 void av_bitstream_filter_close(AVBitStreamFilterContext *bsf);
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3927
6011
b1fe945d73f9 av_*_next() API for libavcodec
michael
parents: 6010
diff changeset
3928 AVBitStreamFilter *av_bitstream_filter_next(AVBitStreamFilter *f);
3421
b7826511f7b6 AVBitStreamFilter (some thingy which can modify the bitstream like add or remove global headers or change the headers or ...)
michael
parents: 3392
diff changeset
3929
492
de11e138a661 memory functions are exported
bellard
parents: 485
diff changeset
3930 /* memory */
4567
f0138063c568 Move the Doxygen function documentation unaltered from libavcodec/utils.c to
takis
parents: 4566
diff changeset
3931
f0138063c568 Move the Doxygen function documentation unaltered from libavcodec/utils.c to
takis
parents: 4566
diff changeset
3932 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3933 * Reallocate the given block if it is not large enough, otherwise do nothing.
4574
a9388782b9b0 Doxygenize the comments for the av_fast_realloc() function.
takis
parents: 4573
diff changeset
3934 *
a9388782b9b0 Doxygenize the comments for the av_fast_realloc() function.
takis
parents: 4573
diff changeset
3935 * @see av_realloc
4567
f0138063c568 Move the Doxygen function documentation unaltered from libavcodec/utils.c to
takis
parents: 4566
diff changeset
3936 */
1058
3c3da6edc9a1 * still unfinished code for Options
kabi
parents: 1055
diff changeset
3937 void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
4567
f0138063c568 Move the Doxygen function documentation unaltered from libavcodec/utils.c to
takis
parents: 4566
diff changeset
3938
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3939 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3940 * Allocate a buffer, reusing the given one if large enough.
9415
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3941 *
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3942 * Contrary to av_fast_realloc the current buffer contents might not be
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3943 * preserved and on error the old buffer is freed, thus no special
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3944 * handling to avoid memleaks is necessary.
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3945 *
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3946 * @param ptr pointer to pointer to already allocated buffer, overwritten with pointer to new buffer
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3947 * @param size size of the buffer *ptr points to
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3948 * @param min_size minimum size of *ptr buffer after returning, *ptr will be NULL and
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3949 * *size 0 if an error occurred.
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3950 */
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3951 void av_fast_malloc(void *ptr, unsigned int *size, unsigned int min_size);
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3952
141badec76fc Add a av_fast_malloc function and replace several uses of av_fast_realloc,
reimar
parents: 9409
diff changeset
3953 /**
12384
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3954 * Copy image data in src_data to dst_data.
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3955 *
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3956 * @param dst_linesize linesizes for the image in dst_data
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3957 * @param src_linesize linesizes for the image in src_data
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3958 */
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3959 void av_picture_data_copy(uint8_t *dst_data[4], int dst_linesize[4],
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3960 uint8_t *src_data[4], int src_linesize[4],
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3961 enum PixelFormat pix_fmt, int width, int height);
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3962
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3963 /**
e1ef713061ce Add av_picture_data_copy() and reimplement av_picture_copy() as a
stefano
parents: 12371
diff changeset
3964 * Copy image src to dst. Wraps av_picture_data_copy() above.
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3965 */
4624
6a900f539e2c Add the prefix "av_" to img_crop(), img_copy() and img_pad(), and rename "img"
takis
parents: 4623
diff changeset
3966 void av_picture_copy(AVPicture *dst, const AVPicture *src,
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3967 enum PixelFormat pix_fmt, int width, int height);
1630
586b5c08863c - Add reget_buffer() function to AVCodecContext
rtognimp
parents: 1624
diff changeset
3968
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3969 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3970 * Crop image top and left side.
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3971 */
4624
6a900f539e2c Add the prefix "av_" to img_crop(), img_copy() and img_pad(), and rename "img"
takis
parents: 4623
diff changeset
3972 int av_picture_crop(AVPicture *dst, const AVPicture *src,
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3973 enum PixelFormat pix_fmt, int top_band, int left_band);
3179
870bbd067df8 Fix cropping, depending on enc pix fmt
bcoudurier
parents: 3136
diff changeset
3974
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3975 /**
4794
2c9f06854306 spelling/wording/grammar
diego
parents: 4790
diff changeset
3976 * Pad image.
4593
2aea8bf268d8 Move the unaltered documentation of the functions which are part of the public
takis
parents: 4588
diff changeset
3977 */
9221
a15ec86bf752 Globally prefer enum PixelFormat over int when it makes sense.
stefano
parents: 9218
diff changeset
3978 int av_picture_pad(AVPicture *dst, const AVPicture *src, int height, int width, enum PixelFormat pix_fmt,
3257
63f61b09dcee Baptiste COUDURIER's padding patch (reworked by me a little bit).
lucabe
parents: 3254
diff changeset
3979 int padtop, int padbottom, int padleft, int padright, int *color);
63f61b09dcee Baptiste COUDURIER's padding patch (reworked by me a little bit).
lucabe
parents: 3254
diff changeset
3980
11528
b0e1c40e9d07 Add doxygen docs for av_xiphlacing
mstorsjo
parents: 11492
diff changeset
3981 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3982 * Encode extradata length to a buffer. Used by xiph codecs.
11528
b0e1c40e9d07 Add doxygen docs for av_xiphlacing
mstorsjo
parents: 11492
diff changeset
3983 *
b0e1c40e9d07 Add doxygen docs for av_xiphlacing
mstorsjo
parents: 11492
diff changeset
3984 * @param s buffer to write to; must be at least (v/255+1) bytes long
b0e1c40e9d07 Add doxygen docs for av_xiphlacing
mstorsjo
parents: 11492
diff changeset
3985 * @param v size of extradata in bytes
b0e1c40e9d07 Add doxygen docs for av_xiphlacing
mstorsjo
parents: 11492
diff changeset
3986 * @return number of bytes written to the buffer.
b0e1c40e9d07 Add doxygen docs for av_xiphlacing
mstorsjo
parents: 11492
diff changeset
3987 */
8250
cf4d575b1982 Delete unnecessary 'extern' keywords.
diego
parents: 8240
diff changeset
3988 unsigned int av_xiphlacing(unsigned char *s, unsigned int v);
2676
0975710cf7f4 change extradata format for vorbis
mru
parents: 2658
diff changeset
3989
12280
fbc6fc80e6c6 Deprecate av_parse_video_frame_size() and av_parse_video_frame_rate()
stefano
parents: 12267
diff changeset
3990 #if LIBAVCODEC_VERSION_MAJOR < 53
5126
7982b376b58a Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 5124
diff changeset
3991 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3992 * Parse str and put in width_ptr and height_ptr the detected values.
5126
7982b376b58a Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 5124
diff changeset
3993 *
12280
fbc6fc80e6c6 Deprecate av_parse_video_frame_size() and av_parse_video_frame_rate()
stefano
parents: 12267
diff changeset
3994 * @deprecated Deprecated in favor of av_parse_video_size().
5126
7982b376b58a Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 5124
diff changeset
3995 */
12280
fbc6fc80e6c6 Deprecate av_parse_video_frame_size() and av_parse_video_frame_rate()
stefano
parents: 12267
diff changeset
3996 attribute_deprecated int av_parse_video_frame_size(int *width_ptr, int *height_ptr, const char *str);
5126
7982b376b58a Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 5124
diff changeset
3997
7982b376b58a Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 5124
diff changeset
3998 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
3999 * Parse str and store the detected values in *frame_rate.
5126
7982b376b58a Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 5124
diff changeset
4000 *
12280
fbc6fc80e6c6 Deprecate av_parse_video_frame_size() and av_parse_video_frame_rate()
stefano
parents: 12267
diff changeset
4001 * @deprecated Deprecated in favor of av_parse_video_rate().
5126
7982b376b58a Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 5124
diff changeset
4002 */
12280
fbc6fc80e6c6 Deprecate av_parse_video_frame_size() and av_parse_video_frame_rate()
stefano
parents: 12267
diff changeset
4003 attribute_deprecated int av_parse_video_frame_rate(AVRational *frame_rate, const char *str);
fbc6fc80e6c6 Deprecate av_parse_video_frame_size() and av_parse_video_frame_rate()
stefano
parents: 12267
diff changeset
4004 #endif
5126
7982b376b58a Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 5124
diff changeset
4005
9012
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4006 /**
9893
1d10ec092b64 Add doxy to av_log_missing_feature() etc. stating that the function is
rbultje
parents: 9892
diff changeset
4007 * Logs a generic warning message about a missing feature. This function is
1d10ec092b64 Add doxy to av_log_missing_feature() etc. stating that the function is
rbultje
parents: 9892
diff changeset
4008 * intended to be used internally by FFmpeg (libavcodec, libavformat, etc.)
1d10ec092b64 Add doxy to av_log_missing_feature() etc. stating that the function is
rbultje
parents: 9892
diff changeset
4009 * only, and would normally not be used by applications.
9892
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4010 * @param[in] avc a pointer to an arbitrary struct of which the first field is
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4011 * a pointer to an AVClass struct
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4012 * @param[in] feature string containing the name of the missing feature
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4013 * @param[in] want_sample indicates if samples are wanted which exhibit this feature.
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4014 * If want_sample is non-zero, additional verbage will be added to the log
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4015 * message which tells the user how to report samples to the development
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4016 * mailing list.
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4017 */
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4018 void av_log_missing_feature(void *avc, const char *feature, int want_sample);
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4019
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4020 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
4021 * Log a generic warning message asking for a sample. This function is
9893
1d10ec092b64 Add doxy to av_log_missing_feature() etc. stating that the function is
rbultje
parents: 9892
diff changeset
4022 * intended to be used internally by FFmpeg (libavcodec, libavformat, etc.)
1d10ec092b64 Add doxy to av_log_missing_feature() etc. stating that the function is
rbultje
parents: 9892
diff changeset
4023 * only, and would normally not be used by applications.
9892
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4024 * @param[in] avc a pointer to an arbitrary struct of which the first field is
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4025 * a pointer to an AVClass struct
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4026 * @param[in] msg string containing an optional message, or NULL if no message
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4027 */
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4028 void av_log_ask_for_sample(void *avc, const char *msg);
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4029
b5ca6219e173 Move av_log_missing_feature() from the internal.h to the public avcodec.h
rbultje
parents: 9882
diff changeset
4030 /**
12024
fdafbcef52f5 Fix grammar errors in documentation
mru
parents: 11921
diff changeset
4031 * Register the hardware accelerator hwaccel.
9012
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4032 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4033 void av_register_hwaccel(AVHWAccel *hwaccel);
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4034
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4035 /**
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4036 * If hwaccel is NULL, returns the first registered hardware accelerator,
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4037 * if hwaccel is non-NULL, returns the next registered hardware accelerator
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4038 * after hwaccel, or NULL if hwaccel is the last one.
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4039 */
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4040 AVHWAccel *av_hwaccel_next(AVHWAccel *hwaccel);
15a3df8c01fd More approved hunks for VAAPI & our new and cleaner hwaccel API.
michael
parents: 9000
diff changeset
4041
9742
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4042
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4043 /**
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4044 * Lock operation used by lockmgr
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4045 */
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4046 enum AVLockOp {
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4047 AV_LOCK_CREATE, ///< Create a mutex
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4048 AV_LOCK_OBTAIN, ///< Lock the mutex
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4049 AV_LOCK_RELEASE, ///< Unlock the mutex
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4050 AV_LOCK_DESTROY, ///< Free mutex resources
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4051 };
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4052
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4053 /**
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4054 * Register a user provided lock manager supporting the operations
9822
2887f410011f Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents: 9786
diff changeset
4055 * specified by AVLockOp. mutex points to a (void *) where the
9742
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4056 * lockmgr should store/get a pointer to a user allocated mutex. It's
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4057 * NULL upon AV_LOCK_CREATE and != NULL for all other ops.
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4058 *
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4059 * @param cb User defined callback. Note: FFmpeg may invoke calls to this
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4060 * callback during the call to av_lockmgr_register().
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4061 * Thus, the application must be prepared to handle that.
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4062 * If cb is set to NULL the lockmgr will be unregistered.
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4063 * Also note that during unregistration the previously registered
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4064 * lockmgr callback may also be invoked.
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4065 */
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4066 int av_lockmgr_register(int (*cb)(void **mutex, enum AVLockOp op));
0d6f887d91fb Add a lock manager API to libavcodec.
andoma
parents: 9722
diff changeset
4067
7760
c4a4495715dd Globally rename the header inclusion guard names.
stefano
parents: 7736
diff changeset
4068 #endif /* AVCODEC_AVCODEC_H */