home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma26.dms / ma26.adf / MineSweeper / MineSweeper.doc < prev    next >
Text File  |  1994-02-26  |  13KB  |  280 lines
  1.  
  2.            ______  __  _____  ____
  3.           /     / / / / _  / / __/     _____________________________
  4.          / /_/ / / / / // / / _/_     |_____________________________|
  5.         /_/ /_/ /_/ /_//_/ /____/
  6.                         ____
  7.                        / __/  __  __  ____   ____   _____  ____   ____
  8.         _________     /_/__  / /_/ / / __/  / __/  /    / / __/  / __/
  9.        |_________|   ___/ / / / / / / _/_  / _/_  / -- / / _/_  / /
  10.                     /____/ /_____/ /____/ /____/ / ___/ /____/ /_/
  11.                                                 /_/
  12.  
  13.  
  14.                                  Version 1.1
  15.  
  16.                               Martin Reddy, 1994
  17.  
  18.                           (Requires WB2.0 or higher)
  19.  
  20.  
  21.  
  22.       "Far out in the uncharted backwaters of the unfashionable end
  23.       of the Western Spiral arm of the Galaxy lies a small unregarded
  24.       yellow sun. Orbiting this at a distance of roughly ninety-eight
  25.       million miles is an utterly insignificant little blue-green
  26.       planet whose ape-descended life forms are so amazingly primitive
  27.       that they still think digital watches are a pretty neat idea ..."
  28.  
  29.  
  30.  
  31. 1 - INTRODUCTION
  32. ~~~~~~~~~~~~~~~~
  33.  
  34. The object of MineSweeper is to locate all of the mines which are hidden in
  35. a mine field.  When the game starts you will see a blank (mine free) area in
  36. the upper left corner of the grid which is surrounded by numbers.  These
  37. numbers (ranging from 1 to 8) will tell you how many of that particular
  38. square's immediate neighbours that contain mines. By counting, thinking,
  39. and the odd bit of guess work, it is up to you to figure out which squares
  40. have mines and which are clear. i.e. You must click on all of the clear
  41. squares to win the game: click on just one mine, and it's lights out time!
  42.  
  43.  
  44.         +---+---+---+       Figure 1.1 - An example square shown with all
  45.         |   |   | M |                    of its eight neighbours, three of
  46.         +---+---+---+                    which contain mines (denoted by
  47.         |   | 3 |   |                    the "M" character). Therefore, the
  48.         +---+---+---+                    value that will be displayed in
  49.         | M | M |   |                    this square is "3"
  50.         +---+---+---+
  51.  
  52.  
  53.  
  54. 2 - AN EXAMPLE
  55. ~~~~~~~~~~~~~~
  56.  
  57. To help you grasp this really complex and difficult concept, here is a 
  58. small example which you can work through yourself.  The numbers are those
  59. which might be displayed by MineSweeper and the letters A-H are the boundary
  60. squares to those values whose contents we don't know; but by a little bit
  61. of elementary deduction, we can find them out...
  62.  
  63.  
  64.                           +---+---+---+---+---+---+...
  65.                           |   |   |   | 2 # A |   |
  66.                           +---+---+---+---+---+---+...
  67.                           |   |   |   | 2 # B |   |
  68.                           +---+---+---+---+---+---+...
  69.                           | 1 | 2 | 2 | 4 # C |   |
  70.                           +###+###+###+###+---+---+...
  71.                           | H | G | F | E | D |   |
  72.                           +---+---+---+---+---+---+...
  73.                           |   |   |   |   |   |   |
  74.                           :   :   :   :   :   :   :
  75.  
  76.  
  77.    A and B     Must be mines since they are the only neighbours to the
  78.                2 to the left of A
  79.    C           Must be free because the 2 next to the B is already
  80.                accounted for by A and B
  81.    D,E and F   Must all be mines for the 4 to fill up its quota of
  82.                neighbouring mines
  83.    G           Cannot be a mine due to the 2 right above F, and finally...
  84.    H           Is a mine because of the 1 above it (remembering that
  85.                G was clear).
  86.             
  87.  
  88.  
  89. 3 - USING FLAGS
  90. ~~~~~~~~~~~~~~~
  91.  
  92. To help you in your quest to keep various bits of your anatomy in the same
  93. relative positions as they are at the moment, it is possible to mark any
  94. square with a flag by holding down the SHIFT key whilst clicking the Left
  95. Mouse Button (repeat the action to toggle the flag off).
  96.  
  97. It is also possible to use the Right Mouse Button (RMB) to toggle flags if
  98. the "RMB=Flag" option in the "Preferences" window is on (the default). When
  99. this is the case, you can still access the MineSweeper menus if you move
  100. the mouse off of the mine field grid. If you would prefer to be able to
  101. access the menus at all times, then you can select "RMB=Flag" to off and
  102. use the SHIFT+LMB method.
  103.  
  104. You start off the game with the same number of flags as there are mines
  105. hidden in the mine field, and you can use these flags to remind you where
  106. you think that there are mines - N.B. Just because you mark a square with a 
  107. flag doesn't mean that there is a mine underneath!
  108.  
  109.  
  110.  
  111. 4 - THE MENUS (WELL, "MENU" REALLY)
  112. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  113.  
  114.    New Game       Starts a new game with the current preference settings
  115.                   (this can also be achieved by pressing the SPACE BAR).
  116.    Abort Game     Terminates the current game (also via ESC key)
  117.    Preferences    Lets you change some of the default settings of the game.
  118.                   These include the following:
  119.  
  120.                      GRID DIMENSION : (Default=10x10) You can specify an
  121.                            Alternative mine field size (the bigger, the
  122.                            more complex!). Minimum size = 5x5, Maximum
  123.                            size = 30x30 (depended upon your WorkBench
  124.                            screen size).
  125.                      LEVEL OF DIFFICULTY : (Default=Moderate) There are
  126.                            four levels of difficulty which you can choose.
  127.                            These are Easy, Moderate, Difficult and
  128.                            Impossible. Changing this setting changes the
  129.                            number of mines which will be hidden in the
  130.                            mine field (and also alters the amount of time
  131.                            you get to complete the mine field appropriately)
  132.                      USE OF TIMER : (Default=ON) You can select whether
  133.                            you wish to try to beat the clock by completing
  134.                            the mine field within an allotted time period,
  135.                            or to switch off the timer so that you can take
  136.                            your own sweet time about things.
  137.                      USE OF DEBRIS : (Default=ON) You can select to have
  138.                            various squares of "debris" which basically 
  139.                            mark squares which do not contain mines and
  140.                            serve to help you with your task.
  141.                      RMB = FLAG : (Default=ON) Lets you use the Right Mouse
  142.                            Button to place flags on squares as well as the
  143.                            SHIFT+Left Mouse Button method.
  144.                      SHOW FACE : (Default=ON) This is "borrowed" from the 
  145.                            PC Version. You can have a little smiley face
  146.                            at the bottom of the screen whose facial 
  147.                            expressions relate to your current progress.
  148.                            This also provides a method for starting a new
  149.                            game by clicking on the face.
  150.                      HEAD START : (Default=ON) You can use this option to
  151.                            give you a little helping hand initially by
  152.                            clearing some of the squares in the top-left
  153.                            hand corner so that you have somewhere to start
  154.                            from.
  155.                      REQUESTERS : (Default=ON) Whenever a game finishes
  156.                            (whether because you won or lost), a little
  157.                            requester appears telling you what happened. If
  158.                            you find these irritating, then you can simply
  159.                            switch them off with this option.
  160.  
  161.    High Scores    Displays the current High Score Table (see later)
  162.    Rules          This option gives you a brief run down on the rules of
  163.                   MineSweeper (just because I wanted to try out the List
  164.                   View gadget!)
  165.    About          The usual boring window.
  166.    Quit           Either makes your Amiga put on a frilly dress, sprout
  167.                   five legs and do a rather festive Manchurian dance, OR,
  168.                   it quits the program - which do you think it is????
  169.  
  170.  
  171.  
  172. 5 - THE HIGH SCORE TABLE
  173. ~~~~~~~~~~~~~~~~~~~~~~~~
  174.  
  175. When you complete a mine field, you are awarded a score which is dependent
  176. upon the amount of time you have left, the mine field size, the difficulty
  177. level and whether you used the "Debris" or "Head Start" options. The ten
  178. best scores are stored by MineSweeper and you can display these via the
  179. "High Scores" menu item.
  180.  
  181. If the High Score Table is modified at any stage whilst MineSweeper is
  182. running, then it will attempt to save the new High Score Table to disk
  183. when it exits so that it can be retrieved when it starts up again. The
  184. High Score data is loaded from ENV: and saved to ENV: and ENVARC:
  185.  
  186. (N.B. If you have put the timer off (via the "Preferences" window), then
  187. you will only be awarded a score if you complete the game within the time
  188. period that you would have been given if you had kept the timer on.)
  189.  
  190.  
  191.  
  192. 6 - WORKBENCH ARGUMENTS
  193. ~~~~~~~~~~~~~~~~~~~~~~~
  194.  
  195. To run MineSweeper, you simply double-click on it's icon from the WorkBench.
  196. This will start up the game with a number of default settings. If you would
  197. like to have different default settings, then you can supply any of the
  198. following Tool Types to the MineSweeper icon (via the Information menu item
  199. of the WorkBench):
  200.  
  201.  
  202.     TIMER=ON|OFF
  203.     DEBRIS=ON|OFF
  204.     LEVEL=EASY|MODERATE|DIFFICULT|IMPOSSIBLE
  205.     XSIZE=<number>
  206.     YSIZE=<number>
  207.     PUBSCREEN=<pubscreenname>
  208.     PROMPT=ON|OFF
  209.     HEADSTART=ON|OFF
  210.     FACE=ON|OFF
  211.     RMBFLAG=ON|OFF
  212.     REQUESTERS=ON|OFF
  213.     
  214.  
  215. Most of these are fairly self-explanatory, with perhaps the exception of
  216. the PROMPT Tool Type. This is a staggeringly useless option which lets you
  217. switch off the initial title bar prompt for "Press SPACE To Play..." -
  218. Well, hey, somebody might want to use it!
  219.  
  220. The PUBSCREEN Tool Type lets you open the MineSweeper program on any named
  221. Public Screen. If this option is not specified (or if the specified Public
  222. Screen does not exist) then the default Public Screen will be used (i.e.
  223. the WorkBench Screen)
  224.  
  225. N.B. There are no command line options to the program if it is run it from
  226. the Shell. However, it will still try to access the icon file to find any
  227. of these settings - so you can still customise your initial defaults, even
  228. when running from the Shell, by setting the above Tool Types for the icon.
  229.  
  230.  
  231.  
  232. 7 - THE END AT LAST
  233. ~~~~~~~~~~~~~~~~~~~
  234.  
  235. This game is based upon the game of similar name which runs under Windows
  236. on a PZZzzz. However, this particular implementation has been modelled more
  237. on the PD game called "Bombs!" for the Mac which was written by Christer
  238. Ericson. I played this game one day last week and got so addicted that I
  239. went home and started to write it for my beloved Amiga. I would like to
  240. thank Christer for his correspondance and much appreciated help during the
  241. development of MineSweeper (all four days of it!).
  242.  
  243. The game was written using "High Speed Pascal V1.10". I also made use of
  244. the GUI Builder "Designer" by Ian OConnor to design the interface and
  245. "DPaint IV" to draw the images, and a really amazing and total brillant
  246. text editor called "EdWord Professional V4.1" to write this doc file (if
  247. you don't have this program, then buy it today (only £10)).
  248.  
  249. This game is "Chocolate Domain" - which is my way of saying that it is
  250. Public Domain (so you can give it to whoever you want), but if you do like
  251. it, then I would appreciate it if you would send me a bar of chocolate!!!
  252. It doesn't have to be a big bar, or an exciting bar - just any old bar of
  253. chocolate will do!  
  254.  
  255. My address is...
  256.  
  257.     
  258.                          ____________________________
  259.                         |                            |
  260.                         |      Martin Reddy,         |
  261.                         |      Lossiemouth House,    |
  262.                         |      33 Clifton Road,      |
  263.                         |      LOSSIEMOUTH,          |
  264.                         |      Moray,                |
  265.                         |      Scotland,             |
  266.                         |      IV31 6DP.             |
  267.                         |                            |
  268.                         |  E-Mail: mxr@dcs.ed.ac.uk  |
  269.                         |____________________________|
  270.                           
  271.  
  272.  
  273.                                ---- o - o ----
  274.  
  275.  
  276. Q. In the force if Yoda's so strong, construct a sentence with words in
  277.    the proper order then why can't he?
  278.  
  279.  
  280.