home *** CD-ROM | disk | FTP | other *** search
/ 100 Great Games for Palm OS 1 / 100PalmV1.iso / Cards / palmjongg / pjongg.txt < prev    next >
Text File  |  2000-04-11  |  16KB  |  391 lines
  1. PalmJongg Copyright (c) 1997-2000 Tan Kok Mun
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. This is the version 3.2 of PalmJongg for PalmPilot. Please read
  5. REGISTER.TXT for more information.
  6.  
  7. The latest version of this software can be found at :
  8.      http://home.pacific.net.sg/~kokmun/palmpilot.htm
  9.  
  10.  
  11. CONTENTS
  12. ========
  13.  0. WHAT'S NEW
  14.  1. GAME FEATURES
  15.  2. THE GAME
  16.  3. TO PLAY
  17.  4. INSTALLATION
  18.  5. DISCLAIMER
  19.  6. REGISTRATION INFORMATION
  20.  7. DISTRIBUTION
  21.  8. SHAREWARE AGREEMENT
  22.  9. LICENSING AGREEMENT
  23. 10. HISTORY
  24. 11. PROBLEM ?
  25.  
  26.  
  27. 0. WHAT'S NEW
  28.    ==========
  29.    Version 3.2
  30.    - Bypass PalmOS 3.5 default program launcher category problem.
  31.    - Added support for 16 Gray shades. ie. 
  32.      Support 4 different display mode, Color, 16 Gray shade,
  33.      4 Gray shade and B&W.
  34.      Color and Gray shade requires PalmOS 3.5 and above and the supported
  35.      hardware.
  36.    - New feature. User selectable background shade/color.
  37.  
  38.    Version 3.1
  39.    - Bug fixed for FIND VISIBLE.
  40.    - Bug fixed for tile selection for CUBE LAYOUT.
  41.    - New feature. Smart menu. You can now write the MENU character without
  42.      specifying the MENU SHORTCUT. eg. Write "U" or "u" to Undo.
  43.  
  44.    - Support 3 different display mode, Color, Gray shade and B&W.
  45.      Color and Gray Shade requires PalmOS 3.5 and above and the supported
  46.      hardware.
  47.  
  48.  
  49. 1. GAME FEATURES
  50.    =============
  51.    - 17 different tiles layout, with one DYNAMIC board generator.
  52.    - For DYNAMIC board the system will generate a unique solvable puzzle.
  53.      You can also control the DYNAMIC board genration.
  54.    - All solvable puzzle generator. All puzzle has at least a solution.
  55.      Please note that when SHUFFLE is used, the shuffled tiles may not
  56.      have a solvable solution.
  57.    - Ability to show a sample solution for the current puzzle.
  58.    - Board style sequence when playing new game.
  59.    - 4 different tile patterns.
  60.    - Dynamic tile resizing to fit screen size for easy viewing.
  61.    - Selectable game number. You can replay the game again as
  62.      and when you want to.
  63.    - Hint features to show you selectable tiles.
  64.    - Find match feature show you the matching tiles you have
  65.      selected. All matching tiles will be shown in sequence.
  66.    - Find visible and find all.
  67.    - User selectable double tap on tile for find match. Simplified
  68.      the search for matching tile.
  69.    - Full undo ability. You can undo till start of game.
  70.      Undo till tap allowed you for continuous undo till the screen is tap.
  71.    - Shuffle feature. You can shuffle the remainder tiles. Limited to
  72.      10 shuffles per game and shuffled tiles may not have a solution.
  73.    - Random Play feature, where the computer will quickly play
  74.      the game by selecting selectable tiles in a random manner.
  75.    - 2D and 3D view, allows you to see tiles that are partially block by
  76.      other tiles.
  77.    - Memorized and recall game state.
  78.    - Tile statistics.
  79.    - Statistics of game won and lost.
  80.    - Pop-up tile info when pen is touching the screen. The duration
  81.      to detect is user selectable. Pop-up tile can be customised
  82.      to appear on the right or left of the pen.
  83.    - Game Sound. Volume can be set a three different level or can be set
  84.      to use the PalmPilot Game Sound Level for Palm OS3.x.
  85.    - Smart menu.
  86.    - Three different display mode, color, gray shade and B&W.
  87.  
  88.  
  89. 2. THE GAME
  90.    ========
  91.    PalmJongg is a simple game of matching tiles. It is played using
  92.    mahjongg tiles. You can remove tiles by selecting two similar
  93.    tiles.
  94.  
  95.    You can only select the right or left most tiles, and if it is
  96.    not stacked by other tile.
  97.  
  98.  
  99. 3. TO PLAY
  100.    =======
  101.    Select one selectable tile and select the matching tile to remove it.
  102.    Selectable tile will be highlighted. To unselect, either tap outside 
  103.    the tiles area or tap another non matching selectable tile.
  104.  
  105.    If double tab find match is enabled, you can find matching tiles of
  106.    the current selected tiles easily by tapping the same tile again.
  107.    Matching tiles of the current selected tiles will be highlighted.
  108.  
  109.    Matching tiles are tiles of the same pattern and value. The only 
  110.    exception is for the following tiles :
  111.    1. Season tiles can match each other. They are mark as SU,SP,WI and AU.
  112.    2. Cross tiles can match each other. They are mark as CR.
  113.  
  114.    The MENU commands are as follows :
  115.  
  116.    GAME
  117.    ~~~~
  118.    - NEW GAME     : Play the next new game.
  119.  
  120.    - RESTART GAME : Restart the current game.
  121.  
  122.    - SELECT GAME  : Select a specific game to play.
  123.  
  124.    - PREFERENCES  : Game settings.
  125.  
  126.                     DOUBLE TAP AS FIND ...
  127.                     - None    : No action.
  128.                     - Match   : Find matching tile.
  129.                     - Visible : Find visible tile.
  130.                     - All     : Find all tile.
  131.  
  132.                     SHOW TILE INFO AFTER
  133.                     - Tile info will be shown after the pen is still
  134.                       pressing the screen for the set duration. To disable,
  135.                       select NONE.
  136.  
  137.                     TILE INFO ON
  138.                     - Controls if the tile info is to be shown on the right
  139.                       or left of the pen.
  140.  
  141.                     GAME SOUND
  142.                     - Set game sound volume. For PalmIII and above you can
  143.                       set it to PREFS. to use the system game sound
  144.                       preferences setting.
  145.  
  146.                       Setting PREFS. on none PalmIII and above machine will
  147.                       disable the game sound.
  148.  
  149.                     TILE PATTERN
  150.                     - Set the tile pattern style.
  151.  
  152.                     DISPLAY MODE
  153.                     - Auto will use the highest possible display mode.
  154.                       B&W is black and white. Gray is shades of Gray.
  155.  
  156.                     BACKGROUND
  157.                     - Select board background. For 4-Gray and above display mode
  158.                       you can define the background shade/color by selecting 
  159.                       USER DEFINED.
  160.                       Click on BACKGROUND button to select the shade/color.
  161.                       Tap on the shade/color you want to select or outside the
  162.                       shade/color palette to use the old setting.
  163.  
  164.                     SLOW AUTO MODE
  165.                     - Slowdown to enable you to see easily the move during
  166.                       Random Play, Show Solution and Demo.
  167.  
  168.  
  169.    - GAME STATS.  : Show the game statistics. You will be shown the
  170.                     number of game you have won, and lost.
  171.  
  172.                     Game won details percentage is based on the total game 
  173.                     won. Assisted game is where the the hint, find match, 
  174.                     undo or quick play feature has been used.
  175.  
  176.                     You can reset the score by pressing the RESET button.
  177.  
  178.    - TILE STATS.  : Show the count for each of the different tiles that are
  179.                     still remaining on the board. If the tile is no longer
  180.                     on the board, it will not be shown.
  181.  
  182.  
  183.    TOOLS
  184.    ~~~~~
  185.    - FIND MATCH   : Find a matching tiles to the currently selected tile.
  186.                     The matching tile can be selected legally.
  187.  
  188.    - FIND VISIBLE : Find all visible tiles similar to the currently selected
  189.                     tile.
  190.  
  191.    - FIND ALL     : Find all tiles similar to the currently selected tile.
  192.  
  193.    - HINT         : Show a valid matching tiles that you can remove.
  194.  
  195.    - UNDO         : Undo the last move.
  196.  
  197.    - UNDO TILL TAP: Continuous undo till the screen is tap.
  198.  
  199.    - RANDOM PLAY  : Randomly select valid tiles to remove.
  200.  
  201.    - SHOW SOLUTION: Show a sample solution for the current puzzle.
  202.  
  203.    - SHUFFLE      : Shuffle remainder tiles.
  204.  
  205.    - MEMORIZED    : Memorized the current game state. A M+ indicator will
  206.                     be shown on the bottom right corner.
  207.  
  208.    - RECALL       : Recall the memorized game state.
  209.  
  210.                     Note: The memorized state will be lost when the game is
  211.                           restarted or a new game is started.
  212.  
  213.  
  214.    VIEW
  215.    ~~~~
  216.    - 2D VIEW      : Switch to 2D view.
  217.  
  218.    - 3D VIEW      : Switch to 3D view.
  219.  
  220.    - TOGGLE VIEW  : Toggle between 2D and 3D view.
  221.  
  222.  
  223.    HELP
  224.    ~~~~
  225.    - RULES   : Text about the game play.
  226.    - ABOUT   : Author information.
  227.  
  228.  
  229. 4. INSTALLATION
  230.    ============
  231.    Install pjongg.prc using the standard PalmPilot application installer.
  232.  
  233.  
  234. 5. DISCLAIMER
  235.    ==========
  236.    The author will not take responsibility for any form of damage or loss 
  237.    that occurs when/by using this program. By using the program, you have 
  238.    agreed on all the conditions stated here.
  239.  
  240.  
  241.  
  242. 6. REGISTRATION INFORMATION
  243.    ========================
  244.    For registration information, please read the REGISTER.TXT file.
  245.  
  246.  
  247. 7. DISTRIBUTION
  248.    ============
  249.    This manual and all accompanying files may be distributed freely,
  250.    provided that:
  251.    - Neither text nor any other file is modified in any way. No file
  252.      may be omitted nor added in the distribution.
  253.  
  254.    - No money may be charged for the program nor for any accompanying
  255.      files, other than the usual downloading time fees charged by
  256.      commercial BBSes and online services.
  257.  
  258.    - I want to know where my program will be distributed. Please notify me
  259.      if it will be included in printed matter, floppy, or CD-ROM before its
  260.      publication. No matter what the circumstance, I would strongly
  261.      appreciate a copy of whatever collection in which it is included.
  262.  
  263.  
  264.  
  265. 8. SHAREWARE AGREEMENT
  266.    ===================
  267.    PalmJongg is a ShareWare. After registration, you are licence to use it. 
  268.    All ownership and Copyright of the software belongs to Tan Kok Mun. 
  269.    Please read LICENSING AGREEMENT below. Each registered copy can only
  270.    be used in a single machine.
  271.  
  272.  
  273.    
  274. 9. LICENSING AGREEMENT
  275.    ===================
  276.    The software accompanying this document (the Software) and the related  
  277.    documentation are licensed to you by Tan Kok Mun (the author) after the
  278.    registration or during the trial period of the first 30 usage from the 
  279.    date of installation.
  280.    
  281.    The software contains copyrighted material and other proprietary material. 
  282.  
  283.  
  284. 10.HISTORY
  285.    =======
  286.    10/04/2000 - Version 3.2
  287.  
  288.    05/04/2000 - Version 3.1
  289.  
  290.    11/06/1999 - Version 3.0
  291.                 NEW FEATURE
  292.                 ~~~~~~~~~~~
  293.                 - New 12 board layout based on Chinese Zodiac sign.
  294.                 - New board style sequence when playing new game.
  295.                 - Pop-up tile info when pen is touching the screen. The 
  296.                   duration to detect is user selectable. Pop-up tile can
  297.                   be customised to appear on the right or left of the pen.
  298.                 - Game Sound. Volume can be set a three different level or
  299.                   can be set to use the PalmPilot Game Sound Level for 
  300.                   Palm OS3.x.
  301.                 - Additional of two new Tile Patterns. Selectable in 
  302.                   PREFERENCE MENU.
  303.                 - UNDO TILL TAP will continue to undo till you tap the screen.
  304.  
  305.                 CHANGES
  306.                 ~~~~~~~
  307.                 - Remove Random Game Order from PREFERENCE MENU. Game numbering 
  308.                   can be set when a NEW GAME is selected.
  309.                 - Remove toggling of 2-D and 3-D view when tapping on blank 
  310.                   space and removed from the PREFERENCE MENU. Toggling of 2D and
  311.                   3D view is now done via the VIEW MENU.
  312.                 - Simplified game statistics.
  313.                 - When requesting multiple hints, the hints will not be 
  314.                   duplicated when possible.
  315.                 - Enhance the FIND... request. You can now select the next tile 
  316.                   without waiting for all the hints to complete.
  317.                 - New update game engine to support more complex tiles layout.
  318.  
  319.                 BUG FIX
  320.                 ~~~~~~~
  321.                 - Fix value overflow problem in the GAME STATISTICS which can 
  322.                   cause a soft reset.
  323.                 - Bug fix for shuffling when tile is selected.
  324.  
  325.    12/11/1998 - Version 2.0
  326.               - Program size is now 26K, a saving of 12K.
  327.               - Two new pattern layout, CUBE and DYNAMIC. For DYNAMIC board 
  328.                 the system will generate a unique solvable puzzle. You can 
  329.                 also control the DYNAMIC board genration.
  330.               - New shuffle features. If you are stuck or anytime you feel 
  331.                 like it you can reshuffle the left over tiles. However you 
  332.                 are only allowed to shuffle 10 times per game only and there
  333.                 is NO guarantee that the shuffled tiles are solvable.
  334.               - Bug fixed on UNDO beyond memorised location.
  335.               - Game generator is now much faster.
  336.               - When doing FIND...MATCH, VISIBLE, ALL, you can now tap 
  337.                 anywhere on the screen to stop the FIND.
  338.               - 2D and 3D view, allows you to see tiles that are partially 
  339.                 block by other tiles. Just tap anywhere on the screen where
  340.                 there is no tiles and the view will toggle between 2D and 3D.
  341.               - Palm III List Icon.
  342.               - Resolve compatibility with EZ Dragonball.
  343.  
  344.    20/02/1998 - Version 1.9
  345.               - Has three different tiles layout. User selectable or let
  346.                 PalmPilot select one for you for each new game.
  347.               - Game engine is now more generic and uses less memory stack
  348.                 area. This is to enable support for different tiles layout.
  349.                 It now handles low stack memory better, especially 
  350.                 for PalmPilot OS 1.x. This also resulted in a slightly 
  351.                 slower game generator.
  352.               - Revised Gane statistics. It now keep tracks only of game won
  353.                 and lost for each of the board style and a total for all.
  354.  
  355.    02/01/1998 - Version 1.8 
  356.               - Game generator is now 50% faster.
  357.               - Find visible.
  358.               - Find all.
  359.               - Memorized and recall game state. Uses only 4 additional 
  360.                 bytes to save the current tile status.
  361.               - Tile statistics.
  362.               - Menu has been reaaranged and some of the shortcut changed.
  363.               - Demo mode has been removed to save memory.
  364.               - Help-tile has been merged with tile statistics.
  365.               - Fixed screen update problem for Palm OS 1.x.
  366.  
  367.    26/12/1997 - Version 1.6 - Unreleased.
  368.  
  369.    19/12/1997 - Version 1.5
  370.               - All solvable puzzle generator. All puzzle has at least
  371.                 a solution.
  372.               - Rename of Quick Play to Random Play to reduce confusion.
  373.               - Ability to show a sample solution for the current puzzle.
  374.               - User selectable tile font size.
  375.               - User selectable slow auto mode. This will slowdown the
  376.                 animation to enable you to see easily the move during
  377.                 Random Play, Show Solution and Demo.
  378.               - User preferences are effective immediately.
  379.               - Demo mode.
  380.               - Valid moves indicator.
  381.  
  382.    29/11/1997 - Version 1.0
  383.  
  384.  
  385. 11.PROBLEM ?
  386.    =========
  387.    If you wish to contact me, I can be reached at:
  388.  
  389.         E-Mail   : kokmun@pacific.net.sg
  390.         Web Page : http://home.pacific.net.sg/~kokmun/
  391.