PalmJongg Copyright (c) 1997-2000 Tan Kok Mun ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is the version 3.2 of PalmJongg for PalmPilot. Please read REGISTER.TXT for more information. The latest version of this software can be found at : http://home.pacific.net.sg/~kokmun/palmpilot.htm CONTENTS ======== 0. WHAT'S NEW 1. GAME FEATURES 2. THE GAME 3. TO PLAY 4. INSTALLATION 5. DISCLAIMER 6. REGISTRATION INFORMATION 7. DISTRIBUTION 8. SHAREWARE AGREEMENT 9. LICENSING AGREEMENT 10. HISTORY 11. PROBLEM ? 0. WHAT'S NEW ========== Version 3.2 - Bypass PalmOS 3.5 default program launcher category problem. - Added support for 16 Gray shades. ie. Support 4 different display mode, Color, 16 Gray shade, 4 Gray shade and B&W. Color and Gray shade requires PalmOS 3.5 and above and the supported hardware. - New feature. User selectable background shade/color. Version 3.1 - Bug fixed for FIND VISIBLE. - Bug fixed for tile selection for CUBE LAYOUT. - New feature. Smart menu. You can now write the MENU character without specifying the MENU SHORTCUT. eg. Write "U" or "u" to Undo. - Support 3 different display mode, Color, Gray shade and B&W. Color and Gray Shade requires PalmOS 3.5 and above and the supported hardware. 1. GAME FEATURES ============= - 17 different tiles layout, with one DYNAMIC board generator. - For DYNAMIC board the system will generate a unique solvable puzzle. You can also control the DYNAMIC board genration. - All solvable puzzle generator. All puzzle has at least a solution. Please note that when SHUFFLE is used, the shuffled tiles may not have a solvable solution. - Ability to show a sample solution for the current puzzle. - Board style sequence when playing new game. - 4 different tile patterns. - Dynamic tile resizing to fit screen size for easy viewing. - Selectable game number. You can replay the game again as and when you want to. - Hint features to show you selectable tiles. - Find match feature show you the matching tiles you have selected. All matching tiles will be shown in sequence. - Find visible and find all. - User selectable double tap on tile for find match. Simplified the search for matching tile. - Full undo ability. You can undo till start of game. Undo till tap allowed you for continuous undo till the screen is tap. - Shuffle feature. You can shuffle the remainder tiles. Limited to 10 shuffles per game and shuffled tiles may not have a solution. - Random Play feature, where the computer will quickly play the game by selecting selectable tiles in a random manner. - 2D and 3D view, allows you to see tiles that are partially block by other tiles. - Memorized and recall game state. - Tile statistics. - Statistics of game won and lost. - Pop-up tile info when pen is touching the screen. The duration to detect is user selectable. Pop-up tile can be customised to appear on the right or left of the pen. - Game Sound. Volume can be set a three different level or can be set to use the PalmPilot Game Sound Level for Palm OS3.x. - Smart menu. - Three different display mode, color, gray shade and B&W. 2. THE GAME ======== PalmJongg is a simple game of matching tiles. It is played using mahjongg tiles. You can remove tiles by selecting two similar tiles. You can only select the right or left most tiles, and if it is not stacked by other tile. 3. TO PLAY ======= Select one selectable tile and select the matching tile to remove it. Selectable tile will be highlighted. To unselect, either tap outside the tiles area or tap another non matching selectable tile. If double tab find match is enabled, you can find matching tiles of the current selected tiles easily by tapping the same tile again. Matching tiles of the current selected tiles will be highlighted. Matching tiles are tiles of the same pattern and value. The only exception is for the following tiles : 1. Season tiles can match each other. They are mark as SU,SP,WI and AU. 2. Cross tiles can match each other. They are mark as CR. The MENU commands are as follows : GAME ~~~~ - NEW GAME : Play the next new game. - RESTART GAME : Restart the current game. - SELECT GAME : Select a specific game to play. - PREFERENCES : Game settings. DOUBLE TAP AS FIND ... - None : No action. - Match : Find matching tile. - Visible : Find visible tile. - All : Find all tile. SHOW TILE INFO AFTER - Tile info will be shown after the pen is still pressing the screen for the set duration. To disable, select NONE. TILE INFO ON - Controls if the tile info is to be shown on the right or left of the pen. GAME SOUND - Set game sound volume. For PalmIII and above you can set it to PREFS. to use the system game sound preferences setting. Setting PREFS. on none PalmIII and above machine will disable the game sound. TILE PATTERN - Set the tile pattern style. DISPLAY MODE - Auto will use the highest possible display mode. B&W is black and white. Gray is shades of Gray. BACKGROUND - Select board background. For 4-Gray and above display mode you can define the background shade/color by selecting USER DEFINED. Click on BACKGROUND button to select the shade/color. Tap on the shade/color you want to select or outside the shade/color palette to use the old setting. SLOW AUTO MODE - Slowdown to enable you to see easily the move during Random Play, Show Solution and Demo. - GAME STATS. : Show the game statistics. You will be shown the number of game you have won, and lost. Game won details percentage is based on the total game won. Assisted game is where the the hint, find match, undo or quick play feature has been used. You can reset the score by pressing the RESET button. - TILE STATS. : Show the count for each of the different tiles that are still remaining on the board. If the tile is no longer on the board, it will not be shown. TOOLS ~~~~~ - FIND MATCH : Find a matching tiles to the currently selected tile. The matching tile can be selected legally. - FIND VISIBLE : Find all visible tiles similar to the currently selected tile. - FIND ALL : Find all tiles similar to the currently selected tile. - HINT : Show a valid matching tiles that you can remove. - UNDO : Undo the last move. - UNDO TILL TAP: Continuous undo till the screen is tap. - RANDOM PLAY : Randomly select valid tiles to remove. - SHOW SOLUTION: Show a sample solution for the current puzzle. - SHUFFLE : Shuffle remainder tiles. - MEMORIZED : Memorized the current game state. A M+ indicator will be shown on the bottom right corner. - RECALL : Recall the memorized game state. Note: The memorized state will be lost when the game is restarted or a new game is started. VIEW ~~~~ - 2D VIEW : Switch to 2D view. - 3D VIEW : Switch to 3D view. - TOGGLE VIEW : Toggle between 2D and 3D view. HELP ~~~~ - RULES : Text about the game play. - ABOUT : Author information. 4. INSTALLATION ============ Install pjongg.prc using the standard PalmPilot application installer. 5. DISCLAIMER ========== The author will not take responsibility for any form of damage or loss that occurs when/by using this program. By using the program, you have agreed on all the conditions stated here. 6. REGISTRATION INFORMATION ======================== For registration information, please read the REGISTER.TXT file. 7. DISTRIBUTION ============ This manual and all accompanying files may be distributed freely, provided that: - Neither text nor any other file is modified in any way. No file may be omitted nor added in the distribution. - No money may be charged for the program nor for any accompanying files, other than the usual downloading time fees charged by commercial BBSes and online services. - I want to know where my program will be distributed. Please notify me if it will be included in printed matter, floppy, or CD-ROM before its publication. No matter what the circumstance, I would strongly appreciate a copy of whatever collection in which it is included. 8. SHAREWARE AGREEMENT =================== PalmJongg is a ShareWare. After registration, you are licence to use it. All ownership and Copyright of the software belongs to Tan Kok Mun. Please read LICENSING AGREEMENT below. Each registered copy can only be used in a single machine. 9. LICENSING AGREEMENT =================== The software accompanying this document (the Software) and the related documentation are licensed to you by Tan Kok Mun (the author) after the registration or during the trial period of the first 30 usage from the date of installation. The software contains copyrighted material and other proprietary material. 10.HISTORY ======= 10/04/2000 - Version 3.2 05/04/2000 - Version 3.1 11/06/1999 - Version 3.0 NEW FEATURE ~~~~~~~~~~~ - New 12 board layout based on Chinese Zodiac sign. - New board style sequence when playing new game. - Pop-up tile info when pen is touching the screen. The duration to detect is user selectable. Pop-up tile can be customised to appear on the right or left of the pen. - Game Sound. Volume can be set a three different level or can be set to use the PalmPilot Game Sound Level for Palm OS3.x. - Additional of two new Tile Patterns. Selectable in PREFERENCE MENU. - UNDO TILL TAP will continue to undo till you tap the screen. CHANGES ~~~~~~~ - Remove Random Game Order from PREFERENCE MENU. Game numbering can be set when a NEW GAME is selected. - Remove toggling of 2-D and 3-D view when tapping on blank space and removed from the PREFERENCE MENU. Toggling of 2D and 3D view is now done via the VIEW MENU. - Simplified game statistics. - When requesting multiple hints, the hints will not be duplicated when possible. - Enhance the FIND... request. You can now select the next tile without waiting for all the hints to complete. - New update game engine to support more complex tiles layout. BUG FIX ~~~~~~~ - Fix value overflow problem in the GAME STATISTICS which can cause a soft reset. - Bug fix for shuffling when tile is selected. 12/11/1998 - Version 2.0 - Program size is now 26K, a saving of 12K. - Two new pattern layout, CUBE and DYNAMIC. For DYNAMIC board the system will generate a unique solvable puzzle. You can also control the DYNAMIC board genration. - New shuffle features. If you are stuck or anytime you feel like it you can reshuffle the left over tiles. However you are only allowed to shuffle 10 times per game only and there is NO guarantee that the shuffled tiles are solvable. - Bug fixed on UNDO beyond memorised location. - Game generator is now much faster. - When doing FIND...MATCH, VISIBLE, ALL, you can now tap anywhere on the screen to stop the FIND. - 2D and 3D view, allows you to see tiles that are partially block by other tiles. Just tap anywhere on the screen where there is no tiles and the view will toggle between 2D and 3D. - Palm III List Icon. - Resolve compatibility with EZ Dragonball. 20/02/1998 - Version 1.9 - Has three different tiles layout. User selectable or let PalmPilot select one for you for each new game. - Game engine is now more generic and uses less memory stack area. This is to enable support for different tiles layout. It now handles low stack memory better, especially for PalmPilot OS 1.x. This also resulted in a slightly slower game generator. - Revised Gane statistics. It now keep tracks only of game won and lost for each of the board style and a total for all. 02/01/1998 - Version 1.8 - Game generator is now 50% faster. - Find visible. - Find all. - Memorized and recall game state. Uses only 4 additional bytes to save the current tile status. - Tile statistics. - Menu has been reaaranged and some of the shortcut changed. - Demo mode has been removed to save memory. - Help-tile has been merged with tile statistics. - Fixed screen update problem for Palm OS 1.x. 26/12/1997 - Version 1.6 - Unreleased. 19/12/1997 - Version 1.5 - All solvable puzzle generator. All puzzle has at least a solution. - Rename of Quick Play to Random Play to reduce confusion. - Ability to show a sample solution for the current puzzle. - User selectable tile font size. - User selectable slow auto mode. This will slowdown the animation to enable you to see easily the move during Random Play, Show Solution and Demo. - User preferences are effective immediately. - Demo mode. - Valid moves indicator. 29/11/1997 - Version 1.0 11.PROBLEM ? ========= If you wish to contact me, I can be reached at: E-Mail : kokmun@pacific.net.sg Web Page : http://home.pacific.net.sg/~kokmun/