WBTRIS V1.52 - Manual NAME WBTRIS DESCRIPTION Little Tetris-Game with many Options. Runs only under Release 2.0 or higher of Workbench. SOURCE The source code is included, it can be compiled with Dice V2.06.37 (registered version only) (or newer). COPYRIGHT WBTRIS is 'Cardware'. So if you enjoy this game please send a postcard or an E-Mail-message to one of us. WBTRIS is free to be spread on public-domain and shareware disks, as long as they are sold for a reasonable charge that is less than $6 or DM 8,-. For use in commercial products the permission of the author is required. WBTRIS may be copied and distributed via electronic networks such as the Internet, also it may be moved on anonymous ftp-servers, mail-boxes or BBS's. AUTHOR Ralf Pieper Peter-Hille-Weg 4 D-3533 Willebadessen Germany Dirk Böhmer Friedr.-Wilh.-Weber-Str. 18 D-3533 Willebadessen Germany INTERNET: medusa@uni-paderborn.de IRC: Medusa Any comments are welcome. VERSION 1.52 STARTING From Shell : Just type 'WBTRIS' But have also a look at the shellarguments! From Workbench : Double-click on its icon. WBTRIS is now started. SYSTEM REQUIREMENTS Runs under Workbench 2.04 and newer. You need the font 'helvetica 13'! You need the following libraries: - mathieeedoubbas.library - mathieeedoubtrans.library - diskfont.library USING AND PLAYING WBTRIS If you have specified an ENV-variable 'WBTRIS' with includes a path and filename (for example: 'setenv WBTRIS "S:WBTRIS.scores"'), the hiscore-file will be saved to this path/filename. In the left upper corner there is a field where you can see the next tile while playing. Switch it on or off in the options window. Below that place you can find 4 displays to show the hiscore, score, level and how many lines you have made. Below these displays are some Gadgets. Pause/Go on: When you click on this gadget the playfield will be erased and a little 'pause-picture' will be shown. The gadget text is now 'Go on'. Another click lets you return to your game and restores the playfield. Statistic: You get a little window with a statistic about the number of the tiles fallen down. You can press this button only in pause-mode. Options: See 'OPTIONS WINDOW' New game: The playfield will be cleared, a little window pops up and shows the 10 best players. After closing this window a new game begins. To control the tilemovements you have 5 keyboardkeys, which are: Return (default): lets the tile fall down to ground Space (default): lets the tile fall down quicker than normal Cursor right (default): lets the tile move to the right Cursor left (default): lets the tile move to the left Cursor up (default): lets the tile rotate to the right Cursor down (default): lets the tile rotate to the left To quit the game click the close-gadget or pres ESC. How to calculate the score: Score = KilledLines^2 * 5 (Level = 0) Score = KilledLines^2 * 10 * Level (Level > 0) Score = FallenPiece * Level ARGUMENTS LEFT=LEFTEDGE/N/K: left Edge of WBTRIS' window TOP=TOPEDGE/N/K: top Edge of WBTRIS' window N=NAME/K: Name of the player NOLOCK=NOLOCKNAME/K/S: if 'NOLOCKNAME' every new game the optionswindow will pop up to ask for another name. The 'NAME' argument is switched off. NONEXT=SHOWNONEXT/K/S: if 'SHOWNONEXT' the preview to the next object is off NOLACE/K/S: if 'NOLACE' you can play the noninterlace game LEVEL/N/K: number of the startlevel PULLDOWNTICKS/N/K: number of the speed to pull down the tiles R=MOVERIGHT/K: rawkey for the tilemovement to the right L=MOVELEFT/K: rawkey for the tilemovement to the left RR=ROTATERIGHT/K: rawkey for the tilerotating to the right RL=ROTATELEFT/K: rawkey for the tilerotating to the left D=MOVEDOWN/K: rawkey for the quicker tiledownmovement DQ=MOVEDOWNQUICK/K: rawkey to let the tiles fall down to ground TOOLTYPES WBTRIS supports Tool Type entries. Click the WBTRIS.info and press Right-Amiga and i to change or add a Tool Type entry. In the Tool Type list there is entered: LEFTEDGE # Windowoffset TOPEDGE # Windowoffset NAME # Your name LOCKNAME # If TRUE then the name is locked during the game (TRUE/FALSE) SHOWNEXT # The next tile will be shown (TRUE/FALSE) LEVEL # Startlevel (0-20) PULLDOWNSPEED # Speed to pulldown the tiles (0-20) MOVERIGHT # rawkey to move the tile to the right (default '0X4e') MOVELEFT # rawkey to move the tile to the left (default '0X4f') ROTATERIGHT # rawkey to rotate the tile to the right (default '0X4c') ROTATELEFT # rawkey to rotate the tile to the right (default '0X4d') MOVEDOWN # rawkey to move the tile down faster (default '0X40') MOVEDOWNQUICK # rawkey to let the tile fall down to ground (default '0X44') USELACE # If TRUE then the lace version will be started, if FALSE then the noninterlace version will be started OPTIONS WINDOW You will see some Gadgets and Sliders. The values inside the Gadgets are via default set to the supplied Arguments in the Tool Types. STARTLEVEL: The specified value for the Startlevel of the game. The higher the faster is the game. shows up. Value may between 0 and 20. PULLDOWNSPEED: The value for the speed of the stones when Space is pressed. The higher the faster are the sones. Value may between 0 and 20. NAME: Your Name. NAMEOPTIONS: Enter value between ´lock name´ and ´ask name´. Lock name is for the same name during the whole time of playing. Ask name is for reenter the name after every game. SHOWNEXTOBJECT: Show the next object to come. If inactive the next Object is hidden. INFO: Opens a Information-Window. OK: Play the game. or just click the close button or press the ESC key to play the game. CREDITS: Matt Dillon for Dice. So we could make WBTRIS be compilable in the most common low-cost C-Compiler. (Only registered version) Ah, yes. Greetings to Stefan Becker! :-) Fred Fish, Mr. Public Domain, hope you like this enough to place it onto one of your new 'Fishes'. Permission herebye given. Commodore Amiga group for this great system. Hope to see some great new stuff this year ! Special thanks to Markus Stipp (corwin), Matthias Scheler (tron), Michael Janich (massa), Aurel Balmosan (aurel), Frank Paetschke and Guido Wulf for their great help and new ideas. Thanks for all emails. Our first postcard (remember the game is CARDWARE) was written by Edith Parzefall ! Thanx Edith. HISTORY Version 1.0: - Our first release Version 1.1 (internal release): - Supports the ENV-variable 'WBTRIS'. There you can specify the name (including its path) of the hiscore-file. If this variable doesn't exist, the current directory will be taken - Better written document (sorry for the first one!) - you can define your own keys to move the tiles (rawkey-codes) - options-window with a correct size Version 1.2: - error-messages with EasyRequest() - error-message if screen is too small - statistic function implemented - fixed a bug in rotate-function - bug fix: startlevelspeed of the first tile was wrong Version 1.3: - supports interlace/noninterlace screens, you can switch it with the tooltype 'USELACE' - now WBTRIS uses the timer.device to control the gamespeed - another keyboard key to let a tile fall down to ground - supports arguments when starting from shell - bug fix: on screens with more than 8 colors the WBTRIS logo now has the correct outfit Version 1.4: - new scoring (more points in higher levels) - name is asked if there is no name given - additionally the level is saved in the hiscoretable - WBTRIS opens the nolace version on nolace screens automatically - WBTRIS uses helvetica/13 in the hiscore and statistic window (only lace version) - you can press any key to close the statistic or hiscore window Version 1.5: - bug fix: last digit of score in the hiscore table (only noninterlace version) was cutted - bug fix: sometimes a stone felt down or the pause symbol was shown when entering new game - bug fix: in pause mode you couldn't view the hiscore table - toolmanager doc-icon was added to the archive - you can leave every window with ESC (included the game) Version 1.51: - big bug fix: WBTRIS cleared a message port that didn't exist. Sorry! :-) - changed the vertical font space in hiscore-window Version 1.52: - bug fix: program crashed when pressing a key on the numericpad - WBTRIS opens the lace version on screens >= 400 pixels - WBTRIS looks for the size of the title bar font - security request if you want to leave WBTRIS with 'ESC' FINAL We wish you a lot of fun with the game !!!