home *** CD-ROM | disk | FTP | other *** search
/ Game Killer / Game_Killer.bin / 216.MJVGA22.DOC < prev    next >
Text File  |  1990-05-10  |  37KB  |  1,100 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                     Mah Jongg
  19.                          -V-G-A-
  20.                                    Version 2.2
  21.                                    June,  1990
  22.  
  23.  
  24.                       Program and Documentation
  25.                          Copyright 1988 - 1990  Ron Balewski
  26.  
  27.  
  28.  
  29.  
  30. Mah Jongg -V-G-A- is a User-Supported (Shareware) prooduct.  It is
  31. freely available through User's Groups, Bulletin Boards, etc.  You have
  32. the opportunity to try the game and see if it suits your needs.  If you
  33. find that you enjoy and use this game, please send the requested
  34. contribution of $15.00 to:
  35.  
  36.      Ron Balewski
  37.      412 E. Ridge St.
  38.      Nanticoke, PA  18634-2915
  39.  
  40.  
  41. User-supported shareware can exist only as long as you, the users, will
  42. support it!
  43.  
  44.  
  45.  
  46.  
  47. TABLE OF CONTENTS:
  48. -------------------
  49.  
  50.         FORWARD: A Message to v1.1 users ....... 3
  51.         WHAT IS MAH JONG -V-G-A- ............... 4
  52.     HARDWARE REQUIREMENTS .................. 4
  53.  
  54.     THE GAME OF MAH JONGG .................. 5
  55.          The Tiles ......................... 5
  56.          The Suits ......................... 5
  57.          The Game Board .................... 5
  58.          Playing Mah Jongg ................. 6
  59.          Strategy .......................... 6
  60.  
  61.     PLAYING MAH JONGG -V-G-A- .............. 7
  62.          The Basics ........................ 7
  63.          The Added Features ................ 8
  64.                   Special ...................... 8
  65.                   Messages ..................... 8
  66.                   Restore ...................... 8
  67.                   Quit ......................... 8
  68.                   New Game ..................... 8
  69.                   Save ......................... 9
  70.                   What's Left .................. 9
  71.                   Back-up ...................... 9
  72.                   Help ......................... 9
  73.                   Turning Off the Menu .........11
  74.  
  75.              The Special Sub-Menu ............. 12
  76.                   Background .................. 12
  77.                   Info... ..................... 12
  78.                   DOS Shell ................... 12
  79.                   Sound ....................... 13
  80.                   Timer ....................... 13
  81.  
  82.              Keyboard Commands ................ 13
  83.                   Load Tile Set ............... 13
  84.                   Box Cursor Toggle ........... 13
  85.                   Hall of Fame ................ 14
  86.                   Book-Marks .................. 14
  87.  
  88.              Command Line Options ............. 14
  89.  
  90.         IN CASE OF DIFFICULTY ................. 15
  91.         TECHNICAL SUPPORT ..................... 15
  92.         WHAT'S NEXT ........................... 16
  93.         SHARWEWARE ............................ 17
  94.         DISCLAIMER ............................ 17
  95.         PERMISSION TO COPY .................... 17
  96.  
  97.         Appendix A:  The Files ................ 18
  98.  
  99. Special thanks to Warren Storosko for his valuable assistance with
  100. this project.  Many of Mah Jongg -V-G-A-'s special features are a
  101. direct result of his helpful suggestions.
  102.  
  103. Thanks, also, Rick & Jami Chism for "beta testing" MJVGA.
  104.                             -  Page 2  -
  105.  
  106.  
  107.  
  108.  
  109.  
  110.                                FORWARD
  111.  
  112.                     A message to current users
  113.  
  114.  
  115.      With this release, I've deleted the NEW.V20 and NEW.V21 files.
  116. There is a new NEW.V22 file, though, which outlines what's been added to
  117. this release.  If you're using MJVGA21, you'll just have to read this
  118. file.  If you're using something earlier, you should at least browse
  119. through this entire manual.
  120.  
  121.      I'd once again like to thank those who have registered the various
  122. versions of MJVGA (this is the fourth release already!).  Your constant
  123. support and encouragement is what keeps me working on MJVGA.
  124.  
  125.      I'd now like your opinion on something.  Many shareware authors
  126. offer for sale to their users a laser-printed, bound version of their
  127. manual.  Since most future updates to MJVGA will be simply to make
  128. what's there a bit better (there probably aren't many new features to
  129. add), this may be a good time for me to introduce such a book.  I'd sell
  130. it only to registered users for whatever printing, binding, and shiping
  131. charges would be.  The master would be done on a laser or ink-jet
  132. printer at 300 DPI, then high-quality copies would be made for
  133. distribution.  I'd probably have it bound with one of those plastic
  134. binders resembling a spiral-bound notebook.  The cover would be whatever
  135. price would allow -- hopefully at least clear plastic with a nice cover
  136. page beneath it.
  137.  
  138.      Before I go through this much trouble, though, I'd like to know if
  139. anyone would want one.  I'd also like your opinions on the printing &
  140. binding method, book size (standard 8.5 x 11 or something different),
  141. and how much you'd be willing to pay for it.  If it'd cost more than
  142. most people would pay, it'd be a wasted effort.  Likewise, if you're
  143. willing to pay a few dollars more, I may be able to put together
  144. something a bit nicer.
  145.  
  146.      Some other thoughts -- How about personalizing it?  Or including a
  147. message to someone & a bound-in floppy disk holder so you can give a
  148. personalized registered version of Mah Jongg -V-G-A-to someone as a
  149. present?  All thoughts and ideas are welcome!
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.                                   - Page 3 -
  167.  
  168.  
  169.  
  170.  
  171.  
  172. WHAT IS MAH JONG -V-G-A-?
  173.  
  174.      Mah Jongg -V-G-A- is a high-tech simulation of the ancient Chinese
  175. game of Mah Jongg.  Some historians date Mah Jongg back to the time of
  176. Confucius -- over 25 centuries ago!
  177.  
  178.      It's believed that sailors and fishermen played Mah Jongg as a
  179. diversion from the monotony of their long voyages.  The game was
  180. originally played with cards, but eventually bone and bamboo tiles were
  181. substituted since these were less likely to be blown off the deck.
  182.  
  183.      Mah Jongg -V-G-A- recreates the beauty and addictive pleasure of
  184. Mah Jongg, but uses modern data processing techniques and
  185. high-resolution graphics instead of bamboo tiles.
  186.  
  187.      In an attempt to make this game as elegant and as enjoyable as
  188. possible, the author has used some of the most advanced features of
  189. today's state-of-the-art MS-DOS computers.  Not all PC computers are
  190. able to run Mah Jongg -V-G-A-.  But if yours can, prepare yourself for
  191. the meeting of the past and future!!!
  192.  
  193.  
  194. WHAT DO I NEED?
  195.  
  196.      Mah Jongg -V-G-A- will run on properly-equipped PC's and
  197. compatibles with 512k of memory.  It should run with less, but I don't
  198. know the exact lower limit.
  199.  
  200.      A VGA graphics card and a Logitech-compatible mouse are also
  201. required.  Certain convenience features require a three-button mouse.
  202. However, the game can be played with a Microsoft-compatible two-button
  203. mouse.
  204.  
  205.      I also recommend a secondary monochrome monitor.  Mah Jongg -V-G-A-
  206. will use both the VGA and the monochrome monitors simultaneously to
  207. display the game board and statistics.  While you don't NEED the
  208. monochrome display, I find it to be a useful part of the game.
  209.  
  210.      A fast processor isn't really necessary.  While a fast machine and
  211. a fast graphics card will speed up tile removal somewhat, the game plays
  212. just fine on a standard turbo XT.
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.                                     -  Page 4 -
  229.  
  230.  
  231.  
  232.  
  233.  
  234. THE GAME OF MAH JONGG
  235. ---------------------
  236.  
  237. THE TILES
  238.  
  239.      There are 42 different tiles used in Mah Jongg as follows:  27 Suit
  240. tiles (nine tiles in each of three suits), 3 Dragons, 4 Winds, 4
  241. Seasons, and 4 Flowers.
  242.  
  243.  
  244. THE SUITS
  245.  
  246.      The Suit Of Dots - This suit goes back to the original sailor's
  247. version of Mah Jongg.  The dots probably represent money.
  248.  
  249.      The Suit Of Bam - Bam stands for Bamboo.  Because bamboo was used
  250. to make deadly spears, this suit is thought to represent power or
  251. victory.
  252.  
  253.      The Suit Of Crak - These are also called Characters or Actors.
  254. Crak may represent actual people or may simply be characters from the
  255. Chinese alphabet.
  256.  
  257.      The Dragons - In the Ancient Mah Jongg, each suit was associated
  258. with a Dragon as follows:
  259.  
  260.            White dragons - Suit Of Dots
  261.            Red Dragons   - Suit Of Bam
  262.            Green Dragons - Suit Of Crak
  263.  
  264. This association has no direct bearing on the current play of the game.
  265.  
  266.      The Winds - These tiles simply represent the four directions of the
  267. winds -- North, South, East, and West.
  268.  
  269.      The Flowers - The four flowers - Orchid, Plum, Mum, and Bamboo -
  270. were introduced by a medieval princess to add beauty and romance to the
  271. game.
  272.  
  273.      The Seasons - This is another direct representation -- this time of
  274. the seasons - Spring, Summer, Autumn, and Winter.  It is thought that
  275. the seasons were added to Mah Jongg by river gamblers.
  276.  
  277.  
  278. THE GAME BOARD
  279.  
  280.      Each game board consists of 144 tiles made up of four of each type
  281. of tile EXCEPT for the Seasons and Flowers of which there is one each.
  282. The tiles are laid out in a formation called a Dragon.  The position of
  283. each tile in the dragon is completely random, making each dragon unique.
  284. Some are more formidable than others.  Some are actually impossible to
  285. defeat.  But all are challenging and exciting.
  286.  
  287.  
  288.  
  289.  
  290.                         - Page 5 -
  291.  
  292.  
  293.  
  294.  
  295.  
  296.      The tiles are placed in stacks ranging in height from one tile at
  297. the edge to five tiles at the center.  The easiest way to understand the
  298. dragon is to see one.  Run Mah Jongg -V-G-A-.  The dragon you'll see
  299. will be a far better explanation than I can give.
  300.  
  301.  
  302. PLAYING MAH JONGG
  303.  
  304.      The object of Mah Jongg is simple -- remove all of the tiles by
  305. matching pairs.  But there IS a catch.  Only tiles which are "free" can
  306. be removed.
  307.  
  308.      A tile is considered "free" if there's nothing on top of it and if
  309. it can slide out to the left OR right.  If tiles on both sides are
  310. stacked to the same height the tile is not "free" to be removed.
  311.  
  312.      Two tiles MUST be free and MUST be an exact match (exceptions
  313. later) before they can be removed from the dragon.  Removal of
  314. mismatched tiles and removal of un-free tiles is not allowed.
  315.  
  316.      The exception:  Since there is one each of the Seasons and the
  317. Flowers, these tiles cannot be matched identically.  So any flower can
  318. match with any other flower.  Likewise, any season can match with any
  319. other season.
  320.  
  321.  
  322. STRATEGY:
  323.  
  324.      During my countless hours of testing Mah Jongg -V-G-A-, I've found
  325. a few pieces of strategy that seem to help:
  326.  
  327. --> Concentrate on removing the four tiles which are blocking the most
  328. moves - the top tile, the single tile on the left, and the two tiles on
  329. the right.
  330.  
  331. --> Look for quadruples.  If all four of a given tile are free, remove
  332. them all immediately.  This will get them out of the way and won't cause
  333. problems later.
  334.  
  335. --> Keep an eye out for doubles (two tiles free) of tiles with only two
  336. left (the monochrome screen helps here).  These should also be removed
  337. immediately.
  338.  
  339. --> Before removing two tiles of four remaining, be sure that no OBVIOUS
  340. harm (trapped tiles) will occur.
  341.  
  342. --> Always check for triples.  If you've found a pair with four
  343. remaining, see if any more are free.  Then, take the two which will free
  344. up the most tiles.
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                         - Page 6 -
  353.  
  354.  
  355.  
  356.  
  357.  
  358. PLAYING MAH JONGG -V-G-A- 2.2
  359. -----------------------------
  360.  
  361. THE BASICS
  362.  
  363.      To start Mah Jongg -V-G-A-, just place the game disk into a drive,
  364. log onto that drive, and type MJVGA22 at the DOS prompt.  After some
  365. disk activity, the opening screen will come up.  A short time later, the
  366. title screen will fade and the dragon will be drawn.
  367.  
  368.      If you have a monochrome monitor connected to your computer, you
  369. should be sure that it's turned on.  From here on, I'll assume that
  370. you're looking at both monitors.  If you only have a VGA monitor, just
  371. ignore all references to the Monochrome.
  372.  
  373.      Tiles are removed by first selecting one, then selecting its mate.
  374. To select a tile, just point to it with the mouse and press the left
  375. mouse button.  The tile will change color (and its listing on the
  376. monochrome will be highlighted) to show that it has been selected. You
  377. don't have to double-click to remove the tiles.  When two tiles have
  378. been selected, they will (after validation) be removed.
  379.  
  380.      To de-select a tile, just click on it again.  The tile and its
  381. listing will return to normal.
  382.  
  383.      If you click on a tile which is not free, a 'Tile Not Free"
  384. meessage will appear on the left side of the screen after which the
  385. offending tile will automatically be de-selected.  Likewise, if you
  386. select two tiles wcich don't match, you'll see a "Tiles don't match"
  387. message after which both tiles will be de-selected.
  388.  
  389.      The counter at the top-left of the VGA screen (and on the right
  390. side of the monochrome screen) will show how many tiles remain in the
  391. dragon.
  392.  
  393.      This is all you really need to know to play the game.  But, there
  394. are some other features which make the play a lot more enjoyable.  The
  395. menu of features can be found in the upper right section of the VGA
  396. display.  I'll explain each of these features individually in a moment.
  397. But, to activate any one of them, just point to the desired feature with
  398. the mouse and click the left button.
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.                         -  Page 7  -
  415.  
  416.  
  417.  
  418.  
  419.  
  420. THE ADDED FEATURES
  421.  
  422.      For convenience, I'll describe the features as they appear in the
  423. menu from top to bottom, starting with Special.
  424.  
  425.  
  426.  
  427. SPECIAL
  428. =======
  429.     Selecting SPECIAL will open up a smaller sub-menu on the left
  430.         side of the VGA screen.  You shouldn't need these features too
  431.         often, but they're nice to have just in case.  I'll describe
  432.         each of these special features in detail later on.
  433.  
  434.  
  435. MESSAGES ARE ON / OFF
  436. =====================
  437.     This option controls whether or not the "Tile not free" and
  438.     Tiles do not match" messages are printed.  The messages are
  439.     initially on.  They can be toggled on / off by clicking on the
  440.         box.  When the messages are turned off, un-free tile selections
  441.         are ignored and mis-matched selections are simply reset.
  442.         Experienced players may prefer to turn off the messages to keep
  443.         mis-clicks from slowing up the game with messages.
  444.  
  445.  
  446. RESTORE
  447. =======
  448.     Restore will load a game previously saved to disk.  A window
  449.     will open and you'll be asked to type a file name.  If you hit
  450.     this button accidentally, just cancel the restore by pressing
  451.     Return without typing a file name.
  452.  
  453.  
  454. QUIT
  455. ====
  456.     Selecting Quit will clear both monitors and return you to the
  457.     DOS prompt.
  458.  
  459.  
  460. NEW GAME
  461. ========
  462.     Clicking on New Game will start a new game of Mah Jongg.  The
  463.         VGA screen will clear and the title screen will appear while the
  464.         computer shuffles the tiles.  Then, the title screen will fade
  465.         and a new dragon will be drawn.
  466.  
  467.     The New Game option can also be used to start the current game
  468.         from the very beginning without having to use the BACK-UP
  469.         command repeatedly.  To re-start the current game, just hold
  470.         down the right mouse button while clicking on the New Game
  471.         button.
  472.  
  473.  
  474.  
  475.  
  476.                                     - Page 8 -
  477.  
  478.  
  479.  
  480.  
  481.  
  482. SAVE
  483. ====
  484.     The Save command is Restore's partner.  You can save a current
  485.     game to disk for later completion by clicking here.  You'll be
  486.     asked for a file name for the game.  If you decide not to save
  487.     the game, just press Return without typing anything.  Either
  488.     way, you'll be returned to the current game.
  489.  
  490.  
  491. WHAT'S LEFT
  492. ===========
  493.     To see exactly what tiles are left in the dragon, just click
  494.     here!  The dragon will be replaced by a graphic depiction of
  495.     exactly how many of which tiles are left.  Very useful for
  496.     determining tricky moves!  To return to the game board, just
  497.     click the RIGHT mouse button.
  498.  
  499.         To quickly find out how many of one type of tile are left, just
  500.         high-light the desied tile before selecting What's Left.  A
  501.         message will appear on the left side of the screen telling
  502.         exactly how many of the selected tile are left.  Note that if
  503.         you select a Season or Flower, the total number of Seasons /
  504.         Flowers will be shown.
  505.  
  506.     Of course, monochrome users will seldom have to use this
  507.         feature.  All of this information (and much more) is constantly
  508.         displayed on the monochrome monitor.
  509.  
  510.  
  511. BACK-UP
  512. =======
  513.     Each time you click on Back-up, your last move will be taken
  514.     back.  Note that the tile(s) which are being returned to the
  515.         board will be momentarily highlighted on the monochrome screen.
  516.         This feature helps you to quickly return to "wherever I removed
  517.         those such-and-such tiles."  You can back-up all the way to the
  518.         beginning of the game, if you like.
  519.  
  520.  
  521. HELP
  522. ====
  523.         Help is really it's own little sub-function.  When you click on
  524.         help, the machine will pause for a moment (it's looking for
  525.     moves) and will then do one of two things.  If no moves are
  526.     left, you'll see a "No moves left" message on the left side of
  527.     the screen.  You're now free to start a new game or back-up to
  528.     try to correct errors in this one (I often do this).
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.                     - Page 9 -
  539.  
  540.  
  541.  
  542.  
  543.  
  544.     If one or more moves is left, the message will tell you how
  545.         many.   The tiles for the first move will be highlighted on both
  546.         monitors.  Then, a small control panel with five buttons will
  547.         appear on the left section of the VGA screen.  To leave Help,
  548.         click on Exit.  To see the next move, just click on "Next".
  549.         Click on "Previous" to display the previous move.  When you've
  550.         decided which move you'd like to take, you can execute it by
  551.         first stepping to it with the Next / Previous buttons and then
  552.         clicking on "Do It!"  The help menu will disappear and your
  553.         selected move will be executed.
  554.  
  555.         You can also "X-ray" the board to find which stacks a given type
  556.         of tile is in regardless of whether or not it's buried.  To
  557.         start an X-ray, click on "X-ray" in the help menu.  A tile will
  558.         be shown in the upper left section of the screen.  Use the
  559.         previous / next buttons to step to the tile that you want to
  560.         find.  Then, click on SHOOT to turn on the X-ray machine.
  561.  
  562.         All stacks will grow dark and begin to flicker except for the
  563.         stacks containing the chosen tile.  They will be highlighted.
  564.         You'll also notice an irritating high-pitched sound coming from
  565.         the PC's built-in X-ray machine.  It's sometimes difficult to
  566.         interpret this X-ray, depending on the tile set.
  567.         Heavily-painted tiles are impervious to X-rays and can give
  568.         false readings.  But, the readings are usually quite helpful.
  569.         And with practice, you'll get better at reading the X-ray.
  570.         After all, your family physician went to school for countless
  571.         years to learn to read them!  One last thing -- the X-ray will
  572.         tell you which stack a tile is in, but NOT how deeply it;s
  573.         buried!  If it's on top, you'll see it.  But if it's buried,
  574.         you'll just have to dig!
  575.  
  576.         To turn off the X-ray machine, just click any mouse button.  You
  577.         can then select another tile with the previous / next buttons or
  578.         return the game by clicking on Exit.
  579.  
  580.         If you high-light a tile before clicking on Help, you'll be
  581.         shown only moves which use the selected tile value.  For
  582.         example:  If you select the One of Dots and then click on Help,
  583.         all One of Dots moves will be shown.  If no moves are possible
  584.         using the selected tile, you will be so informed.
  585.  
  586.     The help system is automatically exited when you select Do It!
  587.     to keep you from playing the entire game from within the Help
  588.     menu.  After all, we've got to give the Dragon a fighting
  589.     chance!!
  590.  
  591.     Some people have told me that they like to play MJVGA on their
  592.         own without help, but would like a quick way to find out if
  593.         there are any moves left.  You can do precisely that by holding
  594.         down the right mouse button while you click on help.  All you'll
  595.         see is a message on the left side of the screen which tells you
  596.         how many moves (if any) are left.  The message will disappear
  597.         after three seconds.  You'll be on your own to find the moves!
  598.  
  599.  
  600.                                     - Page 10 -
  601.  
  602.  
  603.  
  604.  
  605.  
  606.         ATTENTION THREE-BUTTON MOUSE USERS:
  607.         This feature is for you!  When you're in the HELP sub-function,
  608.         you can step through the moves by using the center and right
  609.         mouse buttons.  Pressing the center button is just like clicking
  610.         on PREVIOUS.  The right button is a short-cut for clicking on
  611.         NEXT.  You can select EXIT by pressing the center & right
  612.         buttons at the same time.  (These Previous / Next / Exit mouse
  613.         button shortcuts will also work from within the X-ray menu.)
  614.         There is no short-cut for Do It or Shoot!  That'd make the HELP
  615.         function too convenient!
  616.  
  617.         There is also a short-cut to entering the Help menu available to
  618.         you.  Just click the center button!  If you click the center
  619.         button while holding down the right, you'll be put into the
  620.         abbreviated help mode described above.
  621.  
  622.  
  623. TURNING OFF THE MENU
  624. ====================
  625.         The entire features menu can be removed from the gameboard by
  626.         clicking on the upper "MAH JONGG -V-G-A-" title.  When the menu
  627.         is removed, all menu operations are disabled except for "HELP",
  628.         which can still be accessed via the center mouse button.  To
  629.         return the menu and restore its operations, just click in the
  630.         title area again.
  631.  
  632.         What's the reason for this feature? None, except for aesthetics.
  633.         Someone suggested that the board might look nicer if the menu
  634.         could be removed.  I tried it and found out that he was right.
  635.         The board looks MUCH nicer when you don't have to stare at that
  636.         ugly menu!
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                                     - Page 11 -
  663.  
  664.  
  665.  
  666.  
  667.  
  668. THE SPECIAL SUB-MENU
  669.  
  670.      I'll now describe the functions available in the SPECIAL sub-menu
  671. in the order of their appearance:
  672.  
  673.  
  674. BACKGND
  675. =======
  676.         This feature will let you TEMPORARILY change the background
  677.         color of the board.  When you select BACKGrouND, another small
  678.         window will open.  You'll see three bar-graphs labeled Red,
  679.         Blue, and Green.  You can raise or lower the content of any
  680.         color by clicking on its UP or DOWN button.  The color will
  681.         increase or derease one "notch" for each click.  Holding down
  682.         the center button while clicking will increase or decrease the
  683.         color value by 10 "notches" with each click.  When you've got
  684.         the color set to what you want, just click the right mouse
  685.         button to return to the game.
  686.  
  687.  
  688.     Note that this color change is temporary.  When you quit the
  689.         game, the color will be lost.  The next time you run MJVGA, the
  690.         default color will be used.  If you wish to change the
  691.         background color permanently, you must use The Draftsman.
  692.  
  693.  
  694. INFO...
  695. =======
  696.         Selecting INFO... simply displays the game title, a copyright
  697.         notice, a shareware notice, and the author's name & address.
  698.         This isn't necessary, but it's nice to have just in case the
  699.         program gets separated from its .DOC file.  To return to the
  700.         game, click the RIGHT mouse button.
  701.  
  702.  
  703. DOS SHELL
  704. =========
  705.         This feature will let you drop to DOS without losing your
  706.         current game (and without having to save it).  I added this
  707.         feature because I always seem to get important business phone
  708.         calls requiring access to a file on my PC during a game of Mah
  709.         Jongg!
  710.  
  711.     To return to the game, just type EXIT at the DOS prompt.
  712.  
  713.     NOTE:  As with any shell-to-DOS, you MUST NOT run any TSR-type
  714.     programs from within this shell!  Doing so could crash the
  715.     system!!  If you choose to run a TSR from here, don't say I
  716.     didn't warn you!!!
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                              -  Page 12  -
  725.  
  726.  
  727.  
  728.  
  729.  
  730. SOUND
  731. =====
  732.         This button simply toggles the sound on and off.  With the sound
  733.         turned off, you won't hear all the various beeps, clicks,
  734.         buzzes, and bloops.
  735.  
  736. TIMER
  737. =====
  738.         The Timer button toggles the timer display off and on.  The
  739.         timer will continue to keep time, even if the display is turned
  740.         off.
  741.  
  742.  
  743.  
  744.      Selecting any item on the Special sub-menu will automatically close
  745. the sub-menu.  If you'd like to exit the sub-menu without making a
  746. selection, just press the right mouse button.
  747.  
  748.  
  749.  
  750. KEYBOARD COMMANDS
  751.  
  752.      There are several features which are accessable only by pressing a
  753. key on the keyboard.  The menus were getting just too darn crowded, so
  754. the new features seem to be "overflowing" onto the keyboard!
  755.  
  756. LOAD TILE SET
  757. =============
  758.         You can load in an alternate tile set at any time by tapping the
  759.         "L" key.  A list of available tile sets will be shown.  To
  760.         select a set, use the mouse to move the highlight bar to the
  761.         desired set, then click the left mouse button.
  762.  
  763.         The tile sets which you choose from must be located in the MJVGA
  764.         subdirectory.  There is also a 24-set limit with this version.
  765.         You can choose from only the first 24 tile set files that MJVGA
  766.         finds.  I hope to have this limitation removed in a future
  767.         version -- I was just too lazy to re-program it for this
  768.         release.
  769.  
  770. CURSOR BOX TOGGLE
  771. =================
  772.         MJVGA supports an alternate "box" cursor in addition to the
  773.         standard mouse pointer.  When the box cursor is turned on, a
  774.         thin box will be drawn around a tile when it's being "pointed
  775.         to" by the mouse cursor.  Some people seem to like this feature,
  776.         while others don't.  It does make tile selection a bit more
  777.         accurate, but can be quite distracting.  If you like the box,
  778.         use it -- if not, don't.  It can be turned on & off by tapping
  779.         the "B" key. Note that when the box cursor is active, the mouse
  780.         arrow will NOT disappear -- they'll both be visible.
  781.  
  782.  
  783.  
  784.  
  785.  
  786.                               - Page 13 -
  787.  
  788.  
  789.  
  790.  
  791.  
  792. HALL OF FAME
  793. ============
  794.         MJVGA maintains a "Hall of Fame" for winners.  Whenever you win
  795.         a game, if your time is one of the top ten, you'll be asked to
  796.         enter your name into the hallof fame.  The hall of fame honor
  797.         roll can be called up at any time by pressing the "H" key.
  798.         Click any mouse button to return to the game.
  799.  
  800.         The "Hall of Fame" file can also be edited with the included
  801.         editing utility.  For details, please see the utilities manual.
  802.  
  803. BOOK-MARKS
  804. ==========
  805.         MJVGA will store up to five "book-marks" which will allow you to
  806.         easily back up to a given point in the game.  To save a position
  807.         in one of the book-marks, just type <SHIFT-1> thru <SHIFT-5> for
  808.         book-marks 1 thru 5.  To back up to a bookmark, just type it''s
  809.         number.  MJVGA will then back up move-by-move (just as if you
  810.         repeatedly clicked on back-up) until it gets to the marked spot.
  811.         Please note that these book-marks are NOT currently saved with
  812.         the game when you select SAVE GAME.
  813.  
  814.  
  815. DOS SHELL
  816. =========
  817.         You can now easily get to the DOS shell by hitting <CTRL> - D at 
  818.         any time.  Someone suggested adding a "boss key" feature, and I 
  819.         decided that getting you to an innocent-looking DOS prompt 
  820.         quickly would probably be enough to save your job.  So, here it 
  821.         is!  As with the menu-selected DOS shell, you just type EXIT to 
  822.         return to the game.
  823.  
  824.  
  825.  
  826. COMMAND LINE OPTIONS
  827.  
  828.      Mah Jongg -V-G-A- v2.2 will accept five different command line
  829. options -- S, T, M, F, and D.  The purpose of each is as follows:
  830.  
  831.    B - Begin the game with the "box cursor" turned on
  832.  
  833.    S - Begin the game with sound off
  834.  
  835.    T - Begin the game with the timer display off
  836.  
  837.    M - Begin the game with messages off
  838.  
  839.    D - Enables the dual-monitor feature.  MJVGA21 will NOT use a
  840.        secondary monochrome monitor unless ordered to via the D
  841.        parameter.  Earlier releases used a second monitor by default.
  842.        However, that caused compatibility problems on some systems
  843.        without monochrome cards.
  844.  
  845.  
  846.  
  847.  
  848.  
  849.                           - Page 14 -
  850.  
  851.  
  852.  
  853.  
  854.  
  855.    F - Read PAL.CFG and all .ICN files from another disk or
  856.        subdirectory.  Some examples:
  857.  
  858.           f=a:   <== This reads all files from drive A:
  859.           f=E:\MJVGA\TILES2\  <==  Reads tiles from E:\mjvga\tiles2
  860.  
  861.        Note that all subdirectory references MUST be terminated with a
  862.        backslash (as above).
  863.  
  864.  
  865.  
  866.  
  867.      Any of these options (except for re-enabling the monochrome
  868. monitor) can be changed once the game is started.  These options simply
  869. control the position of these switches when the game starts.  They let
  870. you set up the game to your liking without having to click on buttons
  871. once the game starts.
  872.  
  873.      The parameters must be single letters (except for the F parameter)
  874. separated by a space.  They can be entered in any order.
  875.  
  876.  
  877.  
  878. IN CASE OF DIFFICULTY
  879.  
  880.      So far, I've come across only one problem that you may encounter.
  881. The main symptom is the lack of a mouse pointer, although you will be
  882. able to highlight tiles with the left button.
  883.  
  884.      The problem is caused by an out-of-date mouse driver.  MJVGA uses
  885. the 640x480 VGA graphics mode, and mouse drivers which were written
  886. before VGA became a standard simply don't know how to deal with the
  887. high-resolution graphics screen.
  888.  
  889.      I've heard about this problem with the Kraft Micro-Mouse, the Mouse
  890. Systems mouse, and the Logitech mouse.
  891.  
  892.      The solution is to simply get a newer mouse driver from the
  893. manufacturer of your mouse.  I know for a fact that Logitech (which is
  894. what I use) and Mouse Systems have updated drivers available which will
  895. correct this problem.
  896.  
  897.  
  898.  
  899. TECHNICAL SUPPORT
  900.  
  901.      If you have any problem with MJVGA, please let me know.  I'll be
  902. glad to do what I can to help you get it running.  Of course, I can't
  903. guarantee that MJVGA will run on all systems!  No software company can
  904. do that!  But so far, I haven't heard of any major compatibility
  905. problems (except for the out-of-date mouse driver problem addressed
  906. above).  So, chances are it'll run OK on your PC.
  907.  
  908.  
  909.  
  910.  
  911.                              - Page 15 -
  912.  
  913.  
  914.  
  915.  
  916.      My only request is that you enclose a SASE if you would like a
  917. reply.  My policy has been (and always will be) that I will NOT reply
  918. to letters from non-registered users unless they include a SASE.  I
  919. really don't think it's fair to expect registered users to (literally)
  920. pay the expenses of technical support for non-registered users.
  921. However, I will definitely reply as long as you cover the costs by
  922. sending a SASE.
  923.  
  924.  
  925.  
  926.  
  927. BULLETIN BOARD
  928.  
  929.      Jami, the Sys-Op from The Party Line BBS which has been serving as
  930. my techincal support board, has moved to Texas.  So, there is no longer
  931. a  MJVGA support board.  I haven't yet decided whether I should put up
  932. my own BBS or just do without a tech support board.
  933.  
  934.      Jami will have a BBS operating in Texas, and I plan to send her all
  935. MJVGA updates and tilesets.  So, you should still be able to get the
  936. latest version there.  For her Texas BBS number, please look for a file
  937. called BBS.NUM on one of the disks.  I don't have it yet, so can't
  938. include it in this document.
  939.  
  940.  
  941.  
  942. WHAT'S NEXT
  943.  
  944.      I'm still looking for more tile sets.  My offer to send a disk full
  945. of tile sets (when available) to anyone who contributes an original set
  946. to the collection is still valid.  Unfortunately, I haven't gotten
  947. enough sets to fill a disk yet!  So, keep drawing!
  948.  
  949.      I really don't know what new features (if any) will be added to
  950. MJVGA from here.  It does just about everything I can think of.  If you
  951. have any suggestions, send them in -- I need them!
  952.  
  953.      I'm also looking for a new project.  If you know of any games
  954. similar to Mah Jongg or Solitaire that need to be computerized, please
  955. let me know.
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.                              - Page 16 -
  974.  
  975.  
  976.  
  977.  
  978.  
  979. SHAREWARE
  980.  
  981.      Please remember that this game is NOT public domain.  It is
  982. shareware!  If you play and enjoy this game regularly, you are urged to
  983. send the registration fee of $15.00 (or any amount that you see fit).
  984. Remember, shareware will only be around as long as YOU support the
  985. concept!
  986.  
  987.      When registering, please include the version and serial number from
  988. the copy of MJVGA that you have.  All registered users will receive the
  989. next update free-of-charge.  However, if I don't know what you've got, I
  990. may send you a duplicate copy!
  991.  
  992.      Whether or not you choose to register, I'd like to hear your
  993. comments and suggestions on Mah Jongg -V-G-A-.  If you'd like a reply,
  994. please include a stamped, self-addressed envelope.
  995.  
  996.      All comments and contributions can be sent to:
  997.  
  998.           Ron Balewski
  999.           412 E. Ridge St.
  1000.               Nanticoke, PA  18634-2915
  1001.  
  1002.  
  1003.  
  1004.  
  1005. DISCLAIMER
  1006.  
  1007.      In no event shall the Author be liable to you for any damages,
  1008. including any lost profits, lost savings, or other incidental or
  1009. consequential damages arising out of the use of or inability to use this
  1010. program, even if the Author has been advised of the possibility of such
  1011. damages, or for any claim by any other party.
  1012.  
  1013.  
  1014.  
  1015. PERMISSION TO COPY
  1016.  
  1017.      Individuals, clubs, and other organizations are granted permission
  1018. by the author to freely copy and distribute this program and
  1019. documentation as long as:
  1020.  
  1021.  
  1022.  
  1023. 1:  There is no charge for the software or documentation.  However, you
  1024. may charge a service fee for disk duplication and distribution, as long
  1025. as such fee is not more than $5.00.
  1026.  
  1027. 2.  Club members are informed of the user-supported (shareware) concept
  1028. and are encouraged to support it with their donations.
  1029.  
  1030. 3.  The program or its documentation are not modified in any way.
  1031.  
  1032. 4.  All files are distributed together on the same diskette (if
  1033. possible).  No file may be deleted.
  1034.  
  1035.                              - Page 17 -
  1036.  
  1037.  
  1038.  
  1039.  
  1040.                             Appendix A
  1041.  
  1042.                      The .TIL and .TIS files
  1043.  
  1044.  
  1045. If you'd like to give some newly-created tile to a friend, you've got
  1046. to know which file to give him!  That's the purpose of this Appendix!
  1047. The .TIL files are related to the images as follows:
  1048.  
  1049.      V00.TIL == Bamboo 1
  1050.        thru      thru
  1051.      V08.TIL == Bamboo 9
  1052.      V09.TIL == Dots 1
  1053.        thru      thru
  1054.      V17.TIL == Dots 9
  1055.      V18.TIL == Crak 1
  1056.        thru      thru
  1057.      V26.TIL == Crak 9
  1058.      V27.TIL == North
  1059.      V28.TIL == East
  1060.      V29.TIL == South
  1061.      V30.TIL == West
  1062.      V31.TIL == Dragon C
  1063.      V32.TIL == Dragon P
  1064.      V33.TIL == Dragon F
  1065.      V34.TIL == Spring
  1066.      V35.TIL == Summer
  1067.      V36.TIL == Autumn
  1068.      V37.TIL == Winter
  1069.      V38.TIL == Orchid
  1070.      V39.TIL == Plum
  1071.      V40.TIL == Mum
  1072.      V41.TIL == Bamboo
  1073.      V42.TIL == Reserved -- Internal use
  1074.      V43.TIL == Reserved -- Internal use
  1075.  
  1076.      PAL.CFG == Color configuration file (changeable with The Paint
  1077.                 Shop section of The Draftsman)
  1078.  
  1079. If you customize a complete set of tiles and save them to a separate
  1080. diskette, BE SURE to include an EXACT COPY of V42.ICN and V43,ICN.
  1081. Without these files on the same disk & subdirectory as PAL.CFG and the
  1082. other .ICN files, MJVGA will refuse to load!!!  Also note that these
  1083. files are not (at present) user-changeable!!!
  1084.  
  1085. The .TIS (tileset) file is new to MJVGA21 and later.  It consists of all
  1086. the above tiles saved as one large file.  A collection of .TIL files can
  1087. be assembled into one .TIS file with the PAKTIL utility.  The UPPAKTIL
  1088. utility will do the opposite -- break a .TIS file apart into 44 .TIL
  1089. files and one PAL.CFG file.
  1090.  
  1091. Note that The Draftsman REQUIRES .TIL and PAL.CFG files to operate.  It
  1092. WILL NOT work on a .TIS file.  Before using The Draftsman, you MUST use
  1093. UNPAKTIL to disassemble the thile set that you want to change.
  1094.  
  1095.  
  1096.  
  1097.                              - Page 18 -
  1098.  
  1099.  
  1100.