[FFmpeg-cvslog] r12771 - in trunk/doc: ffmpeg-doc.texi ffplay-doc.texi ffserver-doc.texi
diego
subversion
Tue Apr 8 18:39:30 CEST 2008
Author: diego
Date: Tue Apr 8 18:39:30 2008
New Revision: 12771
Log:
Mark option arguments as variables using @var{}.
patch by Stefano Sabatini, stefano.sabatini-lala poste it
Modified:
trunk/doc/ffmpeg-doc.texi
trunk/doc/ffplay-doc.texi
trunk/doc/ffserver-doc.texi
Modified: trunk/doc/ffmpeg-doc.texi
==============================================================================
--- trunk/doc/ffmpeg-doc.texi (original)
+++ trunk/doc/ffmpeg-doc.texi Tue Apr 8 18:39:30 2008
@@ -202,28 +202,28 @@ Show version.
@item -formats
Show available formats, codecs, protocols, ...
- at item -f fmt
+ at item -f @var{fmt}
Force format.
- at item -i filename
+ at item -i @var{filename}
input filename
@item -y
Overwrite output files.
- at item -t duration
+ at item -t @var{duration}
Restrict the transcoded/captured video sequence
to the duration specified in seconds.
@code{hh:mm:ss[.xxx]} syntax is also supported.
- at item -fs limit_size
+ at item -fs @var{limit_size}
Set the file size limit.
- at item -ss position
+ at item -ss @var{position}
Seek to given time position in seconds.
@code{hh:mm:ss[.xxx]} syntax is also supported.
- at item -itsoffset offset
+ at item -itsoffset @var{offset}
Set the input time offset in seconds.
@code{[-]hh:mm:ss[.xxx]} syntax is also supported.
This option affects all the input files that follow it.
@@ -231,34 +231,34 @@ The offset is added to the timestamps of
Specifying a positive offset means that the corresponding
streams are delayed by 'offset' seconds.
- at item -title string
+ at item -title @var{string}
Set the title.
- at item -timestamp time
+ at item -timestamp @var{time}
Set the timestamp.
- at item -author string
+ at item -author @var{string}
Set the author.
- at item -copyright string
+ at item -copyright @var{string}
Set the copyright.
- at item -comment string
+ at item -comment @var{string}
Set the comment.
- at item -album string
+ at item -album @var{string}
Set the album.
- at item -track number
+ at item -track @var{number}
Set the track.
- at item -year number
+ at item -year @var{number}
Set the year.
- at item -v number
+ at item -v @var{number}
Set the logging verbosity level.
- at item -target type
+ at item -target @var{type}
Specify target file type ("vcd", "svcd", "dvd", "dv", "dv50", "pal-vcd",
"ntsc-svcd", ... ). All the format options (bitrate, codecs,
buffer sizes) are then set automatically. You can just type:
@@ -274,16 +274,16 @@ they do not conflict with the standard,
ffmpeg -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg
@end example
- at item -dframes number
+ at item -dframes @var{number}
Set the number of data frames to record.
- at item -scodec codec
+ at item -scodec @var{codec}
Force subtitle codec ('copy' to copy stream).
@item -newsubtitle
Add a new subtitle stream to the current output stream.
- at item -slang code
+ at item -slang @var{code}
Set the ISO 639 language code (3 letters) of the current subtitle stream.
@end table
@@ -291,13 +291,13 @@ Set the ISO 639 language code (3 letters
@section Video Options
@table @option
- at item -b bitrate
+ at item -b @var{bitrate}
Set the video bitrate in bit/s (default = 200 kb/s).
- at item -vframes number
+ at item -vframes @var{number}
Set the number of video frames to record.
- at item -r fps
+ at item -r @var{fps}
Set frame rate (Hz value, fraction or abbreviation), (default = 25).
- at item -s size
+ at item -s @var{size}
Set frame size. The format is @samp{wxh} (ffserver default = 160x128, ffmpeg default = same as source).
The following abbreviations are recognized:
@table @samp
@@ -359,52 +359,52 @@ The following abbreviations are recogniz
1920x1080
@end table
- at item -aspect aspect
+ at item -aspect @var{aspect}
Set aspect ratio (4:3, 16:9 or 1.3333, 1.7777).
- at item -croptop size
+ at item -croptop @var{size}
Set top crop band size (in pixels).
- at item -cropbottom size
+ at item -cropbottom @var{size}
Set bottom crop band size (in pixels).
- at item -cropleft size
+ at item -cropleft @var{size}
Set left crop band size (in pixels).
- at item -cropright size
+ at item -cropright @var{size}
Set right crop band size (in pixels).
- at item -padtop size
+ at item -padtop @var{size}
Set top pad band size (in pixels).
- at item -padbottom size
+ at item -padbottom @var{size}
Set bottom pad band size (in pixels).
- at item -padleft size
+ at item -padleft @var{size}
Set left pad band size (in pixels).
- at item -padright size
+ at item -padright @var{size}
Set right pad band size (in pixels).
- at item -padcolor (hex color)
+ at item -padcolor @var{hex_color}
Set color of padded bands. The value for padcolor is expressed
as a six digit hexadecimal number where the first two digits
represent red, the middle two digits green and last two digits
blue (default = 000000 (black)).
@item -vn
Disable video recording.
- at item -bt tolerance
+ at item -bt @var{tolerance}
Set video bitrate tolerance (in bit/s).
- at item -maxrate bitrate
+ at item -maxrate @var{bitrate}
Set max video bitrate (in bit/s).
- at item -minrate bitrate
+ at item -minrate @var{bitrate}
Set min video bitrate (in bit/s).
- at item -bufsize size
+ at item -bufsize @var{size}
Set video buffer verifier buffer size (in bits).
- at item -vcodec codec
+ at item -vcodec @var{codec}
Force video codec to @var{codec}. Use the @code{copy} special value to
tell that the raw codec data must be copied as is.
@item -sameq
Use same video quality as source (implies VBR).
- at item -pass n
+ at item -pass @var{n}
Select the pass number (1 or 2). It is useful to do two pass
encoding. The statistics of the video are recorded in the first
pass and the video is generated at the exact requested bitrate
in the second pass.
- at item -passlogfile file
+ at item -passlogfile @var{file}
Set two pass logfile name to @var{file}.
@item -newvideo
@@ -415,37 +415,37 @@ Add a new video stream to the current ou
@section Advanced Video Options
@table @option
- at item -pix_fmt format
+ at item -pix_fmt @var{format}
Set pixel format. Use 'list' as parameter to show all the supported
pixel formats.
- at item -sws_flags flags
+ at item -sws_flags @var{flags}
Set SwScaler flags (only available when compiled with SwScaler support).
- at item -g gop_size
+ at item -g @var{gop_size}
Set the group of pictures size.
@item -intra
Use only intra frames.
- at item -vdt n
+ at item -vdt @var{n}
Discard threshold.
- at item -qscale q
+ at item -qscale @var{q}
Use fixed video quantizer scale (VBR).
- at item -qmin q
+ at item -qmin @var{q}
minimum video quantizer scale (VBR)
- at item -qmax q
+ at item -qmax @var{q}
maximum video quantizer scale (VBR)
- at item -qdiff q
+ at item -qdiff @var{q}
maximum difference between the quantizer scales (VBR)
- at item -qblur blur
+ at item -qblur @var{blur}
video quantizer scale blur (VBR)
- at item -qcomp compression
+ at item -qcomp @var{compression}
video quantizer scale compression (VBR)
- at item -lmin lambda
+ at item -lmin @var{lambda}
minimum video lagrange factor (VBR)
- at item -lmax lambda
+ at item -lmax @var{lambda}
max video lagrange factor (VBR)
- at item -mblmin lambda
+ at item -mblmin @var{lambda}
minimum macroblock quantizer scale (VBR)
- at item -mblmax lambda
+ at item -mblmax @var{lambda}
maximum macroblock quantizer scale (VBR)
These four options (lmin, lmax, mblmin, mblmax) use 'lambda' units,
@@ -454,22 +454,22 @@ but you may use the QP2LAMBDA constant t
ffmpeg -i src.ext -lmax 21*QP2LAMBDA dst.ext
@end example
- at item -rc_init_cplx complexity
+ at item -rc_init_cplx @var{complexity}
initial complexity for single pass encoding
- at item -b_qfactor factor
+ at item -b_qfactor @var{factor}
qp factor between P- and B-frames
- at item -i_qfactor factor
+ at item -i_qfactor @var{factor}
qp factor between P- and I-frames
- at item -b_qoffset offset
+ at item -b_qoffset @var{offset}
qp offset between P- and B-frames
- at item -i_qoffset offset
+ at item -i_qoffset @var{offset}
qp offset between P- and I-frames
- at item -rc_eq equation
+ at item -rc_eq @var{equation}
Set rate control equation (@pxref{FFmpeg formula
evaluator}) (default = @code{tex^qComp}).
- at item -rc_override override
+ at item -rc_override @var{override}
rate control override for specific intervals
- at item -me_method method
+ at item -me_method @var{method}
Set motion estimation method to @var{method}.
Available methods are (from lowest to best quality):
@table @samp
@@ -486,7 +486,7 @@ Try just the (0, 0) vector.
exhaustive search (slow and marginally better than epzs)
@end table
- at item -dct_algo algo
+ at item -dct_algo @var{algo}
Set DCT algorithm to @var{algo}. Available values are:
@table @samp
@item 0
@@ -503,7 +503,7 @@ FF_DCT_MLIB
FF_DCT_ALTIVEC
@end table
- at item -idct_algo algo
+ at item -idct_algo @var{algo}
Set IDCT algorithm to @var{algo}. Available values are:
@table @samp
@item 0
@@ -530,7 +530,7 @@ FF_IDCT_SH4
FF_IDCT_SIMPLEARM
@end table
- at item -er n
+ at item -er @var{n}
Set error resilience to @var{n}.
@table @samp
@item 1
@@ -543,7 +543,7 @@ FF_ER_AGGRESSIVE
FF_ER_VERY_AGGRESSIVE
@end table
- at item -ec bit_mask
+ at item -ec @var{bit_mask}
Set error concealment to @var{bit_mask}. @var{bit_mask} is a bit mask of
the following values:
@table @samp
@@ -553,9 +553,9 @@ FF_EC_GUESS_MVS (default = enabled)
FF_EC_DEBLOCK (default = enabled)
@end table
- at item -bf frames
+ at item -bf @var{frames}
Use 'frames' B-frames (supported for MPEG-1, MPEG-2 and MPEG-4).
- at item -mbd mode
+ at item -mbd @var{mode}
macroblock decision
@table @samp
@item 0
@@ -570,9 +570,9 @@ FF_MB_DECISION_RD: rate distortion
Use four motion vector by macroblock (MPEG-4 only).
@item -part
Use data partitioning (MPEG-4 only).
- at item -bug param
+ at item -bug @var{param}
Work around encoder bugs that are not auto-detected.
- at item -strict strictness
+ at item -strict @var{strictness}
How strictly to follow the standards.
@item -aic
Enable Advanced intra coding (h263+).
@@ -591,37 +591,37 @@ The alternative is to deinterlace the in
Calculate PSNR of compressed frames.
@item -vstats
Dump video coding statistics to @file{vstats_HHMMSS.log}.
- at item -vstats_file file
+ at item -vstats_file @var{file}
Dump video coding statistics to @var{file}.
- at item -vhook module
+ at item -vhook @var{module}
Insert video processing @var{module}. @var{module} contains the module
name and its parameters separated by spaces.
- at item -top n
+ at item -top @var{n}
top=1/bottom=0/auto=-1 field first
- at item -dc precision
+ at item -dc @var{precision}
Intra_dc_precision.
- at item -vtag fourcc/tag
+ at item -vtag @var{fourcc/tag}
Force video tag/fourcc.
@item -qphist
Show QP histogram.
- at item -vbsf bitstream filter
+ at item -vbsf @var{bitstream_filter}
Bitstream filters available are "dump_extra", "remove_extra", "noise".
@end table
@section Audio Options
@table @option
- at item -aframes number
+ at item -aframes @var{number}
Set the number of audio frames to record.
- at item -ar freq
+ at item -ar @var{freq}
Set the audio sampling frequency (default = 44100 Hz).
- at item -ab bitrate
+ at item -ab @var{bitrate}
Set the audio bitrate in bit/s (default = 64k).
- at item -ac channels
+ at item -ac @var{channels}
Set the number of audio channels (default = 1).
@item -an
Disable audio recording.
- at item -acodec codec
+ at item -acodec @var{codec}
Force audio codec to @var{codec}. Use the @code{copy} special value to
specify that the raw codec data must be copied as is.
@item -newaudio
@@ -636,36 +636,36 @@ Example:
@example
ffmpeg -i file.mpg -vcodec copy -acodec ac3 -ab 384k test.mpg -acodec mp2 -ab 192k -newaudio
@end example
- at item -alang code
+ at item -alang @var{code}
Set the ISO 639 language code (3 letters) of the current audio stream.
@end table
@section Advanced Audio options:
@table @option
- at item -atag fourcc/tag
+ at item -atag @var{fourcc/tag}
Force audio tag/fourcc.
- at item -absf bitstream filter
+ at item -absf @var{bitstream_filter}
Bitstream filters available are "dump_extra", "remove_extra", "noise", "mp3comp", "mp3decomp".
@end table
@section Subtitle options:
@table @option
- at item -scodec codec
+ at item -scodec @var{codec}
Force subtitle codec ('copy' to copy stream).
@item -newsubtitle
Add a new subtitle stream to the current output stream.
- at item -slang code
+ at item -slang @var{code}
Set the ISO 639 language code (3 letters) of the current subtitle stream.
@end table
@section Audio/Video grab options
@table @option
- at item -vc channel
+ at item -vc @var{channel}
Set video grab channel (DV1394 only).
- at item -tvstd standard
+ at item -tvstd @var{standard}
Set television standard (NTSC, PAL (SECAM)).
@item -isync
Synchronize read on input.
@@ -678,8 +678,8 @@ Synchronize read on input.
Set stream mapping from input streams to output streams.
Just enumerate the input streams in the order you want them in the output.
[input stream id] sets the (input) stream to sync against.
- at item -map_meta_data outfile:infile
-Set meta data information of outfile from infile.
+ at item -map_meta_data @var{outfile}:@var{infile}
+Set meta data information of @var{outfile} from @var{infile}.
@item -debug
Print specific debug info.
@item -benchmark
@@ -690,24 +690,24 @@ Dump each input packet.
When dumping packets, also dump the payload.
@item -bitexact
Only use bit exact algorithms (for codec testing).
- at item -ps size
+ at item -ps @var{size}
Set packet size in bits.
@item -re
Read input at native frame rate. Mainly used to simulate a grab device.
@item -loop_input
Loop over the input stream. Currently it works only for image
streams. This option is used for automatic FFserver testing.
- at item -loop_output number_of_times
+ at item -loop_output @var{number_of_times}
Repeatedly loop output for formats that support looping such as animated GIF
(0 will loop the output infinitely).
- at item -threads count
+ at item -threads @var{count}
Thread count.
- at item -vsync parameter
+ at item -vsync @var{parameter}
Video sync method. Video will be stretched/squeezed to match the timestamps,
it is done by duplicating and dropping frames. With -map you can select from
which stream the timestamps should be taken. You can leave either video or
audio unchanged and sync the remaining stream(s) to the unchanged one.
- at item -async samples_per_second
+ at item -async @var{samples_per_second}
Audio sync method. "Stretches/squeezes" the audio stream to match the timestamps,
the parameter is the maximum samples per second by which the audio is changed.
-async 1 is a special case where only the start of the audio stream is corrected
@@ -718,9 +718,9 @@ Copy timestamps from input to output.
Finish encoding when the shortest input stream ends.
@item -dts_delta_threshold
Timestamp discontinuity delta threshold.
- at item -muxdelay seconds
+ at item -muxdelay @var{seconds}
Set the maximum demux-decode delay.
- at item -muxpreload seconds
+ at item -muxpreload @var{seconds}
Set the initial demux-decode delay.
@end table
Modified: trunk/doc/ffplay-doc.texi
==============================================================================
--- trunk/doc/ffplay-doc.texi (original)
+++ trunk/doc/ffplay-doc.texi Tue Apr 8 18:39:30 2008
@@ -31,30 +31,30 @@ ffplay [options] @file{input_file}
@table @option
@item -h
show help
- at item -x width
+ at item -x @var{width}
force displayed width
- at item -y height
+ at item -y @var{height}
force displayed height
- at item -s size
+ at item -s @var{size}
Set frame size (WxH or abbreviation), needed for videos which don't
contain a header with the framesize like raw YUV.
@item -an
disable audio
@item -vn
disable video
- at item -ss pos
+ at item -ss @var{pos}
seek to a given position in seconds
@item -bytes
seek by bytes
@item -nodisp
disable graphical display
- at item -f fmt
+ at item -f @var{fmt}
force format
@end table
@section Advanced options
@table @option
- at item -pix_fmt format
+ at item -pix_fmt @var{format}
set pixel format
@item -stats
Show the stream duration, the codec parameters, the current position in
@@ -72,14 +72,14 @@ generate pts
@item -rtp_tcp
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
if you are streaming with the RTSP protocol.
- at item -sync type
+ at item -sync @var{type}
Set the master clock to audio (@code{type=audio}), video
(@code{type=video}) or external (@code{type=ext}). Default is audio. The
master clock is used to control audio-video synchronization. Most media
players use audio as master clock, but in some cases (streaming or high
quality broadcast) it is necessary to change that. This option is mainly
used for debugging purposes.
- at item -threads count
+ at item -threads @var{count}
thread count
@end table
Modified: trunk/doc/ffserver-doc.texi
==============================================================================
--- trunk/doc/ffserver-doc.texi (original)
+++ trunk/doc/ffserver-doc.texi Tue Apr 8 18:39:30 2008
@@ -200,7 +200,7 @@ ffserver [options]
Print the license.
@item -h
Print the help.
- at item -f configfile
+ at item -f @var{configfile}
Use @file{configfile} instead of @file{/etc/ffserver.conf}.
@end table
@c man end
More information about the ffmpeg-cvslog
mailing list