fame.1

一个很好用的MPEG1/4的开源编码器的应用程序

.TH FAME 1 "August 2001" "Fast Assembly Mpeg Encoder" "Vivien Chappelier"
.SH NAME
fame \- video4linux MPEG encoder
.SH SYNOPSIS
.B fame
[\fIOPTIONS\fR] \fIVIDEOFILE\R [\fIAUDIOFILE\fR] 
.br
.SH DESCRIPTION
.PP
.\" Add any additional description here
.PP
Encodes video from a video4linux capture device and optionnaly audio to MPEG.
The following options can be used to configure the encoding.
.PP
.I VIDEOFILE
is the file where MPEG video will be written to. If a '-' is used there, video is sent to standard output.
.I AUDIOFILE
is the file where MPEG audio will be written to. If a '-' is used there, audio is sent to standard output.

.SH OPTIONS
.TP
.B \--help
Show usage information.
.TP
.B \--verbose
Show information about the progress of the encoding.
.TP
.B \--profile
Select the profile to use. "mpeg1", "mpeg4" and "mpeg4_shape" are currently supported. When this option is not specified, the default is "mpeg1".
.TP
.B \--motion
Select the motion estimation algorithm to use. "none", "pmvfast" and "fourstep" are currently supported. When this option is not specified, the default is "pmvfast".
.TP
.B \--refresh
Number of frames before outputing a new sequence header. This option is useful for example when broadcasting output to a network to allow users to start decoding in the middle of a sequence. The default is to generate only one sequence header at the beginning of the output stream.
.TP
.B \--fps
Number of frames per second of the input sequence. When not specified, the default is 25. Fractional frame rates are allowed.
.TP
.B \--search
Specifies the search window, in pixel unit, for motion estimation. Small values give better result on slow motion videos, whereas bigger values work better with fast motion. The default is 16 pixels.
.TP
.B \--alpha
Quality of the shape coding in percent. Lower quality will produce smaller bitstream. The default is 100% since shape data is often negligible compared to video data.
.TP
.B \--buffer
Size of the output bitstream buffer. This should be set according to the size of the video being coded. Prediction over a large number of frames and large frame sizes require a greater output buffer. The default is set to 1Mbyte, which should be enough for nearly all videos. The unit is in bytes but Kbytes and Mbytes can be specified by appending a K (resp. an M) to the number (e.g. 4M).
.TP
.B \--bitrate
Use fixed bitrate. The unit is in bits per second but Kbits/s and Mbits/s can be specified by appending a K (resp. an M) to the number (e.g. 4M). When this option is used, quality will vary according to the complexity of the scene, and thus the --quality option becomes irrevelant. The default is to use fixed quality. Note that the actual bitrate after encoding may be slightly different from the one specified here.
.TP
.B \--quality
Quality of the encoded video in percent. The lower quality, the smaller encoded bitstream. When using fixed quality, bitrate may vary depending on the complexity of the scene, thus the --bitrate option becomes irrevelant. The default is to use fixed quality 75%.
.TP
.B \--coding
Specifies the order and type of frames to be coded. Currently supported frame types are 'I' for intra frames (completely coded) and 'P' for predicted frames (estimated from preceding 'I' or 'P' frame). Other types such as 'B' (bidirectionnal) or 'S' (sprite) are *not* yet supported. The default is "I", i.e. intra frames only. Coding must always begin with an I frame, thus "IP" is valid whereas "PI" is not.
.TP
.B \--picture
Specifies the picture size in the sequence. It can be either specified in 
widthxheight format, or by using names such as CIF (352x288), SIF (352x240) or QCIF (176x144). The default is CIF.

.SH "EXAMPLES"
.TP
fame -v video.mpg audio.mp3
For encoding a simple MPEG-1 video and mp3 audio, and see what's going on.
.TP
fame -q 50 -P mpeg4 video.mpg
For encoding a simple MPEG-4 video at 50% quality without sound.
.TP
fame -
For encoding an MPEG-1 video to standard output.
.TP
fame -c IP video.mpg
For encoding an MPEG-1 video with motion compensation.

.SH "RESTRICTIONS"
.I buffer
must be large enough to contain encoded data. There is no checking of buffer overflow as this would be too slow.
Encoding of B frame is not yet supported.

.SH "REPORTING BUGS"
Report bugs to <[e-mail]>.

.SH "SEE ALSO"
recmpeg (1)
.PP
The full documentation for
.B fame
is maintained as a HTML manual. You should find it at
.B http://fame.sourceforge.net/fame/doc

.SH COPYRIGHT
Copyright \(co 1999-2001 Vivien Chappelier.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.