Code copyright (c) 2004-6 A. Pruss
Some graphics copyright (c) 2000 M. Koester
FreeDroidRPG sounds copyright (c) 2002-2003(?) Johannes Prix and Chris 
Hoeppner
Nexuiz sounds copyright (c) 2001-2006(?) Gottfried Hofmann
Hieroglyphs created by Jonathan Blois - montoumes@hotmail.com -  
http://egypte.web361.fr copyright (c) J. Blois

All licensed under the Gnu General Public License.
No warranty.  Free software.  See COPYING for license.

Special license grant:
All the program source code and scripts, but NONE OF THE ACTUAL 
GRAPHICS 
IMAGES NOR THE AUDIO DATA NOR ANY BINARIES THAT INCLUDE THE GRAPHICS 
IMAGES 
AND/OR THE AUDIO AND/OR DERIVATIVE WORKS THEREFROM, can be used under 
the 
terms of the revised BSD license, and hence are available for use in 
closed source projects.  

The BSD license text is at:
http://www.opensource.org/licenses/bsd-license.php

INSTALLATION INSTRUCTIONS

Hotsync PalmIshido.prc.  This is enough to start playing.  Beyond that,
you may want other boards and/or pieces, or sounds.  

PalmIshido can be played in three display modes if they are supported 
(OS 5 only): Square (standard Palm devices), Tall (320x480 hires+ 
devices) 
and Wide (480x320 hires+ landscape devices like the T3, T5, TX and 
LifeDrive).  To switch between modes, just use your standard rotate and 
minimize/maximize buttons (usually) in the statusbar.  

Different plugins can be installed for different modes.  For the Square
mode, the only Board plugin currently available is Marble.prc, but there
are a couple of Piece plugins such as HieroglyphicPieces.prc.  To use
these, make sure your display is in Square mode (input area up), if you
have a device that can switch, and then activate the correct plugin by
pressing Menu | Options | Preferences.  

Plugins designed specifically for landscape mode display have "Wide" in
the name.  

Finally, there is one Sound plugin available.  Again, you need to enable
it in PalmIshido's Preferences if you want to use it.

You can make your own plugins if you know what you're doing.  The full
source code for PalmIshido includes scripts for generating plugins, but
currently you need to know how to use developer tools to do that, and 
currently no instructions are available.  However, if you are interested
in making a really nice plugin, the PalmIshido developer may be willing
to help you if you allow the plugin to be included in PalmIshido and
GPL licensed.  Square mode tiles for hi-res devices are 24x40, but the
tiles can extend beyond the square for 3D or transparency effects.  You 
can
supply alternate tiles for "lifted piece" mode, as in the Shadowed 
plugins.
Wide mode tiles are 34x40.



GAME PLAY

(You can always get this help by choosing Help | Game play in the menu.)
Ishido is a tile matching game.  There are 72 tiles and a 12x8 board.  
The object of the game is to place all the tiles on the board.
There are six shapes of tiles and six colors of tiles, for a total of 
36 combinations.  There are two copies of each tile.
To play, simply drag the new tile onto the board or just tap on the 
board where you want it.  
You must put each tile next to (below, above, left or right--not 
diagonally) one or more tiles that match according to the following 
rules:
- If the new tile has only one neighbor, it must match it by shape or 
by color or both.
- If it has two neighbors, then one of these must have (at least) the 
same shape as it and the other must have (at least) the same color as 
it.
- If it has three neighbors, then either two of these must have (at 
least) the same shape as it and the other (at least) the same color as 
it, or else one of these must have (at least) the same color while the 
other two have (at least) the same shape.
- If it has four neighbors, then two of the neighbors must have (at 
least) the same shape as it and the other two must have (at least) the 
same color as it.  This is called a "four-way".
The game ends when you put down all the tiles or when there is no legal 
move available.
If you want (or you may consider this cheating), the up/down keys can 
be used to go through all the available legal moves.  On some devices, 
the enter or center key will then select one of these.

Hint: The scoring highly rewards four-ways.


SCORING

There are two scoring systems, "modern" and "ancient".  Your modern 
score is shown vertically.  Your ancient score, when you have one, is 
shown in roman numerals.
Ancient scoring is very simple: your ancient score is equal to the 
number of four-ways.
Modern scoring is quite complex.  
You get no points when you put your tile on one of the outer edges.  
Otherwise, you get a neighbor-count score, which starts off at 1 for 
one neighbor, 2 for two neighbors, 4 for three and 8 for four.  
Each time you get a four-way, subsequent neighbor-count scores get 
doubled.  (E.g., after the first four-way, a two-way match earns you 
four points;  after a second four-way, it earns you eight.)
Additionally, for the first four-way you get an extra 25 points, for 
the second 50, and then in sequence 100, 200, 400, 600, 800, 1000, 
5000, 10000, 25000 and 50000.  
Finally, you get 1000 points for getting all the pieces on the board, 
500 if you get all but one, and 100 for all but two.

Hint: To maximize modern scores, try to get four-ways early in the 
game.  This is more important than getting all the pieces on the board.

PLUGINS

This help information is available in the help menu and by tapping on 
the circle-i icons in the Preferences and Plugin Managers.
You can customize PalmIshido by using plugins.  You simply hotsync your 
plugins and select the ones you want to use for each screen 
configuration in the Options | Preferences menu.
There are three kinds of plugins: Board, Pieces and Sound.  You can 
mix-and-match these.
If your device has a supported virtual Graffiti or virtual input area 
(Hi-Res+), PalmIshido will work in up to three configurations: Square 
(the standard for Palm devices with square screens), Wide (landscape) 
and Tall.  You can set a different plugin combination for each of 
these.  
To change between the configurations use your device's rotate and input 
maximize/minimize buttons (usually on the statusbar).
