
OpenChess for PalmOS Version 3.00
=================================

OpenChess is a Chess game, Opening Trainer and Chess data base for PalmOS 
based on GNU Chess 2

OpenChess is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
(see Copying.txt for details)


Information:
============

For additional information and documentation please visit:
http://palmopenchess.sourceforge.net


Installation:
=============

You are strongly recommended to BACKUP YOUR DEVICE before installing OpenChess.

NOTE: OpenChess databases and preferences from earlier version will be deleted!

Please use your Palm desktop software (see the corresponding documentation for 
further details) to install the following files onto your PalmOS device:

Main program:
- OpenChess.prc (required on all devices)

Additional Piece Sets (please see required screen capabilities):
- Mayan(160x1).prc (160x160 screen size)
- Mayan(160x8).prc (160x160 screen size; 4 bit gray scale or color)
- Mayan(240x4).prc (240x320 screen size; 4 bit gray scale or color)
- Mayan(240x16).prc (240x320 screen size; 4 bit gray scale or color)
- Mayan(320x16).prc (320x320/320x480 screen size; 4 bit gray scale or color)
- OpenChess1(320x8).prc (320x320/320x480 screen size; 4 bit gray scale or color)
For instructions on how to create a new piece set please visit:
http://palmopenchess.sourceforge.net/

Translation:
(Please install the file with your preferred language. If neither of the installed 
 language files matches the localization of your device you must confirm the 
 installation at the next start of OpenChess.)
- OpenChess_enUS.prc (English help texts, skip if you are short on memory)

- OpenChess_itIT.prc (Italian translation)
- OpenChess_ptBR.prc (Portuguese translation)
- OpenChess_nlNL.prc (Dutch translation)
- OpenChess_deDE.prc (German translation)
- OpenChess_esES.prc (Spanish translation)
- OpenChess_frFR.prc (French translation)

- OpenChess_iwIL.prc (Hebrew translation, Hebrew letter support program required!)
- OpenChess_plPL.prc (Polish translation, Polish letter support program required!)
- OpenChess_ruRU.prc (Russian translation, Russian letter support program required!)

Chess engines, native ARM code (requires PalmOS 5 and ARM CPU):
- Fruit21.prc 
- TogaIIv1.1a.prc 
- GambitFruit4bx.prc 
- Phalanx.prc 
- Scorpio16.prc (supports also Time/Game settings)
- GNUChess2.prc (rather weak, same chess engine as the internal one)

NOTE: 
If you run on an early OS5 device (e.g. Tungsten T) you may not have enough heap 
memory to run two ARM engines in parallel or even one large ARM engine standalone.
In order to free as much memory for the heap you can hold the Up-button when 
pressing the Reset button on your device. If you encounter an heap issue after 
several loads/un-loads of an ARM engine you may leave and re-start OpenChess 
because PalmOS leaves the heap memory defragmented sometimes.
The easiest way to overcome the heap memory issue on such devices offers a 
3rd party program to enlarge heap memory. FHR is a good example and can be 
downloaded for free here:
http://fanoush.webpark.cz/palm/fhr.zip

Example Opening Book:
ECO.pdb (Encyclopedia of Chess Openings (ECO) Opening Book with codes and English 
         opening names)

Supporting OpenChess:
=====================

There are many ways to support OpenChess, here are some of:
- Donations (http://sourceforge.net/donate/index.php?group_id=60238)
- Translation-support 
- Publish and share your Opening Books, Piece Sets and ARM Engines for OpenChess
- Even lawyers can support OpenChess as there are many commercial chess programs
  that are just illegal copies of OpenChess (as they clearly violate the GPL 
  and with that my copyrights - I could need some support to chase those guys)

Change Log:
===========

OpenChess V3.00:
- Fixed: Ticker overwrites fullscreen
- Fixed: Square color reset after restart
- Fixed: Internal engine bug 
- New button icons

OpenChess V3.0RC2:
Fixed bugs:
- Crash on Sony Clie devices running Palm OS 4

OpenChess V3.0RC1:
Fixed bugs:
- Fixed occational crashes in edited games
- Internal engine: Improved handling of mate/stalemate positions
- Separate sound for check-moves disabled
New features:
- Cancel possiblity in edit-Board Mode
- Drop down displays availablitiy of variations
- Export of edited games with FEN position
- Added Launcher-Information: 'Games'

OpenChess V3.0Beta3:
Fixed bugs:
- Increased stability for ARM engines
- 'DmWriteCheck failed' at PGN Export
- 'OC-ExtEngines.C,Line:556' after board edit
- No Redo after white ends game
- Score display between 0-1
- 2 lines of internal Opening Book
- Draged piece gets lost while moving off board
- Lost full-screen mode on DIA device
New features:
- Text-ticker if text does not fit to screen
- Clock stops at board leave
- Clock displays time left in time-control mode

OpenChess V3.0Beta2:
Fixed bugs:
- Internal engine does strange moves (gives material with no compensation) 
- Coordinates drawing error in edit board
- UI performance improvements
- Bug with Game Save
- Date error in PGN info
- Redo of promotion move
- Fixed some bugs around memory management
- Fixed: Contempt/Dither not saved properly
New features:
- Multi-Language support 
- ARM Engines: 
  * Toga II v1.1.a
  * Phalanx
  * Scorpio 1.6
  * GambitFruit 4bx
- Preferences and Opening Settings separated
- 'Position Analyze' button in Player vs. Player
- Time Control (limited time game, i.e. Blitz)
- Sound independend of side to play
- Default player name and engine

OpenChess V3.0Beta1 (new compared to OpenChess 2)
- less memory required on the device 
  (color piece sets and languages are distribute as separate files so you only
  need to install the ones you really need)
- HiRes+ or DIA support added (320x480 or 240x320) for Palm, Sony OS4 and HandEra 
- Drag and Move support: you can make a move with just dragging a piece to the new
  square
- Clock/Progress indicator: a clock will display how much time the playing side 
  has consumed so far, the same clock will be used to indicate the progress for 
  computer moves
- Customizable layout: it is possible to change background colors and piece sets 
  (new piece sets are included, can be downloaded or you can even create your own)
- ARM Engine support: native ARM engines can be connected to OpenChess and just use
  it as UI (ARM engines are distributed as separate PRC file, so far Fruit 2.1 and 
  GNU Chess 2 are included)
- Game Recording: Player vs. Player allows to record chess games including variants, 
  this mode allows going back and forward in a game and recall all positions played


Bug reporting & Contact:
========================

Please report any bugs to:
http://sourceforge.net/projects/palmopenchess
... for other questions write to robolaf(at)freenet.de


Compiling OpenChess, Source code:
=================================

OpenChess is developed with the gcc tool chain, prc-tools and pilrc.

Source code can be found in the CVS Repository at:
http://sourceforge.net/projects/palmopenchess

OpenChess uses slightly modified versions of the following projects
(modified source code included in OpenChess package):
* Peal (http://www.sealiesoftware.com/peal/)
* Palmresize (http://sourceforge.net/projects/palmresize/)

The following SDKs are required 
(not included in OpenChess package):
* Palm SDK
* Sony SDK
* Handera SDK
