home *** CD-ROM | disk | FTP | other *** search
/ The Best of Select: Games 4 / CD_1.iso / games / tmatch11 / tilemakr.doc < prev    next >
Text File  |  1993-09-16  |  16KB  |  351 lines

  1.  
  2.                              Tile Maker Utility
  3.                       Version 2.02  September 17, 1993
  4.                     For use with Mah Jongg or Tile Match
  5.  
  6.                                 Nels Anderson
  7.                                92 Bishop Drive
  8.                           Framingham, MA 01701-6515
  9.                                     U.S.A.
  10.  
  11.  
  12.  
  13. USING TILE MAKER
  14.  
  15. The Tile Maker utility allows you to make your own sets of tiles or
  16. modify sets made by others. These tiles can be used with my two
  17. solitaire games, Mah Jongg and Tile Match.
  18.  
  19. The utility is similar to many paint programs with which you might be
  20. familiar, though because of its specialized nature it includes less
  21. functions. Tile Maker can be controlled with your mouse or keyboard
  22. and requires EGA or VGA graphics.
  23.  
  24. The best thing to do is get Tile Maker running and experiment.
  25. You'll find designing good tiles is quite a challenge, but it will
  26. allow you to have your own personalized version of the game when
  27. you're done.
  28.  
  29. You might want to look at other already completed tile sets to see
  30. some of the techniques used. Because the drawing area is so small
  31. you often have to trick the eye to get the effect you want. One
  32. thing to avoid is changing the sloping sides of the tiles. Generally
  33. this will ruin the 3D effect and simply doesn't look good when tiles
  34. are stacked up.
  35.  
  36. HOW TILES ARE STORED ON DISK
  37.  
  38. First, some basics about working with tile sets. A Mah Jongg tile
  39. set includes 42 different tiles. Eight of them are in the "wild
  40. card" suits (normally the flowers and seasons suits) where any tile
  41. in the suit matches any other. The other 34 tiles use the standard
  42. matching rule where there are four of each tile on the board and the
  43. tiles must be matched exactly to be removed. You'll want to keep the
  44. game rules in mind when designing your tiles.
  45.  
  46. Tile Match only needs 36 tiles. Tiles 1 through 34 are used plus
  47. tiles 35 and 39.
  48.  
  49. All 42 tiles are stored in a single disk file. You'll need to know
  50. how the tiles are numbered so that you store your new tiles in the
  51. proper place. For reference, the standard tile set ("MAHJONGG.TIL")
  52. is numbered as follows:
  53.  
  54.             Tiles 1 - 9:  suit of dots
  55.                 Tile 10:  white dragon
  56.           Tiles 11 - 19:  suit of bamboo
  57.                 Tile 20:  green dragon
  58.           Tiles 21 - 29:  suit of characters
  59.                 Tile 30:  red dragon
  60.           Tiles 31 - 34:  suit of winds
  61.           Tiles 35 - 38:  suit of seasons
  62.           Tiles 39 - 42:  suit of flowers
  63.  
  64. GETTING STARTED
  65.  
  66. Start up "TILEMAKR.EXE" by typing "tilemakr" on the command line.
  67. There are no command line options, but you can include the name of a
  68. tile set file on the command line and that tile set will be
  69. immediately loaded once Tile Maker starts up. Note the drawing area
  70. on the left and the tile set display on the right. If you did not
  71. include a tile set name on the command line the tile set displayed
  72. will be blank, but as soon as you read in a tile set it will be shown.
  73.  
  74. Along the top of the screen are a series of menus you can select. If
  75. you're using a mouse you just need to point to the word you want and
  76. click. If using the keyboard you can use the functions keys (each
  77. menu is numbered sequentially so Help is F1, Info is F2, etc.). You
  78. can also select menus by holding down the Alt key while also hitting
  79. the first letter of the menu name; for example, you'd hit Alt-F to
  80. open the File menu.
  81.  
  82. DRAWING
  83.  
  84. Normal drawing can be done with the keyboard or mouse. Using the
  85. mouse, select the desired color by pointing at the color chart and
  86. clicking. Then to draw just point at the drawing area and click on
  87. each spot where you want to draw.
  88.  
  89. Because it's common to switch back and forth between two colors, Tile
  90. Maker remembers the last color you've selected as well as the current
  91. one. Use the right mouse button at any time to toggle back and forth
  92. between the current and previous drawing color.
  93.  
  94. If you're drawing with a mouse there are a few basic drawing shapes
  95. available in addition to the simple dot. Under the drawing area is a
  96. set of push buttons where you can select dots, line, circle,
  97. rectangle, filled circle or box. Click on the desired button and
  98. you'll see it push in to confirm proper selection.
  99.  
  100. When using the line or rectangles, move the mouse cursor to one end
  101. (corner) and hold down the mouse button. Then move to the other end
  102. (corner) and release the button. When using the circles you start in
  103. the center and pull away until the circle is the desired size. You
  104. can pull in any direction since the circle is symmetrical.
  105.  
  106. The seventh drawing tool is a special one. It allows you to outline
  107. an area and then change all pixels within that area that are a
  108. specific color into a different color. Select this tool and then
  109. outline a rectangle just as you would with the rectangle drawing
  110. tool. When the area you want is outlined, release the mouse button.
  111. You'll be prompted to select the color you want to change; point
  112. anywhere you want on the screen and click when pointing to the
  113. desired color. Then you'll be prompted for the color you want to
  114. change to; again you can point anywhere on the screen and click. Now
  115. the selected color will change.
  116.  
  117. The eighth function is fill. Using this function you can fill in an
  118. area of any shape with the currently selected color. When you select
  119. fill the cursor will change to the word "FILL" with a little target
  120. to the upper left. Position the target in the area you want filled
  121. and click to fill. Using the keyboard you can fill by moving the
  122. keyboard cursor within the area to be filled and hitting the Z key.
  123.  
  124. The ninth function is text entry. Because of the small size of the
  125. tiles only one simple font is used. Characters are five pixels high.
  126. Several different widths are available and Tile Maker will try to use
  127. the widest characters possible given the space available. Depending
  128. on whether you have border set on or off (from the Options menu) the
  129. letters may go right to the edge of the tile face or a one pixel
  130. border will be enforced.
  131.  
  132. To enter text, position the mouse to the upper left corner of where
  133. the text should start (if using the keyboard, use the arrow keys to
  134. position the keyboard cursor and then hit the L key). You'll then be
  135. prompted to enter the text you want. Lower case letters are not
  136. available but capital letters and most other characters can be used.
  137. If the text you enter is too much to fit in the available space
  138. you'll be told how many pixels too wide it is and you can then adjust
  139. accordingly.
  140.  
  141. When within the drawing area, the mouse cursor snaps to the center of
  142. each pixel when moving around or drawing dots, lines or rectangles.
  143. If you prefer that the cursor move smoothly you can turn off the snap
  144. function by using Snap Cursor on/off under the Options menu. For most
  145. drawing you'll probably find the snap cursor useful as you'll be able
  146. to more clearly tell what pixel is being pointed to.
  147.  
  148. Drawing with the keyboard requires typing the letter or number of the
  149. desired color, then moving the cursor around with the arrow keys and
  150. finally hitting space when you want to draw a dot. If you hold down
  151. the space bar a line of dots will be drawn in the direction of the
  152. last arrow key used.
  153.  
  154. When drawing the position of the mouse cursor is shown just below the
  155. color selection area. If you wish to see the position of the keyboard
  156. cursor instead, just move the mouse cursor outside the drawing area
  157. and move the keyboard cursor with the arrow keys.
  158.  
  159. MENUS
  160.  
  161. All functions have keyboard shortcuts that are shown in parentheses
  162. after the name of the function. You can use these keys to access
  163. functions directly without going through the menus. A list of all
  164. keyboard shortcuts is at the end of this document.
  165.  
  166. If using a mouse you just point to the function you want and click.
  167. If using the keyboard you can select menus using the function keys or
  168. the Alt key plus the first letter of the menu name. Within the menus
  169. you can select functions by number or by using the arrow keys to move
  170. to the function you want and the Enter key to select it.
  171.  
  172. Most of the functions available from the menu are pretty
  173. self-explanatory, but let's cover each menu and function in detail.
  174.  
  175. HELP
  176.  
  177. Under the help function is an abbreviated set of instructions for
  178. using Tile Maker. To move from one help screen to another click on
  179. the Next or Prev (previous) box. To quit help click on the Quit box.
  180. You can also use the letters shown in red for next, quit or previous.
  181.  
  182. FILE MENU
  183.  
  184. This is the menu used for all disk access. The first choice allows
  185. you to clear any current drawing and start a new tile. You'll be
  186. prompted to make sure you mean to do this.
  187.  
  188. Save Tile allows you to save your work into a tile set file. You'll
  189. first be prompted for the name of the file that your tile should
  190. become part of. If the file you choose is different from the last
  191. one you read in, the new file will be read in and displayed on the
  192. right side of the screen. Finally, you must choose what position
  193. your tile will take. If you're editing an existing tile and just
  194. want to put it back in the same position you just need to click on
  195. OK. Otherwise you can either enter the new position number from the
  196. keyboard or you can point and click on the tile on the right side of
  197. the screen you wish to replace.
  198.  
  199. Read Tile Set allows you to read tiles from the disk. The entire
  200. tile set is always loaded and displayed on the right side of the
  201. screen. If the set does not contain all 42 tiles blanks will be
  202. shown at some positions.
  203.  
  204. The Load Tile function is only needed if you don't have a mouse. It
  205. allows you to transfer a single tile from the tile set shown on the
  206. right side of the screen into the editor. When prompted enter either
  207. the number of the tile you want to edit or hit the Esc key to abort.
  208.  
  209. Import .PCX Picture gives you a limited ability to load tile faces
  210. from PCX drawings, such as you might create with a full-featured
  211. paint program or with a scanner. The PCX pictures must be in 640x350
  212. pixel size and use a 16 color EGA palette.
  213.  
  214. When you select import .PCX picture, the normal file selection box
  215. will pop up and you should select the PCX file you want. The picture
  216. will load and a square cursor will appear. Use the cursor to
  217. surround the portion of the picture you want (the square is exactly
  218. the size of a tile face) and click. You'll be switched back to the
  219. editing screen with the PCX image now on the tile face. If you're
  220. using the keyboard you can use the arrow keys to move the cursor
  221. around and the Enter key to select. Hit Esc to abort.
  222.  
  223. When you're done with your tile set, use the add name function. The
  224. name you enter will be displayed at the bottom of the screen when
  225. playing Mah Jongg or in the Info screen when playing Tile Match. The
  226. name for the currently loaded tile set is also shown at the right
  227. bottom of the Tile Maker screen.
  228.  
  229. At some point you may wish to rearrange the order of the tiles in the
  230. set. You can use the swap two tiles function to swap the positions
  231. of any two tiles in the currently displayed set. When prompted,
  232. select each of the tiles that you want swapped either by entering the
  233. tile number or by using the mouse to point and click. If you change
  234. your mind hit the Esc key or select "No" when asked to confirm.
  235.  
  236. EDIT MENU
  237.  
  238. This menu allows you to do special editing functions on the current
  239. tile. These functions are described below.
  240.  
  241. The flip functions let you reverse the image left/right or
  242. top/bottom. Hitting the same function a second time will flip the
  243. image back the way it originally was.
  244.  
  245. The rotate function rotates the image clock-wise around its center.
  246. Four consecutive rotates puts the image back the way it originally
  247. was.
  248.  
  249. The shift functions move the image in the specified direction by one
  250. pixel. This is handy if you, for example, want to center an image.
  251.  
  252. The final function on the edit menu is undo. Using this will restore
  253. the tile as it was before the most recent change. The image that
  254. will be restored is shown along the left side of the screen directly
  255. below the current image. You can also undo by clicking directly on
  256. this previous image, or on any other image that is below it. Up to
  257. three previous images are kept along the left side of the screen.
  258.  
  259. OPTIONS MENU
  260.  
  261. This menu allows you to select options that affect how other
  262. functions work. Each option can be toggled on or off. If an option
  263. is currently on a check mark will be shown to the right of the option
  264. name.
  265.  
  266. When Tile Maker starts up it is set with snap cursor on. In this
  267. mode the mouse cursor jumps to the center of each pixel when in the
  268. drawing area, which ensures that you know exactly what pixel you're
  269. drawing. If you prefer you can turn this mode off and the cursor
  270. will then move smoothly.
  271.  
  272. When entering text using the text tool you have a choice on how close
  273. to the edge the text will be entered. Text usually looks best if
  274. there is a border around it at the edge of the tile face. However,
  275. if you have a long word that you wish to display you might want to
  276. disable this border to make the text fit. Try entering text first
  277. with the border enabled, but if you only need one or two more pixels
  278. to make it fit you can turn the border off and try again.
  279.  
  280. When drawing with the dot tool (freehand drawing) you can have your
  281. drawing mirrored left to right, top to bottom, or both. Toggle the
  282. appropriate mirror settings on and off to fit your needs.
  283.  
  284. Share Your Creations!
  285.  
  286. If you develop any tile sets you'd like to share please upload them
  287. to the support BBS (Xevious: 508-875-3618) or mail them to the author
  288. on a diskette. I'd suggest that you include a text file describing
  289. your tile set and of course you should include your name in it. I'm
  290. looking forward to seeing what you come up with!
  291.  
  292. KEYBOARD SHORTCUTS
  293.  
  294. All Tile Maker functions can be accessed from the keyboard. Below is
  295. the complete list of keys and their function.
  296.  
  297.                    Key  Function
  298.           ------------  ------------------------------------
  299.            F1 or Alt-H  Help
  300.            F2 or Alt-I  Info
  301.            F3 or Alt-F  File Menu
  302.            F4 or Alt-E  Edit Menu
  303.            F5 or Alt-O  Options Menu
  304.           F10 or Alt-Q  Quit (exit Tile Maker)
  305.  
  306.                      X  New (clear tile)
  307.                      S  Save Tile
  308.                      R  Read Tile Set
  309.                  Alt-L  Load Tile Into Editor
  310.                      P  Import .PCX Picture
  311.                      N  Add Name To File
  312.                  Alt-S  Swap Two Tiles
  313.                      Q  Quit (exit Tile Maker)
  314.  
  315.                      <  Flip left to right
  316.                      >  Flip top to bottom
  317.                      @  Rotate clock-wise
  318.                      -  Shift Right
  319.                      +  Shift Left
  320.                      ^  Shift Up
  321.                      |  Shift Down
  322.                      U  Undo
  323.                      L  Use the letter function (enter text)
  324.                      Z  Use the fill function
  325.  
  326.                      #  Snap Cursor on/off
  327.                      T  Text Border on/off
  328.                      M  Mirroring left/right on/off
  329.                  Alt-M  Mirroring top/bottom on/off
  330.  
  331.                      0  Drawing color is black
  332.                      1  Drawing color is blue
  333.                      2  Drawing color is green
  334.                      3  Drawing color is cyan
  335.                      4  Drawing color is red
  336.                      5  Drawing color is magenta
  337.                      6  Drawing color is brown
  338.                      7  Drawing color is light gray
  339.                      8  Drawing color is dark gray
  340.                      9  Drawing color is light blue
  341.                      A  Drawing color is light green
  342.                      B  Drawing color is light cyan
  343.                      C  Drawing color is light red
  344.                      D  Drawing color is light magenta
  345.                      E  Drawing color is yellow
  346.                      F  Drawing color is white
  347.        
  348.                                   - - - - -
  349.  
  350.    Tile Maker is copyright 1993 by Nels Anderson.  All rights reserved.
  351.