1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
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".
|
