home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / GAMES / KLON / KLONDIKE.DOC < prev   
Encoding:
Text File  |  1995-04-24  |  9.0 KB  |  248 lines
  1.  
  2.  
  3.     Klondike, a Patience Card Game for the Psion Series 3a
  4.     Version 2.1
  5.     Copyright (C) 1993, 1995  J Cade Roux
  6.  
  7.     This program is free software; you can redistribute it and/or modify
  8.     it under the terms of the GNU General Public License as published by
  9.     the Free Software Foundation; either version 2 of the License, or
  10.     (at your option) any later version.
  11.  
  12.     This program is distributed in the hope that it will be useful,
  13.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  14.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15.     GNU General Public License for more details.
  16.  
  17.     You should have received a copy of the GNU General Public License
  18.     along with this program; if not, write to the Free Software
  19.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20.  
  21. *   N.B. For space reasons the GNU General Public License is not
  22. *   included with this Psion palmtop product.
  23.  
  24.  
  25.                              Installation
  26.  
  27. This program (versions 2.0 onwards) will only run on the Psion Series
  28. 3a machine.  Running it on a Series 3 Classic will give a warning and
  29. terminate.
  30.  
  31. To install Klondike, copy Klondike.app it to any directory (like \APP\) and
  32. install it <Psion-I> from the system screen.
  33.  
  34. To enable the digitized sound effects, copy the KLON*.WVE to any \WVE
  35. directory.  These sounds are freely distributable.
  36.  
  37.  
  38.                             De-installation
  39.  
  40. To de-install the program, press Shift-Ctrl-Delete - this causes the
  41. program to free all environment space it uses (currently 21 bytes) and
  42. exit.  Then delete the .APP file and the .WVE files.
  43.  
  44.  
  45.                                 Credits
  46.  
  47. Development tools used:
  48.  
  49.         * The Psion SIBO SDK V2.0
  50.         * JPI TopSpeed C 3.02 compiler
  51.         * Multi-Edit V7.0 for DOS
  52.         * Multi-Edit V7.0 for Windows
  53.         * DeluxePaint IV
  54.  
  55. Thanks to:
  56.         * Zhava Glaser (Pipeline) - sorry I haven't implemented
  57.           everything - but it's got to be released sometime!
  58.         * Greg Friedman (CompuServe) - serious bugs in 2.0, ouch...
  59.  
  60. Very special thanks for usability testing:
  61.         * Michael Boshes (CompuServe)
  62.  
  63.                                  Rules
  64.  
  65. This is the classic Klondike/Canfield/Patience/Solitaire.  I quote a
  66. description of the game from David Parlett's Oxford Guide to Card Games
  67. (OUP 1990).  This is an excellent book for anyone who likes card games,
  68. being an excellent analysis of the development and history of card
  69. games of all kinds and from many different cultures, and I would
  70. heartily recommend it.
  71.  
  72. "Deal seven piles of cards face down in a row, with one in the first
  73. pile, two in the second, and so on up to seven in the seventh.  Turn
  74. the top card of each pile face up.  Aim to place the four Aces at the
  75. top of the board as and when they become available, and to build each
  76. one up into a thirteen-card suit-sequence headed by the King.  Turning
  77. cards from the pack one at a time, play each one face up either to (a)
  78. one of the Ace-piles, provided that it goes on the next lower card of
  79. the same suit, or (b) on of the seven processing columns, provided that
  80. it goes on a next higher card of the opposite colour (e.g.  Red Nine on
  81. Black Ten), or (c) a rubbish heap."
  82.  
  83. "Throughout play, the top card of the rubbish heap may be played to an
  84. Ace-pile in ascending sequence of suit, or to one of the central
  85. columns in descending sequence of alternating colour.  The topmost
  86. (uncovered) card of a central column may also be played in accordance
  87. with the same rules of following.  A whole sequence of properly ordered
  88. cards in alternating colour may be shifted provided that the join
  89. follows the rule.  Whenever a face-down card is exposed, turn it face
  90. up.  Whenever the last card is played from a central column, the space
  91. it leaves may be filled only with a King, or with a proper sequence
  92. from another column headed by a King.  Having run out of cards from the
  93. main pack, you may not (as in other patiences) turn the rubbish heap
  94. and go through it again.  It is therefore vital to play off the topmost
  95. rubbish card at every opportunity."
  96.  
  97. The only difference of this version from the description above is that
  98. cards are dealt one OR three at a time face up onto the rubbish pile,
  99. with only the top card allowed to be played.  Also, the rubbish pile is
  100. recycled each time the draw pile is exhausted.
  101.  
  102.  
  103.                                 Playing
  104.  
  105. The keys used to control Klondike are as follows:
  106.  
  107. Arrow keys move the pointer to the card to be lifted (the arrow points
  108. diagonally up from the left of the card).
  109.  
  110. Using Shift and the Up or Down arrow keys allows the player to split
  111. the pile in order to use intermediate cards.
  112.  
  113. When no card is currently being held, the TAB key picks up wither the
  114. current card, the current pile, or turns the hand pile onto the rubbish
  115. pile.
  116.  
  117. If the TAB key is pressed when a card or cards is being held, the cards
  118. will attempt to be dropped onto the current pile, the best pile, or the
  119. suits pile, depending on what the program thinks is best.
  120.  
  121. When holding cards which can't be dropped anywhere, the TAB key will
  122. return them to their rightful place.  The Esc key serves the same
  123. purpose.
  124.  
  125.  
  126.                           Quick-Pile Controls
  127.  
  128. The Quick-Piles keys are designed to make play as fast as possible,
  129. eliminating the cursor keys altogether.
  130.  
  131. A single key represents each pile on the screen:
  132. 1 - Hand Pile
  133. 2 - Rubbish Pile
  134.  
  135. 5, 6, 7, 8, 9, 0, + - Tableau Piles
  136. Q, W, A, S - Foundation or Suit Piles
  137.  
  138. For instance, pressing <1> will cause a singlet or triplet to be played
  139. off the Hand.
  140.  
  141. Pressing <2> will cause the topmost Rubbish card to be
  142. played first to the tableau, and if that is not possible, then onto the
  143. foundation.
  144.  
  145. Pressing <Q> will attempt to play the topmost foundation card of
  146. Hearts onto the tableau.
  147.  
  148. Pressing <5> will attempt to move the whole of pile 5 onto the most
  149. suitable tableau pile, otherwise, attempting to play the topmost card
  150. of pile 5 onto the foundation.
  151.  
  152. I think the experienced player will find Quick-Piles to be very
  153. intuitive, and, after a few games, VERY fast.
  154.  
  155. Users of other keyboard layouts will have difficulties, which I should
  156. be able to easily accomodate through incorporating different keyboard
  157. layouts into the program's resource file.  Please contact me at the
  158. below address.
  159.  
  160.  
  161.                             Menu Functions
  162.  
  163.         * New Game - Starts a new game.
  164.  
  165.         * Win Game - Attempts to win the current game and start a new
  166.           one.
  167.  
  168.         * Options - Play options
  169.                 * Sound - Digitized sound can be turned on or off.
  170.                 * Deal Type - The user can choose 1 or 3 cards - the choice
  171.                   applies immediately.
  172.                 * Cursor Wrap - Is the cursor allowed to wrap at edges
  173.                   of screen
  174.                 * Auto-win - Computer determines a win if all cards are
  175.                   face up - and if playing triplets, you can have no
  176.                   cards in the hand or rubbish pile
  177.                 * Quick-Piles - Enables the Quick-Piles keys
  178.  
  179.         * Statistics - Shows statistics of past game play
  180.                 * Number of games played
  181.                 * Average number of cards onto foundation piles
  182.                 * Average number of face down cards remaining on the
  183.                   tableau
  184.                 * Number of games won
  185.  
  186.         * Exit - Quit Solipeg
  187.  
  188.  
  189.                                Compiling
  190.  
  191. Klondike V2.0 was largely re-written as an OO HWIM application for the
  192. Series 3a.  Source code is freely available from the author.
  193.  
  194.  
  195.                              Problems/Bugs
  196.  
  197. No known bugs.
  198.  
  199.  
  200.                                 Author
  201.  
  202. V2.0 is being released not as a finished product, but as the vanguard
  203. in a new generation of Klondike - to get some more suggestions.
  204.  
  205. You can tell there are a few things left to do - like undo, scoring,
  206. and improved responsiveness and smoother redraws.  The documentation
  207. and online help are not as complete or accurate as they could be - a
  208. lot of logic goes into Quick-Piles and SmartTAB.
  209.  
  210. The game has been
  211. extensively tested, but as with all software, there will be defects,
  212. and the sooner any defects are reported, the sooner they can be
  213. fixed...
  214.  
  215. I expect to have for 2.1:
  216.  
  217. * Multiple level undo
  218. * Scoring
  219. * Timed games - now Quick-Piles will be real useful!
  220.  
  221.  
  222. Suggestions for improvements are always welcome.  Please contact me
  223. (eMail virtually guarantees same day response):
  224.  
  225. Cade Roux
  226. P.O. Box 513
  227. Boutte, LA  70039  USA
  228.  
  229. 73733.1014@compuserve.com
  230. cade@ix.netcom.com
  231.  
  232.  
  233.                                Revisions
  234.  
  235. 2.1:    Bug fixes related to Spacebar use and redraws...
  236.  
  237. 2.0:    Series 3a-Only Version:
  238.         Smart-TAB invented
  239.         Quick-Piles invented
  240.         Sounds added
  241.         Triplets/Singlets option
  242.         Cursor Wrap option
  243.         Auto-Win feature
  244.         Pile splitting
  245.         Sprites for cursor
  246.         HWIM rewrite
  247.  
  248. 1.0a:   Initial release for S3