NAME

     tetris - Yet Another Tetris Game on X (altered)


SYNOPSIS

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


DESCRIPTION

     This is a game of "Tetris" 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 left, "l" moves right, "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,  and  "m"  toggles the mixed mode.  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 tetris 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 "tetris" 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  8
     or -n 2 -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").

     -p lines
             This option indicates that the program should  start
             with   some  of  the  lines  being  randomly  filled
             (resource name "preFilledLines").

     -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").

     -fixedFill
             Works only with the -p option  where  it  fixes  the
             number  of boxes to be filled to 4 random blocks per
             row. (resource name "fixedFill").

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

     -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  tetris
             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  tetris
             window (resource name "background").

     -{foreground | fg} color
             This option specifies the foreground of  the  tetris
             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),   welltris(6),   tertris(6),
     hextris(6)


COPYRIGHTS

     (Reg.)    Copyright    1993-2001,    David    A.     Bagley,
     <bagleyd@tux.org>.   (Reg.)  Copyright  1992-1995,  Q.  Alex
     Zhao, <azhao@cc.gatech.edu>.


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 by:
          Q. Alex Zhao,   <azhao@cc.gatech.edu>
          College of Computing
          Georgia Institute of Technology
          Atlanta, GA 30332-0280


ACKNOWLEDGEMENTS

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