\input texinfo @c -*- texinfo -*-@settitle General Documentation@titlepage@sp 7@center @titlefont{General Documentation}@sp 3@end titlepage@chapter external librariesFFmpeg can be hooked up with a number of external libraries to add supportfor more formats. None of them are used by default, their use has to beexplicitly requested by passing the appropriate flags to @file{./configure}.@section AMRAMR comes in two different flavors, wideband and narrowband. FFmpeg can makeuse of the AMR wideband (floating-point mode) and the AMR narrowband(floating-point mode) reference decoders and encoders.Go to @url{http://www.penguin.cz/~utx/amr} and follow the instructions forinstalling the libraries. Then pass @code{--enable-libamr-nb} and/or@code{--enable-libamr-wb} to configure to enable the libraries.Note that libamr is copyrighted without any sort of license grant. This meansthat you can use it if you legally obtained it but you are not allowed toredistribute it in any way. @strong{Any FFmpeg binaries with libamr supportyou create are non-free and unredistributable!}@chapter Supported File Formats and CodecsYou can use the @code{-formats} option to have an exhaustive list.@section File FormatsFFmpeg supports the following file formats through the @code{libavformat}library:@multitable @columnfractions .4 .1 .1 .4@item Supported File Format @tab Encoding @tab Decoding @tab Comments@item MPEG audio @tab X @tab X@item MPEG-1 systems @tab X  @tab  X@tab muxed audio and video@item MPEG-2 PS @tab X  @tab  X@tab also known as @code{VOB} file@item MPEG-2 TS @tab    @tab  X@tab also known as DVB Transport Stream@item ASF@tab X @tab X@item AVI@tab X @tab X@item WAV@tab X @tab X@item Macromedia Flash@tab X @tab X@item AVM2 (Flash 9) @tab X @tab X@tab Only embedded audio is decoded.@item FLV              @tab  X @tab X@tab Macromedia Flash video files@item RealMedia @tab X @tab X@item raw AC-3 @tab X  @tab  X@item raw MJPEG @tab X  @tab  X@item raw MPEG video @tab X  @tab  X@item raw PCM 8/16 bits, mu-law/A-law @tab X  @tab  X@item raw CRI ADX audio @tab X  @tab  X@item raw Shorten audio @tab    @tab  X@item SUN AU format @tab X  @tab  X@item NUT @tab X @tab X @tab NUT Open Container Format@item QuickTime        @tab X @tab  X@item MPEG-4           @tab X @tab  X@tab MPEG-4 is a variant of QuickTime.@item raw MPEG-4 video  @tab  X @tab  X@item DV               @tab  X @tab  X@item 4xm              @tab    @tab X@tab 4X Technologies format, used in some games.@item PlayStation STR  @tab    @tab X@item id RoQ           @tab X  @tab X@tab Used in Quake III, Jedi Knight 2, other computer games.@item Interplay MVE    @tab    @tab X@tab Format used in various Interplay computer games.@item WC3 Movie        @tab    @tab X@tab Multimedia format used in Origin's Wing Commander III computer game.@item Sega FILM/CPK    @tab    @tab X@tab Used in many Sega Saturn console games.@item Westwood Studios VQA/AUD  @tab    @tab X@tab Multimedia formats used in Westwood Studios games.@item id Cinematic (.cin) @tab    @tab X@tab Used in Quake II.@item FLIC             @tab    @tab X@tab .fli/.flc files@item Sierra VMD       @tab    @tab X@tab Used in Sierra CD-ROM games.@item Sierra Online    @tab    @tab X@tab .sol files used in Sierra Online games.@item Matroska         @tab X  @tab X@item Electronic Arts Multimedia    @tab    @tab X@tab Used in various EA games; files have extensions like WVE and UV2.@item MAXIS EA XA      @tab    @tab X@tab Used in Sim City 3000; file extension .xa.@item Nullsoft Video (NSV) @tab    @tab X@item ADTS AAC audio @tab X @tab X@item Creative VOC @tab X @tab X @tab Created for the Sound Blaster Pro.@item American Laser Games MM  @tab    @tab X@tab Multimedia format used in games like Mad Dog McCree.@item AVS @tab    @tab X@tab Multimedia format used by the Creature Shock game.@item Smacker @tab    @tab X@tab Multimedia format used by many games.@item GXF @tab  X @tab X@tab General eXchange Format SMPTE 360M, used by Thomson Grass Valley playout servers.@item CIN @tab    @tab X@tab Multimedia format used by Delphine Software games.@item MXF @tab    @tab X@tab Material eXchange Format SMPTE 377M, used by D-Cinema, broadcast industry.@item SEQ @tab    @tab X@tab Tiertex .seq files used in the DOS CD-ROM version of the game Flashback.@item DXA @tab    @tab X@tab This format is used in the non-Windows version of the Feeble Files game anddifferent game cutscenes repacked for use with ScummVM.@item THP @tab    @tab X@tab Used on the Nintendo GameCube.@item C93 @tab    @tab X@tab Used in the game Cyberia from Interplay.@item Bethsoft VID @tab    @tab X@tab Used in some games from Bethesda Softworks.@item CRYO APC @tab    @tab X@tab Audio format used in some games by CRYO Interactive Entertainment.@item Monkey's Audio @tab    @tab X@item SIFF @tab    @tab X@tab Audio and video format used in some games by Beam Software.@item LMLM4 @tab    @tab X@tab Used by Linux Media Labs MPEG-4 PCI boards@item PVA @tab    @tab X@tab Used by TechnoTrend DVB PCI boards@item MSN TCP Webcam @tab    @tab X@tab Used by MSN Messenger Webcam streams.@item RL2 @tab    @tab X@tab Audio and video format used in some games by Entertainment Software Partners@item IFF @tab    @tab X@tab Interchange File Format@item BFI @tab    @tab X@tab Brute Force & Ignorance, used in Flash Traffic: City of Angels.@item OMA @tab    @tab X@tab Audio format used in Sony Sonic Stage and Sony Vegas.@end multitable@code{X} means that encoding (resp. decoding) is supported.@section Image FormatsFFmpeg can read and write images for each frame of a video sequence. Thefollowing image formats are supported:@multitable @columnfractions .4 .1 .1 .4@item Supported Image Format @tab Encoding @tab Decoding @tab Comments@item animated GIF @tab X @tab X @tab Only uncompressed GIFs are generated.@item JPEG         @tab X @tab X @tab Progressive JPEG is not supported.@item PAM          @tab X @tab X @tab PAM is a PNM extension with alpha support.@item PCX          @tab   @tab X @tab PC Paintbrush@item PGM, PPM     @tab X @tab X@item PGMYUV       @tab X @tab X @tab PGM with U and V components in YUV 4:2:0@item PNG          @tab X @tab X @tab 2/4 bpp not supported yet@item PTX          @tab   @tab X @tab V.Flash PTX format@item RAS          @tab   @tab X @tab Sun Rasterfile@item SGI          @tab X @tab X @tab SGI RGB image format@item TIFF         @tab X @tab X @tab YUV, JPEG and some extension is not supported yet.@item Targa        @tab   @tab X @tab Targa (.TGA) image format@item .Y.U.V       @tab X @tab X @tab one raw file per component@end multitable@code{X} means that encoding (resp. decoding) is supported.@section Video Codecs@multitable @columnfractions .4 .1 .1 .4@item Supported Codec @tab Encoding @tab Decoding @tab Comments@item MPEG-1 video           @tab  X  @tab  X@item MPEG-2 video           @tab  X  @tab  X@item MPEG-4                 @tab  X  @tab  X@item MSMPEG4 V1             @tab  X  @tab  X@item MSMPEG4 V2             @tab  X  @tab  X@item MSMPEG4 V3             @tab  X  @tab  X@item WMV7                   @tab  X  @tab  X@item WMV8                   @tab  X  @tab  X@item WMV9                   @tab     @tab  X @tab not completely working@item VC-1                   @tab     @tab  X@item H.261                  @tab  X  @tab  X@item H.263(+)               @tab  X  @tab  X @tab also known as RealVideo 1.0@item H.264                  @tab     @tab  X@item RealVideo 1.0          @tab  X  @tab  X@item RealVideo 2.0          @tab  X  @tab  X@item MJPEG                  @tab  X  @tab  X@item lossless MJPEG         @tab  X  @tab  X@item JPEG-LS                @tab  X  @tab  X @tab fourcc: MJLS, lossless and near-lossless is supported.@item Apple MJPEG-B          @tab     @tab  X@item Sunplus MJPEG          @tab     @tab  X @tab fourcc: SP5X@item DV                     @tab  X  @tab  X@item HuffYUV                @tab  X  @tab  X@item FFmpeg Video 1         @tab  X  @tab  X @tab experimental lossless codec (fourcc: FFV1)@item Snow                   @tab  X  @tab  X @tab experimental wavelet codec (fourcc: SNOW)@item Asus v1                @tab  X  @tab  X @tab fourcc: ASV1@item Asus v2                @tab  X  @tab  X @tab fourcc: ASV2@item Creative YUV           @tab     @tab  X @tab fourcc: CYUV@item Sorenson Video 1       @tab  X  @tab  X @tab fourcc: SVQ1@item Sorenson Video 3       @tab     @tab  X @tab fourcc: SVQ3@item On2 VP3                @tab     @tab  X @tab still experimental@item On2 VP5                @tab     @tab  X @tab fourcc: VP50@item On2 VP6                @tab     @tab  X @tab fourcc: VP60,VP61,VP62@item Theora                 @tab  X  @tab  X @tab still experimental@item Intel Indeo 3          @tab     @tab  X@item FLV                    @tab  X  @tab  X @tab Sorenson H.263 used in Flash@item Flash Screen Video     @tab  X  @tab  X @tab fourcc: FSV1@item ATI VCR1               @tab     @tab  X @tab fourcc: VCR1@item ATI VCR2               @tab     @tab  X @tab fourcc: VCR2@item Cirrus Logic AccuPak   @tab     @tab  X @tab fourcc: CLJR@item 4X Video               @tab     @tab  X @tab Used in certain computer games.@item Sony PlayStation MDEC  @tab     @tab  X@item id RoQ                 @tab  X  @tab  X @tab Used in Quake III, Jedi Knight 2, other computer games.@item Xan/WC3                @tab     @tab  X @tab Used in Wing Commander III .MVE files.@item Interplay Video        @tab     @tab  X @tab Used in Interplay .MVE files.@item Apple Animation        @tab  X  @tab  X @tab fourcc: 'rle '@item Apple Graphics         @tab     @tab  X @tab fourcc: 'smc '@item Apple Video            @tab     @tab  X @tab fourcc: rpza@item Apple QuickDraw        @tab     @tab  X @tab fourcc: qdrw@item Cinepak                @tab     @tab  X@item Microsoft RLE          @tab     @tab  X@item Microsoft Video-1      @tab     @tab  X@item Westwood VQA           @tab     @tab  X@item id Cinematic Video     @tab     @tab  X @tab Used in Quake II.@item planar RGB             @tab     @tab  X @tab fourcc: 8BPS@item FLIC video             @tab     @tab  X@item Duck TrueMotion v1     @tab     @tab  X @tab fourcc: DUCK@item Duck TrueMotion v2     @tab     @tab  X @tab fourcc: TM20@item VMD Video              @tab     @tab  X @tab Used in Sierra VMD files.@item MSZH                   @tab     @tab  X @tab Part of LCL@item ZLIB                   @tab  X  @tab  X @tab Part of LCL, encoder experimental@item TechSmith Camtasia     @tab     @tab  X @tab fourcc: TSCC@item IBM Ultimotion         @tab     @tab  X @tab fourcc: ULTI@item Miro VideoXL           @tab     @tab  X @tab fourcc: VIXL@item QPEG                   @tab     @tab  X @tab fourccs: QPEG, Q1.0, Q1.1@item LOCO                   @tab     @tab  X @tab@item Winnov WNV1            @tab     @tab  X @tab@item Autodesk RLE           @tab     @tab  X @tab fourcc: AASC@item Fraps FPS1             @tab     @tab  X @tab@item CamStudio              @tab     @tab  X @tab fourcc: CSCD@item American Laser Games Video  @tab    @tab X @tab Used in games like Mad Dog McCree.@item ZMBV                   @tab   X @tab  X @tab Encoder works only in PAL8.@item AVS Video              @tab     @tab  X @tab Video encoding used by the Creature Shock game.@item Smacker Video          @tab     @tab  X @tab Video encoding used in Smacker.@item RTjpeg                 @tab     @tab  X @tab Video encoding used in NuppelVideo files.@item KMVC                   @tab     @tab  X @tab Codec used in Worms games.@item VMware Video           @tab     @tab  X @tab Codec used in videos captured by VMware.@item Cin Video              @tab     @tab  X @tab Codec used in Delphine Software games.@item Tiertex Seq Video      @tab     @tab  X @tab Codec used in DOS CD-ROM FlashBack game.@item DXA Video              @tab     @tab  X @tab Codec originally used in Feeble Files game.@item AVID DNxHD             @tab   X @tab  X @tab aka SMPTE VC3@item C93 Video              @tab     @tab  X @tab Codec used in Cyberia game.@item THP                    @tab     @tab  X @tab Used on the Nintendo GameCube.@item Bethsoft VID           @tab     @tab  X @tab Used in some games from Bethesda Softworks.@item Renderware TXD         @tab     @tab  X @tab Texture dictionaries used by the Renderware Engine.@item AMV                    @tab     @tab  X @tab Used in Chinese MP3 players.@item Mimic                  @tab     @tab  X @tab Used in MSN Messenger Webcam streams.@item Electronic Arts CMV    @tab     @tab  X @tab Used in NHL 95 game.@end multitable@code{X} means that encoding (resp. decoding) is supported.@section Audio Codecs@multitable @columnfractions .4 .1 .1 .1 .7@item Supported Codec @tab Encoding @tab Decoding @tab Comments@item MPEG audio layer 2     @tab  IX  @tab  IX@item MPEG audio layer 1/3   @tab X   @tab  IX@tab MP3 encoding is supported through the external library LAME.@item AC-3                   @tab  IX  @tab  IX@tab liba52 can be used alternatively for decoding.@item Vorbis                 @tab  X   @tab  X@item WMA V1/V2              @tab X    @tab X@item AAC                    @tab X    @tab X@tab Supported through the external library libfaac/libfaad.@item Microsoft ADPCM        @tab X    @tab X@item AMV IMA ADPCM          @tab      @tab X@tab Used in AMV files@item MS IMA ADPCM           @tab X    @tab X@item QT IMA ADPCM           @tab X    @tab X@item 4X IMA ADPCM           @tab      @tab X@item G.726  ADPCM           @tab X    @tab X@item Duck DK3 IMA ADPCM     @tab      @tab X@tab Used in some Sega Saturn console games.@item Duck DK4 IMA ADPCM     @tab      @tab X@tab Used in some Sega Saturn console games.@item Westwood Studios IMA ADPCM @tab      @tab X@tab Used in Westwood Studios games like Command and Conquer.@item SMJPEG IMA ADPCM       @tab      @tab X@tab Used in certain Loki game ports.@item CD-ROM XA ADPCM        @tab      @tab X@item CRI ADX ADPCM          @tab X    @tab X@tab Used in Sega Dreamcast games.@item Electronic Arts ADPCM  @tab      @tab X@tab Used in various EA titles.@item MAXIS EA ADPCM         @tab      @tab X@tab Used in Sim City 3000.@item Creative ADPCM         @tab      @tab X@tab 16 -> 4, 8 -> 4, 8 -> 3, 8 -> 2@item THP ADPCM              @tab      @tab X@tab Used on the Nintendo GameCube.@item RA144                  @tab      @tab X@tab Real 14400 bit/s codec@item RA288                  @tab      @tab X@tab Real 28800 bit/s codec@item RADnet                 @tab X    @tab IX@tab real low bitrate AC-3 codec@item AMR-NB                 @tab X    @tab X@tab Supported through an external library.@item AMR-WB                 @tab X    @tab X@tab Supported through an external library.@item DV audio               @tab      @tab X@item id RoQ DPCM            @tab X    @tab X@tab Used in Quake III, Jedi Knight 2, other computer games.@item Interplay MVE DPCM     @tab      @tab X@tab Used in various Interplay computer games.@item Xan DPCM               @tab      @tab X@tab Used in Origin's Wing Commander IV AVI files.@item Sierra Online DPCM     @tab      @tab X@tab Used in Sierra Online game audio files.@item Apple MACE 3           @tab      @tab X@item Apple MACE 6           @tab      @tab X@item FLAC lossless audio    @tab X    @tab X@item Shorten lossless audio @tab      @tab X@item Apple lossless audio   @tab      @tab X@tab QuickTime fourcc 'alac'@item FFmpeg Sonic           @tab X    @tab X@tab experimental lossy/lossless codec@item Qdesign QDM2           @tab      @tab X@tab There are still some distortions.@item Real COOK              @tab      @tab X@tab All versions except 5.1 are supported.