================================================= PSI-JONG - V 1.4 for the Psion Series 7 & netBook ================================================= A CLASSIC GAME - REMOVE AS MANY MATCHING PAIRS OF TILES FROM THE BOARD AS POSSIBLE - WITH HIGH QUALITY COLOUR GRAPHICS, SPEECH AND SOUND EFFECTS. EASY TO PLAY - HARD TO MASTER WITH MULTIPLE TILE GRAPHICS, TILE LAYOUTS, PLUS STATIC & ANIMATED BACKGROUND PICTURES. The latest versions of all my programs can be downloaded from my web site http://www.bjv.btinternet.co.uk ======== CONTENTS ======== 1) Installation 2) Upgrading from an earlier version 3) Troubleshooting 4) How to play 5) Registration 6) More programs 7) Adding your own static & animated background pictures 8) Final comment =============== 1) INSTALLATION =============== Turn on your Series 7, press the System icon (bottom left of the screen), press the Menu key, under 'Tools' select 'Preferences', make sure that there is a tick next to 'show system folder' and click on 'OK'. Go into either C:\System\Apps\ or D:\System\Apps\ From the menu, under 'File' select 'Make new folder' name it Psi-Jong. For a full installation... Copy all the files except README.TXT into this folder, which will be named.. C:\System\Apps\Psi-Jong\ or... D:\System\Apps\Psi-Jong\ ----------------- It is stongly recomended that you do a full installation, however, if you wish to save space, the minimum files you need to copy are as follows... PSI-JONG.APP PSI-JONG.AIF SH-PREFS DONE1 DONE2 DONE3 DONE4 DONE5 DONE6 DONE7 DONE8 MAHJONGG.TLS TITLE.MBM EYES.MBM PLAYERS PLAYLIST If you wish to add extra tilesets, copy some or all of the other files ending with .TLS. If you wish to include sounds, copy some or all of the the files that are named with just 2 characters. If you wish to include background pictures, copy copy some or all of the files ending with .BGP Any of the sounds, tilesets, or background pictures, can be added or removed at any time (as long as Psi-Jong is closed). ----------------- Pressing the 'Extras' button (bottom right of screen) will now reveal this programs icon, select it to begin. Select 'How to play' from the menu for instructions. If you have difficulty with installation, re-read and follow carefully the above instructions, you have probably put the files in the wrong place, or named the folder incorectly. The directory must be named exactly as listed above, or the program will not work. If the folder name is correct, but the program's icon does not appear in the Extra's bar, try renaming the Psi-Jong folder to something different, wait a few moments, and then rename it to the correct name. ==================================== 2) UPGRADING FROM AN EARLIER VERSION ==================================== If you have an earlier Series 7 version of Psi-Jong, delete the contents of your Psi-Jong folder except for the following files (if you have them)... SH-REG SH-DONE1 SH-DONE2 SH-DONE3 SH-DONE4 SH-DONE5 SH-DONE6 SH-DONE7 SH-DONE8 DONE1 DONE2 DONE3 DONE4 DONE5 DONE6 DONE7 DONE8 PLAYERS PLAYLIST then just follow the installation instructions above. If you have a version of Psi-Jong for a different machine, such as the Revo or Series 5, first follow the installation instructions in section 1, then if you wish to keep your score records, copy all files begining with 'SH-DONE' from your old version into the installation folder, overwriting the existing files. ================= 3) TROUBESHOOTING ================= If you have a problem, check that your batteries are not low, and that there is plenty of memory available to the program. The Series 7 may fail to play sounds when batteries are becoming low. Check that you have followed the installation instructions correctly. If the folder name is correct, but the program's icon does not appear in the Extra's bar, try renaming the Psi-Jong folder to something different, wait a few moments, and then rename it to the correct name. Check my web site to see if you are using the latest version of this program. http://www.bjv.btinternet.co.uk If you still have a problem after checking the above, send me an email, explaining the problem in as much detail as possible, stateing what machine you are running the program on, what version you are running, what files have been put where, at what point in the programs execution the error happened, and what error messages (if any) were given. My email address is bjv@btinternet.com ============== 4) HOW TO PLAY ============== Full instructions are included in the program, select 'How to play' from the Menu. =============== 5) REGISTRATION =============== Full instructions on how to register and details of cost are given within the program, just select 'How to Register' from the menu, you will be asked a few questions to determine which method of registration best suites you, followed by full instructions and details of cost for the method of registration selected. All my programs can be downloaded and registered via my website... http://www.bjv.btinternet.co.uk When you register you will receive a code that will enable this program to be used with your Series 7. The code is linked to the Unique ID of your Series 7, if for any reason a replacment code is required, one will be supplied free of charge. If you requre further codes for any reason (including changes in your Series 7's Unique ID due to repair, or to replace a lost code), you will need to register for the new Unique ID. You will recieve a new code, and again be entitled to 1 free replacement code if needed. The above policy is necessary to minimise piracy, and to keep the amount of time spent dealing with each registration to an acceptable level, which in turn, enables me to keep the cost of registration low. It took a long time to write this program, I hope you like it and will register so that I can continue making more programs for your enjoyment. ================ 6) MORE PROGRAMS ================ The latest versions of all my programs can be downloaded from my web site http://www.bjv.btinternet.co.uk If you would like to be informed each time I release a new program, just register any of my programs, and unless you request otherwise, I will keep you informed via email of each new release. ====================================== 7) ADDING YOUR OWN BACKGROUND PICTURES ====================================== PLEASE NOTE: No technical support is given on the supject of adding your own pictures, please don't email me with questions about it, but the information below should help you . Enter the Sketch program on your Series 7, select from the menu under 'File', 'Create new file', give the file a name. Now select from the menu under 'Tools', 'Resize sketch', set the width to 640 pixels, and the height to 480 pixels. If you create an image smaller than 640 x 480, it will be repeated to fill the background, this way you can make a background that is less than 1k in size. Now draw or merge in an image (under 'File' select 'More' then 'Merge in'). Under 'Edit' select 'Select all'. Under 'File' select 'More' then 'Export', you must now name the file. The file name should be no more than 8 characters. A file will be created as you named it, followed by '.mbm', this ending must be renamed to '.bgp'. Select the file, and under 'File' in the Menu, select 'Rename'. Once you have created the file, copy it to your Psi-Jong directory, if Psi-Jong is running, you will need to close the program and then restart it before it will recognise the new background image. If you make a really good background picture, please email it to me, and I may put it on my web site for others to download, or include it in future releases of PSI-JONG. When Psi-Jong displays a list of all available background pictures, the list is made up of a limited number of characters, if the titles of all the background pictures exceeds this limit, you will be told, and some of the pictures will not be listed. You can either delete some of the pictures, or rename some of them with shorter names so that more can be listed. To add animated backgrounds, find an animated gif that you like, or create your own. Up to 52 frames are supported in Psi-Jong. I suggest you use a program such as paintshop pro & animation shop on a PC, extract the frames from the animation shop into paintshop pro. Create a new image with the same width as the each individual frame, the height should be (height of individual frames times the number of frames). Now copy each frame in order, into the new image placing them one beneath the other until you have copied all the frames. Now save the image as a 256 colour GIF. Convert this to a 256 colour MBM using NEUON's 'Nconvert'. Now name the file with up to 6 characters, followed by @ if the animation to jump to the first frame when it gets to the last frame, or followed by ^ if you want the animation to reverse direction when it gets to the last frame, and again when it gets back to the first frame, or followed by % if you want the animation to randomly drift backwards and forward through the frames. Now you need to add another character to tell Psi-Jong how many frames of animation there is. Count the number of frames through the alphabet (lower case), so 6 frames would be 'f' and 26 frames would be 'z'. If your animation has more than 26 frames, continue counting using upper case characters, so 28 frames would be 'B' and so on. Now just add '.BGP' to the end of the file name. You should end up with a file named something like 'Dog@f.BGP'. Just copy your creation into your Psi-Jong folder (with Psi-Jong closed), next time you start Psi-Jong the background should be selectable. ================ 8) FINAL COMMENT ================ If there are any improvments you would like to see made to PSI-JONG please let me know, and I will consider the changes for future versions, but before contacting me, please check my web site to see that you have the latest version, as I may have already made the changes you desire. I hope that you will encorage me to write lots of new programs by registering. I am currently programing full time for the Series 7, and can only continue with your support. Best wishes, Ben Vaughan.