home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma11.dms / ma11.adf / WBTris_1.54 / WBTRIS.doc < prev    next >
Encoding:
Text File  |  1993-04-25  |  10.2 KB  |  287 lines
  1.          WBTRIS V1.54 - Manual
  2.  
  3.  
  4. NAME
  5.  
  6.    WBTRIS
  7.  
  8. DESCRIPTION
  9.  
  10.    Little Tetris-Game with many Options.
  11.    Runs only under Release 2.0 or higher of Workbench.
  12.  
  13. SOURCE
  14.  
  15.    The source code is included, it can be compiled with
  16.    Dice V2.06.37 (registered version only) (or newer).
  17.  
  18. COPYRIGHT
  19.  
  20.    WBTRIS is 'Cardware'. So if you enjoy this game please send a postcard
  21.    or an E-Mail-message to one of us.
  22.    WBTRIS is free to be spread on public-domain and shareware disks, as
  23.    long as they are sold for a reasonable charge that is less than $6 or
  24.    DM 8,-. For use in commercial products the permission of the author is
  25.    required.
  26.    WBTRIS may be copied and distributed via electronic networks such
  27.    as the Internet, also it may be moved on anonymous ftp-servers,
  28.    mail-boxes or BBS's.
  29.  
  30. AUTHOR
  31.  
  32.    Ralf Pieper
  33.    Peter-Hille-Weg 4
  34.    D-3533 Willebadessen
  35.    Germany
  36.  
  37.    Dirk Böhmer
  38.    Friedr.-Wilh.-Weber-Str. 18
  39.    D-3533 Willebadessen
  40.    Germany
  41.  
  42.    INTERNET: medusa@uni-paderborn.de
  43.    IRC: Medusa
  44.  
  45.    Any comments are welcome.
  46.  
  47. VERSION
  48.  
  49.    1.54
  50.  
  51. STARTING
  52.  
  53.    From Shell :
  54.  
  55.       Just type 'WBTRIS'
  56.       But have also a look at the shellarguments!
  57.  
  58.    From Workbench :
  59.  
  60.       Double-click on its icon.
  61.       WBTRIS is now started.
  62.  
  63. SYSTEM REQUIREMENTS
  64.  
  65.    Runs under Workbench 2.04 and newer.
  66.    You need the font 'helvetica 13'!
  67.    You need the following libraries:
  68.       - mathieeedoubbas.library
  69.       - mathieeedoubtrans.library
  70.       - diskfont.library
  71.  
  72. USING AND PLAYING WBTRIS
  73.  
  74.    If you have specified an ENV-variable 'WBTRIS' with includes a path and filename
  75.    (for example: 'setenv WBTRIS "S:WBTRIS.scores"'), the hiscore-file will be
  76.    saved to this path/filename.
  77.  
  78.    In the left upper corner there is a field where you can see the next tile
  79.    while playing. Switch it on or off in the options window.
  80.  
  81.    Below that place you can find 4 displays to show the hiscore, score, level
  82.    and how many lines you have made.
  83.  
  84.    Below these displays are some Gadgets.
  85.       Pause/Go on:   When you click on this gadget the playfield will be erased
  86.                      and a little 'pause-picture' will be shown. The gadget text
  87.                      is now 'Go on'. Another click lets you return to your game
  88.                      and restores the playfield.
  89.  
  90.       Statistic:     You get a little window with a statistic about the number
  91.                      of the tiles fallen down. You can press this button only
  92.                      in pause-mode.
  93.  
  94.       Options:       See 'OPTIONS WINDOW'
  95.  
  96.       New game:      The playfield will be cleared, a little window pops up
  97.                      and shows the 10 best players. After closing this window
  98.                      a new game begins.
  99.  
  100.    To control the tilemovements you have 5 keyboardkeys, which are:
  101.       Return (default):        lets the tile fall down to ground
  102.  
  103.       Space (default):         lets the tile fall down quicker than normal
  104.  
  105.       Cursor right (default):  lets the tile move to the right
  106.  
  107.       Cursor left (default):   lets the tile move to the left
  108.  
  109.       Cursor up (default):     lets the tile rotate to the right
  110.  
  111.       Cursor down (default):   lets the tile rotate to the left
  112.  
  113.    To quit the game click the close-gadget or pres ESC.
  114.  
  115.    How to calculate the score:
  116.       Score = KilledLines^2 * 5              (Level = 0)
  117.       Score = KilledLines^2 * 10 * Level     (Level > 0)
  118.       Score = FallenPiece * Level
  119.  
  120. ARGUMENTS
  121.  
  122.    LEFT=LEFTEDGE/N/K:      left Edge of WBTRIS' window
  123.    TOP=TOPEDGE/N/K:        top Edge of WBTRIS' window
  124.    N=NAME/K:               Name of the player
  125.    NOLOCK=NOLOCKNAME/K/S:  if 'NOLOCKNAME' every new game the optionswindow
  126.                            will pop up to ask for another name. The 'NAME'
  127.                            argument is switched off.
  128.    NONEXT=SHOWNONEXT/K/S:  if 'SHOWNONEXT' the preview to the next object is off
  129.    NOLACE/K/S:             if 'NOLACE' you can play the noninterlace game
  130.    LEVEL/N/K:              number of the startlevel
  131.    PULLDOWNTICKS/N/K:      number of the speed to pull down the tiles
  132.    R=MOVERIGHT/K:          rawkey for the tilemovement to the right
  133.    L=MOVELEFT/K:           rawkey for the tilemovement to the left
  134.    RR=ROTATERIGHT/K:       rawkey for the tilerotating to the right
  135.    RL=ROTATELEFT/K:        rawkey for the tilerotating to the left
  136.    D=MOVEDOWN/K:           rawkey for the quicker tiledownmovement
  137.    DQ=MOVEDOWNQUICK/K:     rawkey to let the tiles fall down to ground
  138.    TF=TILEFILE/K:          you can specify the filename of your own-created TilesFile
  139.  
  140. TOOLTYPES
  141.  
  142.    WBTRIS supports Tool Type entries. Click the WBTRIS.info and press
  143.    Right-Amiga and i to change or add a Tool Type entry.
  144.  
  145.    In the Tool Type list there is entered:
  146.  
  147.       LEFTEDGE         # Windowoffset
  148.       TOPEDGE          # Windowoffset
  149.       NAME             # Your name
  150.       LOCKNAME         # If TRUE then the name is locked during the game (TRUE/FALSE)
  151.       SHOWNEXT         # The next tile will be shown (TRUE/FALSE)
  152.       LEVEL            # Startlevel (0-20)
  153.       PULLDOWNSPEED    # Speed to pulldown the tiles (0-20)
  154.       MOVERIGHT        # rawkey to move the tile to the right (default '0X4e')
  155.       MOVELEFT         # rawkey to move the tile to the left (default '0X4f')
  156.       ROTATERIGHT      # rawkey to rotate the tile to the right (default '0X4c')
  157.       ROTATELEFT       # rawkey to rotate the tile to the right (default '0X4d')
  158.       MOVEDOWN         # rawkey to move the tile down faster (default '0X40')
  159.       MOVEDOWNQUICK    # rawkey to let the tile fall down to ground (default '0X44')
  160.       USELACE          # If TRUE then the lace version will be started, if FALSE
  161.                          then the noninterlace version will be started
  162.       TILEFILE         # you can specify the filename of your own-created TilesFile
  163.  
  164. OPTIONS WINDOW
  165.  
  166.    You will see some Gadgets and  Sliders.
  167.  
  168.    The values inside the Gadgets are via default set to the
  169.    supplied Arguments in the Tool Types.
  170.  
  171.    STARTLEVEL:    The specified value for the Startlevel of the
  172.          game. The higher the faster is the game.
  173.          shows up. Value may between 0 and 20.
  174.  
  175.    PULLDOWNSPEED:    The value for the speed of the stones when Space
  176.          is pressed. The higher the faster are the sones. Value may
  177.          between 0 and 20.
  178.  
  179.    NAME:    Your Name.
  180.  
  181.    NAMEOPTIONS:     Enter value between ´lock name´ and ´ask name´.
  182.          Lock name is for the same name during the whole time of playing.
  183.          Ask name is for reenter the name after every game.
  184.  
  185.    SHOWNEXTOBJECT:     Show the next object to come. If inactive the
  186.          next Object is hidden.
  187.  
  188.    INFO:    Opens a Information-Window.
  189.  
  190.    OK:      Play the game.
  191.  
  192.             or just click the close button or press the ESC key to play the game.
  193.  
  194. TILEFILE-FORMAT:
  195.  
  196.    It's just a simple textfile. You can design your own Tiles (7 pieces).
  197.    '1' stands for the visible part of a tile.
  198.    '0' stands for the invisible part.
  199.    You can put comments into the TileFile but never use a '1' or a '0' as
  200.    a comment! Have a look at the file 'Tiles.dat'. It's quite simple.
  201.  
  202. CREDITS:
  203.  
  204.    Matt Dillon for Dice. So we could make WBTRIS be compilable in
  205.    the most common low-cost C-Compiler. (Only registered version)
  206.    Ah, yes. Greetings to Stefan Becker! :-)
  207.  
  208.    Fred Fish, Mr. Public Domain, hope you like this enough to place
  209.    it onto one of your new 'Fishes'. Permission herebye given.
  210.  
  211.    Commodore Amiga group for this great system. Hope to see some
  212.    great new stuff this year !
  213.  
  214.    Special thanks to Markus Stipp (corwin), Matthias Scheler (tron),
  215.    Michael Janich (massa), Aurel Balmosan (aurel), Frank Paetschke
  216.    and Guido Wulf for their great help and new ideas.
  217.  
  218.    Thanks for all emails.
  219.  
  220.    Our first postcard (remember the game is CARDWARE) was written by
  221.    Edith Parzefall ! Thanx Edith.
  222.  
  223. HISTORY
  224.  
  225.    Version 1.0:
  226.       - Our first release
  227.  
  228.    Version 1.1 (internal release):
  229.       - Supports the ENV-variable 'WBTRIS'. There you can specify the name
  230.         (including its path) of the hiscore-file. If this variable doesn't
  231.         exist, the current directory will be taken
  232.       - Better written document (sorry for the first one!)
  233.       - you can define your own keys to move the tiles (rawkey-codes)
  234.       - options-window with a correct size
  235.  
  236.    Version 1.2:
  237.       - error-messages with EasyRequest()
  238.       - error-message if screen is too small
  239.       - statistic function implemented
  240.       - fixed a bug in rotate-function
  241.       - bug fix: startlevelspeed of the first tile was wrong
  242.  
  243.    Version 1.3:
  244.       - supports interlace/noninterlace screens, you can switch it with the tooltype 'USELACE'
  245.       - now WBTRIS uses the timer.device to control the gamespeed
  246.       - another keyboard key to let a tile fall down to ground
  247.       - supports arguments when starting from shell
  248.       - bug fix: on screens with more than 8 colors the WBTRIS logo now has the correct outfit
  249.  
  250.    Version 1.4:
  251.       - new scoring (more points in higher levels)
  252.       - name is asked if there is no name given
  253.       - additionally the level is saved in the hiscoretable
  254.       - WBTRIS opens the nolace version on nolace screens automatically
  255.       - WBTRIS uses helvetica/13 in the hiscore and statistic window (only lace version)
  256.       - you can press any key to close the statistic or hiscore window
  257.  
  258.    Version 1.5:
  259.       - bug fix: last digit of score in the hiscore table (only noninterlace version)
  260.         was cutted
  261.       - bug fix: sometimes a stone felt down or the pause symbol was shown when entering
  262.         new game
  263.       - bug fix: in pause mode you couldn't view the hiscore table
  264.       - toolmanager doc-icon was added to the archive
  265.       - you can leave every window with ESC (included the game)
  266.  
  267.    Version 1.51:
  268.       - big bug fix: WBTRIS cleared a message port that didn't exist. Sorry!  :-)
  269.       - changed the vertical font space in hiscore-window
  270.  
  271.    Version 1.52:
  272.       - bug fix: program crashed when pressing a key on the numericpad
  273.       - WBTRIS opens the lace version on screens >= 400 pixels
  274.       - WBTRIS looks for the size of the title bar font
  275.       - security request if you want to leave WBTRIS with 'ESC'
  276.  
  277.    Version 1.53:
  278.       - no more crashes if you open the statistic window on an A4000
  279.         Never use floats with the DICE compiler!  :-)
  280.  
  281.    Version 1.54:
  282.       - now you can design your own tiles
  283.  
  284. FINAL
  285.  
  286.    We wish you a lot of fun with the game !!!
  287.