File: USAGE

package info (click to toggle)
atari800 0.8.6-2
  • links: PTS
  • area: contrib
  • in suites: hamm
  • size: 1,364 kB
  • ctags: 2,457
  • sloc: ansic: 22,055; asm: 2,812; cpp: 581; makefile: 68; sh: 8
file content (248 lines) | stat: -rw-r--r-- 7,112 bytes parent folder | download
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
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
Usage
-----

Usage: atari800 [-atari] [-xl] [-xe] [-5200] [-b] [-c] [-d]
		[disk1.xfd ... disk8.xfd]
                [-xcolpf1]
		[-rom filename]
                [-rom16 filename]
                [-ags32 filename]
		[-oss filename]
		[-nopatch]
		{-small|-large|-huge}
		{-sound}
		{-left|-central|-right|-wide1|-wide2}

-atari  Enable Atari 800 Emulation Mode [default]
-xl     Enable Atari 800XL Emulation Mode
-xe     Enable Atari 130XE Emulation Mode (but Antic accesses the bank that
        the CPU is using)
-5200   Enable Atari 5200 Games System Emulation Mode.

-nopatch Normally the OS is patched giving very fast I/O. This option
         prevents the patch from being applied so that the OS works
         using the serial port hardware directly. This option will
         probably never be needed since programs that access the
         serial hardware directly will work even if the OS has been
         patched.
-xcolpf1 Enables Extended Usage of COLPF1 as used by Antic Modes
         2, 3 and f.

-rom     Loads the following 8K ROM Cartridge
-rom16   Loads the following 16K ROM Cartridge
-ags32   Loads the following Atari 5200 Games System 32K ROM Cartridge.
-oss     Loads the following OSS Super Cartridge
-db      Loads the following DB Super Cartridge
         (Private 32K Cartridge Format - not for general use)

-a       Use Atari OS/A ROM (atariosa.rom)
-b       Use Atari OS/B ROM (atariosb.rom) [default]
-c       Enable RAM between $C000 and $CFFF
-d       Enable DEBUG Mode. Monitor is entered straight away. Only
         useful for basic version.

X Window Options
----------------

-small	Creates a small window where one Atari 800 pixel is represented
	by a single X Window pixel.
-large	Creates a large window where one Atari 800 pixel is represented
	by a 2x2 X Window rectangle.
-huge	Creates a huge window where one Atari 800 pixel is represented
	by a 3x3 X Window rectangle.

SVGALIB Options
---------------

-sound	Select this if you want to try the test sound implementation.
	You must have the piano1.sbi file in your current directory.
	The piano1.sbi file can be obtained from snd-data-0.1.tar.Z
	in the kernel/sound directory on sunsite.

-interlace	Select this to display only half the scanlines at a
		time. Gives a performance increase of about 10%.

Amiga Options
-------------

-ocs	Select this if you are using an OCS based Amiga. Note: This
	option has only been tested under OCS emulation on an A1200.
	There could be Workbench compatibility problems on a real OCS
	Amiga.
-ecs	Select this if you are using an ECS based Amiga. Note: This
	option has only been test under ECS emulation on an A1200.
	There could be Workbench compatibility problems on a real ECS
	Amiga.
-aga	Select this if you are using an AGA based Amiga.
-grey	Produce a grey scale display.
-colour	Produce a full colour display on AGA Amigas and up to 32
	simultaneous colours on OCS and ECS Amigas.

Curses Options
--------------

-left		Use columns 0 to 39
-central	Use columns 20 to 59
-right		Use columns 40 to 79
-wide1		Use columns 0 to 79 (Spaces between characters)
-wide2		Use columns 0 to 79 (as above but Normal/Reverse spaces)

Dos VGA Options
---------------

-interlace	Select this to display only half the scanlines at a
		time. Gives a performance increase of about 10%.

Keyboard + Joystick & Paddle Controllers
========================================

Unlike PC Xformer, I have not tried to emulate the exact keyboard layout,
instead, I have tried to make your native keyboard work as normal.

Note: The function keys will eventually be changed to a more logical
      order.

X11 Keyboard + Joystick & Paddle Controllers
============================================

F1	Built in User Interface
F2	Option
F3	Select
F4	Start
F5	Warm Reset
Shft+F5	Cold Reset
F6	Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7	Break Key
F8	---
F9	Exit Emulator
F10	---
F11	Vertical Positioning: Scroll Screen Downwards
F12	Vertical Positioning: Scroll Screen Upwards

ALT	Atari Key (Either ALT Key will work)

Joystick 0 is operated by the mouse position relative to the center of the
screen. The mouse button acts as the trigger.

Paddle 0 is operated by moving the mouse pointer across the window.

SVGALIB Keyboard + Joystick & Paddle Controllers
================================================

F1	Built in User Interface
F2	Option
F3	Select
F4	Start
F5	Warm Reset
Shft+F5	Cold Reset
F6	Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7	Break Key
F8	---
F9	Exit Emulator
F10	---
F11	---
F12	---

`	This character replaces the CAPS lock key because I have not
	found a way of detecting it. A future solution maybe to
	automatically issue a CAPS lock key when a transition is
	made between lower and upper case keys. i.e. If svgalib
	return 'a' followed by 'A' it could send 'a' 'CAPS' 'A' to
	the Atari.

The CTRL+SHIFT keyboard combinations are implemented using the left
ALT key.

Joystick 0 is operated by the numeric keypad (make sure that the numeric
keypad has been enabled).

	7 8 9
	 \|/
	4 5 6
	 /|\
	1 2 3

	And 0 is the fire key.

At the moment it is not possible to use a Paddle with the SVGALIB version.

CURSES Keyboard + Joystick & Paddle Controllers
===============================================

F1	Warm Reset (This doesn't work under Open Windows)
F2	Option
F3	Select
F4	Start
F5	Cold Reset
F6	Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7	Break Key
F8	---
F9	Exit Emulator
F10	---
F11	---
F12	---

Some control have special meaning within curses and should not be used.

	Avoid Control + C, J, M, Q, S and Z

The remaining control characters can be typed. Control characters are
displayed on the screen with the associated upper case character in bold.

No Joystick or Paddle support in this version.

AMIGA Keyboard + Joystick & Paddle Controllers
==============================================

F1	Warm Reset (This doesn't work under Open Windows)
F2	Option
F3	Select
F4	Start
F5	Cold Reset
F6	Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7	Break Key
F8	---
F9	EXIT Emulator
F10	---

Joystick is operated as normal with joystick plugged into port 2.
Paddles are not support at the moment.

BASIC Keyboard + Joystick & Paddle Controllers
==============================================

No Frills text. Upper and Lower case letters, 0-9, !"$% etc.
No Reset, Option, Select, Start, etc.
No Joystick or Paddle support in this version.

DOS VGA Keyboard + Joystick & Paddle Controllers
================================================

F1	Built in User Interface
F2	Option
F3	Select
F4	Start
F5	Warm Reset
Shft+F5	Cold Reset
F6	Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7	Break Key
F8	---
F9	EXIT Emulator
F10	---

Control-C terminates the program; to type Control-c, type ALT-c instead.
` is used as the Caps-Lock key, just like the SVGALIB version.

Joystick 0 is operated by the numeric keypad (make sure that the numeric
keypad has been enabled).
 
        7 8 9
         \|/
        4 5 6
         /|\
        1 2 3
 
        And 0 is the fire key.
 
At the moment it is not possible to use a Paddle with this version.