GATOS version 0.0.3

MAINTAINER
	Insomnia (Stea Greene) <insomnia@core.binghamton.edu>
		send bug reports and code patches to this address

	See file "CREDITS" for author info.

REQUIREMENTS

	-GNU/Linux (only tested on x86).  Also reported to work with
		FreeBSD, with some modifications.
	-ATI All-In-Wonder, All-In-Wonder Pro, or Rage II/Pro with ATI-TV
		tuner card.
	-XFree86.

INSTALLATION/SETUP

	See file "INSTALL" for installation and setup info.

USAGE
	There are many programs packaged with GATOS:

		-===== xatitv: GUI TV-in-a-window app =====-
	This is the main program shipped with GATOS.  It allows GUI access
	to all GATOS functionality, save tv-out.  The GUI is pretty
	self-explanatory, but here are the basics:

		*When first run, hit setup and configure format and
		 options, than do a channel scan.
		*Use the three buttons labeled "TV", "CV" and "SV" to
		 select video input from TV tuner, Composite video and
		 SVHS respectively.
		*The "Adv.", "Capture" and "Edit Channel" buttons toggle
		 other sections of the GUI.
		*Volume, Brightness, Contrast, Hue and Saturation can be
		 modified by clicking the mouse at any location along
		 their respective sliders.
		*The "Edit Channel" 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.
		*There are many other feature, look around and tinker with
		 them.
		*Most features have keyboard shortcuts:
		  -Esc: Quit.
		  -Tab/Right-Click: Hide/Show GUI.
		  -F1-F8: Favorite channels (CTRL+Key to set).
		  -F9-F12: Output debug info.
		  -Numbers: Change channel by number.
		  -Letters/space: Change channel by name.
		  -Enter/Return: Finish entering item (channel name/number).
		  -Up/Down: Scroll through settings.
		  -Left/Right: Change current setting.
		  -Keypad +/-: Change channel.
		  -Backspace: switches to the previous channel that you spent
		    more than 5 seconds at.
		  -Keypad /: Toggle mute.
		  -Keypad *: Toggle Fullscreen Mode.
		  -` or ~: Toggle closed captioning (CC).
		  -> and <: Increase/Decrease size of window by a factor of 2.
		  Pause: Freeze capture on current frame.
		  PrintScreen: Capture single frame (Snapshot).


		-===== atitv: Simple text-mode program =====-
	This program is still under development.  It gives basic
	functionality needed to record video and to toggle tv-out
	capabilities of the ATI card (NOTE: TV-Out is NOT implemented yet).

		*Run "atitv --help" for usage details.


		-= atitoppm: YUV conversion program =-
	This converts the ".yuv" file created by gatos to a series of
	".ppm" files.  Use as follows:

		atitoppm < gatos.yuv


		-===== atitogif: YUV conversion program =====-
	This converts the ".yuv" file created by gatos to a series of
	".gif" files.  Use as follows:

		atitogif < gatos.yuv

	Note, unlike atitoppm, this application requires various
	utilities to be present (such as ppmtogif, etc...).  If they are
	not, this program will fail.


		-===== yuvsum: YUV conversion program =====-
	This averages all images in gatos.yuv (must all be same size)
	into one ppm format image.  Use as follows:

		yuvsum < gatos.yuv


		-===== atisplit: YUV conversion program =====-
	This converts the ".yuv" file created by gatos to the separate
	".yuv" frames.  See file README.atisplit for details.

BUGS

	For bug list and bug submittal instructions, see file "BUGS".

PATCHES

	For instructions on how to use patches, see file "PATCHES".