Commit 179dcf99 authored by stefano's avatar stefano

Fix texi2pod.pl rendering of the Tips section by putting each @item

command on its own line, and create a corresponding "TIPS" man page
section.

Note that such section is not displayed, as currently only sections
with pre-defined names are rendered.

git-svn-id: file:///var/local/repositories/ffmpeg/trunk@23409 9553f0bf-9b14-0410-a0b8-cfaf0461ba5b
parent b2b6f9e7
...@@ -917,9 +917,11 @@ FFserver (see the FFserver documentation). When FFmpeg will be a ...@@ -917,9 +917,11 @@ FFserver (see the FFserver documentation). When FFmpeg will be a
video player it will also be used for streaming :-) video player it will also be used for streaming :-)
@chapter Tips @chapter Tips
@c man begin TIPS
@itemize @itemize
@item For streaming at very low bitrate application, use a low frame rate @item
For streaming at very low bitrate application, use a low frame rate
and a small GOP size. This is especially true for RealVideo where and a small GOP size. This is especially true for RealVideo where
the Linux player does not seem to be very fast, so it can miss the Linux player does not seem to be very fast, so it can miss
frames. An example is: frames. An example is:
...@@ -928,30 +930,36 @@ frames. An example is: ...@@ -928,30 +930,36 @@ frames. An example is:
ffmpeg -g 3 -r 3 -t 10 -b 50k -s qcif -f rv10 /tmp/b.rm ffmpeg -g 3 -r 3 -t 10 -b 50k -s qcif -f rv10 /tmp/b.rm
@end example @end example
@item The parameter 'q' which is displayed while encoding is the current @item
The parameter 'q' which is displayed while encoding is the current
quantizer. The value 1 indicates that a very good quality could quantizer. The value 1 indicates that a very good quality could
be achieved. The value 31 indicates the worst quality. If q=31 appears be achieved. The value 31 indicates the worst quality. If q=31 appears
too often, it means that the encoder cannot compress enough to meet too often, it means that the encoder cannot compress enough to meet
your bitrate. You must either increase the bitrate, decrease the your bitrate. You must either increase the bitrate, decrease the
frame rate or decrease the frame size. frame rate or decrease the frame size.
@item If your computer is not fast enough, you can speed up the @item
If your computer is not fast enough, you can speed up the
compression at the expense of the compression ratio. You can use compression at the expense of the compression ratio. You can use
'-me zero' to speed up motion estimation, and '-intra' to disable '-me zero' to speed up motion estimation, and '-intra' to disable
motion estimation completely (you have only I-frames, which means it motion estimation completely (you have only I-frames, which means it
is about as good as JPEG compression). is about as good as JPEG compression).
@item To have very low audio bitrates, reduce the sampling frequency @item
To have very low audio bitrates, reduce the sampling frequency
(down to 22050 Hz for MPEG audio, 22050 or 11025 for AC-3). (down to 22050 Hz for MPEG audio, 22050 or 11025 for AC-3).
@item To have a constant quality (but a variable bitrate), use the option @item
To have a constant quality (but a variable bitrate), use the option
'-qscale n' when 'n' is between 1 (excellent quality) and 31 (worst '-qscale n' when 'n' is between 1 (excellent quality) and 31 (worst
quality). quality).
@item When converting video files, you can use the '-sameq' option which @item
When converting video files, you can use the '-sameq' option which
uses the same quality factor in the encoder as in the decoder. uses the same quality factor in the encoder as in the decoder.
It allows almost lossless encoding. It allows almost lossless encoding.
@end itemize @end itemize
@c man end TIPS
@bye @bye
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment