home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume5 / tron / part01 / read_me.txt < prev    next >
Encoding:
Text File  |  1989-11-21  |  4.1 KB  |  110 lines
  1.  
  2.      ++++++++++++
  3.      +++ TRON +++      - an XWindows game
  4.      ++++++++++++        (colored or black&white)
  5.  
  6. by Helmut Hoenig (MAY-1988)
  7.  
  8.  
  9.      This is an X-version of the well  known  light-race  of
  10. the  TRON-film.  I  actually wrote that program to get a bit
  11. more familiar with X and with communication between programs
  12. through  sockets. (That should be an excuse for writing pro-
  13. grams with such a bad structure.) But at least it  runs  and
  14. besides  the  programming-experience I got, we already had a
  15. lot of fun with it.
  16.  
  17.      After we tested the program for more  than  a  year,  I
  18. finally  decided  to  post  it.  To play that game you need:
  19. UNIX, XWindows X11R3, a C-compiler, a lot of include-files.
  20.  
  21.      The makefile will help you to  compile  the  4  source-
  22. files  into the 2 binary-files "tron_server" and "tron_run".
  23. These files have to be available in the  same  directory  on
  24. every   host,   where  the  program  should  be  used  (e.g.
  25. /usr/games), since the programs are getting  started  via  a
  26. remote  shell  using a system()-call.  (see "tron_server.c",
  27. line 284ff)
  28.  
  29.  
  30. +++ HOW IT WORKS +++ (you might skip this if it works)
  31.  
  32.      The "tron_server"-program is used to start  the  system
  33. up.   I also call it the master.  In the startup-sequence, a
  34. "tron_run"-program is started for each  player  (usually  on
  35. different  hosts).  Each program connects itself to the mas-
  36. ter. Through that stream-connection, the master is  able  to
  37. send  commands  to  the  players  (e.g.  start game) and the
  38. players can answer with the number  of  rounds  they  played
  39. until they were busted.
  40.  
  41.      After   the   startup-sequence,   we   have   a   star-
  42. configuration  of  the  players  and the master. Each player
  43. sends the port-number of an  additional  datagram-socket  to
  44. the  master, which is used during the game. The master opens
  45. a window to select the players and start the game. When  the
  46. game  gets  started, every player-program receives the port-
  47. number and host of the next player. In that way a  datagram-
  48. paket, produced by the first player, can be send around in a
  49. ring.
  50.  
  51.      No effort (except a timeout, which ends the  game)  has
  52. been  made to recover from missing datagrams, since it seems
  53. that they don't get lost on our system. They just come a bit
  54. late sometimes and then there's no sense in playing anyway.
  55.  
  56.  
  57. +++ WHAT TO KNOW +++
  58.  
  59.      The game is made for up to 8 players. At least  one  of
  60. them has to be human.
  61.  
  62.      The players control their racers by mouse or  keyboard.
  63. The keys to use are available from the program.
  64.  
  65.      Even if you play with the keyboard, you've got to place
  66. your  racer with the mouse (and middle button) in the field.
  67. It starts running in the direction of  your  mouse.  If  you
  68. wait  a  few  seconds,  the  racers are automatically placed
  69. under your mouse and the game starts.
  70.  
  71.      For each player you can  enter  the  display-  and  the
  72. host-name  (separated by a '^', e.g. 'display:0.0^host'). If
  73. there is no display-name given  the  host  is  used  for  an
  74. auto-player only (e.g. '^host').  As you usually play on the
  75. host of the display, a single name is enough to select  host
  76. and   display.    (So  the  usual  command-line  looks  like
  77. 'tron_server host1 host2 ^auto_player1 ...)  You  might  get
  78. problems  in the starting up sequence, if there are too many
  79. auto-players on the same host.
  80.  
  81.  
  82. +++ PROBLEMS +++
  83.  
  84.      On our  system,  we  sometimes  have  problems  in  the
  85. startup-sequence  as  there  seem  to  be  a  lot  processes
  86. envolved when starting the remote-shells.  It  happen,  that
  87. the  startup  fails,  when there are too many players (auto-
  88. players) on the same host.  To avoid that it is possible  to
  89. let  the  server  sleep some seconds between the starting of
  90. players by the option '-s<seconds>'.
  91.  
  92.      When controlling with the mouse, you might get problems
  93. with  your  window-manager,  if  it  grabs  combinations  of
  94. shift/control and mouse-buttons. Play with keyboards or kill
  95. the window-manager in that case.
  96.  
  97.  
  98. +++ HAVE FUN +++
  99.  
  100.     Helmut Hoenig
  101.  
  102. PS.:
  103.  
  104. TRON runs on our system with suns and MicroVaxes. It is
  105. tested on 3 kinds of monochrom-displays and a colored one.
  106.  
  107. Please let me know if TRON runs on your system !
  108. My address:
  109.     hoenig@informatik.uni-kl.de
  110.