general.texi 42.4 KB
Newer Older
1 2 3 4 5 6 7
\input texinfo @c -*- texinfo -*-

@settitle General Documentation
@titlepage
@center @titlefont{General Documentation}
@end titlepage

8 9 10
@top

@contents
11

12
@chapter External libraries
13

14
Libav can be hooked up with a number of external libraries to add support
15
for more formats. None of them are used by default, their use has to be
16 17
explicitly requested by passing the appropriate flags to
@command{./configure}.
18

19
@section OpenCORE and VisualOn libraries
20

21 22
Spun off Google Android sources, OpenCore, VisualOn and Fraunhofer
libraries provide encoders for a number of audio codecs.
23

24 25 26
@float NOTE
OpenCORE and VisualOn libraries are under the Apache License 2.0
(see @url{http://www.apache.org/licenses/LICENSE-2.0} for details), which is
27
incompatible with the LGPL version 2.1 and GPL version 2. You have to
28
upgrade Libav's license to LGPL version 3 (or if you have enabled
29
GPL components, GPL version 3) to use it.
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
@end float

@subsection OpenCORE AMR

Libav can make use of the OpenCORE libraries for AMR-NB
decoding/encoding and AMR-WB decoding.

Go to @url{http://sourceforge.net/projects/opencore-amr/} and follow the
instructions for installing the libraries.
Then pass @code{--enable-libopencore-amrnb} and/or
@code{--enable-libopencore-amrwb} to configure to enable them.

@subsection VisualOn AAC encoder library

Libav can make use of the VisualOn AACenc library for AAC encoding.

Go to @url{http://sourceforge.net/projects/opencore-amr/} and follow the
instructions for installing the library.
Then pass @code{--enable-libvo-aacenc} to configure to enable it.

@subsection VisualOn AMR-WB encoder library

Libav can make use of the VisualOn AMR-WBenc library for AMR-WB encoding.

Go to @url{http://sourceforge.net/projects/opencore-amr/} and follow the
instructions for installing the library.
Then pass @code{--enable-libvo-amrwbenc} to configure to enable it.

58 59 60 61 62 63 64 65
@subsection Fraunhofer AAC library

Libav can make use of the Fraunhofer AAC library for AAC encoding.

Go to @url{http://sourceforge.net/projects/opencore-amr/} and follow the
instructions for installing the library.
Then pass @code{--enable-libfdk-aac} to configure to enable it.

66 67 68 69 70 71 72 73
@section LAME

Libav can make use of the LAME library for MP3 encoding.

Go to @url{http://lame.sourceforge.net/} and follow the
instructions for installing the library.
Then pass @code{--enable-libmp3lame} to configure to enable it.

Paul B Mahol's avatar
Paul B Mahol committed
74 75 76 77 78 79 80 81
@section TwoLAME

Libav can make use of the TwoLAME library for MP2 encoding.

Go to @url{http://www.twolame.org/} and follow the
instructions for installing the library.
Then pass @code{--enable-libtwolame} to configure to enable it.

82 83 84 85 86 87 88 89
@section libvpx

Libav can make use of the libvpx library for VP8 encoding.

Go to @url{http://www.webmproject.org/} and follow the instructions for
installing the library. Then pass @code{--enable-libvpx} to configure to
enable it.

90 91 92 93 94 95 96 97
@section libwavpack

Libav can make use of the libwavpack library for WavPack encoding.

Go to @url{http://www.wavpack.com/} and follow the instructions for
installing the library. Then pass @code{--enable-libwavpack} to configure to
enable it.

98 99 100 101 102 103 104 105
@section OpenH264

Libav can make use of the OpenH264 library for H.264 encoding.

Go to @url{http://www.openh264.org/} and follow the instructions for
installing the library. Then pass @code{--enable-libopenh264} to configure to
enable it.

106 107 108 109 110 111 112 113 114 115 116 117 118 119
@section x264

Libav can make use of the x264 library for H.264 encoding.

Go to @url{http://www.videolan.org/developers/x264.html} and follow the
instructions for installing the library. Then pass @code{--enable-libx264} to
configure to enable it.

@float NOTE
x264 is under the GNU Public License Version 2 or later
(see @url{http://www.gnu.org/licenses/old-licenses/gpl-2.0.html} for
details), you must upgrade Libav's license to GPL in order to use it.
@end float

Derek Buitenhuis's avatar
Derek Buitenhuis committed
120 121 122 123 124 125 126 127 128 129 130
@section x265

Libav can make use of the x265 library for HEVC encoding.

Go to @url{http://x265.org/developers.html} and follow the instructions
for installing the library. Then pass @code{--enable-libx265} to configure
to enable it.

@float note
x265 is under the GNU Public License Version 2 or later
(see @url{http://www.gnu.org/licenses/old-licenses/gpl-2.0.html} for
Diego Biurrun's avatar
Diego Biurrun committed
131
details), you must upgrade Libav's license to GPL in order to use it.
Derek Buitenhuis's avatar
Derek Buitenhuis committed
132 133
@end float

134 135 136 137 138 139 140 141 142 143 144
@section libilbc

iLBC is a narrowband speech codec that has been made freely available
by Google as part of the WebRTC project. libilbc is a packaging friendly
copy of the iLBC codec. Libav can make use of the libilbc library for
iLBC encoding and decoding.

Go to @url{https://github.com/dekkers/libilbc} and follow the instructions for
installing the library. Then pass @code{--enable-libilbc} to configure to
enable it.

145 146 147
@section AviSynth

Libav can read AviSynth scripts as input. To enable support you need a
148 149 150 151
suitable @file{avisynth_c.h} header to compile against. The header as
provided by AviSynth+ is fully compatible. AviSynth 2.5 is not supported
by Libav. Once you have the appropriate header, pass
@code{--enable-avisynth} to configure to enable AviSynth support.
152 153

For Windows, supported AviSynth variants are
154 155
@url{http://avisynth.nl, AviSynth 2.6 RC1 or higher} for 32-bit builds and
@url{http://avs-plus.net, AviSynth+ r1718 or higher} for 32-bit and 64-bit builds.
156 157 158 159 160 161 162 163 164 165 166
@url{https://github.com/AviSynth/AviSynthPlus, AviSynth+'s git repository}
provides a GNU-style Makefile which can install just the headers using
@code{make install PREFIX=/install/prefix}.

@float NOTE
When using AviSynth+'s installed headers, the user must also pass
the avisynth/ include directory to @code{--extra-cflags}. For example,
if the PREFIX given to AviSynth+'s Makefile was /usr/i686-w64-mingw32,
then the correct command would be
@code{--extra-cflags="-I/usr/i686-w64-mingw32/include/avisynth"}.
@end float
167 168 169 170 171 172 173 174 175

For Linux and OS X, the supported AviSynth variant is
@url{https://github.com/avxsynth/avxsynth, AvxSynth}.
@file{avxsynth_c.h} is installed as part of the normal
build routine, as illustrated on
@url{https://github.com/avxsynth/avxsynth/wiki/System-Setup, AvxSynth's wiki}.
(the instructions for compiling its prerequisites are outdated, as FFMS 2.18
or higher is now needed; the list of dependencies to be downloaded from the
repositories is still the same, though).
176

177 178 179 180 181 182
@float NOTE
AviSynth and AvxSynth are loaded dynamically.  Distributors can build Libav
with @code{--enable-avisynth}, and the binaries will work regardless of the
end user having AviSynth or AvxSynth installed - they'll only need to be
installed to use AviSynth scripts (obviously).
@end float
183 184 185

@chapter Supported File Formats and Codecs

Daniel Verkamp's avatar
Daniel Verkamp committed
186
You can use the @code{-formats} and @code{-codecs} options to have an exhaustive list.
187 188 189

@section File Formats

190
Libav supports the following file formats through the @code{libavformat}
191 192 193
library:

@multitable @columnfractions .4 .1 .1 .4
194
@item Name @tab Encoding @tab Decoding @tab Comments
Diego Biurrun's avatar
Diego Biurrun committed
195
@item 4xm                       @tab   @tab X
196
    @tab 4X Technologies format, used in some games.
197
@item 8088flex TMV              @tab   @tab X
198
@item Adobe Filmstrip           @tab X @tab X
199
@item Audio IFF (AIFF)          @tab X @tab X
Diego Biurrun's avatar
Diego Biurrun committed
200 201
@item American Laser Games MM   @tab   @tab X
    @tab Multimedia format used in games like Mad Dog McCree.
202
@item 3GPP AMR                  @tab X @tab X
Paul B Mahol's avatar
Paul B Mahol committed
203 204
@item Amazing Studio Packed Animation File  @tab   @tab X
    @tab Multimedia format used in game Heart Of Darkness.
205
@item Apple HTTP Live Streaming @tab   @tab X
206 207
@item ASF                       @tab X @tab X
@item AVI                       @tab X @tab X
208
@item AviSynth                  @tab   @tab X
209
@item AVS                       @tab   @tab X
210
    @tab Multimedia format used by the Creature Shock game.
211 212 213
@item Beam Software SIFF        @tab   @tab X
    @tab Audio and video format used in some games by Beam Software.
@item Bethesda Softworks VID    @tab   @tab X
214
    @tab Used in some games from Bethesda Softworks.
Peter Ross's avatar
Peter Ross committed
215 216
@item Bink                      @tab   @tab X
    @tab Multimedia format used by many games.
Peter Ross's avatar
Peter Ross committed
217 218
@item Bitmap Brothers JV        @tab   @tab X
    @tab Used in Z and Z95 games.
219 220
@item Brute Force & Ignorance   @tab   @tab X
    @tab Used in the game Flash Traffic: City of Angels.
Tomas Härdin's avatar
Tomas Härdin committed
221
@item BWF                       @tab X @tab X
Justin Ruggles's avatar
Justin Ruggles committed
222
@item CRI ADX                   @tab X @tab X
223
    @tab Audio-only format used in console video games.
Kostya Shishkov's avatar
Kostya Shishkov committed
224
@item Discworld II BMV          @tab   @tab X
225
@item Interplay C93             @tab   @tab X
226
    @tab Used in the game Cyberia from Interplay.
227
@item Delphine Software International CIN @tab   @tab X
228
    @tab Multimedia format used by Delphine Software games.
Oleksij Rempel's avatar
Oleksij Rempel committed
229
@item Digital Speech Standard (DSS) @tab   @tab X
Vittorio Giovara's avatar
Vittorio Giovara committed
230
@item Canopus HQX               @tab   @tab X
Michael Tison's avatar
Michael Tison committed
231 232
@item CD+G                      @tab   @tab X
    @tab Video format used by CD+G karaoke disks
Paul B Mahol's avatar
Paul B Mahol committed
233 234
@item Commodore CDXL            @tab   @tab X
    @tab Amiga CD video format
Peter Ross's avatar
Peter Ross committed
235 236
@item Core Audio Format         @tab   @tab X
    @tab Apple Core Audio Format
237
@item CRC testing format        @tab X @tab
238
@item Creative Voice            @tab X @tab X
239
    @tab Created for the Sound Blaster Pro.
Diego Biurrun's avatar
Diego Biurrun committed
240 241
@item CRYO APC                  @tab   @tab X
    @tab Audio format used in some games by CRYO Interactive Entertainment.
242
@item D-Cinema audio            @tab X @tab X
Peter Ross's avatar
Peter Ross committed
243
@item Deluxe Paint Animation    @tab   @tab X
Kostya Shishkov's avatar
Kostya Shishkov committed
244 245
@item DFA                       @tab   @tab X
    @tab This format is used in Chronomaster game
246
@item DV video                  @tab X @tab X
247
@item DXA                       @tab   @tab X
248 249
    @tab This format is used in the non-Windows version of the Feeble Files
         game and different game cutscenes repacked for use with ScummVM.
250
@item Electronic Arts cdata  @tab    @tab X
251
@item Electronic Arts Multimedia  @tab    @tab X
252
    @tab Used in various EA games; files have extensions like WVE and UV2.
253
@item Flash (SWF)               @tab X @tab X
254 255 256
@item Flash 9 (AVM2)            @tab X @tab X
    @tab Only embedded audio is decoded.
@item FLI/FLC/FLX animation     @tab   @tab X
257
    @tab .fli/.flc files
258
@item Flash Video (FLV)         @tab X @tab X
259
    @tab Macromedia Flash video files
260
@item framecrc testing format   @tab X @tab
261 262
@item FunCom ISS                @tab   @tab X
    @tab Audio format used in various games from FunCom like The Longest Journey.
263
@item GIF Animation             @tab X @tab
264
@item GXF                       @tab X @tab X
265
    @tab General eXchange Format SMPTE 360M, used by Thomson Grass Valley
Diego Biurrun's avatar
Diego Biurrun committed
266
         playout servers.
267 268
@item HNM @tab   @tab X
    @tab Only version 4 supported, used in some games from Cryo Interactive
269
@item id Quake II CIN video     @tab   @tab X
Diego Biurrun's avatar
Diego Biurrun committed
270
@item id RoQ                    @tab X @tab X
271
    @tab Used in Quake III, Jedi Knight 2, other computer games.
Anssi Hannula's avatar
Anssi Hannula committed
272
@item IEC61937 encapsulation @tab X @tab X
273
@item IFF                       @tab   @tab X
274
    @tab Interchange File Format
275
@item iLBC                      @tab X @tab X
276
@item Interplay MVE             @tab   @tab X
277
    @tab Format used in various Interplay computer games.
278 279
@item IV8                       @tab   @tab X
    @tab A format generated by IndigoVision 8000 video server.
280
@item IVF (On2)                 @tab X @tab X
David Conrad's avatar
David Conrad committed
281
    @tab A format used by libvpx
Kieran Kunhya's avatar
Kieran Kunhya committed
282
@item LATM                      @tab X @tab X
283
@item LMLM4                     @tab   @tab X
284
    @tab Used by Linux Media Labs MPEG-4 PCI boards
285 286
@item LXF                       @tab   @tab X
    @tab VR native stream format, used by Leitch/Harris' video servers.
Diego Biurrun's avatar
Diego Biurrun committed
287
@item Matroska                  @tab X @tab X
288
@item Matroska audio            @tab X @tab
Anton Khirnov's avatar
Anton Khirnov committed
289
@item FFmpeg metadata           @tab X @tab X
Anton Khirnov's avatar
Anton Khirnov committed
290
    @tab Metadata in text format.
291
@item MAXIS XA                  @tab   @tab X
292
    @tab Used in Sim City 3000; file extension .xa.
293
@item MD Studio                 @tab   @tab X
Anatoly Nenashev's avatar
Anatoly Nenashev committed
294
@item Mobotix .mxg              @tab   @tab X
Diego Biurrun's avatar
Diego Biurrun committed
295
@item Monkey's Audio            @tab   @tab X
296
@item Motion Pixels MVI         @tab   @tab X
297 298
@item MOV/QuickTime/MP4         @tab X @tab X
    @tab 3GP, 3GP2, PSP, iPod variants supported
299 300
@item MP2                       @tab X @tab X
@item MP3                       @tab X @tab X
301 302 303 304 305
@item MPEG-1 System             @tab X @tab X
    @tab muxed audio and video, VCD format supported
@item MPEG-PS (program stream)  @tab X @tab X
    @tab also known as @code{VOB} file, SVCD and DVD format supported
@item MPEG-TS (transport stream) @tab X @tab X
306
    @tab also known as DVB Transport Stream
307
@item MPEG-4                    @tab X @tab X
308
    @tab MPEG-4 is a variant of QuickTime.
Kostya Shishkov's avatar
Kostya Shishkov committed
309 310
@item Mirillis FIC video        @tab   @tab X
    @tab No cursor rendering.
311
@item MIME multipart JPEG       @tab X @tab
312
@item MSN TCP webcam            @tab   @tab X
313
    @tab Used by MSN Messenger webcam streams.
314 315 316
@item MTV                       @tab   @tab X
@item Musepack                  @tab   @tab X
@item Musepack SV8              @tab   @tab X
317 318
@item Material eXchange Format (MXF) @tab X @tab X
    @tab SMPTE 377M, used by D-Cinema, broadcast industry.
319 320
@item Material eXchange Format (MXF), D-10 Mapping @tab X @tab X
    @tab SMPTE 386M, D-10/IMX Mapping.
321 322
@item NC camera feed            @tab   @tab X
    @tab NC (AVIP NC4600) camera streams
323 324
@item NTT TwinVQ (VQF)          @tab   @tab X
    @tab Nippon Telegraph and Telephone Corporation TwinVQ.
325
@item Nullsoft Streaming Video  @tab   @tab X
326
@item NuppelVideo               @tab   @tab X
327
@item NUT                       @tab X @tab X
328
    @tab NUT Open Container Format
329
@item Ogg                       @tab X @tab X
330
@item Playstation Portable PMP  @tab   @tab X
331
@item TechnoTrend PVA           @tab   @tab X
332
    @tab Used by TechnoTrend DVB PCI boards.
Kenan Gillet's avatar
Kenan Gillet committed
333
@item QCP                       @tab   @tab X
334
@item raw ADTS (AAC)            @tab X @tab X
Diego Biurrun's avatar
Diego Biurrun committed
335
@item raw AC-3                  @tab X @tab X
336
@item raw Chinese AVS video     @tab X @tab X
337 338 339 340 341 342 343 344 345 346
@item raw CRI ADX               @tab X @tab X
@item raw Dirac                 @tab X @tab X
@item raw DNxHD                 @tab X @tab X
@item raw DTS                   @tab X @tab X
@item raw E-AC-3                @tab X @tab X
@item raw FLAC                  @tab X @tab X
@item raw GSM                   @tab   @tab X
@item raw H.261                 @tab X @tab X
@item raw H.263                 @tab X @tab X
@item raw H.264                 @tab X @tab X
Derek Buitenhuis's avatar
Derek Buitenhuis committed
347
@item raw HEVC                  @tab X @tab X
348
@item raw Ingenient MJPEG       @tab   @tab X
Diego Biurrun's avatar
Diego Biurrun committed
349
@item raw MJPEG                 @tab X @tab X
350 351 352 353 354 355
@item raw MLP                   @tab   @tab X
@item raw MPEG                  @tab   @tab X
@item raw MPEG-1                @tab   @tab X
@item raw MPEG-2                @tab   @tab X
@item raw MPEG-4                @tab X @tab X
@item raw NULL                  @tab X @tab
Diego Biurrun's avatar
Diego Biurrun committed
356
@item raw video                 @tab X @tab X
357 358
@item raw id RoQ                @tab X @tab
@item raw Shorten               @tab   @tab X
359
@item raw TAK                   @tab   @tab X
Ramiro Polla's avatar
Ramiro Polla committed
360
@item raw TrueHD                @tab X @tab X
361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381
@item raw VC-1                  @tab   @tab X
@item raw PCM A-law             @tab X @tab X
@item raw PCM mu-law            @tab X @tab X
@item raw PCM signed 8 bit      @tab X @tab X
@item raw PCM signed 16 bit big-endian  @tab X @tab X
@item raw PCM signed 16 bit little-endian  @tab X @tab X
@item raw PCM signed 24 bit big-endian  @tab X @tab X
@item raw PCM signed 24 bit little-endian  @tab X @tab X
@item raw PCM signed 32 bit big-endian  @tab X @tab X
@item raw PCM signed 32 bit little-endian  @tab X @tab X
@item raw PCM unsigned 8 bit    @tab X @tab X
@item raw PCM unsigned 16 bit big-endian  @tab X @tab X
@item raw PCM unsigned 16 bit little-endian  @tab X @tab X
@item raw PCM unsigned 24 bit big-endian  @tab X @tab X
@item raw PCM unsigned 24 bit little-endian  @tab X @tab X
@item raw PCM unsigned 32 bit big-endian  @tab X @tab X
@item raw PCM unsigned 32 bit little-endian  @tab X @tab X
@item raw PCM floating-point 32 bit big-endian  @tab X @tab X
@item raw PCM floating-point 32 bit little-endian  @tab X @tab X
@item raw PCM floating-point 64 bit big-endian  @tab X @tab X
@item raw PCM floating-point 64 bit little-endian  @tab X @tab X
382
@item RDT                       @tab   @tab X
383
@item REDCODE R3D               @tab   @tab X
Baptiste Coudurier's avatar
Baptiste Coudurier committed
384
    @tab File format used by RED Digital cameras, contains JPEG 2000 frames and PCM audio.
Diego Biurrun's avatar
Diego Biurrun committed
385
@item RealMedia                 @tab X @tab X
386
@item Redirector                @tab   @tab X
387
@item Renderware TeXture Dictionary @tab   @tab X
388
@item RL2                       @tab   @tab X
389
    @tab Audio and video format used in some games by Entertainment Software Partners.
390
@item RPL/ARMovie               @tab   @tab X
391
@item Lego Mindstorms RSO       @tab X @tab X
392 393
@item RTMP                      @tab X @tab X
    @tab Output is performed by publishing stream to RTMP server
394
@item RTP                       @tab X @tab X
Martin Storsjö's avatar
Martin Storsjö committed
395
@item RTSP                      @tab X @tab X
Martin Storsjö's avatar
Martin Storsjö committed
396
@item SAP                       @tab X @tab X
397
@item SDP                       @tab   @tab X
398
@item Sega FILM/CPK             @tab   @tab X
399
    @tab Used in many Sega Saturn console games.
Peter Ross's avatar
Peter Ross committed
400
@item Silicon Graphics Movie    @tab   @tab X
401
@item Sierra SOL                @tab   @tab X
402
    @tab .sol files used in Sierra Online games.
403
@item Sierra VMD                @tab   @tab X
404
    @tab Used in Sierra CD-ROM games.
405
@item Smacker                   @tab   @tab X
406
    @tab Multimedia format used by many games.
Paul B Mahol's avatar
Paul B Mahol committed
407
@item SMJPEG                    @tab X @tab X
Paul B Mahol's avatar
Paul B Mahol committed
408
    @tab Used in certain Loki game ports.
Paul B Mahol's avatar
Paul B Mahol committed
409 410
@item Smush
    @tab Multimedia format used in some LucasArts games.
411
@item Sony OpenMG (OMA)         @tab X @tab X
412 413
    @tab Audio format used in Sony Sonic Stage and Sony Vegas.
@item Sony PlayStation STR      @tab   @tab X
Daniel Verkamp's avatar
Daniel Verkamp committed
414
@item Sony Wave64 (W64)         @tab   @tab X
415
@item SoX native format         @tab X @tab X
Diego Biurrun's avatar
Diego Biurrun committed
416
@item SUN AU format             @tab X @tab X
Vittorio Giovara's avatar
Vittorio Giovara committed
417
@item TDSC                      @tab   @tab X
Peter Ross's avatar
Peter Ross committed
418
@item Text files                @tab   @tab X
419
@item THP                       @tab   @tab X
420
    @tab Used on the Nintendo GameCube.
421 422
@item Tiertex Limited SEQ       @tab   @tab X
    @tab Tiertex .seq files used in the DOS CD-ROM version of the game Flashback.
423 424
@item True Audio                @tab   @tab X
@item VC-1 test bitstream       @tab X @tab X
425
@item WAV                       @tab X @tab X
426
@item WavPack                   @tab   @tab X
James Zern's avatar
James Zern committed
427
@item WebM                      @tab X @tab X
Peter Ross's avatar
Peter Ross committed
428
@item Windows Televison (WTV)   @tab   @tab X
429
@item Wing Commander III movie  @tab   @tab X
430
    @tab Multimedia format used in Origin's Wing Commander III computer game.
431 432 433 434
@item Westwood Studios audio    @tab   @tab X
    @tab Multimedia format used in Westwood Studios games.
@item Westwood Studios VQA      @tab   @tab X
    @tab Multimedia format used in Westwood Studios games.
Sven Hesse's avatar
Sven Hesse committed
435 436
@item XMV                       @tab   @tab X
    @tab Microsoft video container used in Xbox games.
Max Horn's avatar
Max Horn committed
437 438
@item xWMA                      @tab   @tab X
    @tab Microsoft audio container used by XAudio 2.
439
@item YUV4MPEG pipe             @tab X @tab X
440
@item Psygnosis YOP             @tab   @tab X
Derek Buitenhuis's avatar
Derek Buitenhuis committed
441
@item ZeroCodec Lossless Video  @tab   @tab X
442 443 444 445 446 447
@end multitable

@code{X} means that encoding (resp. decoding) is supported.

@section Image Formats

448
Libav can read and write images for each frame of a video sequence. The
449 450 451
following image formats are supported:

@multitable @columnfractions .4 .1 .1 .4
452
@item Name @tab Encoding @tab Decoding @tab Comments
453 454
@item .Y.U.V       @tab X @tab X
    @tab one raw file per component
455 456
@item Alias PIX    @tab X @tab X
    @tab Alias/Wavefront PIX image format
457 458
@item animated GIF @tab X @tab X
    @tab Only uncompressed GIFs are generated.
459 460
@item BMP          @tab X @tab X
    @tab Microsoft BMP image
Aleksi Nurmi's avatar
Aleksi Nurmi committed
461 462
@item BRender PIX  @tab   @tab X
    @tab Argonaut BRender 3D engine image format.
Peter Ross's avatar
Peter Ross committed
463
@item DPX          @tab X @tab X
464
    @tab Digital Picture Exchange
Jimmy Christensen's avatar
Jimmy Christensen committed
465 466
@item EXR          @tab   @tab X
    @tab OpenEXR
467 468
@item JPEG         @tab X @tab X
    @tab Progressive JPEG is not supported.
469 470
@item JPEG 2000    @tab E @tab X
    @tab encoding supported through external library libopenjpeg
471 472 473
@item JPEG-LS      @tab X @tab X
@item LJPEG        @tab X @tab
    @tab Lossless JPEG
474
@item PAM          @tab X @tab X
475
    @tab PAM is a PNM extension with alpha support.
476
@item PBM          @tab X @tab X
477
    @tab Portable BitMap image
478
@item PCX          @tab X @tab X
479
    @tab PC Paintbrush
480
@item PGM          @tab X @tab X
481
    @tab Portable GrayMap image
482
@item PGMYUV       @tab X @tab X
483
    @tab PGM with U and V components in YUV 4:2:0
Peter Ross's avatar
Peter Ross committed
484 485
@item PIC          @tab @tab X
    @tab Pictor/PC Paint
486 487
@item PNG          @tab X @tab X
    @tab 2/4 bpp not supported yet
488
@item PPM          @tab X @tab X
489
    @tab Portable PixelMap image
490 491 492 493
@item PTX          @tab   @tab X
    @tab V.Flash PTX format
@item SGI          @tab X @tab X
    @tab SGI RGB image format
494
@item Sun Rasterfile  @tab X @tab X
495
    @tab Sun RAS image format
496 497
@item TIFF         @tab X @tab X
    @tab YUV, JPEG and some extension is not supported yet.
498 499
@item Truevision Targa  @tab X @tab X
    @tab Targa (.TGA) image format
Justin Ruggles's avatar
Justin Ruggles committed
500 501
@item WebP         @tab E @tab X
    @tab WebP image format, encoding supported through external library libwebp
Vittorio Giovara's avatar
Vittorio Giovara committed
502
@item XBM  @tab X @tab X
Paul B Mahol's avatar
Paul B Mahol committed
503
    @tab X BitMap image format
Paul B Mahol's avatar
Paul B Mahol committed
504 505
@item XWD  @tab X @tab X
    @tab X Window Dump image format
506 507 508 509
@end multitable

@code{X} means that encoding (resp. decoding) is supported.

510 511
@code{E} means that support is provided through an external library.

512 513 514
@section Video Codecs

@multitable @columnfractions .4 .1 .1 .4
515
@item Name @tab Encoding @tab Decoding @tab Comments
516
@item 4X Movie               @tab     @tab  X
517
    @tab Used in certain computer games.
518
@item 8088flex TMV           @tab     @tab  X
519 520
@item 8SVX exponential       @tab     @tab  X
@item 8SVX fibonacci         @tab     @tab  X
521 522
@item A64 multicolor         @tab  X  @tab
    @tab Creates video suitable to be played on a commodore 64 (multicolor mode).
Paul B Mahol's avatar
Paul B Mahol committed
523
@item Amazing Studio PAF Video @tab     @tab  X
524
@item American Laser Games MM  @tab    @tab X
525
    @tab Used in games like Mad Dog McCree.
526
@item AMV Video              @tab     @tab  X
527
    @tab Used in Chinese MP3 players.
Peter Ross's avatar
Peter Ross committed
528
@item ANSI/ASCII art         @tab     @tab  X
529
@item Apple Intermediate Codec @tab     @tab  X
530
@item Apple MJPEG-B          @tab     @tab  X
Kostya Shishkov's avatar
Kostya Shishkov committed
531
@item Apple ProRes           @tab  X  @tab  X
532
@item Apple QuickDraw        @tab     @tab  X
533
    @tab fourcc: qdrw
534
@item Asus v1                @tab  X  @tab  X
535
    @tab fourcc: ASV1
536
@item Asus v2                @tab  X  @tab  X
537
    @tab fourcc: ASV2
538
@item ATI VCR1               @tab     @tab  X
539
    @tab fourcc: VCR1
540
@item ATI VCR2               @tab     @tab  X
541
    @tab fourcc: VCR2
542
@item Auravision Aura        @tab     @tab  X
Kostya Shishkov's avatar
Kostya Shishkov committed
543
@item Auravision Aura 2      @tab     @tab  X
544
@item Autodesk Animator Flic video  @tab     @tab  X
545
@item Autodesk RLE           @tab     @tab  X
546
    @tab fourcc: AASC
547
@item AVS (Audio Video Standard) video  @tab     @tab  X
548
    @tab Video encoding used by the Creature Shock game.
549
@item Beam Software VB       @tab     @tab  X
550
@item Bethesda VID video     @tab     @tab  X
551
    @tab Used in some games from Bethesda Softworks.
Kostya Shishkov's avatar
Kostya Shishkov committed
552
@item Bink Video             @tab     @tab  X
Peter Ross's avatar
Peter Ross committed
553
@item Bitmap Brothers JV video  @tab   @tab X
554 555
@item Brute Force & Ignorance   @tab   @tab X
    @tab Used in the game Flash Traffic: City of Angels.
556
@item C93 video              @tab     @tab  X
557
    @tab Codec used in Cyberia game.
558
@item CamStudio              @tab     @tab  X
559
    @tab fourcc: CSCD
Michael Tison's avatar
Michael Tison committed
560 561
@item CD+G                   @tab     @tab  X
    @tab Video codec for CD+G karaoke disks
Paul B Mahol's avatar
Paul B Mahol committed
562 563
@item CDXL                   @tab     @tab  X
    @tab Amiga CD video codec
564 565
@item Chinese AVS video      @tab  E  @tab  X
    @tab AVS1-P2, JiZhun profile, encoding through external library libxavs
566 567
@item Delphine Software International CIN video  @tab     @tab  X
    @tab Codec used in Delphine Software International games.
Kostya Shishkov's avatar
Kostya Shishkov committed
568
@item Discworld II BMV Video @tab     @tab  X
Derek Buitenhuis's avatar
Derek Buitenhuis committed
569
@item Canopus Lossless Codec @tab     @tab  X
570
@item Cinepak                @tab     @tab  X
Paul B Mahol's avatar
Paul B Mahol committed
571
@item Cirrus Logic AccuPak   @tab  X  @tab  X
572
    @tab fourcc: CLJR
573
@item Creative YUV (CYUV)    @tab     @tab  X
Kostya Shishkov's avatar
Kostya Shishkov committed
574 575
@item DFA                    @tab     @tab  X
    @tab Codec used in Chronomaster game.
576
@item Dirac                  @tab  E  @tab  E
Diego Biurrun's avatar
Diego Biurrun committed
577
    @tab supported through external library libschroedinger
Peter Ross's avatar
Peter Ross committed
578
@item Deluxe Paint Animation @tab     @tab  X
579 580
@item DNxHD                  @tab   X @tab  X
    @tab aka SMPTE VC3
581
@item Duck TrueMotion 1.0   @tab     @tab  X
582
    @tab fourcc: DUCK
583
@item Duck TrueMotion 2.0    @tab     @tab  X
584
    @tab fourcc: TM20
585
@item DV (Digital Video)     @tab  X  @tab  X
586
@item Dxtory capture format  @tab     @tab  X
587
@item Feeble Files/ScummVM DXA  @tab     @tab  X
588
    @tab Codec originally used in Feeble Files game.
589
@item Electronic Arts CMV video  @tab     @tab  X
590
    @tab Used in NHL 95 game.
Peter Ross's avatar
Peter Ross committed
591
@item Electronic Arts Madcow video  @tab     @tab  X
592 593 594 595
@item Electronic Arts TGV video  @tab     @tab  X
@item Electronic Arts TGQ video  @tab     @tab  X
@item Electronic Arts TQI video  @tab     @tab  X
@item Escape 124             @tab     @tab  X
Eli Friedman's avatar
Eli Friedman committed
596
@item Escape 130             @tab     @tab  X
597
@item FFmpeg video codec #1  @tab  X  @tab  X
598
    @tab experimental lossless codec (fourcc: FFV1)
599
@item Flash Screen Video v1  @tab  X  @tab  X
600
    @tab fourcc: FSV1
601
@item Flash Screen Video v2  @tab     @tab  X
602
@item Flash Video (FLV)      @tab  X  @tab  X
603
    @tab Sorenson H.263 used in Flash
604
@item Forward Uncompressed   @tab     @tab  X
605
@item Fraps                  @tab     @tab  X
Kostya Shishkov's avatar
Kostya Shishkov committed
606 607
@item Go2Webinar             @tab     @tab  X
    @tab fourcc: G2M4
608
@item H.261                  @tab  X  @tab  X
609 610 611
@item H.263 / H.263-1996     @tab  X  @tab  X
@item H.263+ / H.263-1998 / H.263 version 2  @tab  X  @tab  X
@item H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10  @tab  E  @tab  X
612
    @tab encoding supported through external library libx264 and OpenH264
Derek Buitenhuis's avatar
Derek Buitenhuis committed
613 614
@item HEVC                   @tab  X  @tab  X
    @tab encoding supported through the external library libx265
615
@item HNM version 4          @tab     @tab  X
616
@item HuffYUV                @tab  X  @tab  X
617
@item HuffYUV FFmpeg variant @tab  X  @tab  X
618
@item IBM Ultimotion         @tab     @tab  X
619
    @tab fourcc: ULTI
620
@item id Cinematic video     @tab     @tab  X
621
    @tab Used in Quake II.
622
@item id RoQ video           @tab  X  @tab  X
623
    @tab Used in Quake III, Jedi Knight 2, other computer games.
Peter Ross's avatar
Peter Ross committed
624
@item IFF ILBM               @tab     @tab  X
Diego Biurrun's avatar
Diego Biurrun committed
625
    @tab IFF interleaved bitmap
Peter Ross's avatar
Peter Ross committed
626 627
@item IFF ByteRun1           @tab     @tab  X
    @tab IFF run length encoded bitmap
628 629
@item Intel H.263            @tab     @tab  X
@item Intel Indeo 2          @tab     @tab  X
630
@item Intel Indeo 3          @tab     @tab  X
Kostya Shishkov's avatar
Kostya Shishkov committed
631
@item Intel Indeo 4          @tab     @tab  X
Kostya Shishkov's avatar
Kostya Shishkov committed
632
@item Intel Indeo 5          @tab     @tab  X
633
@item Interplay C93          @tab     @tab  X
634
    @tab Used in the game Cyberia from Interplay.
635
@item Interplay MVE video    @tab     @tab  X
636
    @tab Used in Interplay .MVE files.
637
@item Karl Morton's video codec  @tab     @tab  X
638
    @tab Codec used in Worms games.
639 640
@item Kega Game Video (KGV1) @tab      @tab  X
    @tab Kega emulator screen capture codec.
641
@item Lagarith               @tab     @tab  X
642 643
@item LCL (LossLess Codec Library) MSZH  @tab     @tab  X
@item LCL (LossLess Codec Library) ZLIB  @tab  E  @tab  E
644
@item LOCO                   @tab     @tab  X
645 646
@item LucasArts SANM         @tab     @tab  X
    @tab Used in LucasArts SMUSH animations.
647
@item lossless MJPEG         @tab  X  @tab  X
648 649
@item Microsoft ATC Screen   @tab     @tab  X
    @tab Also known as Microsoft Screen 3.
650 651
@item Microsoft Expression Encoder Screen  @tab     @tab  X
    @tab Also known as Microsoft Titanium Screen 2.
652
@item Microsoft RLE          @tab     @tab  X
Kostya Shishkov's avatar
Kostya Shishkov committed
653 654
@item Microsoft Screen 1     @tab     @tab  X
    @tab Also known as Windows Media Video V7 Screen.
Alberto Delmás's avatar
Alberto Delmás committed
655 656
@item Microsoft Screen 2     @tab     @tab  X
    @tab Also known as Windows Media Video V9 Screen.
657
@item Microsoft Video 1      @tab     @tab  X
658
@item Mimic                  @tab     @tab  X
659
    @tab Used in MSN Messenger Webcam streams.
660
@item Miro VideoXL           @tab     @tab  X
661
    @tab fourcc: VIXL
662
@item MJPEG (Motion JPEG)    @tab  X  @tab  X
anatoly's avatar
anatoly committed
663
@item Mobotix MxPEG video    @tab     @tab  X
664 665 666 667
@item Motion Pixels video    @tab     @tab  X
@item MPEG-1 video           @tab  X  @tab  X
@item MPEG-2 video           @tab  X  @tab  X
@item MPEG-4 part 2          @tab  X  @tab  X
668
    @tab libxvidcore can be used alternatively for encoding.
669
@item MPEG-4 part 2 Microsoft variant version 1  @tab     @tab  X
670 671
@item MPEG-4 part 2 Microsoft variant version 2  @tab  X  @tab  X
@item MPEG-4 part 2 Microsoft variant version 3  @tab  X  @tab  X
672
@item Nintendo Gamecube THP video  @tab     @tab  X
673 674
@item NuppelVideo/RTjpeg     @tab     @tab  X
    @tab Video encoding used in NuppelVideo files.
675
@item On2 VP3                @tab     @tab  X
676
    @tab still experimental
677
@item On2 VP5                @tab     @tab  X
678
    @tab fourcc: VP50
679
@item On2 VP6                @tab     @tab  X
680
    @tab fourcc: VP60,VP61,VP62
Peter Ross's avatar
Peter Ross committed
681 682
@item On2 VP7                @tab     @tab  X
    @tab fourcc: VP70,VP71
David Conrad's avatar
David Conrad committed
683 684
@item VP8                    @tab  E  @tab  X
    @tab fourcc: VP80, encoding supported through external library libvpx
Ronald S. Bultje's avatar
Ronald S. Bultje committed
685 686
@item VP9                    @tab  E  @tab  X
    @tab Encoding supported through external library libvpx
687
@item planar RGB             @tab     @tab  X
688
    @tab fourcc: 8BPS
689
@item Q-team QPEG            @tab     @tab  X
690
    @tab fourccs: QPEG, Q1.0, Q1.1
691
@item QuickTime 8BPS video   @tab     @tab  X
692 693 694 695 696 697
@item QuickTime Animation (RLE) video  @tab  X  @tab  X
    @tab fourcc: 'rle '
@item QuickTime Graphics (SMC)  @tab     @tab  X
    @tab fourcc: 'smc '
@item QuickTime video (RPZA) @tab     @tab  X
    @tab fourcc: rpza
Zhou Zongyi's avatar
Zhou Zongyi committed
698
@item R10K AJA Kona 10-bit RGB Codec     @tab     @tab  X
699
@item R210 Quicktime Uncompressed RGB 10-bit     @tab     @tab  X
700
@item Raw Video              @tab  X  @tab  X
701 702
@item RealVideo 1.0          @tab  X  @tab  X
@item RealVideo 2.0          @tab  X  @tab  X
Kostya Shishkov's avatar
Kostya Shishkov committed
703 704
@item RealVideo 3.0          @tab     @tab  X
    @tab still far from ideal
Kostya Shishkov's avatar
Kostya Shishkov committed
705
@item RealVideo 4.0          @tab     @tab  X
706
@item Renderware TXD (TeXture Dictionary)  @tab     @tab  X
707
    @tab Texture dictionaries used by the Renderware Engine.
708 709
@item RL2 video              @tab     @tab  X
    @tab used in some games by Entertainment Software Partners
710 711
@item Sierra VMD video       @tab     @tab  X
    @tab Used in Sierra VMD files.
712 713
@item Silicon Graphics Motion Video Compressor 1 (MVC1)  @tab     @tab  X
@item Silicon Graphics Motion Video Compressor 2 (MVC2)  @tab     @tab  X
714
@item Silicon Graphics RLE 8-bit video  @tab     @tab  X
715
@item Smacker video          @tab     @tab  X
716
    @tab Video encoding used in Smacker.
717
@item SMPTE VC-1             @tab     @tab  X
718
@item Sony PlayStation MDEC (Motion DECoder)  @tab     @tab  X
719
@item Sorenson Vector Quantizer 1  @tab  X  @tab  X
720
    @tab fourcc: SVQ1
721
@item Sorenson Vector Quantizer 3  @tab     @tab  X
722
    @tab fourcc: SVQ3
723
@item Sunplus JPEG (SP5X)    @tab     @tab  X
724
    @tab fourcc: SP5X
725
@item TechSmith Screen Capture Codec  @tab     @tab  X
726
    @tab fourcc: TSCC
727 728
@item TechSmith Screen Capture Codec 2  @tab     @tab  X
    @tab fourcc: TSC2
729
@item Theora                 @tab  E  @tab  X
730
    @tab encoding supported through external library libtheora
731
@item Tiertex Limited SEQ video  @tab     @tab  X
732
    @tab Codec used in DOS CD-ROM FlashBack game.
Jan Ekström's avatar
Jan Ekström committed
733
@item Ut Video               @tab  X  @tab  X
Derek Buitenhuis's avatar
Derek Buitenhuis committed
734 735
@item v210 QuickTime uncompressed 4:2:2 10-bit     @tab  X  @tab  X
@item v410 QuickTime uncompressed 4:4:4 10-bit     @tab  X  @tab  X
Derek Buitenhuis's avatar
Derek Buitenhuis committed
736
@item VBLE Lossless Codec    @tab     @tab  X
737
@item VMware Screen Codec / VMware Video  @tab     @tab  X
738
    @tab Codec used in videos captured by VMware.
739
@item Westwood Studios VQA (Vector Quantized Animation) video  @tab     @tab  X
740
@item Windows Media Image    @tab     @tab  X
741
@item Windows Media Video 7  @tab  X  @tab  X
742
@item Windows Media Video 8  @tab  X  @tab  X
743 744
@item Windows Media Video 9  @tab     @tab  X
    @tab not completely working
745 746
@item Wing Commander III / Xan  @tab     @tab  X
    @tab Used in Wing Commander III .MVE files.
Kostya Shishkov's avatar
Kostya Shishkov committed
747 748
@item Wing Commander IV / Xan  @tab     @tab  X
    @tab Used in Wing Commander IV.
749 750
@item Winnov WNV1            @tab     @tab  X
@item WMV7                   @tab  X  @tab  X
751
@item YAMAHA SMAF            @tab  X  @tab  X
752
@item Psygnosis YOP Video    @tab     @tab  X
753
@item ZLIB                   @tab  X  @tab  X
754
    @tab part of LCL, encoder experimental
755
@item Zip Motion Blocks Video  @tab   X @tab  X
756
    @tab Encoder works only in PAL8.
757 758 759 760
@end multitable

@code{X} means that encoding (resp. decoding) is supported.

761 762
@code{E} means that support is provided through an external library.

763 764
@section Audio Codecs

765
@multitable @columnfractions .4 .1 .1 .4
766
@item Name @tab Encoding @tab Decoding @tab Comments
767
@item 8SVX audio             @tab     @tab  X
768
@item AAC                    @tab  E  @tab  X
769
    @tab encoding supported through external library libfaac and libvo-aacenc
Justin Ruggles's avatar
Justin Ruggles committed
770
@item AC-3                   @tab IX  @tab  X
771 772 773 774 775 776 777 778 779 780 781 782
@item ADPCM 4X Movie         @tab     @tab  X
@item ADPCM CDROM XA         @tab     @tab  X
@item ADPCM Creative Technology @tab     @tab  X
    @tab 16 -> 4, 8 -> 4, 8 -> 3, 8 -> 2
@item ADPCM Electronic Arts  @tab     @tab  X
    @tab Used in various EA titles.
@item ADPCM Electronic Arts Maxis CDROM XS  @tab     @tab  X
    @tab Used in Sim City 3000.
@item ADPCM Electronic Arts R1  @tab     @tab  X
@item ADPCM Electronic Arts R2  @tab     @tab  X
@item ADPCM Electronic Arts R3  @tab     @tab  X
@item ADPCM Electronic Arts XAS @tab     @tab  X
Martin Storsjö's avatar
Martin Storsjö committed
783
@item ADPCM G.722            @tab  X  @tab  X
784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811
@item ADPCM G.726            @tab  X  @tab  X
@item ADPCM IMA AMV          @tab     @tab  X
    @tab Used in AMV files
@item ADPCM IMA Electronic Arts EACS  @tab     @tab  X
@item ADPCM IMA Electronic Arts SEAD  @tab     @tab  X
@item ADPCM IMA Funcom       @tab     @tab  X
@item ADPCM IMA QuickTime    @tab  X  @tab  X
@item ADPCM IMA Loki SDL MJPEG  @tab     @tab  X
@item ADPCM IMA WAV          @tab  X  @tab  X
@item ADPCM IMA Westwood     @tab     @tab  X
@item ADPCM ISS IMA          @tab     @tab  X
    @tab Used in FunCom games.
@item ADPCM IMA Duck DK3     @tab     @tab  X
    @tab Used in some Sega Saturn console games.
@item ADPCM IMA Duck DK4     @tab     @tab  X
    @tab Used in some Sega Saturn console games.
@item ADPCM Microsoft        @tab  X  @tab  X
@item ADPCM MS IMA           @tab  X  @tab  X
@item ADPCM Nintendo Gamecube THP  @tab     @tab  X
@item ADPCM QT IMA           @tab  X  @tab  X
@item ADPCM SEGA CRI ADX     @tab  X  @tab  X
    @tab Used in Sega Dreamcast games.
@item ADPCM Shockwave Flash  @tab  X  @tab  X
@item ADPCM SMJPEG IMA       @tab     @tab  X
    @tab Used in certain Loki game ports.
@item ADPCM Sound Blaster Pro 2-bit  @tab     @tab  X
@item ADPCM Sound Blaster Pro 2.6-bit  @tab     @tab  X
@item ADPCM Sound Blaster Pro 4-bit  @tab     @tab  X
812 813
@item ADPCM VIMA
    @tab Used in LucasArts SMUSH animations.
814 815 816
@item ADPCM Westwood Studios IMA @tab     @tab  X
    @tab Used in Westwood Studios games like Command and Conquer.
@item ADPCM Yamaha           @tab  X  @tab  X
817
@item AMR-NB                 @tab  E  @tab  X
818
    @tab encoding supported through external library libopencore-amrnb
819 820
@item AMR-WB                 @tab  E  @tab  X
    @tab encoding supported through external library libvo-amrwbenc
Paul B Mahol's avatar