home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / solitile.zip / SOLITILE.DOC next >
Text File  |  1989-08-18  |  13KB  |  294 lines
  1.  
  2.  
  3.                 SOLITILE
  4.  
  5.  
  6.             Copyright 1989 by Everett Kaser
  7.               All Rights Reserved
  8.  
  9.  
  10.  
  11.  
  12.     Solitile is a game of solitaire, played with "tiles".  It derives
  13.     from several similar games, such as "Shanghai" and "Mahjongg", which
  14.     are played with Mah-Jong tiles.  Solitile plays the same game, but
  15.     adds new starting layouts and the ability for the player to create
  16.     new layouts and/or modify the layouts provided.  It also uses new,
  17.     "westernized" pictures on the faces of the tiles.
  18.  
  19.     Solitile is being distributed as Shareware.  If you use the game
  20.     for more than a week, you are expected to pay for its use by sending
  21.     a registration fee to:
  22.  
  23.             Everett Kaser
  24.             Solitile
  25.             35405 Spruce St
  26.             Albany, OR  97321
  27.  
  28.     I can be contacted via email on Internet at:
  29.  
  30.         hplabs!hp-pcd!everett  or  everett%hpcvlx@hplabs.hp.com
  31.  
  32.     The registration fees are:
  33.  
  34.         $10.00 if you're happy with the copy of the game you have.
  35.         $15.00 if you'd like a fresh copy of the latest version
  36.             mailed to you.  There are no guarantees that the
  37.             version mailed to you will be newer or different
  38.             from the one you have.  Specify media type: 5 1/4"
  39.             or 3 1/2".
  40.         $35.00 if you'd like the sources to the latest version
  41.             mailed to you.  These sources are copyrighted, and
  42.             distribution rights are reserved.  This means you
  43.             may NOT give a copy of the sources to anyone else,
  44.             NOR may you distribute them or place them in a
  45.             publicly accessible place, such as a computer
  46.             network or BBS.  They are for your private use only.
  47.             You are free to modify and re-compile them at will,
  48.             but you may NOT distribute any program that is so
  49.             generated.  The sources are primarily Microsoft C,
  50.             with a small amount of assembly language.
  51.  
  52.     The game package, which MUST include the files SOLITILE.EXE (the game)
  53.     and SOLITILE.DOC (this file), may be freely copied and distributed.
  54.     It's use is subject to the conditions of the above paragraphs.
  55.  
  56.     See section 7 for changes since the first release.
  57. 1. INTRODUCTION
  58.  
  59.     The set of tiles consist of 144 individual tiles.  There are 36
  60.     different pictures on the faces of the tiles, with each picture
  61.     appearing on four tiles.
  62.  
  63.     The object of the game is to remove all of the tiles from the board.
  64.     Tiles are removed in matching pairs.  For a tile to be removable, it
  65.     must not have any other tiles on top of it, and it must have either
  66.     its entire right side exposed, or its entire left side.  "Exposed"
  67.     means that there is not another tile on the same level and laying
  68.     immediately against it.
  69.  
  70.     A few definitions of terms:
  71.  
  72.     LAYOUT: the starting pattern or arrangement of tiles, disregarding
  73.         the faces of the tiles.  This simply tells the program where
  74.         to place tiles when starting a game, but not WHICH tiles to
  75.         put in any given place.  There are ten possible layouts,
  76.         with nine being provided.  The you may add to, delete, and
  77.         modify these layouts.
  78.     BOARD NUMBER: a number between 0 and 65535, which is used to control
  79.         the placement of specific tiles in the starting layout.  This
  80.         number allows you to replay a specific game at will.  The game
  81.         normally starts with a random board.
  82.     MENU:    The list (displayed down the right side of the display) of
  83.         up to ten possible actions you can direct the game to perform.
  84.         These are in addition to playing the game.  The menu items
  85.         may be activated by clicking on them with the mouse, or by
  86.         pressing the appropriate softkey.
  87.     BUTTONS: the Left and Right Buttons refer to the buttons on your
  88.         mouse.  If you don't have a mouse, the HOME and PGUP keys on
  89.         the numeric keypad of your keyboard perform the same functions.
  90.         These two buttons are used to control the game action. The
  91.         meaning of the two buttons is always shown in the bottom
  92.         right corner of the display.
  93.  
  94.  
  95. 2. STARTING THE PROGRAM
  96.  
  97.     The program is started by typing
  98.  
  99.         SOLITILE
  100.  
  101.     There is an optional argument for specifying the board number:
  102.  
  103.         SOLITILE -b 34728
  104.  
  105.     The number 34728 could be replaced by any number from 0 to 65535.
  106.     The space between the -b and the board number is not required.
  107.     The welcome screen is displayed first.  You may proceed to the game
  108.     screen at any time by pressing a key or clicking a mouse button.
  109.  
  110.     There are two primary "modes" the game can be in: PLAY and EDIT.
  111.     PLAY mode is the default.  EDIT mode is entered by selecting the
  112.     "EDIT LAYOUT" menu.  This allows you to edit, delete, and add
  113.     layouts.
  114. 3. GAME CONTROL DURING "PLAY" MODE
  115.  
  116.     To select the first tile of a pair to be removed, move the cursor
  117.     onto the tile and press the LEFT BUTTON.  This will cause that tile
  118.     (if it's removable, ie. not blocked by other tiles) to be highlighted.
  119.     Once you've selected the first tile of the pair, move the cursor to
  120.     the second tile and, again, press the LEFT BUTTON.  This will cause
  121.     the second tile to be highlighted.  At this point, pressing the
  122.     LEFT BUTTON a third time will cause those two tiles to be removed,
  123.     or pressing both BUTTONs together will de-select the two tiles.
  124.  
  125.     A shortcut for selecting the second tile is to use the RIGHT BUTTON.
  126.     First, select the first tile using the LEFT BUTTON.  Then, pressing
  127.     the RIGHT BUTTON will cause the computer to search for a removable
  128.     matching tile.  If one is found, it will be highlighted.  Once both
  129.     tiles are highlighted, pressing the RIGHT BUTTON again will cause
  130.     the computer to look for a different tile to use as the matching
  131.     tile.  The RIGHT BUTTON can be used repeatedly to cycle through all
  132.     possible matches for the first tile you selected.
  133.  
  134.     If you're having trouble finding a matching pair of removable tiles,
  135.     or if you want to see all of the pairs that are currently removable,
  136.     press the RIGHT BUTTON before selecting a tile.  This will cause the
  137.     computer to search for all matching tiles that are removable.  It
  138.     will highlight them, one set at a time.  To cycle through the sets
  139.     of removable tiles, repeat pressing the RIGHT BUTTON until a message
  140.     appears in the lower left of the display, informing you that there
  141.     are no more matches.  At any time during this "help cycle", pressing
  142.     the LEFT BUTTON will abort the "help cycle".
  143.  
  144.     During the PLAY mode, the menu contains these entries:
  145.  
  146.       F1  Try Again       restarts the game with the same layout and board
  147.                number.  This is used if you get stuck and want
  148.                another try at solving the board.
  149.       F2  New Board       starts a new game with a new board number.  You
  150.                can specify the board number, or the computer will
  151.                pick a random number for you.
  152.       F3  New Layout   lets you select a new starting layout for the tiles.
  153.                There are nine supplied with the game.
  154.       F4  Back Color   lets you modify the color used for the background.
  155.                You can specify a number from 0 to 63, or cycle 
  156.                through the colors until you find one you like.
  157.       F5  Save Board   saves your current game, so you can come back to
  158.                it later.  It's saved in a file called SOLITILE.SAV.
  159.       F6  Load Board   loads your saved game.
  160.       F7           unused
  161.       F8  Undo       allows you to put back tiles you've taken off, to
  162.                recover from an accidental removal, or to try
  163.                alternate paths.  Tiles are put back in exactly
  164.                the reverse order from which they were removed.
  165.       F9  Edit Layout  allows you to edit, delete, and add your own
  166.                layouts.
  167.       F10 Exit To DOS  quits the game, returning control of your monitor
  168.                to your you, until next time, in the Solitile Zone.
  169.  
  170.     Several of the parameters of the game, such as Layout, Background
  171.     color, and any Layout Edits, can be saved to disk in a file called
  172.     SOLITILE.DAT.  To do this, follow these steps:
  173.         1) select the "New Layout" you wish to be the default.
  174.         2) select the "Back Color" you wish to have.
  175.         3) enter EDIT mode by selecting the "Edit Layout" menu.
  176.         4) press F7 "Save Changes" to store your selections in the
  177.             file SOLITILE.DAT
  178.     See section 4 below.
  179.     
  180.  
  181. 4. GAME CONTROL DURING "EDIT" MODE
  182.  
  183.     In EDIT mode, you can add or delete tiles in the current layout.
  184.     When finished with your edits, you MUST have exactly 144 tiles in
  185.     the layout (if you intend to save it).  You can also delete and
  186.     insert layouts.
  187.  
  188.     The LEFT BUTTON adds tiles, and the RIGHT BUTTON deletes them.  The
  189.     menu contains these entries:
  190.  
  191.       F1  Delete All Tiles    deletes all the tiles in the current layout,
  192.                 leaving you a "blank slate" upon which to
  193.                 create your NEW layout.  (This is frequently
  194.                 used after an "Insert New Layout".)
  195.       F2  Insert New Layout    if there's room, moves all layouts from the
  196.                 current layout to the last one, to make room
  197.                 for a new layout where the current one is.
  198.       F3  Delete Layout    deletes the current layout.
  199.       F4  Back Color    lets you modify the color used for the
  200.                 background. You can specify a number from
  201.                 0 to 63, or cycle through the colors until
  202.                 you find one you like.
  203.       F5  Change Name    changes the name of the current layout
  204.       F6  unused
  205.       F7  Save Changes    updates the SOLITILE.DAT file, saving the
  206.                 BACKGROUND color, default LAYOUT number, and
  207.                 the layouts.
  208.       F8  unused
  209.       F9  End Edit        terminates EDIT mode, returns program to the
  210.                 PLAY mode.   If changes have been made, they
  211.                 will be saved in the file SOLITILE.DAT.
  212.       F10 Exit To DOS    quits the game.
  213.  
  214.     Although the mouse works (sort of) in EDIT mode, it is recommended
  215.     that the keyboard be used for all layout editing.  See bugs.
  216.  
  217.  
  218. 5. PLANNED CHANGES AND ENHANCEMENTS
  219.  
  220.     1) Add "Select Layout" menu entry to EDIT mode.
  221.     2) Reorganize the menus.
  222.     3) Re-draw some of the tile pictures.
  223.     4) Fix bugs
  224.     5) Hopefully, add a "light source" and shadows, to enhance the
  225.        appearance of three dimensions.
  226. 6. KNOWN BUGS
  227.  
  228. ********1) When editing a layout, "Save Changes" doesn't save the changes
  229. *    *  you've edited into the current layout.  To avoid loosing your
  230. * FIXED *  layout edits, DON'T use "Save Changes" (except for saving the
  231. *rev 1.3*  BACKGROUND COLOR and the DEFAULT LAYOUT).  Instead, after you
  232. *    *  finish your edit, press F9 "End EDIT".  This will prompt you
  233. *********  to save your edits.  Respond with YES (LEFT BUTTON).  This WILL
  234.        save your edits.
  235.  
  236.     2) In EDIT mode, the mouse doesn't work well.  The cursor is limited
  237.        to those locations where tiles may be placed, and this is difficult
  238.        to control with the mouse (for you, the User.  For me, the prog-
  239.        rammer, it's humiliating failure).  Additionally, the mouse buttons
  240.        will NOT activate the menu.  You MUST press the softkeys on the
  241.        keyboard to activate the menu.  Because of this, it is recommended
  242.        that ONLY the keyboard be used while in EDIT mode.
  243.  
  244.     3) In EDIT mode, sometimes the cursor won't move in a specific 
  245.        direction, as if it's blocked.  Try moving "around" the blocked
  246.        area, sneak in from the back.  You should be able to get to where
  247.        you're trying to go.  This happens particularly when there is a
  248.        large difference in the height of the stacked tiles that you're
  249.        moving "across".
  250.  
  251. ********4) If one or two tiles are selected when UNDO is activated, those
  252. * FIXED *  tiles remain selected, but may become blocked, and partially
  253. *rev 1.4*  re-painted by the UNDO.
  254. *********
  255.  
  256. 7. CHANGES, ENHANCEMENTS, AND AMMENDMENTS
  257.  
  258.      In rev 1.3:
  259.     a) "patched" around an apparent timing problem with certain Mice on
  260.        certain computers.  The reported failure mode was that the game
  261.        ran fine with the keyboard, but the mouse buttons would not
  262.        activate anything (except responses to questions).  This was seen
  263.        by four or five people with Logitech mice and one person with a
  264.        Microsoft serial mouse.  Most of the people with Logitech mice had
  265.        the problem with the 4.00 mouse driver, while the 3.42 driver
  266.        worked fine.  One person was the other way around (or, at least,
  267.        his computer system was).  Since I didn't have access to this
  268.        problem first hand, I had to depend upon others for information
  269.        and testing.  I would like to thank Brynn Rogers, BOTE chief
  270.        (Beta/Omega Tester Extraordinaire) particularly for his testing
  271.        help.
  272.     b) Added in the three layouts that were accidentally left out of the
  273.        original release, bringing to nine the total layouts supplied with
  274.        the game.
  275.     c) Added the ability to de-select a single tile by pressing both mouse
  276.        buttons together.  This was previously available ONLY when you had
  277.        a pair of tiles selected.  To de-select a single tile, you had to 
  278.        move back to that tile and click the left button ON the tile.  Now,
  279.        you can de-select the single tile from anywhere by clicking both
  280.        mouse buttons at the same time (or pressing esc on the keyboard).
  281.     d) Fixed bug 1) listed above in section 6, having to do with an edited
  282.        layout not being saved by "Save Changes".  This now works properly,
  283.        by saving your edited layout, IF it has 144 tiles, otherwise an
  284.        error message is displayed, and NOTHING is updated in the disk file
  285.        SOLITILE.DAT.
  286.     e) Added a more visually stimulating congratulations display when you
  287.        successfully complete a board.
  288.      In rev 1.4:
  289.     f) Fixed bug 4) listed above in section 6, having to do with the
  290.        failure to first un-select any selected tiles before UNDOing a
  291.        previous move.
  292.  
  293. End of SOLITILE.DOC
  294.