home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / 1997 / 1002.ZIP / Mjs.txt < prev   
Encoding:
Text File  |  1997-05-02  |  4.1 KB  |  121 lines
  1. MJS - Mah Jongg Scorer
  2. For the Psion 3a
  3. Copyright by Phil Davidson
  4.  
  5. Introduction
  6.  
  7. I have been playing Mah Jongg for a number of years now, one of the
  8. problems that our faced was that of keep score of a game.  We'd quickly
  9. work out what each hand had scored, but it took quite a few minutes
  10. on paper to work out the adjusted scores, and then to update the 
  11. ongoing score for the whole game.
  12.  
  13. At that time, I was blessed with my first Psion.  I soon recognised
  14. the potential for developing a small application that would allow
  15. me to track the scoring of a Mah Jongg game.
  16.  
  17. Out of that need, came this application.
  18.  
  19.  
  20. Overview
  21.  
  22. The MJS application does not calculate what an individual hand scores
  23. i.e. you can't tell it that you've got 2 pongs of minor tiles and
  24. a pong of dragons, and have it tell you what that scores.  We found
  25. that using the psion for this did not in anyway speed up our play,
  26. we can work out hand scores quite quickly.
  27.  
  28. What it can do though, is let you input the four hand scores, and
  29. will work out who owes who what, it will make the appropriate
  30. adjustements, and give you the resulting score, along with the new
  31. total score for the whole game.
  32.  
  33. Please note, this is not based around the fan scoring method, although if there's
  34. demand, I could make a fan scoring version.  The scoring mechanism is based
  35. around the 2 points for a pong in minor tiles, 32 for a concealed kong of
  36. major tiles, doubles for this and doubles for that.
  37.  
  38. I have tried to make the interface as intuitive as possible, but no doubt there are
  39. areas that can be improved.
  40.  
  41. Other features include:
  42.  
  43.     - Save/Load facility
  44.     - Enter Penalties scores
  45.     - Display hand scores
  46.     - Display total game score
  47.     - Dual format display (toggle with diamond key)
  48.     - Menu & Hotkey driven
  49.     - Tracks which is the current wind
  50.     - Tracks which player is East wind
  51.  
  52. Statistics database
  53.  
  54.     - number of games played
  55.     - number of games won
  56.     - average score
  57.     - best hand score
  58.     - best/worst game scores 
  59.     - average number of mahjongs
  60.     - % win rate
  61.     - etc...
  62.  
  63. Future Developments
  64.  
  65.     - History facility - keep a history of past games, who won,
  66.       scores etc.
  67.     - Anything you want to suggest that I can be bothered coding ;-)
  68.     - Ability to customise settings.  e.g. starting score - I've
  69.       assumed and hard coded a starting score of zero for games.
  70.     - No testing for 3c compatibility has been done
  71.     - If someone gives me a Siena I'll have a go at re-coding for
  72.       the smaller display (he says hopefully ;-)
  73.  
  74.  
  75. How to get MJS
  76.  
  77.     - Check out my home page, http://ds.dial.pipex.com/davidson/
  78.     - I have posted the zip file containing all required files to
  79.       comp.binaries.psion
  80.     - You can always email me at the address given below, and I
  81.       will email you a copy back.
  82.  
  83. Installation
  84.  
  85. Copy the files into the apps directory and install as normal.  
  86.  
  87.  
  88. Known Bugs, areas for improvement etc.
  89.  
  90.     - Cannot escape out of all dialog boxes. But all the major ones are
  91.       catered for.
  92.     - Error checking.  Again, sloppy on my part, I really need to
  93.       tighten the error checking - mostly on imputing values.
  94.       There is nothing here though that should spoil your
  95.       enjoyment.  I've been using this application for months
  96.       now and have never lost a game half way through.
  97.     - The statistics screen only displays about a dozen entries on the screen,
  98.       it crashes if you try to have more.  I need to implement a
  99.       paging/scrolling facility for the statistics screens/
  100.     - The score display.  I quite like the default score display,
  101.       but that doesn't everyone else will.  If you've got
  102.       suggestions - send them in.
  103.  
  104.  
  105.  
  106. Registration and how to contact me
  107.  
  108. There is NO registration, I had originally released  this as shareware, but
  109. have decided to release it as freeware. I still retain copyright, and request
  110. that you do not modify this distribution file in anyway, but do feel free
  111. to pass it on and around.
  112.  
  113. My news feed doesn't carry a lot of the psion newsgroups traffic,
  114. so I'll probably miss anything you post to usenet.
  115.  
  116. You can get me at the following email address
  117.  
  118. fil@mojo.europe.dg.com
  119. or
  120. davidson@dial.pipex.com
  121.