home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / 1997 / 974 / MJS.TXT < prev    next >
Encoding:
Text File  |  1997-03-26  |  4.5 KB  |  136 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. I have tried to make the interface as intuitive as possible, but no doubt there are areas that can be improved.
  34.  
  35. Other features include:
  36.  
  37.     - Save/Load facility
  38.     - Enter Penalties scores
  39.     - Display hand scores
  40.     - Display total game score
  41.     - Dual format display (toggle with diamond key)
  42.     - Menu & Hotkey driven
  43.     - Tracks which is the current wind
  44.     - Tracks which player is East wind
  45.  
  46. The registered version adds the following features
  47.  
  48. Statistics database
  49.  
  50.     - number of games played
  51.     - number of games won
  52.     - average score
  53.     - best hand score
  54.     - best/worst game scores 
  55.     - average number of mahjongs
  56.     - % win rate
  57.     - etc...
  58.  
  59. Future Developments
  60.  
  61.     - History facility - keep a history of past games, who won,
  62.       scores etc.
  63.     - Anything you want to suggest that I can be bothered coding ;-)
  64.     - Ability to customise settings.  e.g. starting score - I've
  65.       assumed and hard coded a starting score of zero for games.
  66.     - No testing for 3c compatibility has been done
  67.     - If someone gives me a Siena I'll have a go at re-coding for
  68.       the smaller display (he says hopefully ;-)
  69.  
  70.  
  71. How to get MJS
  72.  
  73.     - I have posted the zip file containing all required files to
  74.       comp.binaries.psion
  75.     - The binaries are not currently available on the web, or via
  76.       ftp - I'm working on that.
  77.     - You can always email me at the address given below, and I
  78.       will email you a copy back.
  79.  
  80. Installation
  81.  
  82. Copy the files into the apps directory and install as normal.  
  83.  
  84.  
  85. Known Bugs, areas for improvement etc.
  86.  
  87.     - The ICON is crap!  I know it, you know it, but I'm no
  88.       graphic artist. However I am working on getting a decent
  89.       icon.  If you have one you wish to donate, I'll be more
  90.       than happy to use it. 
  91.     - Cannot escape out of dialog boxes.  Sloppy coding on my part,
  92.       but for the time being, escape will not cancel a dialog
  93.       box, if you hit escape, things will progress as
  94.       normal.  This means you could end up accidently entering
  95.       a zero score for players. (Hint: save the game after
  96.       each time you enter a round).
  97.     - Error checking.  Again, sloppy on my part, I really need to
  98.       tighten the error checking - mostly on imputing values.
  99.       There is nothing here though that should spoil your
  100.       enjoyment.  I've been using this application for months
  101.       now and have never lost a game half way through.
  102.     - The statistics screen (not available in the shareware version)
  103.       only displays about a dozen entries on the screen,
  104.       it crashes if you try to have more.  I need to implement a
  105.       paging/scrolling facility for the statistics screens/
  106.     - The score display.  I quite like the default score display,
  107.       but that doesn't everyone else will.  If you've got
  108.       suggestions - send them in.
  109.  
  110.  
  111.  
  112. Registration and how to contact me
  113.  
  114. Registration will bring you an updatesd version of the application
  115. that gives you all the functionality of the shareware version plus
  116. the statistics database functionality.  In addition you will get
  117. free bug patches, upgrades etc. as and when they become available.
  118.  
  119. Registration costs seven pounds sterling, or ten US dollars.
  120.  
  121. My news feed doesn't carry a lot of the psion newsgroups traffic,
  122. so I'll probably miss anything you post to usenet.
  123.  
  124. You can get me at the following address
  125.  
  126. Phil Davidson
  127. 70 Telford Road
  128. Edinburgh
  129. EH3 7JA
  130. Scotland
  131. UK
  132.  
  133. fil@mojo.europe.dg.com
  134. or
  135. davidson@dial.pipex.com
  136.