home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 2 / agavol2.iso / software / games / n-z / solitaire / amigasolitaire.doc < prev    next >
Text File  |  1992-11-12  |  13KB  |  284 lines
  1. ******************************************************************************
  2. *                                                                            *
  3. *                         AMIGA SOLITAIRE, v. 2.1                            *
  4. *                                                                            *
  5. *                                   by                                       *
  6. *                                                                            *
  7. *                              David W. Meny                                 *
  8. *                                                                            *
  9. *                                                                            *
  10. *                          Additional Graphics by:                           *
  11. *                                                                            *
  12. *                            Albert J. Penello                               *
  13. *                                                                            *
  14. ******************************************************************************
  15.  
  16.  
  17. RULES OF SOLITAIRE:
  18. -------------------
  19.  
  20.    There are dozens of variations of the traditional game of Solitaire.  This
  21. program emulates the most common variation, Klondike Solitaire, and allows
  22. you to customize the rules of the game to your liking.
  23.  
  24.    The object of Solitaire is to move all of the 52 cards of the deck into
  25. four foundations (located in the upper right corner of the game screen),
  26. one for each suit with cards arranged in ascending order from Ace up to King.
  27. Seven stacks across the middle of the game screen facilitate the movement of
  28. the cards.
  29.  
  30.    A game of Solitaire is dealt by placing one card face up on the leftmost
  31. stack and one card face down on each of the next six stacks, then one card
  32. face up on the second stack and one card face down on each of the next five
  33. stacks, then one card face up on the third stack and one card face donw on
  34. each of the next four stacks, and so on until each of the seven stacks has
  35. one face up card as the very top card of the deck.  The result is a right
  36. triangle made up of 28 cards, with the face up cards of each stack
  37. forming the hypotenuse, and the right angle being in the upper right corner.
  38. Fortunately, since this is a computer game, the computer takes care of
  39. dealing the cards for you!
  40.  
  41.    The remaining 24 cards of the deck are placed in the upper right corner of
  42. the screen to be turned over, either three cards at or time or singly.  The
  43. topmost card of this "flip deck" can then be played either on a stack or
  44. moved up to a foundation.  When all the cards from the deck have been flipped
  45. through, they may be turned back over and flipped through again.  If you are
  46. flipping by 3 cards each time and a card or several cards had been moved from
  47. the flip deck (to a stack or a foundation), then the cards will be flipped
  48. over in a different sequence, allowing for other cards to be played. 
  49.  
  50.    The top most card of a stack or the topmost card of the "flip deck" may be
  51. moved up to a foundation if it is an Ace or the next higher card in that
  52. suit's sequence.  For example, if the Ace of Spades is moved up to a
  53. foundation (it does not matter which empty foundation it is placed in), then
  54. the 2 of spades must then be placed on top of the Ace of Spades, followed by
  55. the 3 of spades, the 4 of spades, and so on, up to the King of spades.  An
  56. Ace of any suit may only be moved up to an empty foundation, but it does not
  57. matter which empty foundation it is placed in.
  58.  
  59.    A card may be moved from the flip deck to a stack if it is of the opposite
  60. color of the topmost, face up card on the stack and one denomination less.
  61. For example, if a 6 of spades if on top of one of the deck, either a 5 of 
  62. hearts or a 5 of diamonds may be played on it.  Or if a King of Hearts is on
  63. top of a stack, a Queen of Spades or a Queen of Clubs may be placed on top
  64. of it.  If there is only one card face up on a stack, it may be played on
  65. a different stack in this same manner.
  66.  
  67.    All the face up cards from one stack may be moved onto a different stack
  68. if the bottomost face up card (the one behind all the others) from the stack
  69. to be moved is of the opposite color and one less than the topmost face up
  70. card of the destination stack.  
  71.  
  72.    When a stack is empty, only a King may be moved to this stack, or the
  73. face up cards from another stack if the bottomost faceup card is a king.  
  74.  
  75.    When all 52 cards have been placed, in sequence, into their appropriate
  76. foundation by suit, the game is won!
  77.  
  78.  
  79. MENU OPTIONS:
  80. -------------
  81.  
  82.    There are three menus that are accessed by holding down the right mouse
  83. button and moving the mouse to the title bar at the top of the screen.  A
  84. description of each menu option follows:
  85.  
  86.     I.  Game menu
  87.  
  88.         A. About
  89.  
  90.               This opens a window displaying information about the game,
  91.            including the authors and current version.  Click on the close
  92.            button of the about window to return to the game.
  93.  
  94.         B. New Game (right-Amiga N)
  95.                 
  96.               This option shuffles the deck and deals a new solitaire game.
  97.            The game timer and the count of the number of times gone through
  98.            the deck are reset, while the rest of the options remain the
  99.            same.
  100.  
  101.         C. Select Deck (right-Amiga S)
  102.  
  103.               This option allows you to choose from six different playing
  104.            decks.  A window will open in the middle of the screen displaying
  105.            each of the six decks when you choose this option.  Click on any
  106.            one of the six decks and it will become the current deck.
  107.  
  108.         D. Quit (right-Amiga Q)
  109.  
  110.               Selecting this option aborts the game and returns you to the
  111.            operating system.
  112.  
  113.    II.  Options menu
  114.  
  115.            These options can be changed at any time during the game.  This
  116.         allows for customization of the game to fit your playing tastes.
  117.  
  118.         A. Error Flash (right-Amiga F)
  119.  
  120.               This sets the option of having the computer screen flash
  121.            whenever an illegal move is made.
  122.  
  123.         B. Card Dragging (right-Amiga C)
  124.  
  125.            a. On:
  126.  
  127.                  Turns card dragging on.  See "Mouse Controls", below, for
  128.               an explanation of the actual controls of card dragging.
  129.  
  130.            b. Off:
  131.  
  132.                  Turns card dragging off.  See "Mouse Controls", below, for
  133.               an explanation of the actual controls of non-card dragging.
  134.  
  135.         C. Game Timer (right-Amiga T)
  136.  
  137.               This option turns on and off the timer of the current game,
  138.            measured in seconds.  If the timer is turned off and then turned
  139.            back on, it will start over at 0 seconds.
  140.  
  141.         D. Flip by: 
  142.  
  143.            a. Threes (right-Amiga 3)
  144.  
  145.                  Flips the deck by three cards with every mouse click.
  146.  
  147.            b. Ones (right-Amiga 1)
  148.  
  149.                  Flips the deck by one card with every mouse click.
  150.  
  151.         E. Times Thru Deck
  152.  
  153.               This option lets you select the total amount of times you are 
  154.            able to flip through the cards remaining in the deck.  Choices
  155.            are 1, 3, 5, 10, or unlimited times through the deck.
  156.  
  157.    III. Cheats menu
  158.  
  159.         A. Undo last move (right-Amiga U)
  160.  
  161.               This option lets you take back the last move, whether it was
  162.            moving a card from the deck to a stack, or just flipping the deck.
  163.            Selecting this option again before making any other move will
  164.            restore the move you made (i.e., undo the undo).
  165.  
  166.         B. View stack: (right-Amiga V)
  167.  
  168.               This option allows you to look at the cards that are face down
  169.            on any of the seven stacks across the middle of the play screen.
  170.            Select this option and then you will be told to select a stack
  171.            to view (displayed in the title bar).  Place the mouse pointer
  172.            over any of the stacks and click the left mouse button.  A window
  173.            will appear in the middle of the screen showing any face cards
  174.            of the selected stack, with the top most card on the very right.
  175.            Click on the close button of the view window to return to the
  176.            game.
  177.  
  178.  
  179. MOUSE CONTROLS:
  180. ---------------
  181.  
  182.    Here are descriptions of how to operate the mouse in Solitaire.  First
  183. are instructions that apply whether or not card dragging is selected.  Then
  184. a description of the differences between card dragging and non-card dragging
  185. is explained.
  186.  
  187.   I. General Operations
  188.      (operations that apply whether card dragging is on or off)
  189.  
  190.         To flip over the top card of a stack when it is face down, move the
  191.      mouse pointer to the stack and press and release the left mouse
  192.      button.  The top card will flip over.
  193.  
  194.         To flip cards from the deck, position the mouse pointer over the
  195.      deck (the face-down card back in the upper right corner of the screen)
  196.      and press and release the left mouse button.
  197.  
  198.         Once all the cards from the deck have been flipped through, a black
  199.      deck outline will appear in the upper left corner of the screen, if you
  200.      have not used all of your times through the deck.  Move the mouse
  201.      pointer over this outline, and press and release the mouse button to
  202.      move all the cards that have been flipped back into the deck.
  203.  
  204.         Sometimes the top card off a stack can be moved to a foundation and
  205.      all the face up cards from the same stack can also be moved to another
  206.      stack.  So how do you tell the game you want to pick up all the cards
  207.      face up on the stack (to move them to another stack), or only the top
  208.      card (to move it to a foundation)?  Simple: If the mouse pointer is
  209.      over the top card, it will pick up only the top card.  If the mouse
  210.      pointer is over any of the other face up cards of the stack, it will
  211.      pick up all of the cards that are face up on that stack.
  212.  
  213.  II. Card Dragging On
  214.  
  215.         With card dragging selected, to select a card (or set of cards) to
  216.      move, position the mouse pointer over the desired card and then press
  217.      and hold the left mouse button.  The cards will be picked up and you
  218.      will be able to drag them around as long as keep the left mouse button
  219.      held down.  To move the card(s) to a new location, release the left
  220.      button when the mouse pointer is over the new location.  If it is a
  221.      valid move, the card will be placed at the new location; if it is not,
  222.      the card will be returned to its original position.
  223.  
  224.         If you pick up a card (or cards) that you don't want to move,
  225.      simply move the mouse pointer back to where the cards where picked up
  226.      from and release the left mouse button.  The cards will be returned.
  227.  
  228.         A shortcut is provided to move a card from one of the seven stacks
  229.      up to the foundation of the same suit.  Move the mouse pointer over
  230.      the top card on one of the stacks and press and release the left mouse
  231.      button quickly (this time is determined by your Preference's double
  232.      click setting).  If the card can be moved to one of the foundations,
  233.      it will be moved for you; otherwise it will not be moved.
  234.  
  235. III. Card Dragging Off
  236.  
  237.         To select a card (or cards) to move with card dragging unselected,
  238.      move the mouse pointer over the desired card (or cards) to move, press
  239.      and release the left mouse button.  The cards that can be moved will
  240.      be reversed in color to show which cards have been selected to be
  241.      moved.  Now move the mouse pointer to where the cards should be
  242.      moved and press and release the left mouse button.  If the cards can
  243.      be moved, they will be; otherwise, they will remain where they are
  244.      and become unselected.
  245.  
  246.         If you select a card (or set of cards) that you don't actually
  247.      want to move, simply press and release the mouse pointer over the
  248.      highlited card(s), and they will be deselected.
  249.  
  250.         A shortcut to move the top card from a stack up to one of the
  251.      foundations is to position the mouse pointer over a stack with at
  252.      least the top card face up (if it isn't, then clicking on the card
  253.      will flip it over).  Double-click on the top card quickly (this time
  254.      is determined by your Preferences Double-Click setting), and if it
  255.      can be moved up to one of the foundations, it will be; otherwise, it
  256.      will be deselected.
  257.  
  258.  
  259. PROGRAM INFORMATION:
  260. --------------------
  261.  
  262.    Amiga Solitaire was written in SAS/C 5.10a.  It was started on an Amiga
  263. 1000, under AmigaDOS 1.3, and completed on an Amiga 3000, under AmigaDOS 2.0.
  264. And later on fixed AmigaDOS 3.0, AGA and 040/060 problems.
  265. The card graphics were originally drawn in Deluxe Paint III and then
  266. converted into C code.
  267.  
  268.    I, David Meny, wrote all of the program code, drew the card front graphics
  269. (2-10), the Legend of Lothian deck, and drew the blue diamonds, Amiga, and
  270. fireworks card backfaces.  Albert Penello drew the wonderful face card
  271. graphics, the Batman deck, and the Peter's Quest deck.
  272.  
  273.    If you have any comments, suggestions, or encounter a problem, please
  274. write to me at the following address:
  275.  
  276.                        David W. Meny
  277.                        2923 Carmel Way
  278.                        Fairfield, CA  94533
  279.  
  280.    Thank you and have fun!
  281.  
  282. -----------------------------------------------------------------------------
  283. Version 2.1: 15/10/95
  284.