Run documentation through ispell, plus some minor fixes.
Originally committed as revision 13670 to svn://svn.ffmpeg.org/ffmpeg/trunk
This commit is contained in:
parent
890f6fd3ec
commit
831ec93567
28
doc/faq.texi
28
doc/faq.texi
@ -38,7 +38,7 @@ No. Windows DLLs are not portable, bloated and often slow.
|
|||||||
Moreover FFmpeg strives to support all codecs natively.
|
Moreover FFmpeg strives to support all codecs natively.
|
||||||
A DLL loader is not conducive to that goal.
|
A DLL loader is not conducive to that goal.
|
||||||
|
|
||||||
@section My bugreport/mail to ffmpeg-devel/user has not received any replies.
|
@section My bug report/mail to ffmpeg-devel/user has not received any replies.
|
||||||
|
|
||||||
Likely reasons
|
Likely reasons
|
||||||
@itemize
|
@itemize
|
||||||
@ -69,7 +69,7 @@ documentation.
|
|||||||
@section Which codecs are supported by Windows?
|
@section Which codecs are supported by Windows?
|
||||||
|
|
||||||
Windows does not support standard formats like MPEG very well, unless you
|
Windows does not support standard formats like MPEG very well, unless you
|
||||||
install some additional codecs
|
install some additional codecs.
|
||||||
|
|
||||||
The following list of video codecs should work on most Windows systems:
|
The following list of video codecs should work on most Windows systems:
|
||||||
@table @option
|
@table @option
|
||||||
@ -82,7 +82,7 @@ The following list of video codecs should work on most Windows systems:
|
|||||||
@item wmv2
|
@item wmv2
|
||||||
.asf only
|
.asf only
|
||||||
@item mpeg4
|
@item mpeg4
|
||||||
only if you have some MPEG-4 codec installed like ffdshow or Xvid
|
Only if you have some MPEG-4 codec like ffdshow or Xvid installed.
|
||||||
@item mpeg1
|
@item mpeg1
|
||||||
.mpg only
|
.mpg only
|
||||||
@end table
|
@end table
|
||||||
@ -96,8 +96,9 @@ The following list of audio codecs should work on most Windows systems:
|
|||||||
@item adpcm_ima_wav
|
@item adpcm_ima_wav
|
||||||
@item adpcm_ms
|
@item adpcm_ms
|
||||||
@item pcm
|
@item pcm
|
||||||
|
always
|
||||||
@item mp3
|
@item mp3
|
||||||
if some MP3 codec like LAME is installed
|
If some MP3 codec like LAME is installed.
|
||||||
@end table
|
@end table
|
||||||
|
|
||||||
|
|
||||||
@ -111,12 +112,12 @@ the gcc developers. Note that we will not add workarounds for gcc bugs.
|
|||||||
|
|
||||||
@chapter Usage
|
@chapter Usage
|
||||||
|
|
||||||
@section ffmpeg does not work; What is wrong?
|
@section ffmpeg does not work; what is wrong?
|
||||||
|
|
||||||
Try a @code{make distclean} in the ffmpeg source directory before the build. If this does not help see
|
Try a @code{make distclean} in the ffmpeg source directory before the build. If this does not help see
|
||||||
(@url{http://ffmpeg.org/bugreports.html}).
|
(@url{http://ffmpeg.org/bugreports.html}).
|
||||||
|
|
||||||
@section How do I encode single pictures to movies?
|
@section How do I encode single pictures into movies?
|
||||||
|
|
||||||
First, rename your pictures to follow a numerical sequence.
|
First, rename your pictures to follow a numerical sequence.
|
||||||
For example, img1.jpg, img2.jpg, img3.jpg,...
|
For example, img1.jpg, img2.jpg, img3.jpg,...
|
||||||
@ -160,7 +161,8 @@ Beware that there is no "jpeg" codec. Use "mjpeg" instead.
|
|||||||
|
|
||||||
@section I get "Unsupported codec (id=86043) for input stream #0.1". What is the problem?
|
@section I get "Unsupported codec (id=86043) for input stream #0.1". What is the problem?
|
||||||
|
|
||||||
This is the Qcelp codec, FFmpeg has no support for that codec currently. Try mencoder/mplayer it might work.
|
This is the Qcelp codec, FFmpeg has no support for that codec currently.
|
||||||
|
Try MEncoder/MPlayer, it might work.
|
||||||
|
|
||||||
@section Why do I see a slight quality degradation with multithreaded MPEG* encoding?
|
@section Why do I see a slight quality degradation with multithreaded MPEG* encoding?
|
||||||
|
|
||||||
@ -170,7 +172,7 @@ quite logical that there is a small reduction of quality. This is not a bug.
|
|||||||
|
|
||||||
@section How can I read from the standard input or write to the standard output?
|
@section How can I read from the standard input or write to the standard output?
|
||||||
|
|
||||||
Use @file{-} as filename.
|
Use @file{-} as file name.
|
||||||
|
|
||||||
@section Why does FFmpeg not decode audio in VOB files?
|
@section Why does FFmpeg not decode audio in VOB files?
|
||||||
|
|
||||||
@ -206,7 +208,7 @@ Choose a different codec with the -vcodec command line option.
|
|||||||
|
|
||||||
Both Xvid and DivX (version 4+) are implementations of the ISO MPEG-4
|
Both Xvid and DivX (version 4+) are implementations of the ISO MPEG-4
|
||||||
standard (note that there are many other coding formats that use this
|
standard (note that there are many other coding formats that use this
|
||||||
same standard). Thus, use '-vcodec mpeg4' to encode these formats. The
|
same standard). Thus, use '-vcodec mpeg4' to encode in these formats. The
|
||||||
default fourcc stored in an MPEG-4-coded file will be 'FMP4'. If you want
|
default fourcc stored in an MPEG-4-coded file will be 'FMP4'. If you want
|
||||||
a different fourcc, use the '-vtag' option. E.g., '-vtag xvid' will
|
a different fourcc, use the '-vtag' option. E.g., '-vtag xvid' will
|
||||||
force the fourcc 'xvid' to be stored as the video fourcc rather than the
|
force the fourcc 'xvid' to be stored as the video fourcc rather than the
|
||||||
@ -362,7 +364,7 @@ examining all of the vbv_delay values and making complicated computations."
|
|||||||
|
|
||||||
Yes. Read the Developers Guide of the FFmpeg documentation. Alternatively,
|
Yes. Read the Developers Guide of the FFmpeg documentation. Alternatively,
|
||||||
examine the source code for one of the many open source projects that
|
examine the source code for one of the many open source projects that
|
||||||
already incorporate ffmpeg at (@url{projects.html}).
|
already incorporate FFmpeg at (@url{projects.html}).
|
||||||
|
|
||||||
@section Can you support my C compiler XXX?
|
@section Can you support my C compiler XXX?
|
||||||
|
|
||||||
@ -404,7 +406,7 @@ No. These tools are too bloated and they complicate the build.
|
|||||||
|
|
||||||
@section Why not rewrite ffmpeg in object-oriented C++?
|
@section Why not rewrite ffmpeg in object-oriented C++?
|
||||||
|
|
||||||
ffmpeg is already organized in a highly modular manner and does not need to
|
FFmpeg is already organized in a highly modular manner and does not need to
|
||||||
be rewritten in a formal object language. Further, many of the developers
|
be rewritten in a formal object language. Further, many of the developers
|
||||||
favor straight C; it works for them. For more arguments on this matter,
|
favor straight C; it works for them. For more arguments on this matter,
|
||||||
read "Programming Religion" at (@url{http://www.tux.org/lkml/#s15}).
|
read "Programming Religion" at (@url{http://www.tux.org/lkml/#s15}).
|
||||||
@ -412,14 +414,14 @@ read "Programming Religion" at (@url{http://www.tux.org/lkml/#s15}).
|
|||||||
@section Why are the ffmpeg programs devoid of debugging symbols?
|
@section Why are the ffmpeg programs devoid of debugging symbols?
|
||||||
|
|
||||||
The build process creates ffmpeg_g, ffplay_g, etc. which contain full debug
|
The build process creates ffmpeg_g, ffplay_g, etc. which contain full debug
|
||||||
information. Those binaries are strip'd to create ffmpeg, ffplay, etc. If
|
information. Those binaries are stripped to create ffmpeg, ffplay, etc. If
|
||||||
you need the debug information, used the *_g versions.
|
you need the debug information, used the *_g versions.
|
||||||
|
|
||||||
@section I do not like the LGPL, can I contribute code under the GPL instead?
|
@section I do not like the LGPL, can I contribute code under the GPL instead?
|
||||||
|
|
||||||
Yes, as long as the code is optional and can easily and cleanly be placed
|
Yes, as long as the code is optional and can easily and cleanly be placed
|
||||||
under #ifdef CONFIG_GPL without breaking anything. So for example a new codec
|
under #ifdef CONFIG_GPL without breaking anything. So for example a new codec
|
||||||
or filter would be OK under GPL while a bugfix to LGPL code would not.
|
or filter would be OK under GPL while a bug fix to LGPL code would not.
|
||||||
|
|
||||||
@section I want to compile xyz.c alone but my compiler produced many errors.
|
@section I want to compile xyz.c alone but my compiler produced many errors.
|
||||||
|
|
||||||
|
@ -124,7 +124,7 @@ Converts a.wav to a.mp2 at 64 kbits and to b.mp2 at 128 kbits. '-map
|
|||||||
file:index' specifies which input stream is used for each output
|
file:index' specifies which input stream is used for each output
|
||||||
stream, in the order of the definition of output streams.
|
stream, in the order of the definition of output streams.
|
||||||
|
|
||||||
* You can transcode decrypted VOBs
|
* You can transcode decrypted VOBs:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
ffmpeg -i snatch_1.vob -f avi -vcodec mpeg4 -b 800k -g 300 -bf 2 -acodec libmp3lame -ab 128k snatch.avi
|
ffmpeg -i snatch_1.vob -f avi -vcodec mpeg4 -b 800k -g 300 -bf 2 -acodec libmp3lame -ab 128k snatch.avi
|
||||||
@ -206,7 +206,7 @@ Show available formats, codecs, protocols, ...
|
|||||||
Force format.
|
Force format.
|
||||||
|
|
||||||
@item -i @var{filename}
|
@item -i @var{filename}
|
||||||
input filename
|
input file name
|
||||||
|
|
||||||
@item -y
|
@item -y
|
||||||
Overwrite output files.
|
Overwrite output files.
|
||||||
@ -419,7 +419,7 @@ Add a new video stream to the current output stream.
|
|||||||
Set pixel format. Use 'list' as parameter to show all the supported
|
Set pixel format. Use 'list' as parameter to show all the supported
|
||||||
pixel formats.
|
pixel formats.
|
||||||
@item -sws_flags @var{flags}
|
@item -sws_flags @var{flags}
|
||||||
Set SwScaler flags (only available when compiled with SwScaler support).
|
Set SwScaler flags (only available when compiled with swscale support).
|
||||||
@item -g @var{gop_size}
|
@item -g @var{gop_size}
|
||||||
Set the group of pictures size.
|
Set the group of pictures size.
|
||||||
@item -intra
|
@item -intra
|
||||||
@ -801,7 +801,7 @@ Fabrice Bellard
|
|||||||
|
|
||||||
@section Protocols
|
@section Protocols
|
||||||
|
|
||||||
The filename can be @file{-} to read from standard input or to write
|
The file name can be @file{-} to read from standard input or to write
|
||||||
to standard output.
|
to standard output.
|
||||||
|
|
||||||
FFmpeg also handles many protocols specified with an URL syntax.
|
FFmpeg also handles many protocols specified with an URL syntax.
|
||||||
|
@ -43,7 +43,7 @@ Force displayed width.
|
|||||||
Force displayed height.
|
Force displayed height.
|
||||||
@item -s @var{size}
|
@item -s @var{size}
|
||||||
Set frame size (WxH or abbreviation), needed for videos which don't
|
Set frame size (WxH or abbreviation), needed for videos which don't
|
||||||
contain a header with the framesize like raw YUV.
|
contain a header with the frame size like raw YUV.
|
||||||
@item -an
|
@item -an
|
||||||
Disable audio.
|
Disable audio.
|
||||||
@item -vn
|
@item -vn
|
||||||
@ -129,7 +129,7 @@ Seek to percentage in file corresponding to fraction of width.
|
|||||||
@settitle FFplay media player
|
@settitle FFplay media player
|
||||||
|
|
||||||
@c man begin SEEALSO
|
@c man begin SEEALSO
|
||||||
ffmpeg(1), ffserver(1) and the html documentation of @file{ffmpeg}.
|
ffmpeg(1), ffserver(1) and the HTML documentation of @file{ffmpeg}.
|
||||||
@c man end
|
@c man end
|
||||||
|
|
||||||
@c man begin AUTHOR
|
@c man begin AUTHOR
|
||||||
|
@ -22,7 +22,7 @@ etc. are not covered here. Read @file{ffmpeg-doc.html} for more
|
|||||||
information.
|
information.
|
||||||
@c man end
|
@c man end
|
||||||
|
|
||||||
@chapter QuickStart
|
@chapter Quick Start
|
||||||
|
|
||||||
[Contributed by Philip Gladstone, philip-ffserver at gladstonefamily dot net]
|
[Contributed by Philip Gladstone, philip-ffserver at gladstonefamily dot net]
|
||||||
|
|
||||||
@ -211,7 +211,7 @@ Use @file{configfile} instead of @file{/etc/ffserver.conf}.
|
|||||||
|
|
||||||
@ignore
|
@ignore
|
||||||
|
|
||||||
@setfilename ffsserver
|
@setfilename ffserver
|
||||||
@settitle FFserver video server
|
@settitle FFserver video server
|
||||||
|
|
||||||
@c man begin SEEALSO
|
@c man begin SEEALSO
|
||||||
|
@ -72,8 +72,8 @@ library:
|
|||||||
@item DV @tab X @tab X
|
@item DV @tab X @tab X
|
||||||
@item 4xm @tab @tab X
|
@item 4xm @tab @tab X
|
||||||
@tab 4X Technologies format, used in some games.
|
@tab 4X Technologies format, used in some games.
|
||||||
@item Playstation STR @tab @tab X
|
@item PlayStation STR @tab @tab X
|
||||||
@item Id RoQ @tab X @tab X
|
@item id RoQ @tab X @tab X
|
||||||
@tab Used in Quake III, Jedi Knight 2, other computer games.
|
@tab Used in Quake III, Jedi Knight 2, other computer games.
|
||||||
@item Interplay MVE @tab @tab X
|
@item Interplay MVE @tab @tab X
|
||||||
@tab Format used in various Interplay computer games.
|
@tab Format used in various Interplay computer games.
|
||||||
@ -83,7 +83,7 @@ library:
|
|||||||
@tab Used in many Sega Saturn console games.
|
@tab Used in many Sega Saturn console games.
|
||||||
@item Westwood Studios VQA/AUD @tab @tab X
|
@item Westwood Studios VQA/AUD @tab @tab X
|
||||||
@tab Multimedia formats used in Westwood Studios games.
|
@tab Multimedia formats used in Westwood Studios games.
|
||||||
@item Id Cinematic (.cin) @tab @tab X
|
@item id Cinematic (.cin) @tab @tab X
|
||||||
@tab Used in Quake II.
|
@tab Used in Quake II.
|
||||||
@item FLIC format @tab @tab X
|
@item FLIC format @tab @tab X
|
||||||
@tab .fli/.flc files
|
@tab .fli/.flc files
|
||||||
@ -112,7 +112,7 @@ library:
|
|||||||
@item MXF @tab @tab X
|
@item MXF @tab @tab X
|
||||||
@tab Material eXchange Format SMPTE 377M, used by D-Cinema, broadcast industry.
|
@tab Material eXchange Format SMPTE 377M, used by D-Cinema, broadcast industry.
|
||||||
@item SEQ @tab @tab X
|
@item SEQ @tab @tab X
|
||||||
@tab Tiertex .seq files used in the DOS CDROM version of the game Flashback.
|
@tab Tiertex .seq files used in the DOS CD-ROM version of the game Flashback.
|
||||||
@item DXA @tab @tab X
|
@item DXA @tab @tab X
|
||||||
@tab This format is used in non-Windows version of Feeble Files game and
|
@tab This format is used in non-Windows version of Feeble Files game and
|
||||||
different game cutscenes repacked for use with ScummVM.
|
different game cutscenes repacked for use with ScummVM.
|
||||||
@ -211,8 +211,8 @@ following image formats are supported:
|
|||||||
@item ATI VCR2 @tab @tab X @tab fourcc: VCR2
|
@item ATI VCR2 @tab @tab X @tab fourcc: VCR2
|
||||||
@item Cirrus Logic AccuPak @tab @tab X @tab fourcc: CLJR
|
@item Cirrus Logic AccuPak @tab @tab X @tab fourcc: CLJR
|
||||||
@item 4X Video @tab @tab X @tab Used in certain computer games.
|
@item 4X Video @tab @tab X @tab Used in certain computer games.
|
||||||
@item Sony Playstation MDEC @tab @tab X
|
@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 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 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 Interplay Video @tab @tab X @tab Used in Interplay .MVE files.
|
||||||
@item Apple Animation @tab X @tab X @tab fourcc: 'rle '
|
@item Apple Animation @tab X @tab X @tab fourcc: 'rle '
|
||||||
@ -223,7 +223,7 @@ following image formats are supported:
|
|||||||
@item Microsoft RLE @tab @tab X
|
@item Microsoft RLE @tab @tab X
|
||||||
@item Microsoft Video-1 @tab @tab X
|
@item Microsoft Video-1 @tab @tab X
|
||||||
@item Westwood VQA @tab @tab X
|
@item Westwood VQA @tab @tab X
|
||||||
@item Id Cinematic Video @tab @tab X @tab Used in Quake II.
|
@item id Cinematic Video @tab @tab X @tab Used in Quake II.
|
||||||
@item Planar RGB @tab @tab X @tab fourcc: 8BPS
|
@item Planar RGB @tab @tab X @tab fourcc: 8BPS
|
||||||
@item FLIC video @tab @tab X
|
@item FLIC video @tab @tab X
|
||||||
@item Duck TrueMotion v1 @tab @tab X @tab fourcc: DUCK
|
@item Duck TrueMotion v1 @tab @tab X @tab fourcc: DUCK
|
||||||
@ -248,7 +248,7 @@ following image formats are supported:
|
|||||||
@item KMVC @tab @tab X @tab Codec used in Worms games.
|
@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 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 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 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 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 AVID DNxHD @tab X @tab X @tab aka SMPTE VC3
|
||||||
@item C93 Video @tab @tab X @tab Codec used in Cyberia game.
|
@item C93 Video @tab @tab X @tab Codec used in Cyberia game.
|
||||||
@ -311,7 +311,7 @@ following image formats are supported:
|
|||||||
@item AMR-WB @tab X @tab X
|
@item AMR-WB @tab X @tab X
|
||||||
@tab Supported through an external library.
|
@tab Supported through an external library.
|
||||||
@item DV audio @tab @tab X
|
@item DV audio @tab @tab X
|
||||||
@item Id RoQ DPCM @tab X @tab X
|
@item id RoQ DPCM @tab X @tab X
|
||||||
@tab Used in Quake III, Jedi Knight 2, other computer games.
|
@tab Used in Quake III, Jedi Knight 2, other computer games.
|
||||||
@item Interplay MVE DPCM @tab @tab X
|
@item Interplay MVE DPCM @tab @tab X
|
||||||
@tab Used in various Interplay computer games.
|
@tab Used in various Interplay computer games.
|
||||||
@ -340,7 +340,7 @@ following image formats are supported:
|
|||||||
@item Intel Music Coder @tab @tab X
|
@item Intel Music Coder @tab @tab X
|
||||||
@item Musepack @tab @tab X
|
@item Musepack @tab @tab X
|
||||||
@tab SV7 and SV8 are supported
|
@tab SV7 and SV8 are supported
|
||||||
@item DT$ Coherent Audio @tab @tab X
|
@item DTS Coherent Audio @tab @tab X
|
||||||
@item ATRAC 3 @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 Monkey's Audio @tab @tab X @tab Only versions 3.97-3.99 are supported
|
||||||
@item Nellymoser ASAO @tab @tab X
|
@item Nellymoser ASAO @tab @tab X
|
||||||
|
Loading…
x
Reference in New Issue
Block a user