home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 Mobile / Chip_Mobile_2001.iso / palm / spiele / lightsou / lightsou.exe / readme.txt < prev   
Text File  |  1999-11-09  |  10KB  |  274 lines
  1. *** LIGHTS OUT for the Palm Computing Platform
  2. *** v1.1
  3. ***
  4. *** By Andy Scheffler (ascheffl@hamusutaa.com)
  5.  
  6. Contents:
  7.  
  8. 0. Freeware Notice
  9. 1. How to Play
  10. 2. Layout of the screen
  11. 3. The Menus
  12. 4. Differences from the toy
  13. 5. Version History
  14. 6. What's planned for the future
  15. 7. Edit Mode
  16. 8. Technical Notes
  17. 9. Philosophy of Lights Out
  18. 10. Contacting the Author
  19.  
  20. ****************************************
  21. 0. Freeware Notice
  22. ****************************************
  23.  
  24. This program is freeware.  No one can charge for it, and it cannot be
  25. distributed without this readme.  Although I'm not charging for it, if
  26. you send me an email just to let me know how you like it, I'd
  27. appreciate it.
  28.  
  29. ****************************************
  30. 1. How to Play
  31. ****************************************
  32. Lights Out is a handheld device made by Tiger Electronics, about the
  33. size of a VHS tape.  It has 25 lights/buttons on it which can either
  34. be on or off.  The object is to get all of the lights off, hence the
  35. name of the game.
  36.  
  37. Whenever you hit a button, if that button is off, it turns on.  If
  38. that button was on, it turns off.  But, the four buttons that are on
  39. the top, bottom, left and right of that button also switch states like
  40. this.
  41.  
  42. Also, I should mention that you have to do it in a certain number of
  43. moves.  Each puzzle has a magic number of moves that is the minimum
  44. number of moves necessary to solve it.  If you solve it in this
  45. number, the screen will give a little spiral animation.  If you take
  46. anywhere up to 10 extra moves, it will instead flash a number of
  47. buttons equal to the number you were over.  Any more than 10 extra
  48. moves, and it flashes a big "X" and you have to start that level over.
  49.  
  50. There are three modes of play.  The main mode is the Puzzle mode.  There
  51. are 50 puzzles built into the game.  In this mode, when you finish one
  52. puzzle, you advance to the next.  The next mode is Random mode.  In
  53. this mode, a puzzle is automatically generated at the specified
  54. difficulty.  Your progress will be saved if you turn off your Palm
  55. device.  The last mode is Edit mode.  In this mode, you can create your
  56. own puzzle, and then play it.
  57.  
  58. ****************************************
  59. 2. Layout of the screen 
  60. ****************************************
  61. The main portion of the screen is made up of the lights.  If you tap
  62. one, it will switch states of it and its four neighbors.  Along the
  63. right side, there are the following, from top to bottom:
  64.  
  65. * Number of Moves taken so far in this attempt
  66. * Minimum number of moves necessary to solve this level
  67. * Level number of current puzzle (only in Puzzle Mode)
  68. * Restart button - restarts the current puzzle
  69. * Hint button (only works in Puzzle Mode)
  70. * Play / Edit switch button (replaces the Hint button in Edit Mode)
  71.  
  72. These should be self-explanitory except for the Hint button.  The Hint
  73. button only works in Puzzle Mode, and only if you haven't hit any
  74. lights yet.  If you hit it, it will flash a light as a hint to start
  75. you off, and then it will make the move for you.  You can do this up
  76. to twice on each level, and only on the first 25.
  77.  
  78. In Edit mode, the Hint icon changes from a "?" to a "P/E".  This button
  79. is used to switch between Edit Mode (edit) and Edit Mode (play).  For
  80. more information, see Section 7: Edit Mode.
  81.  
  82. In addition, when selecting a Random level (or you have just completed
  83. one) a spinning bar will appear in the lower left corner to let you know
  84. the program is trying to find a new Random level.  This should never be
  85. noticable except in levels 14 and 15.
  86.  
  87. ****************************************
  88. 3. The Menus
  89. ****************************************
  90.  
  91. Game Menu
  92. ---------
  93.  
  94. Select...: Select a new puzzle
  95.  
  96.   In Puzzle mode, you can select any puzzle you have already completed.
  97.   In Random mode, you can select the difficulty of a new puzzle.  Keep
  98.   in mind that when you select a new level, your current puzzle will be
  99.   lost.
  100.  
  101. Restart: Restart the current puzzle
  102.   
  103.   Same as pressing the restart button, restarts the puzzle to what it
  104.   was when you first got it.  In Edit Mode (edit), this clears the screen.
  105.  
  106. Reset: Reset progress in Puzzle mode
  107.  
  108.   After a confirmation, this will reset you back to Puzzle #1 in Puzzle
  109.   Mode.
  110.  
  111. Mode Menu
  112. ---------
  113.  
  114. Puzzle: Selects Puzzle Mode
  115.  
  116.   Selects the Puzzle Mode.  You will lose your current Puzzle.
  117.  
  118. Random: Selects Random Mode
  119.  
  120.   Selects the Random Mode.  You will lose your current Puzzle.
  121.  
  122. Edit: Selects Edit Mode
  123.  
  124.   Selects the Edit Mode.  You will lose your current Puzzle.  For more
  125.   information on Edit Mode, see section 7.
  126.  
  127. Help Menu
  128. ---------
  129.  
  130. Hint: Same as pressing the hint button.
  131.  
  132. Solve: Solve the current puzzle.
  133.  
  134.   The last resort of the truly frustrated.  This button will display
  135.   the solution on top of the current puzzle.  To solve it, hit all
  136.   of the buttons marked with an "x" in any order.
  137.  
  138. About: Display version info.
  139.  
  140. ****************************************
  141. 4. Differences from the toy
  142. ****************************************
  143. 1) There is a solve feature.
  144.  
  145. 2) Random puzzles can be selected at any level at any time.  In the
  146.    toy, you can only select a random level of difficulty no harder
  147.    that the current level you are on in the Puzzle mode.
  148.  
  149. 3) Random puzzles of difficulty 14 and 15 take much longer to figure out.
  150.  
  151. 4) Levels in Edit mode keep track of moves and have a minimum.  In the 
  152.    handheld, you could take as long as you liked.
  153.  
  154. 5) Progress in current puzzle is saved when pilot it turned off.  The
  155.    toy only saves progress from puzzle to puzzle.
  156.  
  157. 6) Easier interface.
  158.  
  159. ****************************************
  160. 5. Version History
  161. ****************************************
  162.  
  163. v1.1 Nov 9, 1999
  164. -------------------
  165. Added Edit Mode, re-added Random Levels 14 and 15, with a spinning status
  166. indicator in the lower-left corner.  Fixed a bug that was causing Random
  167. Mode to take much longer than necessary to find a suitable level and was
  168. not working quite right anyway.  This version completes my vision of the
  169. game, and all further releases will most likely be bug-fixes.
  170.  
  171. v1.0.3 Nov 2, 1999
  172. -------------------
  173. Fixed bug caused by 1.0.2 fix that caused no progress to be saved.
  174. Silly me.
  175.  
  176. v1.0.2 May 10, 1999
  177. -------------------
  178. Fixed bug where solving level 50 would go to nonexistant level 51 instead
  179. of back to level 50.  (In the future, to more properly mirror the function
  180. of the original, it should sit at a cross pattern with none of the buttons
  181. doing anything, until a new game is selected, but this was a quick fix.)
  182.  
  183. v1.0.1 Mar 2, 1999
  184. -------------------
  185. Fixed bug in help code that didn't press the buttons correctly for you, and
  186. didn't flash correctly.
  187.  
  188. v1.0   Jan 19, 1999
  189. -------------------
  190. Everything.
  191.  
  192. ****************************************
  193. 6. What's planned for the future
  194. ****************************************
  195.  
  196. * Better random puzzle selection process
  197. * My next game
  198.  
  199. ****************************************
  200. 7. Edit Mode
  201. ****************************************
  202.  
  203. This new mode, introduced in version 1.1, completes the functionality of the
  204. orignal hand-held.  When Edit mode is first selected, you are in Edit Mode
  205. (edit).  The Moves Made indicator is replaced with "-Edit-" and now, button
  206. presses do not have the normal effect, they instead only turn the clicked
  207. button on or off.  You are now editing the level that you wish to play.
  208. If you press the reset button, or select "Reset" from the menu, the current
  209. level will be cleared so you can start editing over.
  210.  
  211. When you are ready to attempt the level you currently have, hit the "P/E"
  212. button in the lower right corner. (It has replaced the Hint button)  You will
  213. now switch to Edit Mode (play).  If the level that you have constructed has
  214. no solution, however, the program will pop up a dialog informing you of this.
  215. You may still play the level, of course, but you will never be able to solve
  216. it.
  217.  
  218. If the level does have a solution, the Minimum Number of moves is displayed 
  219. on the right, and the level continues as normal.
  220.  
  221. If you press the "P/E" button again, you will go back to Play Mode (edit).
  222.  
  223. ****************************************
  224. 8. Technical Notes
  225. ****************************************
  226.  
  227. * Lights Out stores its data entirely in the Preferences, using up almost all
  228.   of its entitled share.
  229.  
  230. * The solve feature uses an iterative algorithm that finds the best possible
  231.   solution after trying all possibilities. It's O(1), because it always tries
  232.   everything.  It never should take any noticable amount of time.
  233.  
  234. * This was compiled using the GCC cross compiler and Palm's Header Files.  It
  235.   was compiled with OS 2 in mind... it works in OS 3, but has not been tested
  236.   in OS 1.
  237.  
  238. ****************************************
  239. 9. Philosophy of Lights Out
  240. ****************************************
  241.  
  242. As you may have inferred from the solve feature, in any given puzzle
  243. in Lights Out, it does not matter in which order you press the
  244. buttons, only which buttons you press. In most cases, if you press a
  245. certain pattern of buttons, the easiest solution is to press all of
  246. those buttons again.  This isn't always the case, which is why the 14
  247. and 15 difficulty puzzles took too long to figure.  It had to find a
  248. puzzle which didn't have a shorter solution.  I'm curious to know how
  249. the handheld figures this out...
  250.  
  251. This was the first Lights Out toy.  There are two sequels, Lights Out
  252. Cube, where the lights are on a cube, and the switching effects wrap
  253. around the cube, and Lights Out Deluxe, with a 6x6 grid and a whole
  254. lot of other options.  The same solution algorithm can be applied to
  255. LOD in most of its modes, but not the cube.  I'm still trying to
  256. figure it out.
  257.  
  258. ****************************************
  259. 10. Contacting the Author
  260. ****************************************
  261.  
  262. My email is ascheffl@hamusutaa.com and I appreciate any sort of bug-reports,
  263. compliments, suggestions etc.
  264.  
  265. You can find the most recent version at:
  266.  
  267. http://www.hamusutaa.com/pilot/lightsout.html
  268.  
  269. ****************************************
  270.  
  271. This document, as well as the source code for Lights Out, was edited in
  272. GNU Emacs.
  273.  
  274. v1.1   11/09/99