home *** CD-ROM | disk | FTP | other *** search
/ Game Killer / Game_Killer.bin / 329.MANUAL.DOC < prev    next >
Text File  |  1992-12-17  |  44KB  |  1,177 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                SUPER-RETRISS Version 3.00
  7.                   Unregistered Release
  8.                           Not Another TETRIS<tm> Clone
  9.                   Manual of Operations
  10.  
  11.  
  12.  
  13.                 COPYRIGHT (C) 1992 by
  14.                    Rogelio  Bernal
  15.                  All Rights Reserved
  16.  
  17.  
  18.  
  19.                    Rogelio Bernal
  20.                 62 Boylston St. #920
  21.                   Boston, MA.02116
  22.  
  23.  
  24.  
  25.  
  26.             Originally written using Turbo C++ V1.0
  27.  
  28.           Versions 2.01 and up written using Borland C++ 3.0
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  ─────────────────────────────────────────────────────────────────────────────
  62.      ─────────────────────────────────────────────────────────────────────
  63.      ─────────────────────────────────────────────────────────────
  64.  
  65.  
  66.  
  67.                  C O N T E N T S
  68.  
  69.                                                                   Page
  70.                                                                   ════
  71.          0.- Disclaimer, license and other stuff . . . . . . .  2
  72.          0.1  Disclaimer of warranty . . . . . . . . . . .  2
  73.          0.2  License  . . . . . . . . . . . . . . . . . .  2
  74.          0.3  Registration . . . . . . . . . . . . . . . .  3
  75.                         Basic Registration                          3
  76.                         Special Registration 1                      3
  77.                         Special Registration 2                      3
  78.                         How to register                             4
  79.                         Shareware distributors                      4
  80.  
  81.          1.- Introduction  . . . . . . . . . . . . . . . . . .  5
  82.          1.1 Yet Another Tetris Clone? . . . . . . . . . .  5
  83.          1.2 What do you need to run Super Retriss?  . . .  5
  84.          1.3 What's new on this version? . . . . . . . . .  6
  85.  
  86.          2.- Getting started . . . . . . . . . . . . . . . . .  7
  87.          2.1 Quick start . . . . . . . . . . . . . . . . .  7
  88.          2.2 Configuration   . . . . . . . . . . . . . . .  7
  89.  
  90.          3.- Basic rules of the game . . . . . . . . . . . . .  8
  91.          3.1 What to do  . . . . . . . . . . . . . . . . .  8
  92.          3.2 Details and Score . . . . . . . . . . . . . .  8
  93.             Speed                                       8
  94.             Zones                                       8
  95.             Blocks                                      8
  96.             Score/Bonus                                 8
  97.  
  98.          4.- Main Menu . . . . . . . . . . . . . . . . . . . .  9
  99.          4.1 Play  . . . . . . . . . . . . . . . . . . . .  9
  100.          4.2 High Scores . . . . . . . . . . . . . . . . . 10
  101.          4.3 Graph-Match . . . . . . . . . . . . . . . . . 10
  102.          4.4 Load Zones  . . . . . . . . . . . . . . . . . 11
  103.             Using a mouse                              11
  104.             Using the keyboard                         11
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.     SuperRetriss v3.00                                   Contents  Page 0
  112.  
  113.  
  114.  
  115.  
  116.                                                                   Page
  117.                                                                   ════
  118.          4.5 Zone Designer . . . . . . . . . . . . . . . . 12
  119.              4.5.1  Entering the Designer  . . . . . . . . 12
  120.              4.5.2  How to design  . . . . . . . . . . . . 12
  121.                    Identifying the areas               12
  122.                   Block Area                       13
  123.                   Reference & Selection Areas      13
  124.                   Editing Area                     14
  125.                   Menu Area                        14
  126.                     Copy/Delete/Grid               14
  127.                     New/Clear                      15
  128.              4.5.3  Save Zones to Disk . . . . . . . . . . 15
  129.          4.6 Redefine Keys . . . . . . . . . . . . . . . . 16
  130.          4.7 Exit  . . . . . . . . . . . . . . . . . . . . 16
  131.  
  132.          5.- SoundBlaster support  . . . . . . . . . . . . . . 16
  133.  
  134.          6.- Command line options  . . . . . . . . . . . . . . 17
  135.          6.1 The -p switch                                 18
  136.  
  137.          7.- The future  . . . . . . . . . . . . . . . . . . . 18
  138.  
  139.          8.- Last Comments . . . . . . . . . . . . . . . . . . 19
  140.  
  141.              9.- Acknowledgments  . . . . . . . . . . . . . . . .  19
  142.  
  143.  
  144.                  ─────────────────────────────────
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.     SuperRetriss v3.0                     Contents  Page 1
  168.  
  169.  
  170.  
  171.  
  172.         ╔══════════════════════════════════════════╗
  173.         ║ 0 - DISCLAIMER, LICENSE AND REGISTRATION ║
  174.         ╚══════════════════════════════════════════╝
  175.  
  176.   0.1 - DISCLAIMER OF WARRANTY
  177.   ════════════════════════════
  178.  
  179.   THIS SOFTWARE AND MANUAL ARE DISTRIBUTED "AS IS" AND WITHOUT WARRANTIES AS
  180.   TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED
  181.   OR IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS
  182.   INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR
  183.   PURPOSE IS OFFERED.
  184.  
  185.   EVEN THIS PROGRAM HAS BEEN THOROUGHLY TESTED UNDER NON-CRITICAL
  186.   CIRCUMSTANCES, THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM
  187.   AND THE AUTHOR ASSUMES NO LIABILITY OF ANY KIND.
  188.  
  189.  
  190.   0.2 - LICENSE
  191.   ═════════════
  192.  
  193.   THIS IS NOT FREE SOFTWARE!! This program is distributed under the
  194.   shareware concept. This means that you must register this software if you
  195.   want to keep using it, after a short time for evaluation. If you think the
  196.   program fits your needs or you just would like to keep it and use it, then
  197.   you MUST register it.
  198.  
  199.       NEVER CHARGE PEOPLE A FEE FOR GIVING THEM A COPY OF SUPER-RETRISS !!
  200.        (PD/Shareware distributors read last section)
  201.  
  202.   You, as a user, may freely copy and pass this program to others, as far
  203.   as you include all the files that come in the original package.
  204.   You cannot add ANY extra files, nor destroy, change or modify any of the
  205.   original files included in this package in any way.
  206.  
  207.   If you have seen previous versions of this game, you may notice that
  208.   many features previously only available in registered releases have been
  209.   included now in the shareware release. I've done this because I believe
  210.   in the shareware concept, and I want you to go as far as you can before
  211.   you register the program. Now you can use the editor and play using your
  212.   designs. Only three options were disabled in the shareware release:
  213.  
  214.     You cannot save your designs on diskette
  215.     You can only start playing from zone 1 to zone 10.
  216.         You cannot play Graph Match
  217.  
  218.   These limitations were not implemented to bother you before you register
  219.   the program, but to keep some features to the users who really deserve
  220.   them.
  221.  
  222.  
  223.     SuperRetriss v3.00                      Disclaimer,License...  Page 2
  224.  
  225.  
  226.  
  227.  
  228.   SUPER-RETRISS is copyrighted software, and all rights are reserved.
  229.  
  230.  
  231.   0.3 REGISTRATION
  232.   ════════════════
  233.  
  234.   Now you can register Super Retriss in the way is more convenient for you.
  235.   A basic registration and two special registration procedures are
  236.   available.
  237.  
  238.  
  239.   Basic Registration
  240.   ──────────────────
  241.   The basic registration fee is 10 (ten) US dollars. This entitles you to
  242.   legally use Super Retriss 3.0, as well as to receive a personal
  243.   registration code. You will receive easy-to-follow instructions on how to
  244.   setup your copy of Super Retriss 3.0 so you can register your shareware
  245.   copy (you will be able to save your own set of zones, start from any zone
  246.   and play Graph-Match).
  247.  
  248.   Also, your registration will let me know that you are interested in
  249.   Super Retriss. The more the registered users, the more work I put on the
  250.   program. Almost two years since Super Retriss was born, the program would
  251.   not be what you see now without the support of all the people who have
  252.   registered the program.
  253.  
  254.  
  255.   Special Registration 1
  256.   ──────────────────────
  257.   Special registration is $20 (U.S.). I will mail you a diskette containing
  258.   the latest registered version of Super Retriss, as well as various ZNE
  259.   files that will fit on the diskette.
  260.  
  261.  
  262.   Special Registration 2
  263.   ──────────────────────
  264.   Special registration is $15 (U.S.). It is basically like the Special
  265.   Registration 1 but you put the diskette. In other words, you send me a
  266.   formatted diskette (720k or bigger) along with the registration form and
  267.   payment, and I will mail it back to you with your customized registered
  268.   copy of the latest Super Retriss version, (and the ZNE files).
  269.  
  270.   If I have the time, I will also customize the program so it will display
  271.   your name (or whatever you want) where you see now in the game the moving
  272.   "Unregistered Release" title.   This also applies to the Special
  273.   Registration 1.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.     SuperRetriss v3.00                               Registration  Page 3
  280.  
  281.  
  282.  
  283.  
  284.   How to register
  285.   ───────────────
  286.  
  287.   To register, print out the file FORM.TXT (type PRINT FORM.TXT from the DOS
  288.   prompt), fill all the blanks and endorse a check drawn on US funds,
  289.   payable to Rogelio Bernal, and send  it to :
  290.  
  291.     Rogelio Bernal
  292.     62 Boylston St. Box 920
  293.     Boston, MA 02116
  294.  
  295.   Please, add $5 for international shipping and handling. International
  296.   s&h applies anywhere except U.S. or Canada.
  297.  
  298.   If you are registering for the Special Registration 2 ($15), don't forget
  299.   to include a formatted diskette of at least 720k.
  300.  
  301.   You will notice I ask you several questions about your equipment and other
  302.   specific information about the game performance on your system. You are not
  303.   required to answer all those questions, but that information will help me
  304.   fine tune some features of the game, specially the well known problem
  305.   with the speed. Please take a few minutes and try to answer as many
  306.   questions as you can, thank you.
  307.  
  308.   If you are registering using the Basic Registration method, you MUST
  309.   enter your personal registration name, when asked for "CUSTOM TEXT...".
  310.   This registration name can be your name, company name or anything you
  311.   want, as far as you don't use more than 20 characters (including spaces).
  312.   This text will be used to obtain your personal id code. Both, your
  313.   personal registration name and id code will be part of your record as
  314.   a registered user of Super Retriss. Please, don't reveal them to others,
  315.   as you could be traced, and don't copy or distribute your registered
  316.   release (only copies for back-up purposes are allowed). Protect your
  317.   investment!
  318.  
  319.  
  320.   Shareware distributors
  321.   ──────────────────────
  322.   Shareware distributors that would like to include Super Retriss 3.0 on
  323.   their catalogs, please read the file INFODS.TXT
  324.  
  325.  
  326.          ──────────────────────────────────────
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.     SuperRetriss v3.00                               Registration  Page 4
  336.  
  337.  
  338.  
  339.  
  340.               ╔══════════════════╗
  341.               ║ 1 - INTRODUCTION ║
  342.               ╚══════════════════╝
  343.  
  344.   1.1 Yet Another Tetris Clone?
  345.   ═════════════════════════════
  346.  
  347.   Super Retriss has been defined as what people use to call "a Tetris clone".
  348.   However that definition is quite ugly and is not inaccurate. Since Tetris
  349.   was created by a Russian student, and commercialized by Spectrum Holobyte,
  350.   hundreds of "clones" appeared on the shareware market. Why? Well, the
  351.   algorithms needed to write a Tetris-like game are not complicated,
  352.   and almost any 'average' student of computer science should be able to
  353.   write his own version of this popular game. Most of the different versions
  354.   of the game you find out there are just that: a poorly written version of
  355.   the game, sometimes with the main purpose of seeing that he or she is able
  356.   to write a Tetris-like game.
  357.  
  358.   I started collecting as many Tetris clones as I could, to evaluate and
  359.   compare them. But soon I found out that only one out of ten was worth
  360.   to register. Now I only check out a Tetris clone if I have heard good
  361.   comments about it.
  362.  
  363.   Then, what makes Super Retriss to be so special?  Well, first of all,
  364.   the rules of the game are slightly different from the original Tetris
  365.   and, as far as I know, no other Tetris clone has implemented the idea
  366.   of the zones and the flicking block so far.  Second, Super Retriss has
  367.   always used a 256 colors VGA mode, even before the first commercial
  368.   Tetris game using VGA (Super Tetris by Spectrum Holobyte). Third, Super
  369.   Retriss is not just a tetris player: You can design your own zones and
  370.   play them later. Fourth, you don't play all the time with the same set
  371.   of blocks: In Super Retriss you play with square blocks, rounded blocks,
  372.   tiny square blocks... Up to ten different block shapes. And finally
  373.   Super Retriss now includes SoundBlaster support.
  374.  
  375.   All these features (and others that you will soon discover) make of
  376.   Super Retriss a different game, with appealing colors and sound, far
  377.   from the regular Tetris clones we are used to see everywhere. And that
  378.   is why the name of the game is not just Retriss but SUPER Retriss!!
  379.  
  380.  
  381.   1.2 What do you need to run Super Retriss?
  382.   ══════════════════════════════════════════
  383.  
  384.   The basic system you need to run Super Retriss is a computer (8086 family),
  385.   using MS DOS 3.3 or above, with at least 512k of RAM and a VGA card and
  386.   monitor. You don't need a mouse (or trackball) to play Super Retriss, but
  387.   the Zone Designer will not work if you don't have one installed (and the
  388.   driver loaded).
  389.  
  390.  
  391.     SuperRetriss v3.00                     Introduction  Page 5
  392.  
  393.  
  394.  
  395.  
  396.   A hard disk is not absolutely necessary, but strongly recommended.
  397.  
  398.   Also, if you have a Sound Blaster card, you should have a 286 or faster
  399.   computer in order to listen the initial music tones. You will also need
  400.   a copy of one of the SoundBlaster sound drivers (CT-VOICE.DRV) included
  401.   in the software that comes with your SoundBlaster/SoundBlaster Pro card.
  402.  
  403.   Releases of the Sound Blaster (v1.5 and up) have included an option to set
  404.   up an environment variable to locate the CT-VOICE.DRV file so that it
  405.   would not be needed all over one's hard drive in whatever directory you
  406.   needed it in.  This environment variable would look something like this:
  407.  
  408.     SOUND=C:\SB
  409.  
  410.   And the actual driver would then be in a DRV directory underneath the SB
  411.   directory. Current releases of many software take advantage of this
  412.   feature, as well as Super Retriss 3.0!  All you need is to include a line
  413.   in your autoexec to set up the environment variable.  If you are having
  414.   troubles setting up the environment variable, then Super Retriss will need
  415.   the extra copy of the driver in the directory, but using the environment
  416.   variable, the need for extra copies is not necessary.
  417.  
  418.   I was going to include a copy of the driver with Super Retriss 3.0, but
  419.   I noticed that different Sound Blaster cards installed on different systems
  420.   sometimes do not recognize drivers obtained from other sources. Besides,
  421.   I have no rights to copy and distribute the driver, so you will need either
  422.   to setup the environment variable, or copy your CT-VOICE.DRV to the
  423.   directory Super Retriss 3.0 was installed.
  424.  
  425.   If you are still having problems to have the Sound Blaster work, make sure
  426.   you don't have SBFMDRV.COM loaded to use your particular Sound Blaster
  427.   driver. Other than that, please report me any problem you may have and
  428.   I will fix it up for you.
  429.  
  430.  
  431.   1.3 What's new on this version?
  432.   ═══════════════════════════════
  433.  
  434.   Three months since the latest version of Super Retriss (v.2.01). There
  435.   must be some improvements, right? They are:
  436.  
  437.   - Annoying flicking effect when switching between screens should work
  438.     fine on all computers now.
  439.  
  440.   - Now you can quit from the DEFINE KEYS menu by pressing ESC anytime.
  441.     That will also abort the operation.
  442.  
  443.  
  444.  
  445.  
  446.  
  447.     SuperRetriss v3.00                               Introduction  Page 6
  448.  
  449.  
  450.  
  451.  
  452.   - When entering a zone number to start playing, when you type a number,
  453.     the '1' (by default) was moved to the right. Now it will disappear (as
  454.     suggested by L.T.Y).
  455.  
  456.   - After receiving many comments about the speed of the game, I decided
  457.     to add the -p switch so the speed of the game is now totally up to you!
  458.     Read to the manual for further information.
  459.  
  460.   - SoundBlaster support: SuperRetriss will scream through the speakers of
  461.     any owner of a SoundBlaster/SoundBlaster Pro card.
  462.  
  463.   - Some cosmetic changes have been also added to make Super Retriss a little
  464.     bit more appealing.
  465.  
  466.   - The documentation is now extensive and better organized. And hopefully,
  467.     you will find less grammar mistakes (English is yet more difficult than
  468.     C, trust me).
  469.  
  470.  
  471.               ╔═════════════════════╗
  472.               ║ 2 - GETTING STARTED ║
  473.               ╚═════════════════════╝
  474.  
  475.   2.1  Quick start
  476.   ════════════════
  477.  
  478.   The game is very easy to play and the best way to learn the basic rules
  479.   is by playing it. First, you must copy all the files to a single
  480.   directory, and then just type SR from the DOS prompt and follow the
  481.   instructions. If you feel lost, you can come back to the manual anytime
  482.   for specific information.
  483.  
  484.   If you want to use the SoundBlaster capabilities, read below.
  485.  
  486.  
  487.   2.2  Configuration
  488.   ══════════════════
  489.  
  490.   By default, the game is configured to use the PC speaker. To configure
  491.   Super Retriss to use the SoundBlaster sound capabilities, run SETUP
  492.   before running SR. You will be asked to enter the following information:
  493.  
  494.   - Sound device. Options are the PC speaker and a SounBlaster card.
  495.  
  496.   - Address used by your SoundBlaster card. This is a hexadecimal number
  497.     usually between 200 and 2A0.
  498.  
  499.   - IRQ used by your SoundBlaster card. This is a number usually between
  500.     1 and 10 (generally 5 or 7).
  501.  
  502.  
  503.     SuperRetriss v3.00                  Getting Started  Page 7
  504.  
  505.  
  506.  
  507.  
  508.   Once you run SETUP, the information will be permanently saved on a file
  509.   (SR3-CFG.DAT) in the current directory (which should be the directory
  510.   where Super Retriss was installed). You can run SETUP anytime later to
  511.   change the configuration.
  512.  
  513.  
  514.              ╔═════════════════════════════╗
  515.              ║ 3 - BASIC RULES OF THE GAME ║
  516.              ╚═════════════════════════════╝
  517.  
  518.   3.1 What to do
  519.   ══════════════
  520.  
  521.   What you have to do is very simple. Every zone (or screen) will show ONE
  522.   flicking brick. You must ELIMINATE the row where the brick is located,
  523.   by filling all the empty spaces with the pieces falling from the top of
  524.   the screen. When you're done, you will receive bonus depending on how many
  525.   seconds it took you to finish and how many empty lines are from the top of
  526.   the board to the highest brick found.  Then you will see another zone (or
  527.   screen), and so on...
  528.  
  529.   3.2 Details and Score
  530.   ═════════════════════
  531.  
  532.   A few things keep changing as you keep playing a game. They are: Speed
  533.   of the falling blocks, the zones being played and the design of the
  534.   blocks. Of course the score changes too, but I assume you know that.
  535.  
  536.   - Speed: The speed of the falling blocks is indicated by the LEVEL where
  537.     you are.  You will go to a faster level every time you finish 5 (five)
  538.     lines. When you pass level ten (the fastest one), you will go back to
  539.     level zero (the slowest level).
  540.  
  541.   - Zones: It is obvious. When you finish one zone, you go to the next zone.
  542.     When you finish the last zone (since different sets can have a different
  543.     number of zones, the last zone is not a fixed number) of the current
  544.     set, you will go back to the first zone again.
  545.  
  546.   - Blocks: The shape of the blocks changes as you go to a higher level.
  547.     That is, every time you finish 5 lines, a new block type will be used.
  548.     This also helps you to know when you entered on a faster level.
  549.  
  550.   - Score/Bonus: Your score is increased according to the following rules:
  551.  
  552.      1.- For every falling block you get 10 points.
  553.  
  554.      2.- For every finished line you get 100 points.
  555.  
  556.  
  557.  
  558.  
  559.     SuperRetriss v3.00                    Basic Rules of the Game  Page 8
  560.  
  561.  
  562.  
  563.  
  564.      3.- BONUS: Bonuses are given every time you finish one zone. The points
  565.      you receive are calculated using the following formula:
  566.  
  567.        (100 - seconds) * number of empty lines
  568.  
  569.      'seconds' is how many seconds you needed to finish the zone. If you
  570.      needed more than 100 seconds, NO BONUSES ARE GIVEN.
  571.      The number of empty lines is how many empty lines are from the top
  572.      of the screen to the highest brick found (the empty lines will be
  573.      filled with red bricks).
  574.      For instance, if you finished a zone in 45 seconds and there are
  575.      7 empty lines, you will receive:
  576.  
  577.      (100-45) * 7 = 385 points
  578.  
  579.  
  580.              ╔═══════════════════════╗
  581.              ║ 4 - MAIN MENU OPTIONS ║
  582.              ╚═══════════════════════╝
  583.  
  584.   The main menu has a few changes. The options available and their function
  585.   are :
  586.  
  587.     1.- PLAY        ───> Go to play !
  588.     2.- HIGH SCORES        ───> See the high score's table
  589.     3.- GRAPH-MATCH        ───> Not included in the shareware release
  590.     4.- LOAD ZONES        ───> Load new set of zones
  591.     5.- ZONE DESIGNER    ───> Design your own zones
  592.     6.- REDEFINE KEYS    ───> Select your favorite keys to play
  593.  
  594.     7.- EXIT        ───> Guess...
  595.  
  596.   You can select any option by entering the option number (ie. type '1' to
  597.   play, '2' to see the high scores...) or by pointing and clicking the
  598.   left button of the mouse on the desired option. Don't click on the
  599.   option number, but on the description.
  600.  
  601.  
  602.   4.1 Play
  603.   ════════
  604.  
  605.   You will see a familiar menu to select the set of pieces (as in
  606.   previous versions) you want to play with.
  607.  
  608.   (1) - The set #1 contains the typical pieces found in every Tetris-like
  609.     game (7 different pieces / 4 bricks per piece).
  610.   (2) - The set #2 adds three more pieces.
  611.   (3) - The set #3 uses the pieces from sets #1 and #2 plus a few more,
  612.     with a total of 15 different pieces.
  613.  
  614.  
  615.     SuperRetriss v3.00                            Main Menu: Play  Page 9
  616.  
  617.  
  618.  
  619.  
  620.   The pieces have not changed from previous versions.
  621.   I suggest you to use always the set #3. The set 3 may contain some pieces
  622.   difficult to play with, but there are also some pieces very helpful, not
  623.   present in the smaller sets. I always play using the set #3.
  624.  
  625.   If you decide not to play, the ESCape key will bring you back to the main
  626.   menu.
  627.   After you press 1,2 or 3, you will be asked for the zone you want to start
  628.   playing. Registered release allows you to start from any zone you want,
  629.   always  within the limit of the zones available in that set. Shareware
  630.   release lets you start from zones 1 thru 10. If you are not sure how many
  631.   zones are in the current set, you can find the number by selecting the
  632.   options 4 or 5 in the main menu. The default set contains 25 zones.
  633.   You can also go back to the previous menu pressing the ESCape key.
  634.  
  635.   After you enter the zone number, wait one second and start playing. The
  636.   keys are shown in the initial screen, and they are basically the arrow
  637.   keys, in the same manner most of the Tetris-like games use them, but you
  638.   can select any keys you want using the option 6 in the main menu.
  639.  
  640.  
  641.   4.2 High Scores
  642.   ═══════════════
  643.  
  644.   All entries in the table coming with this program have been reset to
  645.   10,000. If you have a table you wish to keep using, delete the file
  646.   SRETRISS.SCO from the directory where this game has been installed, and
  647.   copy the old STETRIS.SCO (or SRETRISS.SCO) from the last release to the
  648.   new directory.  Then, rename it to SR3-SCO.DAT. The format of the data
  649.   file is the same as the format used in the very first version of Super
  650.   Retriss, so you should not experience any problem. If you still have
  651.   some problems, let me know and I will fix it for you.
  652.  
  653.  
  654.  
  655.   4.3 Graph-Match
  656.   ═══════════════
  657.  
  658.   The game is self-explanatory. The object of the game is to match cards
  659.   with the same picture. It's a very simple VGA game I wrote some time ago.
  660.   Don't ask me why I included it. Consider is as a gift if you decide to
  661.   register the game. It is absolutely not needed in order to play Super
  662.   Retriss, and it does not affect the game at all.
  663.  
  664.   You can use the keyboard, but a mouse is strongly recommended. It was
  665.   designed for two players only, but you can still have some fun playing
  666.   it alone.
  667.  
  668.  
  669.  
  670.  
  671.     SuperRetriss v3.00                    Main Menu: Graph Match  Page 10
  672.  
  673.  
  674.  
  675.  
  676.   4.4 Load Zones
  677.   ══════════════
  678.  
  679.   This option allows you to load different sets of zones from the disk
  680.   that you previously created or obtained from other sources.
  681.   There are some restrictions :
  682.  
  683.   - You can only play ONE set of zones (or file) at a time. This means that
  684.     if you create a file by using the ZONE DESIGNER, and you create four
  685.     zones, when you exit the zone designer and go to play the game, you will
  686.     play only those four zones, until you exit the game and run it again, or
  687.     you select a different set. Every time you run the program, the default
  688.     set will be the standard set, also included in the trial release
  689.     (SR3-BRD.DAT). Further zones you create with the Zone Designer will
  690.     use the file extension ZNE.
  691.  
  692.   - When you load a new file of zones, such file MUST be in the same
  693.     directory as the game in order to be found by Super Retriss. Another
  694.     important limitation is that the program will display only the first 20
  695.     files found (extension *.ZNE). This doesn't mean that you are limited
  696.     to 20 zone files (i.e. you can create a subdirectory and move the old
  697.     zone files to it), but you are to do the job.
  698.  
  699.   ─────────────
  700.   Using a mouse
  701.   ─────────────
  702.   Point & click with the mouse on the file name you want to use. It will
  703.   be marked using red color. If you want to select a different one before
  704.   you exit the menu, just point & click on the new name.
  705.  
  706.   To exit the menu, point & click on the title screen to load the selected
  707.   zone (the one in red). If you click on the title screen before selecting
  708.   any file, you will leave the menu with the current set of zones unchanged.
  709.   Also, if you don't want to load any file, just press ESCape.
  710.  
  711.   ──────────────────
  712.   Using the keyboard
  713.   ──────────────────
  714.   Use the arrow keys to move the blue arrow and point to the file you want to
  715.   retrieve. Then, press ENTER or SPACE to select, or ESCape to exit without
  716.   changes.
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.     SuperRetriss v3.00                     Main Menu: Load Zones  Page 11
  728.  
  729.  
  730.  
  731.  
  732.   4.5 Zone Designer
  733.   ═════════════════
  734.  
  735.   ───────────────────────────
  736.   4.5.1 Entering the Designer
  737.   ───────────────────────────
  738.  
  739.   If you don't have a mouse or a trackball (and the corresponding driver
  740.   is installed), this option will be displayed as UNAVAILABLE, and you will
  741.   not be able to use the designer. If that is your case, I strongly suggest
  742.   you to purchase a mouse. They are cheap, and very useful.
  743.  
  744.   If you do have a mouse, when you select this option, before entering the
  745.   designer screen, the program will ask you :
  746.  
  747.        DO YOU WANT TO MODIFY THE CURRENT SET
  748.        OR START WITH A NEW ONE (C/N) ?
  749.  
  750.   If you type C, you'll be able to edit and change the current set.
  751.   However a new name will be asked for it when you save it. So, no matter
  752.   what you do, you will never lose the current set, unless you save it with
  753.   the same name.
  754.  
  755.   If you type N, a new, clean, empty set will be ready for you to create
  756.   whatever you like. It will have only one zone (empty) for you to start
  757.   working. Later I shall explain how to add more zones.
  758.  
  759.   You can also use the mouse and click on the C or N using the left button.
  760.   The right button will quit, going back to the main menu.  To go back to
  761.   the main menu, you can also press ESCape.
  762.  
  763.  
  764.   ─────────────
  765.   How to design
  766.   ─────────────
  767.  
  768.   Identifying the areas
  769.   ─────────────────────
  770.   For a clear explanation and to avoid repeating screen locations, we'll
  771.   assign intuitive names to each of the different areas on the screen :
  772.  
  773.   * BLOCK AREA: Located on the left side of the screen, you will see some
  774.     small windows with all the available block colors.
  775.  
  776.   * REFERENCE AREA: On the top of the middle of the screen, you'll see three
  777.     windows showing a reduced drawing of the zone being edited, and the two
  778.     adjacent zones (previous and next).
  779.  
  780.  
  781.  
  782.  
  783.     SuperRetriss v3.00                  Main Menu: Zone Designer  Page 12
  784.  
  785.  
  786.  
  787.  
  788.   * INFORMATION AREA: Under the reference area you'll see a window showing
  789.     the number of the area being edited, and a big block used to indicate the
  790.     current color being used by the editor.
  791.  
  792.   * EDITING AREA: Under the information area, there is a big green grid.
  793.  
  794.   * MENU AREA: Located on the right side of the screen, there is a menu with
  795.     several options.
  796.  
  797.   * SELECTION AREA: Under the menu area there are two buttons with a left
  798.     and right arrows.
  799.  
  800.  
  801.                ┌──>  REFERENCE AREA
  802.                │                 ┌─────────────> INFORMATION
  803.           ┌          ┌─┴───────────────┐ │               AREA
  804.           │  ┌─┬─┐    ┌───┐ ┌───┐ ┌───┐  │  ╔════╗   ┐
  805.      BLOCK  <─┤  ├─┼─┤    │   │ │   │ │   │  │  ╚════╝   ├─> MENU
  806.      AREA     │  ├─┼─┤    │   │ │   │ │   │  │  ╔════╗   │   AREA
  807.           │  ├─┼─┤    └───┘ └───┘ └───┘  │  ╚════╝   │
  808.           │  ├─┼─┤    ╔═══════╗       ┐  │  ╔════╗   │
  809.           │  ├─┼─┤    ║ BLOCK ║   ██  ├──┘  ╚════╝   │
  810.           │  ├─┼─┤    ╚═══════╝       ┘     ╔════╗   │
  811.           │  ├─┼─┤    ╔╤╤╤╤╤╤╤╤╤╤╤╤╤╤╤╗     ╚════╝   │
  812.           │  ├─┼─┤    ╟┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼╢     ╔════╗   │
  813.           │  ├─┼─┤    ╟┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼╢     ╚════╝   ┘
  814.           │  ├─┼─┤    ╟┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼╢              ┐
  815.           │  ├─┼─┤    ╟┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼╢   ┌────────┐ │
  816.           │  ├─┼─┤    ╟┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼╢   │ <    > │ ├─> SELECTION
  817.           │  └─┴─┘    ╚╧╧╧╧╧╧╧╧╧╧╧╧╧╧╧╝   └────────┘ │   AREA
  818.           └          └─┬───────────────┘             ┘
  819.                └─> EDITING AREA
  820.  
  821.  
  822.   Block Area
  823.   ──────────
  824.   Use it to select the color you want to use. Just point & click on the
  825.   window with the block color desired, and you will see how the big block in
  826.   the information area is redrawn using the same color. Then, anything you
  827.   draw on the editing area will be drawn using that color.
  828.  
  829.  
  830.   Reference & Selection Areas
  831.   ───────────────────────────
  832.   To move from one zone to another you can use the arrow keys LEFT & RIGHT,
  833.   or point & click on any button in the selection area. The editing area
  834.   will show the new zone to be edited, and the reference area will also be
  835.   updated.
  836.  
  837.  
  838.  
  839.     SuperRetriss v3.00                  Main Menu: Zone Designer  Page 13
  840.  
  841.  
  842.  
  843.  
  844.   IMPORTANT: When you move to a different zone, you will lose the changes in
  845.   the last zone, UNLESS you COPY it to the file (option 1 of the menu).
  846.  
  847.  
  848.   Editing Area
  849.   ────────────
  850.   The usage of the mouse for drawing a new zone (or make changes) on the
  851.   grid is very intuitive. All green small squares indicate the available
  852.   locations for single blocks.
  853.  
  854.   The left and right buttons of the mouse have different functions :
  855.  
  856.   * Left Mouse Button : When you click this button pointing inside one
  857.       of the green squares in the grid, a block in that location will be
  858.       drawn with the current block color (big block shown in the information
  859.       area).
  860.       If there was already a block OF THE SAME COLOR, instead of redraw it,
  861.       it will delete it. You just need to click again to redraw the block.
  862.  
  863.   * Right Mouse Button : This button is used to delete blocks. Whenever you
  864.       want to delete some particular blocks, use this button. If you want
  865.       to start over, select the option 5 (CLEAR) from the menu.
  866.  
  867.  
  868.   Menu Area
  869.   ─────────
  870.   There are five options available from the menu. Select anyone by pointing
  871.   and clicking on it.
  872.  
  873.    1.- COPY: It updates the changes to memory.   The zone being edited
  874.        will not be saved on memory until you select this option.
  875.        For example, if you have been working on the zone 1, and now you want
  876.        to save it and start with the number 2, you must select COPY in order
  877.        to save this zone before you go to the zone 2.
  878.        On the other hand, if you try to modify a particular zone, but you
  879.        don't like what you did, you can retrieve the original by leaving
  880.        that zone and going back to it.
  881.        Notice that when you draw on the editing area, the reference area
  882.        does not show the modifications. The reference area shows the zones
  883.        AS IN MEMORY. Remember, the zone will not be saved until you press
  884.        copy and see it updated on the reference area.
  885.  
  886.    2.- DEL: It eliminates the current zone from the set. No undo option is
  887.        available. However, it will ask you if you are sure. Just press Y or
  888.        N, or simply click on them (on the screen) with the mouse.
  889.        You can't use delete if there is only one zone in the set. In other
  890.        words, you cannot have a set with 0 (zero) zones.
  891.  
  892.    3.- GRID: Toggle on/off display of the green grid on the editing area.
  893.  
  894.  
  895.     SuperRetriss v3.00                  Main Menu: Zone Designer  Page 14
  896.  
  897.  
  898.  
  899.  
  900.    4.- NEW: It will add an empty zone at the end of the set. So far, a
  901.        maximum of 100 (one hundred) zones are allowed. If you already have
  902.        100 zones, this option will not work.
  903.  
  904.    5.- CLEAR: It will delete all blocks currently in the editing area. So
  905.        you can start over on a particular zone.
  906.  
  907.  
  908.   Save Zones to Disk (Not available in the Shareware release)
  909.   ──────────────────
  910.   If you want to save the zones to disk or just abort and use them, press ESC
  911.   while in the design screen. The program will ask you if you want to save
  912.   the set on the disk.
  913.  
  914.   - If you answer N, you will be able to play with the new zones, and, if
  915.     you like them, you can go back to the designer, select C to edit the
  916.     current one, make some changes and save it. If you don't save it and
  917.     you load/create a new one, or exit the game, it'll be lost forever.
  918.  
  919.   - If you answer Y, it will ask you for a file name. DO NOT INCLUDE
  920.     EXTENSION, neither invalid characters for DOS filenames such * : ? ...
  921.     If the name is not valid or DOS reports any error, your data file will
  922.     not be saved and probably the program will exit to DOS. So make sure you
  923.     give valid names and have free space in your disk.
  924.  
  925.   For this game, it would not make sense to have a zone containing no blocks
  926.   at all. Every single zone needs to have at least ONE block on it (so it
  927.   can locate the blinking block while playing). If you try to ESCape when
  928.   there is at least one empty zone, the program will inform you of that fact,
  929.   and it will bring you back to the editor with the first empty zone found
  930.   as the current zone to edit.
  931.   If you want to abort everything you did and play the set as it was before
  932.   your editing session, follow these steps :
  933.  
  934.   - Make sure there are no empty zones (you don't really need to
  935.     check that, since the program will do it for you).
  936.  
  937.   - If any, delete them, and exit again.
  938.  
  939.   - Do not save the file (if you really don't want it at all) when asked.
  940.  
  941.   - Select LOAD ZONE from the main menu, and load the previously loaded set.
  942.  
  943.   If you create a set of zones that you didn't save, but after playing it,
  944.   you decide to save it, you must select ZONE DESIGNER, then select
  945.   'C'ontinue editing current set, click with the mouse on the COPY option,
  946.   press ESCape and answer Y when asked. If you don't click on COPY at least
  947.   once, the program will assume that you didn't make any changes and it will
  948.   not ask you whether you want to save it or not.
  949.  
  950.  
  951.     SuperRetriss v3.00                  Main Menu: Zone Designer  Page 15
  952.  
  953.  
  954.  
  955.  
  956.   4.6 REDEFINE KEYS
  957.   ═════════════════
  958.  
  959.   This option has been added because many users requested so. In order
  960.   to make life much easier, after selecting the keys you want to use, you
  961.   will be asked if you want to save that configuration as permanent, so
  962.   you don't need to redefine the keys every time you load the game. But
  963.   notice that after you save them, you will not be able to play with the
  964.   default keys anymore. You may say "Well, I just need to redefine them
  965.   again as they were before". But notice that the default set uses
  966.   multiple keys for the same function (ie.: SPACE BAR, ENTER and
  967.   UP-KEY to rotate), while redefining the keys allows only one key for
  968.   each function. Anyway, you can always copy the file SR3-KBD.DAT from
  969.   the original ZIP or ARJ file to restore the default keys in case you
  970.   miss them and want them back...
  971.  
  972.   The function keys cannot be used, and the program will not do anything if
  973.   you try to select them. Keys such PrtScr,Shift,Alt...  will also not be
  974.   accepted.
  975.  
  976.   You can now press ESCape anytime to abort the keys selection and go back
  977.   to the main menu.
  978.  
  979.  
  980.   4.7 Exit
  981.   ════════
  982.  
  983.   The easiest part of the game. It will quit Super Retriss and exit to
  984.   DOS. You can exit by entering '7', clicking on the option using the
  985.   left mouse button, or pressing ESCape.
  986.  
  987.     ──────────────────────────────────────────────────────
  988.  
  989.                ╔══════════════════════════╗
  990.                ║ 5 - SOUNDBLASTER SUPPORT ║
  991.                ╚══════════════════════════╝
  992.  
  993.   Probably, the major difference between previous versions of Super Retriss
  994.   and Super Retriss 3.0 is the capability of using a SoundBlaster as the
  995.   sound device, instead of the PC speaker.
  996.  
  997.   To configure Super Retriss to use the SoundBlaster capabilities, you
  998.   must run SETUP.EXE first. Read the previous chapter 2.2 Configuration
  999.   for more details.
  1000.  
  1001.   Please, note that this is my first attempt to include SoundBlaster support
  1002.   to a program. I've been checking the program on several computers with
  1003.   different speed performance (286/16Mhz, 386sx/16Mhz, 486/33Mhz...) and
  1004.   experienced no problems at all. Things should run smooth and bug-free.
  1005.  
  1006.  
  1007.     SuperRetriss v3.00                     Sound Blaster Support  Page 16
  1008.  
  1009.  
  1010.  
  1011.  
  1012.   However being my first attempt on programming the SoundBlaster, I cannot
  1013.   assure that no weird behavior might occur on some systems. It doesn't
  1014.   matter whether you decide to register or not, please, let me know of any
  1015.   unusual situation you find while using the SoundBlaster with Super Retriss.
  1016.   A post card with your telephone number or address, explaining the
  1017.   problem will do. If you are a registered user, you can expect me to call
  1018.   you (if the call is to United States, Canada or Spain) to ask for details
  1019.   about your particular problem.
  1020.  
  1021.   Thanks to Joel Lucsy for his VOC routines, as well as Mark J. Cox for the
  1022.   MODOBJ code (I'm sending out my registration right now, Mark!). Without
  1023.   them, Super Retriss would still be limited to the poor PC speaker sound
  1024.   capabilities. Here I do credit these two programmers for their very
  1025.   helpful routines.
  1026.  
  1027.   The code used to play the initial song on the main menu is copyright
  1028.   of Mark J. Cox.
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.             ╔══════════════════════════╗
  1035.             ║ 6 - COMMAND LINE OPTIONS ║
  1036.             ╚══════════════════════════╝
  1037.  
  1038.  
  1039.  The executable file SRETRISS.EXE accepts a few command line parameters.
  1040.  This are their function and syntax :
  1041.  
  1042.     Syntax:
  1043.  
  1044.     SRETRISS [parm]             ──>   Characters [ and ] must not be typed.
  1045.                       They indicate that "parm" is optional.
  1046.  
  1047.     Where "parm" is one, and only one of the following :
  1048.  
  1049.     -h    : Displays the help screen, similar to this page.
  1050.     -?    : Same as -h.
  1051.     -v    : Displays version number.
  1052.     -s    : Displays the results of the machine's speed test.
  1053.     -pXXX : Select customized game speed.
  1054.  
  1055.   The character / may be used instead of -. Characters may be upper or lower
  1056.   case letters. Also, characters / or - may be omitted.
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.     SuperRetriss v3.00                      Command Line Options  Page 17
  1064.  
  1065.  
  1066.  
  1067.  
  1068.   6.1 The -p switch
  1069.   ─────────────────
  1070.  
  1071.   After receiving many comments from users regarding the speed of the game
  1072.   (ie: too fast on a 486, too slow on an 8086...), and since I don't have
  1073.   a real-time delay function (yet), I decided to add the -p switch.
  1074.  
  1075.   Loading SuperRetriss using the -p switch  (SR -pXXX) where XXX is a
  1076.   number between 1 and 999, will setup a customized speed for the game.
  1077.   SR -p1 will run the game too fast (even on a floppy and an 8088), and
  1078.   SR -p200 will run it too slow, even on a 486/50Mhz. You can experience
  1079.   with different values, and when you find a satisfactory speed, you can
  1080.   write a batch file that calls SRETRISS.EXE with the same switch all the
  1081.   time. "Regular" values for -p are from 20 to 200. The default value is
  1082.   based on the old method used in Super Retriss 2.00 and SuperRetriss 2.01,
  1083.   and even it has been improved, it is not very accurate yet. For fast 386
  1084.   and 486 machines, you may want to enter a higher value than the value
  1085.   reported by the speed test (by default) that will make the game to run
  1086.   slower,  and for very slow machines, you would probably want to decrease
  1087.   the default value in order to make it run faster.
  1088.  
  1089.   Be honest when entering a different value than the default. If you always
  1090.   play Super Retriss with a value that makes the game run very slow, the
  1091.   game would be so easy to play and there will be no challenge. Use always
  1092.   a fair value to keep Super Retriss somehow challenging. You don't want
  1093.   to set it up at a speed that will allow you to keep playing forever...
  1094.  
  1095.  
  1096.  
  1097.                 ╔════════════════╗
  1098.                 ║ 7 - THE FUTURE ║
  1099.                 ╚════════════════╝
  1100.  
  1101.   Super Retriss 3.0 is a big step from Super Retriss 2.01 but, does it end
  1102.   here? Definitely not! New and exciting features are waiting to be added to
  1103.   Super Retriss as soon as I have the time. Some of them are:
  1104.  
  1105.   - Full SoundBlaster/Pro support: The current SB fx are fine, but expect
  1106.     much more in future versions. Also I may go on other sound cards if I
  1107.     receive some requests from users.
  1108.  
  1109.   - Piece Designer : Finally, a very awaited tool. Tired of the same old
  1110.     blocks?  Not anymore. You will be able to design your own set of pieces
  1111.     to play Super Retriss.
  1112.  
  1113.   - Two players against the clock : Self explanatory! Who can make more
  1114.     points in X minutes?
  1115.  
  1116.  
  1117.  
  1118.  
  1119.     SuperRetriss v3.00                                The Future  Page 18
  1120.  
  1121.  
  1122.  
  1123.  
  1124.   - Save/Restore game : You will be able to save a game at any time, and
  1125.     later restore it to keep playing (you can even enter a secret password
  1126.     so nobody can 'play your game').
  1127.  
  1128.   - Multiple score tables : Organize separated championships, using different
  1129.     score tables. Also, a new, more completed scoring data is stored on the
  1130.     data tables.
  1131.  
  1132.   - Unlimited number of ZNE files. The LOAD ZONES option will not be limited
  1133.     to 20 ZNE files anymore.
  1134.  
  1135.   - Some new graphic touches. New fonts and screens.
  1136.  
  1137.   These are some of the features I have in mind. I'll be working on them
  1138.   during the first months of 1993. Registered users will be notified of any
  1139.   official update.
  1140.  
  1141.  
  1142.               ╔═══════════════════╗
  1143.               ║ 8 - LAST COMMENTS ║
  1144.               ╚═══════════════════╝
  1145.  
  1146.   Should you happen to run across one of those little "bugs" (even a minor
  1147.   one), or are you having problems using this program, please be sure to
  1148.   notify me (no obligation to register it) so that it can be fixed in the
  1149.   next version of Super Retriss.
  1150.  
  1151.   Any comments regarding program features, documentation, presentation,
  1152.   etc. are always appreciated.
  1153.  
  1154.  
  1155.              ╔═════════════════════╗
  1156.              ║ 9 - ACKNOWLEDGMENTS ║
  1157.              ╚═════════════════════╝
  1158.  
  1159.   - Tetris is a registered trademark of Spectrum Holobyte.
  1160.   - Super Tetris is a registered trademark of Spectrum Holobyte.
  1161.   - Sound Blaster is a registered trademark of Creative Labs, Inc.
  1162.   - Sound Blaster Pro is a registered trademark of Creative Labs, Inc.
  1163.   - SBFMDRV.COM is copyright (c) 1990,91 by Creative Labs, Inc.
  1164.   - CT-VOICE.DRV is copyright (c) 1989,90 by Creative Labs, Inc.
  1165.   - Borland C++ Version 3.0 is copyright (c) 1990,1991 by Borland
  1166.     International, Inc.
  1167.   - Turbo C++ Version 1.0 is copyright (c) 1989,1990 by Borland
  1168.     International, Inc.
  1169.   - MS DOS is copyright (c) 1981-1992 by Microsoft Corp.
  1170.  
  1171.     ──────────────────────────────────────────────────────
  1172.                ────────────────────────
  1173.                   ──────────
  1174.                   ──
  1175.  
  1176.     SuperRetriss v3.00                           Acknowledgments  Page 19
  1177.