general.texi 42.2 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 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170
@section AviSynth

Libav can read AviSynth scripts as input. To enable support you need a
suitable @file{avisynth_c.h} header to compile against. The header in
classic AviSynth's CVS repository is not compatible as it has not been
updated to support AviSynth 2.6. AviSynth 2.5 is not supported by Libav.
Once you have the appropriate header, pass @code{--enable-avisynth} to
configure to enable AviSynth support.

For Windows, supported AviSynth variants are
@url{http://avisynth.nl, AviSynth 2.6} for 32-bit builds and
@url{http://avs-plus.net, AviSynth+ 0.1} for 32-bit and 64-bit builds.
The necessary @file{avisynth_c.h} header is the variant in the @file{extras/}
directory of the @url{https://www.videolan.org/developers/x264.html, x264}
source tree. For convenience, this header is also available from a
@url{https://github.com/qyot27/avisynth_headers, temporary repository}
along with an installation routine.

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).
171

172 173 174 175 176 177
@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
178 179 180

@chapter Supported File Formats and Codecs

Daniel Verkamp's avatar
Daniel Verkamp committed
181
You can use the @code{-formats} and @code{-codecs} options to have an exhaustive list.
182 183 184

@section File Formats

185
Libav supports the following file formats through the @code{libavformat}
186 187 188
library:

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

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

@section Image Formats

442
Libav can read and write images for each frame of a video sequence. The
443 444 445
following image formats are supported:

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

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

504 505
@code{E} means that support is provided through an external library.

506 507 508
@section Video Codecs

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

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

755 756
@code{E} means that support is provided through an external library.

757 758
@section Audio Codecs

759
@multitable @columnfractions .4 .1 .1 .4
760
@item Name @tab Encoding @tab Decoding @tab Comments
761
@item 8SVX audio             @tab     @tab  X
762
@item AAC                    @tab  E  @tab  X
763
    @tab encoding supported through external library libfaac and libvo-aacenc
Justin Ruggles's avatar
Justin Ruggles committed
764
@item AC-3                   @tab IX  @tab  X
765 766 767 768 769 770 771 772 773 774 775 776
@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
777
@item ADPCM G.722            @tab  X  @tab  X
778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805
@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
806 807
@item ADPCM VIMA
    @tab Used in LucasArts SMUSH animations.
808 809 810
@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
811
@item AMR-NB                 @tab  E  @tab  X
812
    @tab encoding supported through external library libopencore-amrnb
813 814
@item AMR-WB                 @tab  E  @tab  X
    @tab encoding supported through external library libvo-amrwbenc
Paul B Mahol's avatar
Paul B Mahol committed
815
@item Amazing Studio PAF Audio @tab     @tab  X
816
@item Apple lossless audio   @tab  X  @tab  X
817
    @tab QuickTime fourcc 'alac'
818 819
@item ATRAC1                 @tab     @tab  X
@item ATRAC3                 @tab     @tab  X
Maxim Polijakowski's avatar
Maxim Polijakowski committed
820
@item ATRAC3+                @tab     @tab  X
Peter Ross's avatar
Peter Ross committed
821 822
@item Bink Audio