general.texi

mediastreamer2是开源的网络传输媒体流的库

\input texinfo @c -*- texinfo -*-

@settitle General Documentation
@titlepage
@sp 7
@center @titlefont{General Documentation}
@sp 3
@end titlepage


@chapter external libraries

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

@section AMR

AMR comes in two different flavors, wideband and narrowband. FFmpeg can make
use 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 for
installing 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 means
that you can use it if you legally obtained it but you are not allowed to
redistribute it in any way. @strong{Any FFmpeg binaries with libamr support
you create are non-free and unredistributable!}


@chapter Supported File Formats and Codecs

You can use the @code{-formats} option to have an exhaustive list.

@section File Formats

FFmpeg 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 Real Audio and Video @tab X @tab X
@item Raw AC3 @tab X  @tab  X
@item Raw MJPEG @tab X  @tab  X
@item Raw MPEG video @tab X  @tab  X
@item Raw PCM8/16 bits, mulaw/Alaw@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 MPEG4 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 format      @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 Nullsoft Video (NSV) format @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 CDROM version of the game Flashback.
@item DXA @tab    @tab X
@tab This format is used in non-Windows version of Feeble Files game and
different 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
@end multitable

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

@section Image Formats

FFmpeg can read and write images for each frame of a video sequence. The
following image formats are supported:

@multitable @columnfractions .4 .1 .1 .4
@item Supported Image Format @tab Encoding @tab Decoding @tab Comments
@item PGM, PPM     @tab X @tab X
@item PAM          @tab X @tab X @tab PAM is a PNM extension with alpha support.
@item PGMYUV       @tab X @tab X @tab PGM with U and V components in YUV 4:2:0
@item JPEG         @tab X @tab X @tab Progressive JPEG is not supported.
@item .Y.U.V       @tab X @tab X @tab one raw file per component
@item animated GIF @tab X @tab X @tab Only uncompressed GIFs are generated.
@item PNG          @tab X @tab X @tab 2 bit and 4 bit/pixel not supported yet.
@item Targa        @tab   @tab X @tab Targa (.TGA) image format.
@item TIFF         @tab X @tab X @tab YUV, JPEG and some extension is not supported yet.
@item SGI          @tab X @tab X @tab SGI RGB image format
@item PTX          @tab   @tab X @tab V.Flash PTX format
@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 @tab not completely working
@item WMV9                   @tab     @tab  X @tab not completely working
@item VC1                    @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 FFmpeg 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 Animator Studio Codec  @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 on 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 CDROM 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.
@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 AC3                    @tab  IX  @tab  IX
@tab liba52 is used internally 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      @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 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 AC3 codec, liba52 is used for decoding.
@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
@item DSP Group TrueSpeech   @tab      @tab X
@item True Audio (TTA)       @tab      @tab X
@item Smacker Audio          @tab      @tab X
@item WavPack Audio          @tab      @tab X
@item Cin Audio              @tab      @tab X
@tab Codec used in Delphine Software games.
@item Intel Music Coder      @tab      @tab X
@item Musepack               @tab      @tab X
@tab SV7 and SV8 are supported
@item DT$ Coherent Audio     @tab      @tab X
@item ATRAC 3                @tab      @tab X
@item Monkey's Audio         @tab      @tab X @tab Only versions 3.97-3.99 are supported
@item Nellymoser ASAO        @tab      @tab X
@end multitable