NAME

     welltris - Yet Another tetris Game on X


SYNOPSIS

     /usr/games/welltris [-s] [-l <start level>] [-n <squares  in
     each  polyomino>]  [-showNext]  [-beep] [-diagonal] [-mixed]
     [-plain]  [-ccw]   [-suddenAppear]   [-noGrid]   [-scorefile
     <filename>]  [-u  <name>]  [-display  <display>]  [-geometry
     <geometry>] [-iconGeometry <geometry>] [-{background  |  bg}
     <color>]  [-{foreground  | fg} <color>] [-bigFont <font>] [-
     tinyFont <font>] [-xrm <resource specification>]


DESCRIPTION

     This is a game of "Welltris" for the X Window System.

     The program lists the top 15 players at the end, each player
     may  has  at most three scores. With the option -s, it shows
     all the players and scores.

     Key "j" moves the block counter-clockwise, "l" moves  clock-
     wise, "k" rotates, "i" reflects. Left-handed people may want
     to use "s", "f", "d", "e" respectively.   Or  maybe  someone
     wants  to try the arrow keys...  The space bar drops a block
     quickly. Use "CTRL-L" key combination to redraw  -  in  case
     the program messes something up.

     As usual, "+" speeds up the game. To avoid cheating  "-"  is
     disabled  from slowing down the game.  Note: that you do not
     need to press the "SHIFT" key - "=" also works. The "b"  key
     toggles  "beep",  and  "n"  toggles  "show  next".  The  ">"
     increase and the "<" decrease  the  number  of  squares  per
     polyomino.   Again, you do not need to press the "SHIFT" key
     - "." and the "," also work.  (Since it would lead to cheat-
     ing, the number of squares can not be decreased from 3).  If
     available for current number of  squares,  "g"  toggles  the
     diagonal  mode,  "m" toggles the mixed mode, and "r" toggles
     the grid.  Note: to keep the  level  of  play  similar,  the
     ability  to  reflect  polyominoes,  and later the ability to
     rotate polyominoes, may get turned off when  the  number  of
     squares in a polyomino is decreased.

     If you press "p", the game will be paused,  and  the  window
     will  be iconified - just in case your boss suddenly appears
     at your door ;o). When the welltris window loses its  focus,
     it  also  goes  to  "paused"  mode except it doesn't iconify
     itself.

     To get high scores, don't use "show next" mode, try starting
     at  a  higher  level and try to let "welltris" eat more than
     one line at a time.  Play fast and see how well you  can  do
     in  the  bonus  mode.  Bonus mode also set when the level is
     changed automatically.  (Bonus mode not available for  -n  6
     or -n 3 -diagonal).


OPTIONS

     -s      This option lets  the  program  only  list  all  the
             recorded scores then exit.

     -l level
             This option starts  the  program  at  the  specified
             level (resource name "startLevel").

     -n squares
             This option starts the program  with  the  specified
             number  of  squares in each polyomino (resource name
             "squares").

     -showNext
             This option tells the program start in  "show  next"
             mode (resource name "showNext").

     -beep   This  option  turns  the  sound  on  (resource  name
             "beep").

     -diagonal
             This option turns diagonal mode on  (only  available
             on -n <2-3>) (resource name "diagonal").

     -mixed  This option turns the mixed mode on  (not  available
             for  -n  2  since  there is nothing to mix it with).
             This allows polyominoes of  less  squares  than  the
             maximum determined by -n (resource name "mixed").

     -plain  Uses the old "plain" bitmaps instead of the  default
             3D ones (resource name "plain").

     -ccw    The rotate key will now rotate pieces ccw  (resource
             name "ccw").

     -suddenAppear
             Polyominoes will now suddenly appear within the win-
             dow. Now one cannot rotate a piece above the window.
             (resource name "suddenAppear").

     -noGrid No grid if you want (resource name "noGrid").

     -scorefile filename
             Specify an alternative  score  file  (resource  name
             "scoreFile").

     -u name This option sets alternative player name.

     -display host:dpy
             This option specifies the X server to contact.

     -geometry {+|-}X{+|-}Y
             This  option  sets  the  initial  position  of   the
             welltris window (resource name "geometry").

     -iconGeometry {+|-}X{+|-}Y
             This option sets the position of the icon  (resource
             name "iconGeometry").

     -{background | bg} color
             This option specifies the background of the welltris
             window (resource name "background").

     -{foreground | fg} color
             This option specifies the foreground of the welltris
             window (resource name "foreground").

     -bigFont font
             This option sets the font used in drawing titles and
             important messages (resource name "bigFont").

     -tinyFont font
             This option sets the font  used  in  drawing  status
             information (resource name "tinyFont").

     -xrm <resource specification>
             Another method of specifying preferences.


SEE ALSO

     X(1),   xtetris(6),   xmris(6),    tetris(6),    tertris(6),
     hextris(6)


COPYRIGHTS

     (Reg.)    Copyright    1993-2001,    David    A.     Bagley,
     <bagleyd@tux.org>.


BUG REPORTS AND PROGRAM UPDATES

     Problems with this version, send bug reports (or fixes):
          David Albert Bagley,     <bagleyd@tux.org>

     The latest version is currently at:
          ftp://ftp.tux.org/pub/tux/bagleyd/altris
          ftp://ftp.x.org/contrib/games/altris

     The basis for this program is tetris by:
          Q. Alex Zhao,   <azhao@cc.gatech.edu>


ACKNOWLEDGEMENTS

     Thanks go to people who helped me in improving the program.