bionic (6) xonix.6x.gz

Provided by: xonix_1.4-31_amd64 bug

NAME

       xonix - a game

SYNOPSIS

       xonix [ -toolkitoption ... ]

DESCRIPTION

       The xonix application consists of a playing area and a status display below.

       The  status  display  shows  the  current  values  for level, filled area (in percent), number of players
       (lifes), and elapsed time.

       The playing area has several regions.  The brown region (initially only the border) is ``filled region'',
       where  the  player  can  move, starting from the top left corner.  Beware of the bouncing yellow eater(s)
       that do also move across filled regions however, if they hit the player, a life will go away.  The flyers
       can only bounce across the green (so-called empty) area in the middle.

       The  purpose  of  the  game is to move the player across the empty region (whereby it leaves his way in a
       brown color to show where it came along), and finally cut off a piece of unfilled region  by  moving  him
       back  to  some  filled  region.  If the player itself or the (unfilled yet) way will be hit by a flyer, a
       life will be lost again.  Once the player's way reached another part of filled region, the  way  and  all
       adjacent  unfilled regions where there is no flyer in will be filled in turn.  One level has completed as
       soon as 75 % of the originally unfilled area have been filled this way.

       Every level, there will be one flyer more.  Every second level, an additional  player  will  be  granted.
       Every fifth level, an additional eater will be fired off.

       The  default  keys to move the player around are the arrow keys.  This can be changed in the app-defaults
       file, however, as well as the timeout between single steps (defaulting  to  50  ms  equal  20  moves  per
       second).

       The  default keys to immediately quit the game are `Q' and `Escape'.  Hitting `P' or iconizing the window
       with the window manager will pause the game; de-iconizing will continue it.

       There is also a high-score file, /var/cache/xonix/xonix.scores.  It records the top ten xonix players for
       that  machine.   As a special compile-time option, a mail is sent to the previous xonix score leader when
       he's lost his first rank.

WIDGETS

       Xonix uses the X Toolkit and the Athena  Widget  Set.   Below  is  the  widget  structure  of  the  xonix
       application.   Indentation  indicates  hierarchical  structure.   The  widget  class name is given first,
       followed by the widget instance name.

            Xonix  xonix
                 VendorShellExt  shellext
                 Form  container
                      MenuButton  game_button
                      Canvas  canvas
                      Form  status
                           Form  level
                                Label  lev_label
                                Label  lev_d10
                                Label  lev_d1
                           Form  percentage
                                Label  perc_label
                                Label  perc_d10
                                Label  perc_d1
                           Form  runner
                                Label  run_label
                                Label  run_d10
                                Label  run_d1
                           Form  time
                                Label  time_label
                                Label  mins_d10
                                Label  mins_d1
                                Label  time_colon
                                Label  secs_d10
                                Label  secs_d1
                      SimpleMenu  game_menu
                           SmeBSB  about
                           SmeLine  game_l1
                           SmeBSB  quit
                 TransientShell  about_shell
                      VendorShellExt  shellext
                      Box  about_box
                           Label  about_msg
                           Command  about_done
                 TransientShell  gameover_shell
                      VendorShellExt  shellext
                      Box  gameover_box
                           Label  gameover_msg
                           Box  gameover_buttonbox
                                Command  gameover_iknow
                                Command  gameover_goon

OPTIONS

       All the standard toolkit options apply.  It's not particularly useful to  attempt  forcing  any  geometry
       however.

AUTHORS

       The  original  xonix game has been seen somewhere on an old PC/XT clone.  This is a reimplementation from
       scratch, done by Torsten Schoenitz starting the project on a Macintosh.  The X11 support has been written
       by Joerg Wunsch with the pleasant help by Alfredo Herrera Hernandez.

BUGS

       Source  code  comments are still mostly in German.  Some files require the unusal tab width of 4 in order
       to be displayed correctly.

       It should be possible to pass some parameters from the command line as well (e.g. the time  step  value),
       which is currently only possible by the back-door via the -xrm toolkit option.

       Mail any suggestions to <joerg_wunsch@uriah.heep.sax.de>.

                                                                                                       XONIX(6x)