.\"             -*-Nroff-*-
.\" xatitv man page
.\"   Written by Gatos Devel. Team, and so grinded and scribbled by DCB.
.\"
.\" History:
.\"    0.1: (first generation)
.\"    0.2: some clean-ups and cosmetic changes 
.\"    0.3: updates for 0.0.5
.\"
.\" Last update: Mon Dec 20 03:00:05 CET 1999
.\" "
.TH xatitv 1 "20 Dec 1999 " " " "GATOS Manual"
.SH NAME
xatitv \- GUI "TV in a Window" application from the \fBGATOS\fP
package.
.SH SYNOPSIS
.BI "xatitv [options]"
.SH DESCRIPTION
\fIXatitv\fP is the main program shipped with GATOS.  It allows GUI
access to all \fBGATOS\fP functionality, save tv-out.  The GUI is
pretty self-explanatory, but here are the basics:
.TP
.B "\-"
When first run, hit setup and configure format and options, than do a
channel scan.
.TP
.B "\-"
Use the three buttons labeled \fITV\fP, \fICV\fP and \fISV\fP to
select video input from \fITV tuner\fP, \fIComposite Video\fP and
\fISVHS\fP respectively.
.TP
.B "\-"
The \fIAdv.\fP, \fICapture\fP and \fIEdit Channel\fP buttons toggle
other sections of the GUI.
.TP
.B "\-"
\fIVolume\fP, \fIBrightness\fP, \fIContrast\fP, \fIHue\fP and
\fISaturation\fP can be modified by clicking the mouse at any location
along their respective sliders.
.TP
.B "\-"
The \fIEdit Channel\fP GUI can be used to set channel-specific video
and audio settings (if a channel is too bright/dark, too loud/quiet,
etc) and to remove bogus channels.  It can also be used to name a
channel so you can later select that channel by name.
.TP
.B "\-"
There are many other feature, look around and tinker with them.
.TP
.B "\-"
Most features have keyboard shortcuts:
.RS
.TP
\fB\-\fP\fIEsc\fP
Quit.
.TP
\fB\-\fP\fITab\fP/\fIRight-Click\fP
Hide/Show GUI.
.TP
\fB\-\fP\fIF1\fP-\fIF8\fP
Favorite channels (\fICTRL\+Key\fP to set).
.TP
\fB\-\fP\fIF9\fP-\fIF12\fP
Output debug info.
.TP
\fB\-\fP\fINumbers\fP
Change channel by number.
.TP
\fB\-\fP\fILetters\fP/\fIspace\fP
Change channel by name.
.TP
\fB\-\fP\fIEnter\fP/\fIReturn\fP
Finish entering item (channel name/number).
.TP
\fB\-\fP\fIUp\fP/\fIDown\fP
Scroll through settings.
.TP
\fB\-\fP\fILeft\fP/\fIRight\fP
Change current setting.
.TP
\fB\-\fP\fIKeypad \+\fP/\fI\-\fP
Change channel.
.TP
\fB\-\fP\fIBackspace\fP
Switches to the previous channel that you spent more than 5 seconds
at.
.TP
\fB\-\fP\fIKeypad /\fP
Toggle mute.
.TP
\fB\-\fP\fIKeypad *\fP or \fIDouble-Click\fP
Toggle fullscreen Mode.
.TP
\fB\-\fP\fI` \fPor\fI ~\fP
Toggle closed captioning (\fICC\fP).
.TP
\fB\-\fP\fI>\fP and \fI<\fP
Increase/Decrease size of window by a factor of 2.
.TP
\fB\-\fP\fIPause\fP
Freeze capture on current frame.
.TP
\fB\-\fP\fIPrintScreen\fP
Capture single frame (Snapshot).
.RE
.SH FILE FORMATS
Note, motion capture in xatitv use a special ".yuv" file format 
unique to gatos.
.sp
Snapshots on the other hand save to ".ppm" files, which are
viewable (and convertible) by most graphics programs.
.sp
There is no automatic intelligence in xatitv to select this file's
extension, so to make sure other programs don't get confused, always take
snapshots to a ".ppm" file, and capture video to ".yuv" files.  This
should be fixed in the next version.
.sp
Snapshots to files containing a number (eg: gatos000.ppm) will
automatically increment the number in this filename for the next snapshot.  
So after taking a ppm snapshot to gatos000.ppm, xatitv will capture the
next to gatos001.ppm, then gatos002.ppm, etc....
.SH OPTIONS
.TP
\fB\-pci\fP <\fIpciaddr\fP>
Override PCI address in \fIgatos.conf\fP.
.TP
\fB\-q
Quiet mode (disable messages output).
.TP
\fB\-v
Verbose mode (display many debug infos).
.TP
\fB\-qv\fP|\fB-vq\fP
Display \fIGATOS\fP and \fIIBTK\fP versions used.
.TP
\fB\-d\fP<\fIvalue\fP>
Set verbosity level (\fBno\fP space between \fId\fP and \fIvalue\fP).
.TP
\fB\-nosa\fP
\fIOnly\fP for testing.
.SH FILES
.TP 
/etc/gatos.conf - Configuration file of GATOS.
.SH SEE ALSO
gatos, gatos-conf, gatos.conf, atitv, atisplit, atitogif, atitojpg, yuvsum,
scanpci.
.SH AUTHORS
\fIXatitv\fP was written and copyrighted by Steaphan Greene, \(/Oyvind
Aabling, Octavian Purdila, Vladimir Dergachev, Christian Lupien, and
Daniel Caujolle-Bert.