vcr.1

这个软件的功能同我上次传的那个avifile.也是linux上的一个用于多媒体应用的源码。

.TH VCR 1
.SH NAME
VCR - a text-console video recorder
.SH SYNOPSIS
.TP
\fBvcr\fR [\fBoptions\fR] filename
.SH DESCRIPTION
.I VCR 
is a program which enables you to record a program using a video grabber
card that's supported by the video4linux drivers. It doesn't require a
graphical environment, and you can use all popupular windows codecs (like
DivX, Indeo Video 5, etc) because VCR is built around the avifile library.
Now, you can finally record your favourite program from a remote place,
because Murphy's law dictates that you remember to record it when you're as
far away from your home as possible...
.PP
In the current early implementation, you can get an overview of all command
line options by executing it with option '--help'
.PP
If you want to exit vcr before the recording time is finished, type 'q' and
press enter. After a short while, VCR will exit gracefully.

.SH OPTIONS
Command-line options always override options specified in the config file.
If you choose a different video codec, the codec's attributes in the config
file will be ignored.
.PP
.TP
.B --codec-attribute, -a <attribute>=<value>
Sets a codec attribute. To get a list of attributes for your 
selected codec, give 'list=1' as argument. You can set more than
one attribute by using this option multiple times.
.br
Config-file directive: \fBattributes\fR
.TP
.B --audiobitrate, -b <rate>
If an audiobitrate is specified, audio will be compressed to mp3 format. Valid
bitrates will be listed if you specify an illegal value (e.g. 1). For 44Khz,
16 bits stereo recording, 128 kbps is an average quality. For mono, 96 is.
.br
Config-file directive: \fBaudiobitrate\fR
.TP
.B --codec, -c <codec>
Sets the codec to be used for video compression. Currently, only the DivX ;-)
codecs work well for encoding. The default codec is 'DivX ;-) low-motion'
with no attributes set (the defaults depend on your installed codec). To get
a list of available codecs, use 'list' as codecname.
.br
Config-file directive: \fBcodec\fR
.TP
.B --debug, -d [filename]
Turn on debug info. If you don't specify a filename, debug info will be logged
to ~/.vcrdebug.
.TP
.B --framerate, -F <rate>
Sets the framerate of the captured video. The default value is 25. If you
capture in NTSC mode, you can set it to 29.97.
.br
Config-file directive: \fBframerate\fR
.TP
.B --config-file, -f
Which file to use as configuration file (default= ~/.vcrrc)
See section \fBCONFIGFILE\fR for the syntax.
.TP
.B --help, -h
Shows an overview of all command line options and quits.
.TP
.B --keyframes, -k <keyframes>
Number of frames between keyframes (default=15)
.br
Config-file directive: \fBkeyframes\fR
.TP
.B --audiomode, -m <mode>
Sets audio recording mode. Can be either 'stereo' or 'mono'.
.br
Config-file directive: \fBaudiomode\fR
.TP
.B --codec-preset, -P <codec preset>
Which codec preset to use. A codec preset is similar to a tuner preset; it's
convenient when you want to define several qualities of recordings (archival,
something you view just once, etc). A codec preset \fBrequires\fR at least
a \fBcodec\fR (this distincts codec presets from tuner presets in the config
file). Other supported configuration directives are:
.br
\fBattributes\fR, \fBquality\fR, \fBkeyframes\fR, \fBaudiobitrate\fR, 
\fBaudiomode\fR, \fBaudiofrequency\fR, \fBaudiosamplesize\fR,
\fBframerate\fR, \fBresolution\fR, \fBsplitsize\fR, \fBwindow\fR.
.br
It's not possible (nor necessary) to set a default codec preset in the config
file. When no codec preset is given on the command line, the values from the
\fBDefaults\fR section will be used.
.TP
.B --preset, -p <tuner preset>
Which tuner preset to use. Tuner presets are read from the config
file, and have the same syntax/setup as xawtv's presets (which is
explained in the \fBCONFIGFILE\fR section).
.br
Config-file directive: \fBchannel\fR (sets default preset)
.TP
.B --quality, -q <quality>
Quality for codec (1..100, 100 being best, default = 95)
.br
Config-file directive: \fBquality\fR
.TP
.B --resolution, -r <resolution>
Sets the size of the capture window. To get a list of possible values,
supply an invalid number (e.g. 10). Default = 384x288.
.br
Config-file directive: \fBresolution\fR
.TP
.B --splitsize, -s <size>
Split the output in files of <size> megabytes. Useful for recording long
captures to files the size of a CD-ROM. Default = -1, unlimited size.
Some filesystems have a 2GB filesize barrier.
.br
Config-file directive: \fBsplitsize\fR
.TP
.B --source, -s <source>
Input source (use 'list'  to get a list of available sources). Default
input source is 'Television', if available on your hardware.
.br
Config-file directive: \fBsource\fR
.TP
.B --rectime, -t <time>
Length of time this program will record (notation: <number>h/m/s,
where number can have decimals, e.g. '1.5h' = 90 minutes)). If you omit h/m/s,
then minutes are assumed.
.br
Use -1 for unlimited recording time.
.TP
.B --window, -w <x>,<y>,<width>,<height>
Crops each video frame to a window of width x height pixels, starting at
offset (x,y). Offset is relative to the upper left corner (0,0). Without
specifying a window, the captured video size is the size of your chosen
\fBresolution\fR.
.br
Config-file directive: \fBwindow\fR
.SH CONFIGFILE
VCR expects to find the default config file in ~/.vcrrc. With '-f', you
can supply a different config file.
.br
The syntax of VCR's config file is the same as xawtv's syntax. The file
is split into sections, which are denominated by a keyword in square
brackets on a single line. Every line up to the next denominator belongs
to this section.
.PP
All section names represent the name of a tuner preset, except for 3
specific names: \fBdefaults\fR, \fBglobal\fR and \fBlaunch\fR.
.br
Of these 3 special sections, VCR only uses \fBdefaults\fR.
.PP
Each line in a section contains a keyword/value pair, unless the line begins
with a '#', which means it's ignored (you can use it to put comments on).
Empty lines are also ignored.
.br
A keyword/value pair is formatted like this:
.TP
\fBkeyword\fR = \fBvalue\fR
.PP
These keywords are recognized in the defaults section:
.TP
.B attributes
Attributes specific to the codec used for encoding. Syntax:
.br
\fBattribute1=value1,attribute2=value2\fR
.TP
.B audiofrequency
Sets audio frequency. Possible values are \fB44\fR, \fB22\fR and \fB11\fR.
(kHz)
.TP
.B audiomode
Same as \fB--audiomode\fR parameter.
.TP
.B audiosamplesize
Sets audio sample size. Can be \fB16\fR (default) or \fB8\fR.
.TP
.B codec
Same as \fB--codec\fR parameter
.TP
.B channel
Default tuner preset to record from (same as \fB--preset\fR)
.TP
.B framerate
Same as \fB--framerate\fR parameter.
.TP
.B freqtab
Sets the frequency table for your region. If you omit this keyword, you will
get a list of available frequency tables.
.TP
.B init-sound [mixer:][device:]volume
Sets up the sound recording device. The default \fBmixer\fR is /dev/mixer,
the default mixer \fBdevice\fR is 'Line'. A sane volume level is likely
in the range of 70..100. Without the init-sound keyword, you will have
to initialize the sound-device yourself before starting vcr.
.TP
.B keyframes
Same as \fB--keyframes\fR parameter
.TP
.B norm
TV norm in your country (currently one of PAL,NTSC,SECAM,AUTO).
.TP
.B quality
Same as \fB--quality\fR parameter
.TP
.B rectime
Same as \fB--rectime\fR parameter.
.TP
.B resolution
Same as \fB--resolution\fR parameter.
.br
The bigger the window, the faster your CPU must be.
.TP
.B sound-device
The sound device to record from. Default: /dev/dsp
.TP
.B source
Same as \fB--source\fR parameter
.TP
.B splitsize
Same as \fB--splitsize\fR parameter
.TP
.B vflip
Set this to 1 if you want to flip the image vertically. This might be
necessary on some systems. If you don't specify it, or set it to 0, no
flipping will be performed.
.TP
.B window
Same as \fB--window\fR parameter.
.br
.PP
All other sections are considered tuner- or codec presets. You should supply
the name of the preset (between the square brackets) to vcr using the
\fB--preset\fR (tuner) or \fB--codec-preset\fR (codec) parameter.
.br
The difference between tuner- and codecpresets is determined by the presence
of the keyword 'codec': If it's present, it's a codec preset, otherwise a 
tuner preset.
.PP
VCR recognizes these 2 keywords in each tuner preset:
.TP
.B channel
Channel (see xawtv manual)
.TP
.B fine
Fine-tuning (see xawtv manual)
.SH EXAMPLE CONFIG
An example configuration file with 3 tuner presets:
.IP
.TS
l l.
[defaults]
quality = 100
keyframes = 15
codec = DivX ;-) low-motion
attributes = BitRate=1600,Crispness=100
source = Television
norm = pal
verbose = 1

[Nederland 1]
channel = E11
fine = -26

[Nederland 2]
channel = E6
fine = +20

[Nederland 3]
channel = E7
fine = +36
.TE
.SH BUGS
.PP
If you find bugs, please send reports to [e-mail].
.PP
.SH AUTHOR
.I VCR
has been written by
.B Bram Avontuur <[e-mail]> <http://www.stack.nl/~brama/>
.PP
Much code has been taken from avifile (\fBhttp://divx.euro.ru/\fR).
.PP
Config file parsing code is taken from xawtv
(\fBhttp://www.strusel007.de/linux/xawtv/\fR)
.PP
Please send comments, suggestions, complaints, bug fixes, coffee and porting
experiences to me, including the version number of VCR in your mail.