Content-type: text/html; charset=UTF-8 Man page of WELLTRIS

WELLTRIS

Section: Games and Demos (6)
Updated: 15 Aug 2024
Index Return to Main Contents

NAME

welltris - Welltris X widget

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}] [-[no]stippleFrame] [-[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 {filename}] [-scores] [-version]

DESCRIPTION

The ever popular falling tetromino game. Enhanced to allow all polyomino 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 polyominoes 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).

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 polyomino.

The key pad and arrow keys are defined similar.
Key pad is defined for Welltris as:

/ Reflect

  8     Rotate

  ^
4<5>6 Left, Rotate, Right

  v

  2     Drop

Press "C" or "c" keys to clear.

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 for 2-3 squares.

Press "M" or "m" to toggle mixed mode. This is ignored for 2 squares.

Press "B" or "b" to toggle bonus mode. This is ignored for 6 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 and it iconifies itself.

Press "Q", "q", or "CTRL-C" keys to kill program.

OPTIONS

-geometry {+|-}X{+|-}Y: This option sets the initial position of the welltris window (resource name "geometry").
-display host:dpy: This option specifies the X server to contact.
-[no]mono: This option allows you to display the welltris window on a color screen as if it were monochrome (resource name "mono").
-[no]{reverse|rv}: This option allows you to see the welltris window in reverse video (resource name "reverseVideo").
-{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").
-frame color: This option specifies the color of the frame (resource name "frameColor").
-[no]stippleFrame: This option allows you to toggle the frame stippling (resource name "stippleFrame").
-[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 for the elimination of rows (resource name "bumpSound").
-dripSound filename: This option specifies the file for the drip sound the freezing the freezing and dropping of walls (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 "suddenAppear").
-[no]diagonal: This option turns diagonal mode on for 2-3 squares (resource name "diagonal").
-[no]mixed: This option turns the mixed mode on (ignored for 2 squares since there is nothing to mix it with). This allows polyominoes of less squares than the maximum determined by -n (resource name "mixed").
-[no]bonus: This option turns the bonus pieces on (ignored for 6 squares since 7 squares could have holes). 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 specifies 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.

COPYRIGHTS

BUG REPORTS AND PROGRAM UPDATES

Send bugs (or their reports, or fixes) to the author:

: David A. Bagley, <bagleyd AT verizon.net>

The latest version is currently at:

: https://www.sillycycle.com/puzzles.html
http://www.ibiblio.org/pub/Linux/games/arcade/tetris/

This document was created by man2html, using the manual pages.
Time: 06:06:41 GMT, August 18, 2024