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