NAME

     tertris - Yet Another tetris Game on X


SYNOPSIS

     /usr/games/tertris [-s] [-l <start  level>]  [-p  <prefilled
     lines>]  [-n  <triangles in each polyiamond>] [-showNext] [-
     beep]   [-diagonal]   [-mixed]   [-ccw]   [-fixedFill]    [-
     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 "Tertris" 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  triangles  per
     polyiamond.  Again, you do not need to press the "SHIFT" key
     - "." and the ","  also  work.   If  available  for  current
     number of triangles, "g" toggles the diagonal mode, "m" tog-
     gles the mixed mode, and "r" toggles  the  grid.   Note:  to
     keep  the  level  of  play  similar,  the ability to reflect
     polyiamonds, and later the ability  to  rotate  polyiamonds,
     may get turned off when the number of triangles in a polyia-
     mond 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 tertris 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 "tertris" 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").

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

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

     -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>) (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 polyiamonds of less triangles  than  the
             maximum determined by -n (resource name "mixed").

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

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