general.texi 40.9 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 74 75 76 77 78 79 80 81
@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.

@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.

82 83 84 85 86 87 88 89
@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.

90 91 92 93 94 95 96 97 98 99 100 101 102 103
@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
104 105 106 107 108 109 110 111 112 113 114
@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
115
details), you must upgrade Libav's license to GPL in order to use it.
Derek Buitenhuis's avatar
Derek Buitenhuis committed
116 117
@end float

118 119 120 121 122 123 124 125 126 127 128
@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.

129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154
@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).
155

156 157 158 159 160 161
@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
162 163 164

@chapter Supported File Formats and Codecs

Daniel Verkamp's avatar
Daniel Verkamp committed
165
You can use the @code{-formats} and @code{-codecs} options to have an exhaustive list.
166 167 168

@section File Formats

169
Libav supports the following file formats through the @code{libavformat}
170 171 172
library:

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

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

@section Image Formats

422
Libav can read and write images for each frame of a video sequence. The
423 424 425
following image formats are supported:

@multitable @columnfractions .4 .1 .1 .4
426
@item Name @tab Encoding @tab Decoding @tab Comments
427 428
@item .Y.U.V       @tab X @tab X
    @tab one raw file per component
429 430
@item Alias PIX    @tab X @tab X
    @tab Alias/Wavefront PIX image format
431 432
@item animated GIF @tab X @tab X
    @tab Only uncompressed GIFs are generated.
433 434
@item BMP          @tab X @tab X
    @tab Microsoft BMP image
Aleksi Nurmi's avatar
Aleksi Nurmi committed
435 436
@item BRender PIX  @tab   @tab X
    @tab Argonaut BRender 3D engine image format.
Peter Ross's avatar
Peter Ross committed
437
@item DPX          @tab X @tab X
438
    @tab Digital Picture Exchange
439 440
@item JPEG         @tab X @tab X
    @tab Progressive JPEG is not supported.
441 442
@item JPEG 2000    @tab E @tab X
    @tab encoding supported through external library libopenjpeg
443 444 445
@item JPEG-LS      @tab X @tab X
@item LJPEG        @tab X @tab
    @tab Lossless JPEG
446
@item PAM          @tab X @tab X
447
    @tab PAM is a PNM extension with alpha support.
448
@item PBM          @tab X @tab X
449
    @tab Portable BitMap image
450
@item PCX          @tab X @tab X
451
    @tab PC Paintbrush
452
@item PGM          @tab X @tab X
453
    @tab Portable GrayMap image
454
@item PGMYUV       @tab X @tab X
455
    @tab PGM with U and V components in YUV 4:2:0
Peter Ross's avatar
Peter Ross committed
456 457
@item PIC          @tab @tab X
    @tab Pictor/PC Paint
458 459
@item PNG          @tab X @tab X
    @tab 2/4 bpp not supported yet
460
@item PPM          @tab X @tab X
461
    @tab Portable PixelMap image
462 463 464 465
@item PTX          @tab   @tab X
    @tab V.Flash PTX format
@item SGI          @tab X @tab X
    @tab SGI RGB image format
466
@item Sun Rasterfile  @tab X @tab X
467
    @tab Sun RAS image format
468 469
@item TIFF         @tab X @tab X
    @tab YUV, JPEG and some extension is not supported yet.
470 471
@item Truevision Targa  @tab X @tab X
    @tab Targa (.TGA) image format
Justin Ruggles's avatar
Justin Ruggles committed
472 473
@item WebP         @tab E @tab X
    @tab WebP image format, encoding supported through external library libwebp
Vittorio Giovara's avatar
Vittorio Giovara committed
474
@item XBM  @tab X @tab X
Paul B Mahol's avatar
Paul B Mahol committed
475
    @tab X BitMap image format
Paul B Mahol's avatar
Paul B Mahol committed
476 477
@item XWD  @tab X @tab X
    @tab X Window Dump image format
478 479 480 481
@end multitable

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

482 483
@code{E} means that support is provided through an external library.

484 485 486
@section Video Codecs

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

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

726 727
@code{E} means that support is provided through an external library.

728 729
@section Audio Codecs

730
@multitable @columnfractions .4 .1 .1 .4
731
@item Name @tab Encoding @tab Decoding @tab Comments
732
@item 8SVX audio             @tab     @tab  X
733
@item AAC                    @tab  E  @tab  X
734
    @tab encoding supported through external library libfaac and libvo-aacenc
Justin Ruggles's avatar
Justin Ruggles committed
735
@item AC-3                   @tab IX  @tab  X
736 737 738 739 740 741 742 743 744 745 746 747
@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
748
@item ADPCM G.722            @tab  X  @tab  X
749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779
@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
@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
780
@item AMR-NB                 @tab  E  @tab  X
781
    @tab encoding supported through external library libopencore-amrnb
782 783
@item AMR-WB                 @tab  E  @tab  X
    @tab encoding supported through external library libvo-amrwbenc
Paul B Mahol's avatar
Paul B Mahol committed
784
@item Amazing Studio PAF Audio @tab     @tab  X
785
@item Apple lossless audio   @tab  X  @tab  X
786
    @tab QuickTime fourcc 'alac'
787 788
@item ATRAC1                 @tab     @tab  X
@item ATRAC3                 @tab     @tab  X
Maxim Polijakowski's avatar
Maxim Polijakowski committed
789
@item ATRAC3+                @tab     @tab  X
Peter Ross's avatar
Peter Ross committed