home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / GAMES / SOLP / SOLIPEG.DOC < prev    next >
Text File  |  1994-10-13  |  9KB  |  232 lines
  1.  
  2.  
  3.     Solipeg, a Classic Marble Puzzle Game for the Psion Series 3a
  4.     Version 1.4 (and 1.4 Lite)
  5.     Copyright (C) 1993, 1994 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 1.2 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 Solipeg, copy Solipeg.app it to any directory (like \APP\)
  32. and install it using Install (Psion-I) from the system screen.
  33.  
  34. To access the external library (PUZZLIB.SLL is the same as the internal
  35. library in 1.4 and is provided for the Lite version), copy PUZZLIB.SLL
  36. to any \SOLIPEG\ directory.  Other libraries may be provided in the
  37. future.
  38.  
  39. To enable the digitized sound effects, copy SOLI*.WVE to any \WVE
  40. directory.  These sounds are freely distributable.
  41.  
  42.  
  43.                             De-installation
  44.  
  45. To de-install the program, press Shift-Ctrl-Delete - this causes the
  46. program to free all environment space it uses (currently 19 bytes) and
  47. exit.  Then delete the .APP file, the .WVE files, and any .SOL or .SLL
  48. files which were created or installed.
  49.  
  50.  
  51.                                  Rules
  52.  
  53. This is the classic Solitaire game played with marbles or pegs on a
  54. board.  Solipeg is the name of an old commercial game produced in the
  55. early part of this century.  There are two board shapes, and two rule
  56. sets.
  57.  
  58. The two board shapes are:
  59.  
  60.   000                     000
  61.   000                    00000
  62. 0000000                 0000000
  63. 000O000                 000O000
  64. 0000000                 0000000
  65.   000                    00000
  66.   000                     000
  67.  
  68. English pattern         French pattern
  69.  
  70. The object is to remove pegs one by one from the board by jumping over
  71. them (similarly to Chinese Checkers), leaving just one peg in the
  72. center hole (or not, as the particular rules decree - in certain
  73. problems, for instance, that is impossible).
  74.  
  75. The standard rule set allows only N-S-E-W jumps i.e.  no diagonals.  In
  76. the diagonal rules, jumps are allowed in all eight directions.
  77.  
  78. In more complicated restrictions - see Hoyle - a specific peg can be
  79. designated as a "ball on the watch", which can only be used to make the
  80. final jump.  Other pegs can also be designated as "dead balls", which
  81. are compelled to remain stationary and may only be captured on the
  82. final move(s).  These may be implemented in future versions as new ball
  83. types in the board editor and then restrict play accordingly.
  84.  
  85. The game Puzzle-Peg (Third Edition, 1924, Lubbers & Bell Mfg. Co.,
  86. Clinton, Iowa, USA, 50 cents) included a small booklet (23 pages),
  87. "Problems in Puzzle-Peg", which details over 100 different
  88. end-game-type problems which can be played on the standard English
  89. board, sent in by players of their earlier versions.  It also contained
  90. adverts for other games of theirs.  All 104 of the problems are
  91. included in this distribution - embedded in the library.  The Lite
  92. version contains only the standard two starting positions, although
  93. an external library is provided which is comparable to the internal
  94. library.
  95.  
  96. The advantage of the internal library is that when a New game is
  97. started, it will automatically start at the starting position of the
  98. last problem - this is especially useful if you are attempting
  99. repeatedly to solve a problem.  This is currently not possible with
  100. the external library or regular saved games.
  101.  
  102.  
  103.                                 Playing
  104.  
  105. By pressing the keys in the following pattern, the cursor can be moved
  106. one position in that direction.  If the shift key is held, a jump will
  107. be attempted in that direction, removing the peg jumped.  Only one peg
  108. may be jumped at a time, and so only one peg is removed with each turn.
  109.  
  110.                 NW          N        NE
  111.  
  112.                          9  0  +
  113.                 W        O     -     E
  114.                          L  *  /
  115.  
  116.                 SW          S        SE
  117.  
  118. Alternatively, the arrow keys can be used in a similar manner, although
  119. no diagonal moves/jumps can be made with them.  If shift is held with
  120. the arrow keys a jump is made.
  121.  
  122. If the move selected is illegal/impossible, a beep will warn the user.
  123.  
  124.  
  125.                             Menu Functions
  126.  
  127. New - Starts a new game.  If the current game is one from the embedded
  128. library, the same starting position will be reloaded.  Otherwise, the
  129. starting position will be either the classic English or French.
  130.  
  131. Open - Opens a single save game
  132.  
  133. Save - Saves a single game board
  134.  
  135. Library - Opens a starting position from the internal library.
  136.  
  137. External - Opens an external library for a list of problems - first
  138. choose a library file (.SLL) and then choose a problem by name
  139.  
  140. Options - Play options
  141.  
  142. Statistics - Show statistics of past game play
  143.  
  144. Exit - Quit Solipeg
  145.  
  146.  
  147.                                 Editing
  148.  
  149. Solipeg includes a board editor.  To use this, go into edit mode
  150. using the DIAMOND key, and then pieces can be toggled on and off
  151. using the space bar.  Then the game can be saved or one can resume play
  152. mode to play the board.  Games saved in either mode are equivalent.  By
  153. default, the \SOLIPEG directory is suggested for saved games, but they
  154. can be saved to any directory, and this directory does not need to
  155. exist on any drive.
  156.  
  157.  
  158.                                Compiling
  159.  
  160. Solipeg was re-written for 1.2 completely with HWIM functions and, as
  161. such, is not portable.  The source archive is freely available from the
  162. author.  To translate Solipeg to languages other than English, the
  163. resource script can be translated and does not require any changes to
  164. the program.
  165.  
  166.  
  167.                                 Credits
  168.  
  169. Development tools used included:
  170.  
  171. On PC: Psion SIBO SDK V2 with TopSpeed C compiler and associated tools,
  172. Multi-Edit 7.0 editor for DOS by American Cybernetics
  173.  
  174. On the Amiga: DeluxePaint IV.
  175.  
  176. This version benefited from suggestions by: Mark Jelic, Les Hall
  177.  
  178.  
  179.                                 Author
  180.  
  181. Suggestions for improvements are always welcome.  Please contact me
  182. (eMail virtually guarantees same day response):
  183.  
  184. Cade Roux
  185. P.O. Box 513
  186. Boutte, LA  70039  USA
  187.  
  188. 73733.1014@compuserve.com
  189.  
  190.  
  191.                                Revisions
  192.  
  193. 1.4:    External libraries of problems can now be loaded.  These are
  194.         a standardized form of resource files.
  195.  
  196.         Two versions of the program are supplied - solipeg.app
  197.         (Normal), solipegl.app (Lite).  The Lite version has only a
  198.         minimal internal library.  Lite version suggested by Mark Jelic
  199.         (via CIS).
  200.  
  201.         The internal library represents 26K worth of individually saved
  202.         games (using minimum 256-byte blocks on internal disk, 512-byte
  203.         blocks on RAM SSD means this would take up 52K if saved as
  204.         individual files!) - a quite considerable savings when
  205.         compressed to a single 6K resource and then embedded.  This is
  206.         now supplied as an external library (puzzlib.sll) for Solipeg
  207.         Lite.
  208.  
  209.         This version also includes a history of the result of the last
  210.         5 completed games, plus the average number of marbles left,
  211.         plus the number of games played - these numbers can be reset
  212.         using Shift-Ctrl-Delete (the environment variable now requires
  213.         19 bytes).  Statistics option suggested by Les Hall (via CIS).
  214.  
  215. 1.3:    All 104 problems now in embedded library with descriptive names.
  216.         Stores some options in environment var "$05$sp1" for recall.
  217.         The special key combination Shift-Ctrl-Delete will delete the
  218.         environment variable (6 bytes) and exit the game without
  219.         updating them - useful for de-installation.
  220.  
  221. 1.2:    First HWIM S3a-only release:
  222.  
  223.         Completely rewritten for HWIM with full OO techniques.
  224.         Uses grey and sound.
  225.         More options - Sound, and window position.
  226.         Library embedded as a resource, save and open modified slightly
  227.  
  228. 1.1:    First release allowing individual save games.  Jump count
  229.         removed - not necessary, and minor/cosmetic bug fixes.
  230.  
  231. 1.0a:   Initial release
  232.