home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff362.lzh / PUZZ / read.me < prev    next >
Text File  |  1990-08-11  |  6KB  |  192 lines
  1. 27-Jan-1990               PUZZ 1.0
  2.                           ========
  3.  
  4. Have you ever played with one of those little plastic '15'
  5. puzzles; the ones that have 15 sliding tiles arranged in a
  6. four by four grid, with the sixteenth square missing?
  7.  
  8. '15 puzzles' are only the most basic of the sliding block
  9. family of puzzles.  The more difficult puzzles have pieces
  10. of different sizes, 'L' shaped pieces and so on.  Some of
  11. them take many hours to solve, and require hundreds of
  12. moves to finish.
  13.  
  14. PUZZ brings sliding block puzzles to your Amiga.
  15.  
  16. There are already many block puzzles for the Amiga, and
  17. some of them (e.g. 'GOLD' by David Cole) are very good.
  18. The difference with PUZZ, is that it is not just one
  19. puzzle, rather it is a puzzle system, which can run an
  20. infinite number of different puzzles.
  21.  
  22. Some puzzles, for use with PUZZ, are included in this
  23. archive.  '15.puzzle' is easy, and you should try this one
  24. to get used to PUZZ.  From the Workbench, click on the
  25. 15.puzzle icon,  or from the CLI use the command:
  26.  
  27. PUZZ 15.puzzle
  28.  
  29. When you've finished 15.puzzle, have a go at rabbit.puzzle
  30. or some of the others.
  31.  
  32. I intend to construct many more puzzles for use with PUZZ,
  33. so keep a look out for them on your local bulletin board.
  34. Some of them will be fiendishly difficult!
  35.  
  36. It is also very easy to make your own puzzles.  First, you
  37. use a paint package, such as Deluxe Paint, to draw the
  38. puzzle.  Then, you write a small text file, which specifies
  39. the number of blocks in the puzzle, and their position etc.
  40. You join the two together, and Bingo! a new puzzle.
  41.  
  42. If you want to make your own puzzles, the format of the
  43. text file is specified at the end of this read.me file.
  44.  
  45. If you do make any good puzzles, please upload them onto
  46. bulletin boards for the benefit of others, or send them to
  47. me on a disk.
  48.  
  49. If you like PUZZ, and use it for more than a few hours,
  50. perhaps you would consider sending me a donation?  If you
  51. also send me a disk, with reply-paid packaging, I will send
  52. you the latest version off PUZZ, and a disk full of puzzles
  53. and other programs I've written.  I will include the source
  54. code (C) for some programs if you ask for it.
  55.  
  56. Please feel free to distibute PUZZ to your friends, post it
  57. on bulletin boards etc.  The only restrictions are these:-
  58.  
  59. 1.  This document must be distributed with the program.
  60.  
  61. 2.  Nobody should make a profit by distributing PUZZ. A
  62.     small charge to cover administration is O.K.
  63.  
  64. 3.  On NO account must PUZZ be distributed by Amiga Format
  65.     Magazine, or any of their employees or associates.
  66.     The reason I impose this restriction, is that I once
  67.     sent a disk to Amiga Format, complete with reply paid
  68.     envelope etc.  Despite writing to them four times over
  69.     a four month period, they have never returned my disk,
  70.     nor even acknowledged my letters.
  71.  
  72.  
  73. How to create your own puzzle
  74. =============================
  75.  
  76. Draw your puzzle and save it in ILBM format (most paint
  77. packages do this anyway).  The picture can be any size,
  78. and you can use Hold-and-Modify paint programs if you wish.
  79. Let's assume you've saved the picture as 'puzzle.pic'.
  80.  
  81. Use a text editor, such as MEmacs or whatever to create
  82. a small text file.  The format is as follows:-
  83.  
  84. PUZZ 1.0
  85. Make the blocks read 'RATE;
  86. YOUR MIND PAL'.  To move  ;
  87. a block, point at it, and ;     Instructions:
  88. click left mouse button.  ;     6 lines of 26 characters
  89.                           ;
  90. Clue: Swap 4 blocks not 2.;
  91. 4
  92. 4
  93.  1, 9, 3, 4
  94.  5, 6, 7, 4
  95.  8,13,11, 0
  96. 12,14,2,10
  97.  1, 2, 3, 4
  98.  5, 6, 7, 4
  99.  8, 9,10,11
  100. 12,13,14,0
  101. 21
  102. 22
  103. 40
  104. 40
  105. 2
  106. 14
  107. 2
  108. 31
  109. 0
  110. **ILBM**;   last line of file.
  111.  
  112. You can append comments to any line of the file, by
  113. preceding them with a semi colon.
  114.  
  115. The FIRST line of the file must read  PUZZ 1.0
  116. 1.0 is the minimum required version of PUZZ to run the
  117. puzzle.  This is for future compatability.
  118.  
  119. Next follows six lines of puzzle instuctions.
  120.  
  121. The following two lines specify the width and height of
  122. the puzzle in blocks (i.e. 4 * 4 for the 15.puzzle).
  123.  
  124. Next follows <height> lines of starting position (in this
  125. example height is 4.  Each line must contain <width> items,
  126. seperated by commas.  Use 0 for any empty squares.  Use
  127. 255 for any squares that can never be moved.
  128.  
  129. Similarly the next <height> lines are the required
  130. finishing position.  Use zeros for any "don't care"
  131. positions.
  132.  
  133. The next two lines specify the X and Y coordinates of the
  134. top left hand corner, of the top left hand square.  The
  135. units for these values are pixels.
  136.  
  137. The following two lines give a squares width and height in
  138. pixels.
  139.  
  140. The next line controls how blocks slide.  '0' makes blocks
  141. move just one square.  '1' keeps them sliding till they
  142. can't move any further.  '2' allows several blocks to be
  143. pushed along with a single move.
  144.  
  145. The next four lines control how and where the number of
  146. moves is displayed.  The order is X, Y, Pen colour, Paper
  147. colour.  If X and Y are zero, the score is not displayed.
  148.  
  149. The last line of the file must read **ILBM** (optionaly
  150. with a comment).  When you type in the last line, press
  151. carriage return, to terminate it, but make sure you don't
  152. have any blank lines trailing after the **ILBM**.
  153.  
  154. Let's assume you've saved the text file as 'puzzle.text'.
  155.  
  156. Now join the .text and the .pic files together, to create
  157. the .puzzle file.  You can use the AmigaDos 'Join' command
  158. for this.  For example, to create 'my.puzzle':
  159.  
  160. join puzzle.text puzzle.pic as my.puzzle
  161.  
  162. Now you are ready to try the puzzle!:
  163.  
  164. PUZZ my.puzzle
  165.  
  166. You can knock up an icon for your puzzle if you want to run
  167. it from the workbench.  Use 'Info' to make PUZZ the default
  168. tool for the icon.
  169.  
  170. Good luck and happy PUZZleing!
  171.  
  172.  
  173. Martin Round.
  174.  
  175. 17, Naseby Drive,
  176. Halesowen,
  177. West Mids.
  178. B63 1HJ
  179. England.
  180.  
  181.  
  182. You can contact me on the following British Amiga Bulletin
  183. boards:-
  184.  
  185. Plug 'Ole       021-472-0256
  186. AMLINK          021-778-5868
  187. MABBS           021-444-8972
  188. Short Circuit   0273-462967
  189. MAX             0905-754127
  190.  
  191. That's all folks!
  192.