GATOS version 0.0.5

HOMEPAGE

	The GATOS homepage is located at:
		http://www.core.binghamton.edu/~insomnia/gatos/

	Updates, news, additional documentation and the FAQ can be found there.
	
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, FreeBSD or NetBSD (only tested on x86).
	-ATI All-In-Wonder, All-In-Wonder Pro, or Rage II/Pro with ATI-TV
		tuner card.  Limited support for the All-In-Wonder 128 and
		Rage128 with ATI-TV tuner card.
	-XFree86 recommended, but not required.

INSTALLATION/SETUP

	See file "INSTALL" for installation and setup info.

FILE FORMATS

	Note, motion capture in xatitv and atitv uses a special ".yuv"
	file format unique to gatos.

	Snapshots on the other hand save to ".ppm" files, which are
	viewable (and convertible) by most graphics programs.

	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.

USAGE
	There are many programs packaged with GATOS:

		-===== gatos-conf: GUI GATOS configuration app =====-
	This is a new configuration program for GATOS written by Daniel
	Caujolle-Bert.  Just run it, and chose the correct settings and
	hit "save & quit".  A few notes:

		-Even if you chose "Gatos will Probe RAM", you still need
		 to select the correct amount of ram.
		-I2C mode selection should be left on "Gatos autodetection"
		 unless gatos fails to startup.
		-Television type is optional, it can be setup within xatitv.

		-===== 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.  It can also be used to name a channel so you
		 can later select that channel by name.
		*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 take snapshots.

		*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.


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

		atitojpg < gatos.yuv

	Note, unlike atitoppm, this application requires various
	utilities to be present (such as ppmtojpg, 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".