SYNOPSIS

       /usr/games/welltris                                          [-geometry
       [{width}][x{height}][{+-}{xoff}[{+-}{yoff}]]]                 [-display
       [{host}]:[{vs}]]   [-[no]mono]   [-[no]{reverse|rv}]  [-{foreground|fg}
       {color}]  [-{background|bg}  {color}]  [-frame  {color}]  [-{border|bd}
       {color}]  [-[no]sound]  [-bumpSound {filename}] [-dripSound {filename}]
       [-level  {starting_level}]  [-units   {size_of_polyomino}]   [-diameter
       {diameter}]   [-fill   {rows}]   [-[no]fixedFill]   [-[no]suddenAppear]
       [-[no]diagonal]  [-[no]mixed]   [-[no]bonus]   [-[no]cw]   [-[no]plain]
       [-[no]showNext]  [-[no]grid]  [-userName  {string}]  [-scoreFile {file-
       name}] [-scores] [-version]


DESCRIPTION

       The ever popular falling tetromino game.  Enhanced to allow  all  poly-
       omino  classes  that  do  not have pieces with holes.  Mixing polyomino
       classes (so as to permit polyominoes  made  up  by  a  variable  number
       squares) can also be selected, as well as, the 2 sets of diagonal poly-
       ominoes that do not have pieces with holes.

       To make these games interesting and "do-able"  the  ability  to  rotate
       gets  turned off if it is easier than the 4 square polyomino.  An added
       ability "reflect" (right-left -> left-right) allows one to attempt  the
       5 square and 6 square polyomino pieces.

       To  get  high  scores,  do  not use "show next" mode, try starting at a
       higher level and try to let "welltris" eat more  than  one  line  at  a
       time.   Polyominoes  with  diagonal  or with a higher number of squares
       earn more points.  Mixed mode earns less points.  Play fast and see how
       well  you  can do in the bonus mode.  Bonuses are set when the level is
       changed automatically.  (Bonus mode not available for 6  squares  or  3
       squares and diagonal mode).

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


FEATURES

       Click  "mouse-left" button, or press "J", "j", "S", or "s" keys to move
       the falling polyomino left.

       Click "mouse-center" button, or press "K", "k", "D",  or  "d"  keys  to
       rotate  the  falling  polyomino.   Note  this  may be turned off if the
       depending on the "turn-style", but normally this is "on".

       Click "mouse-right" button, or press "L", "l", "F", or "f" keys to move
       the falling polyomino right.

       Click  "mouse-scroll-up",  or  press "I", "i", "E", or "e" keys to flip
       (reflect) the falling polyomino.  Note this may be turned  off  if  the
       depending on the "turn-style", but normally this is "off".

       Click  "mouse-scroll-down",  or  press  "space-bar" to drop the falling
       Press ">" or "." keys to speed up the falling polyomino.

       Press "<" or "," keys to slow down the falling polyomino.  This may  be
       turned off to avoid cheating.

       Press "+" or "=" keys to increase the squares in the falling polyomino.
       Note: To keep the level of play similar, the "turn style"  can  change.
       The ability to reflect polyominoes is available only when the number of
       squares >= 5.  The ability to rotate  polyominoes,  is  available  only
       when  the  number of squares is >= 4.  Bonus polyominoes still have the
       current "turn style".

       Press "-" or "_" keys to decrease the squares in the falling polyomino.

       Press "]" or "}" keys to increase the diameter/depth size.

       Press "[" or "{" keys to decrease the diameter/depth size.

       Press  "`",  "1",  "2",  "3", "4", "5", "6", "7", "8", "9", or "0" keys
       (not the keypad 0-9) to change the number of fill  lines.   "`"  for  0
       lines and "0" for 10 lines.

       Press "X" or "x" to toggle between fixed fill or random fill.

       Press "R" or "r" to toggle between sudden initial appearance or gradual
       initial appearance.

       Press "G" or "g" to toggle diagonal mode.  This may  not  be  available
       for current number of squares.

       Press  "M"  or "m" to toggle mixed mode.  This may not be available for
       current number of squares.

       Press "B" or "b" to toggle bonus mode.  This may not be  available  for
       current number of squares.

       Press "W" or "w" to toggle clockwise or counter clockwise turning.

       Press "P" or "p" to toggle plain pieces or three dimensional pieces.

       Press "N" or "n" to toggle show next.

       Press "#" key to toggle the grid.

       Press "|" key to pause.

       Press "@" key to toggle the sound.

       Press  "Esc"  key  to hide and pause program.  When the welltris window
       loses its focus, it also goes to  "paused"  mode  except  it  does  not
       iconify itself.

       -[no]{reverse|rv}
               This  option  allows  you to see the welltris window in reverse
               video (resource name "reverse").

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

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

       -{border|bd} color
               This option specifies the border color of  the  blocks  in  the
               welltris window (resource name "borderColor").

       -[no]sound
               This  option specifies if row completion should make a sound or
               not (resource name "sound").

       -bumpSound filename
               This option specifies the file for  the  bump  sound  (resource
               name "bumpSound").

       -dripSound filename
               This  option  specifies  the  file for the drip sound (resource
               name "dripSound").

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

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

       -diameter diameter
               This option starts the program with the specified  diameter  in
               squares (depth is 3 * diameter / 2) (resource name "diameter").

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

       -[no]fixedFill
               Works  only  with  the  -p  option where it fixes the number of
               boxes to be filled to diameter size / 2 - 1 random  blocks  per
               row. (resource name "fixedFill").

       -[no]suddenAppear
               Polyominoes will now suddenly appear within the window. Now one
               cannot rotate a piece above the window. (resource name  "sudde-
               since there are no size 7 pieces). This allows  polyominoes  of
               more  squares  than the minimum determined by -n (resource name
               "bonus").

       -[no]cw The rotate key will now rotate pieces cw (resource name  "cw").

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

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

       -[no]grid
               This  option  specifies  if a grid should appear (resource name
               "grid").

       -userName name
               This option speicfies the user name for  any  records  made  or
               else it will get your login name (resource name "userName").

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

       -scores This option lists all the recorded scores and then exits.

       -version
               This option tells you what version of welltris you have.


REFERENCES

       Based at one time on Q. Alex Zhao's Tetris.


SEE ALSO

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


COPYRIGHTS

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


BUG REPORTS AND PROGRAM UPDATES

       Send bugs (or their reports, or fixes) to the author:
              David Albert Bagley, <bagleyd@tux.org>

       The latest version is currently at:
              ftp://ftp.tux.org/pub/tux/bagleyd/altris
              ftp://ibiblio.org/pub/Linux/games/arcade/tetris



V7.2.1                            05 May 2006                      WELLTRIS(6)