![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to atc.6 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / games / atc|
Return to atc.6 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / games / atc |
1.1 root 1: .\" Copyright (c) 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" This code is derived from software contributed to Berkeley by
5: .\" Ed James.
6: .\"
7: .\" Redistribution and use in source and binary forms are permitted provided
8: .\" that: (1) source distributions retain this entire copyright notice and
9: .\" comment, and (2) distributions including binaries display the following
10: .\" acknowledgement: ``This product includes software developed by the
11: .\" University of California, Berkeley and its contributors'' in the
12: .\" documentation or other materials provided with the distribution and in
13: .\" all advertising materials mentioning features or use of this software.
14: .\" Neither the name of the University nor the names of its contributors may
15: .\" be used to endorse or promote products derived from this software without
16: .\" specific prior written permission.
17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
20: .\"
21: .\" @(#)atc.6 5.4 (Berkeley) 6/23/90
22: .\"
23: . \" XP - exdented paragraph
24: .de XP
25: .RT
26: .if \\n(1T .sp \\n(PDu
27: .ne 1.1
28: .if !\\n(IP .nr IP +1
29: .in +\\n(I\\n(IRu
30: .ti -\\n(I\\n(IRu
31: ..
32: .\" Copyright (c) 1986 Ed James. All rights reserved.
33: .\"
34: .TH ATC 6 "June 23, 1990"
35: .UC
36: .SH NAME
37: atc \- Air Traffic Controller Game
38: .SH SYNOPSIS
39: .B atc
40: -[u?lstp] [-[gf] game_name] [-r random seed]
41: .SH DESCRIPTION
42: .LP
43: .I Atc
44: lets you try your hand at the nerve wracking duties of the air traffic
45: controller without endangering the lives of millions of
46: travelers each year.
47: Your responsibilities require you to direct the flight of jets
48: and prop planes into and out of the flight arena and airports.
49: The speed (update time) and frequency of the planes depend on the
50: difficulty of the chosen arena.
51: .SH OPTIONS
52: .LP
53: .TP 8
54: .B \-u
55: Print the usage line and exit.
56: .TP
57: .B \-?
58: Same as
59: .B \-u.
60: .TP
61: .B \-l
62: Print a list of available games and exit.
63: The first game name printed is the default game.
64: .TP
65: .B \-s
66: Print the score list (formerly the Top Ten list).
67: .TP
68: .B \-t
69: Same as
70: .B \-s.
71: .TP
72: .B \-p
73: Print the path to the special directory where
74: .I atc
75: expects to find its private files. This is used during the
76: installation of the program.
77: .TP
78: .B "\-g game"
79: Play the named game. If the game listed is not one of the
80: ones printed from the
81: .B \-l
82: option, the default game is played.
83: .TP
84: .B "\-f game"
85: Same as
86: .B \-g.
87: .TP
88: .B "\-r seed"
89: Set the random seed. The purpose of this flag is questionable.
90: .SH GOALS
91: .LP
92: Your goal in
93: .I atc
94: is to keep the game going as long as possible.
95: There is no winning state, except to beat the times of other players.
96: You will need to: launch planes at airports (by instructing them to
97: increase their altitude); land planes at airports (by instructing them to
98: go to altitude zero when exactly over the airport); and maneuver planes
99: out of exit points.
100: .LP
101: Several things will cause the end of the game.
102: Each plane has a destination (see information area), and
103: sending a plane to the wrong destination is an error.
104: Planes can run out of fuel, or can collide. Collision is defined as
105: adjacency in any of the three dimensions. A plane leaving the arena
106: in any other way than through its destination exit is an error as well.
107: .LP
108: Scores are sorted in order of the number of planes safe. The other
109: statistics are provided merely for fun. There is no penalty for
110: taking longer than another player (except in the case of ties).
111: .LP
112: Suspending a game is not permitted. If you get a talk message, tough.
113: When was the last time an Air Traffic Controller got called away to
114: the phone?
115: .SH "THE DISPLAY"
116: .LP
117: Depending on the terminal you run
118: .I atc
119: on, the screen will be divided into 4 areas.
120: It should be stressed that the terminal driver portion of the
121: game was designed to be reconfigurable, so the display format can vary
122: depending the version you are playing. The descriptions here are based
123: on the ascii version
124: of the game. The game rules and input format, however,
125: should remain consistent.
126: Control-L redraws the screen, should it become muddled.
127: .SS RADAR
128: .IP
129: The first screen area is the radar display, showing the relative locations
130: of the planes, airports, standard entry/exit points, radar
131: beacons, and "lines" which simply serve to aid you in guiding
132: the planes.
133: .IP
134: Planes are shown as a single letter with an altitude. If
135: the numerical altitude is a single digit, then it represents
136: thousands of feet.
137: Some distinction is made between the prop
138: planes and the jets. On ascii terminals, prop planes are
139: represented by a upper case letter, jets by a lower case letter.
140: .IP
141: Airports are shown as a number and some indication of the direction
142: planes must be going to land at the airport.
143: On ascii terminals, this is one of '^', '>', '<', and 'v', to indicate
144: north (0 degrees), east (90), west (270) and south (180), respectively.
145: The planes will also
146: take off in this direction.
147: .IP
148: Beacons are represented as circles or asterisks and a number.
149: Their purpose is to offer a place of easy reference to the plane pilots.
150: See 'the delay command' under the input section of this manual.
151: .IP
152: Entry/exit points are displayed as numbers along the border of the
153: radar screen. Planes will enter the arena from these points without
154: warning. These points have a direction associated with them, and
155: planes will always enter the arena from this direction. On the
156: ascii version of
157: .I atc,
158: this direction is not displayed. It will become apparent
159: what this direction is as the game progresses.
160: .IP
161: Incoming planes will always enter at the same altitude: 7000 feet.
162: For a plane to successfully depart through an entry/exit point,
163: it must be flying at 9000 feet.
164: It is not necessary for the planes to be flying in any particular
165: direction when they leave the arena (yet).
166: .SS "INFORMATION AREA"
167: .IP
168: The second area of the display is the information area, which lists
169: the time (number of updates since start), and the number of planes you
170: have directed safely out of the arena.
171: Below this is a list of planes currently in the air, followed by a
172: blank line, and then a list of planes on the ground (at airports).
173: Each line lists the plane name and its current altitude,
174: an optional asterisk indicating low fuel, the plane's destination,
175: and the plane's current command. Changing altitude is not considered
176: to be a command and is therefore not displayed. The following are
177: some possible information lines:
178: .IP
179: B4*A0: Circle @ b1
180: .br
181: g7 E4: 225
182: .IP
183: The first example shows a prop plane named 'B' that is flying at 4000
184: feet. It is low on fuel (note the '*'). It's destination is
185: Airport #0.
186: The next command it expects
187: to do is circle when it reaches Beacon #1.
188: The second example shows a jet named 'g' at 7000 feet, destined for
189: Exit #4. It is just now executing a turn to 225 degrees (South-West).
190: .SS "INPUT AREA"
191: .IP
192: The third area of the display is the input area. It is here that
193: your input is reflected. See the INPUT heading of this manual
194: for more details.
195: .SS "AUTHOR AREA"
196: .IP
197: This area is used simply to give credit where credit is due. :-)
198: .SH INPUT
199: .LP
200: A command completion interface is built into
201: the game. At any time, typing '?' will list possible input characters.
202: Typing a backspace (your erase character) backs up, erasing the last part
203: of the command. When a command is complete, a return enters it, and
204: any semantic checking is done at that time. If no errors are detected,
205: the command is sent to the appropriate plane. If an error is discovered
206: during the check, the offending statement will be underscored and a
207: (hopefully) descriptive message will be printed under it.
208: .LP
209: The command syntax is broken into two parts:
210: .I "Immediate Only"
211: and
212: .I Delayable
213: commands.
214: .I "Immediate Only"
215: commands happen on the next
216: update.
217: .I Delayable
218: commands also happen on the next update unless they
219: are followed by an optional predicate called the
220: .I Delay
221: command.
222: .LP
223: In the following tables, the syntax
224: .B [0\-9]
225: means any single digit, and
226: .B <dir>
227: refers to the keys around the 's' key, namely ``wedcxzaq''.
228: In absolute references, 'q' refers to North-West or 315 degrees, and 'w'
229: refers to North, or 0 degrees.
230: In relative references, 'q' refers to -45 degrees or 45 degrees left, and 'w'
231: refers to 0 degrees, or no change in direction.
232: .LP
233: All commands start with a plane letter. This indicates the recipient
234: of the command. Case is ignored.
235: .SS "IMMEDIATE ONLY COMMANDS"
236: .RS
237: .B "\- a Altitude:"
238: .RS
239: Affect a plane's altitude (and take off).
240: .RE
241: .RS
242: .B "\- [0\-9] Number:"
243: .RS
244: Go to the given altitude (thousands of feet).
245: .RE
246: .B "\- c/+ Climb:"
247: .RS
248: Relative altitude change.
249: .RE
250: .RS
251: .B "\- [0\-9] Number:"
252: .RS
253: Difference in thousands of feet.
254: .RE
255: .RE
256: .B "\- d/\- Descend:"
257: .RS
258: Relative altitude change.
259: .RE
260: .RS
261: .B "\- [0\-9] Number:"
262: .RS
263: Difference in thousands of feet.
264: .RE
265: .RE
266: .RE
267: .B "\- m Mark:"
268: .RS
269: Display in highlighted mode. Command is displayed normally.
270: .RE
271: .B "\- i Ignore:"
272: .RS
273: Do not display highlighted. Command is displayed as a
274: line of dashes if there is no command.
275: .RE
276: .B "\- u Unmark:"
277: .RS
278: Same as ignore, but if a delayed command is processed,
279: the plane will become marked. This is useful if you want
280: to forget about a plane during part, but not all, of its
281: journey.
282: .RE
283: .RE
284: .SS "DELAYABLE COMMANDS"
285: .RS
286: .B "\- c Circle:"
287: .RS
288: Have the plane circle (clockwise by default).
289: .RE
290: .RS
291: .B "\- l Left:"
292: .RS
293: Circle counterclockwise.
294: .RE
295: .B "\- r Right:"
296: .RS
297: Circle clockwise.
298: .RE
299: .RE
300: .B "\- t Turn:"
301: .RS
302: Change direction.
303: .RE
304: .RS
305: .B "\- l Left:"
306: .RS
307: Turn counterclockwise (45 degrees by default).
308: .RE
309: .RS
310: .B "\- <dir> Direction:"
311: .RS
312: Turn ccw the given number of degrees.
313: Zero degrees is no turn. A ccw turn
314: of -45 degrees is 45 cw.
315: .RE
316: .RE
317: .B "\- r Right:"
318: .RS
319: Turn clockwise (45 degrees by default).
320: .RE
321: .RS
322: .B "\- <dir> Direction:"
323: .RS
324: Same as turn left <dir>.
325: .RE
326: .RE
327: .B "\- L Left 90:"
328: .RS
329: Turn counterclockwise 90 degrees.
330: .RE
331: .B "\- R Right 90:"
332: .RS
333: Turn clockwise 90 degrees.
334: .RE
335: .B "\- <dir> Direction:"
336: .RS
337: Turn to the absolute compass heading given.
338: The shortest turn will be taken.
339: .RE
340: .B "\- t Towards:"
341: .RS
342: Turn towards a beacon, airport or exit. The turn is
343: just an estimate.
344: .RE
345: .RS
346: .B "\- b/* Beacon:"
347: .RS
348: Turn towards the beacon.
349: .RE
350: .RS
351: .B "\- [0-9] Number:"
352: .RS
353: The beacon number.
354: .RE
355: .RE
356: .B "\- e Exit:"
357: .RS
358: Turn towards the exit.
359: .RE
360: .RS
361: .B "\- [0-9] Number:"
362: .RS
363: The exit number.
364: .RE
365: .RE
366: .B "\- a Airport:"
367: .RS
368: Turn towards the airport.
369: .RE
370: .RS
371: .B "\- [0-9] Number:"
372: .RS
373: The airport number.
374: .RE
375: .RE
376: .RE
377: .RE
378: .RE
379: .SS THE DELAY COMMAND
380: .LP
381: The
382: .B Delay
383: (a/@)
384: command may be appended to any
385: .B Delayable
386: command. It allows the controller to instruct a plane to do an action
387: when the plane reaches a particular beacon (or other objects in future
388: versions).
389: .sp
390: .RS
391: .B "\- a/@ At:"
392: .RS
393: Do the given delayable command when the plane reaches the given beacon.
394: .RE
395: .RS
396: .B "\- b/* Beacon:"
397: .RS
398: This is redundant to allow for expansion.
399: .RE
400: .RS
401: .B "\- [0-9] Number:"
402: .RS
403: The beacon number.
404: .RE
405: .RE
406: .RE
407: .RE
408: .SS "MARKING, UNMARKING AND IGNORING"
409: .LP
410: Planes are
411: .B marked
412: when they enter the arena. This means they are displayed in highlighted
413: mode on the radar display. A plane may also be either
414: .B unmarked
415: or
416: .B ignored.
417: An
418: .B unmarked
419: plane is drawn in unhighlighted mode, and a line of dashes is displayed in
420: the command field of the information area. The plane will remain this
421: way until a mark command has been issued. Any other command will be issued,
422: but the command line will return to a line of dashes when the command
423: is completed.
424: .LP
425: An
426: .B ignored
427: plane is treated the same as an unmarked plane, except that it will
428: automatically switch to
429: .B marked
430: status when a delayed command has been processed. This is useful if
431: you want to forget about a plane for a while, but its flight path has
432: not yet been completely set.
433: .LP
434: As with all of the commands, marking, unmarking and ignoring will take effect
435: at the beginning of the next update. Do not be surprised if the plane does
436: not immediately switch to unhighlighted mode.
437: .SS EXAMPLES
438: .RS
439: .TP 16
440: atlab1
441: a: turn left at beacon #1
442: .TP 16
443: cc
444: C: circle
445: .TP 16
446: gtte4ab2
447: g: turn towards exit #4 at beacon #2
448: .TP 16
449: ma+2
450: m: altitude: climb 2000 feet
451: .TP 16
452: stq
453: S: turn to 315
454: .TP 16
455: xi
456: x: ignore
457: .RE
458: .SH "OTHER INFORMATION"
459: .LP
460: Jets move every update; prop planes move every other update.
461: .LP
462: All planes turn a most 90 degrees per movement.
463: .LP
464: Planes enter at 7000 feet and leave at 9000 feet.
465: .LP
466: Planes flying at an altitude of 0 crash if they are not over an airport.
467: .LP
468: Planes waiting at airports can only be told to take off (climb in altitude).
469: .SH "NEW GAMES"
470: .LP
471: The
472: .B Game_List
473: file lists the currently available play fields. New field description
474: file names must be placed in this file to be 'playable'. If a player
475: specifies a game not in this file, his score will not be logged.
476: .LP
477: The game field description files are broken into two parts. The first
478: part is the definition section. Here, the four tunable game parameters
479: must be set. These variables are set with the syntax:
480: .IP
481: variable = number;
482: .LP
483: Variable may be one of:
484: .B update,
485: indicating the number of seconds between forced updates;
486: .B newplane,
487: indicating (about) the number of updates between new plane entries;
488: .B width,
489: indicating the width of the play field; and
490: .B height,
491: indicating the height of the play field.
492: .LP
493: The second part of the field description files describes the locations
494: of the exits, the beacons, the airports and the lines.
495: The syntax is as follows:
496: .IP
497: beacon: (x y) ... ;
498: .br
499: airport: (x y direction) ... ;
500: .br
501: exit: (x y direction) ... ;
502: .br
503: line: [ (x1 y1) (x2 y2) ] ... ;
504: .LP
505: For beacons, a simple x, y coordinate pair is used (enclosed in parenthesis).
506: Airports and exits require a third value, a direction, which is one
507: of
508: .B wedcxzaq.
509: For airports, this is the direction that planes must be going to take
510: off and land, and for exits, this is the direction that planes will going
511: when they
512: .B enter
513: the arena. This may not seem intuitive, but as there is no restriction on
514: direction of exit, this is appropriate.
515: Lines are slightly different, since they need two coordinate pairs to
516: specify the line endpoints. These endpoints must be enclosed in
517: square brackets.
518: .LP
519: All statements are semi-colon (;) terminated. Multiple item statements
520: accumulate. Each definition must occur exactly once, before any
521: item statements. Comments begin with a hash (#) symbol
522: and terminate with a newline.
523: The coordinates are between zero and width-1 and height-1
524: inclusive. All of the exit coordinates must lie on the borders, and
525: all of the beacons and airports must lie inside of the borders.
526: Line endpoints may be anywhere within the field, so long as
527: the lines are horizontal, vertical or
528: .B "exactly diagonal."
529: .SS "FIELD FILE EXAMPLE"
530: .RS
531: .sp
532: .nf
533: .TA 1i 1i
534: .ta 1i 1i
535: # This is the default game.
536:
537: update = 5;
538: newplane = 5;
539: width = 30;
540: height = 21;
541:
542: exit: ( 12 0 x ) ( 29 0 z ) ( 29 7 a ) ( 29 17 a )
543: ( 9 20 e ) ( 0 13 d ) ( 0 7 d ) ( 0 0 c ) ;
544:
545: beacon: ( 12 7 ) ( 12 17 ) ;
546:
547: airport: ( 20 15 w ) ( 20 18 d ) ;
548:
549: line: [ ( 1 1 ) ( 6 6 ) ]
550: [ ( 12 1 ) ( 12 6 ) ]
551: [ ( 13 7 ) ( 28 7 ) ]
552: [ ( 28 1 ) ( 13 16 ) ]
553: [ ( 1 13 ) ( 11 13 ) ]
554: [ ( 12 8 ) ( 12 16 ) ]
555: [ ( 11 18 ) ( 10 19 ) ]
556: [ ( 13 17 ) ( 28 17 ) ]
557: [ ( 1 7 ) ( 11 7 ) ] ;
558: .fi
559: .RE
560: .SH FILES
561: .LP
562: Files are kept in a special directory. See the OPTIONS for a way to
563: print this path out.
564: .TP 16
565: .B ATC_score
566: Where the scores are kept.
567: .TP 16
568: .B Game_List
569: The list of playable games.
570: .SH AUTHOR
571: .LP
572: Ed James, UC Berkeley: [email protected], ucbvax!edjames
573: .LP
574: This game is based on someone's description of the overall flavor
575: of a game written for some unknown PC many years ago, maybe.
576: .SH BUGS
577: .LP
578: The screen sometimes refreshes after you have quit.
579: .LP
580: Yet Another Curses Bug was discovered during the development of this game.
581: If your curses library clrtobot.o is version 5.1 or earlier,
582: you will have erase problems with the backspace operator in the input
583: window.
584:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.