J!Chess Viewer version 1.00 Readme File
Copyright (C) 2000, YanCheng.Cheok
yccheok@yahoo.com
http://i.am/cchess

=============================================================================
J!Chess Viewer is a Java Applet which can demonstrate chess game on
web site. J!Chess is developed by using JDK 1.1.2

Copyright/Disclaims
===================
J!Chess Viewer is free for personal non-commercial use. Any use for 
commercial purpose is prohibited.  

This software is provided AS IS, WITHOUT WARRANTY OF ANY KIND.  THE AUTHOR OF 
THIS SOFTWARE DISCLAIMS ALL WARRANTIES OF ANY KIND.  IN NO EVENT SHALL THE 
AUTHOR OF THIS SOFTWARE BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, 
INDIRECT, INCIDENTAL, CONSEQUENTIAL LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, 
EVEN IF THE AUTHOR OF THIS SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGES.

Registration
==================
Please send following information to yccheok@yahoo.com.  Registration is
required if you would like to obtain email support.  

User Name:
Email Address:
Web Site URL:
Comments:


Basic Concept
==================
1. Chess Board Position
The location of piece on the board is determined by the X and Y position. 
The X position ranges from a to h 
The Y position ranges from 1 to 8(See picture)
                   Black
     ---------------------------------
     |   |   |   |   |   |   |   |   |
  8  |   |   |   |   |   |   |   |   |
     ---------------------------------
     |   |   |   |   |   |   |   |   |
  7  |   |   |   |   |   |   |   |   |
     ---------------------------------
     |   |   |   |   |   |   |   |   |
  6  |   |   |   |   |   |   |   |   |
     ---------------------------------
     |   |   |   |   |   |   |   |   |
  5  |   |   |   |   |   |   |   |   |
     ---------------------------------
     |   |   |   |   |   |   |   |   |                          
  4  |   |   |   |   |   |   |   |   |                   
     ---------------------------------
     |   |   |   |   |   |   |   |   |
  3  |   |   |   |   |   |   |   |   |
     ---------------------------------
     |   |   |   |   |   |   |   |   |
  2  |   |   |   |   |   |   |   |   |
     ---------------------------------
     |   |   |   |   |   |   |   |   |
  1  |   |   |   |   |   |   |   |   |
    ---------------------------------
       a   b   c   d   e   f   g   h   
                   white

2. Coordinate Notation and Algebraic Notation
For more information about coordinate notation, please visit
http://www.exeter.ac.uk/~dregis/DR/notation.txt

Quick Start
===================
1. Unzip chessviewer.zip which contains
	jchess.jar	(You need to upload this file to your web site)
	piece.gif       (You need to upload this file to your web site)
	readme.txt      (The file that you are reading now)
	a.html		(example on how J!Chess look like)
	

2. Upload jchess.jar and piece.gif to your web site (in the same directory). Don't unzip the jchess.jar

3. Add following code to your html.

<applet archive="jchess.jar" code="jchess.class" width="511" height="467">
<param name="position" value="a1b1c1d1e1f1g1h1a2b2c2d2e2f2g2h2a8b8c8d8e8f8g8h8a7b7c7d7e7f7g7h7">
<param name="movenotation" VALUE="1">
<param name="whomovefirst" VALUE="0">
<param name="themovelist" value="c2-c4[]c7-c6[]d2-d4[]d7-d5[]e2-e3[]g8-f6[]b1-c3[]e7-e6[]g1-f3[]b8-d7[]d1-c2[]b7-b6[]f1-d3[]c8-b7[]O-O[]f8-e7[]a1-b1[]d5xc4[]d3xc4[]c6-c5[]d4xc5[]e7xc5[]e3-e4[]a7-a6[]c1-f4[]a8-c8[]c2-e2[]b6-b5[]c4-d3[]h7-h6[]f3-d2[]e6-e5[]f4-g3[]O-O[]f1-d1[]f8-e8[]a2-a4[]b5-b4[]c3-a2[]a6-a5[]a2-c1[]d7-b8[]c1-b3[]b8-c6[]d3-b5[]c6-d4[]b3xd4[]c5xd4[]b5xe8[]d8xe8[]b2-b3[]c8-c2[]d1-c1[]c2xd2[]e2xd2[]f6xe4[]d2-d3[]e4-c3[]d3-c4[]e8-a8[]h2-h3[]b7xg2[]g1-h2[]a8-b7[]b1-b2[]g2-d5[]c4-d3[]d5-e4[]d3-c4[]e4-d5[]c4-d3[]d5-e4[]d3-c4[]b7-d7[]b2-d2[]d7-f5[]c1-g1[]e4-d5[]c4-c7[]c3-e4[]c7-d8[]g8-h7[]d8xd5[]e4xd2[]h2-g2[]d2-e4[]g1-f1[]e4-g5[]f1-h1[]h6-h5[]h3-h4[]g5-e4[]h1-f1[]f5-g4[]f1-e1[]e4xf2[white won]">
<param name="whiteplayer" value="Zlotnikov, M">
<param name="blackplayer" value="Waitzkin, J">
<param name="gameinfomation" value="Zlotnikov vs. Waitzkin, 1997.cmg">
</applet>

4. Modify the applet size by changing the value of width and height. The standard size is 511 and 467.

5. Modify applet parameter values.  Do not change the parameter name.
   "position"
       The initial position of pieces.  Each piece is represented by two 
       characters (X position and Y Position). 
       The normal start position for these 32 piece is 
       a1b1c1d1e1f1g1h1a2b2c2d2e2f2g2h2a8b8c8d8e8f8g8h8a7b7c7d7e7f7g7h7
       If you want remove one piece at start up, just change that piece 
       postion to "z0". (See end game example).
   "movenotation"
       1 means coordinate notation, 2 means algebraic notation
   "whomovefirst"
       0 means white move first, 16 means black move first
   "themovelist"
       Each move step follows the format of e2-e4[comment] for coordinate           notation. If you do not have comment for that step, there must be an         empty "[]" for that step.  The move list could be very long, do not          add line break in the middle of the move list.  Just keep it in 
       one line.
   "whiteplayer"
       The name of white player.
   "blackplayer"
       The name of black player.
   "gameinfomation"
       The information about this game.

6. End game example

<center>
<applet archive="jchess.jar" code="jchess.class" width="511" height="467">
<param name="position" value="z0z0z0c3e5z0z0z0z0z0z0z0z0z0z0z0z0z0z0z0e8z0z0z0z0z0z0z0z0z0z0z0">
<param name="movenotation" VALUE="2">
      <param name="whomovefirst" VALUE="0">
      <param name="themovelist" value="Qc7[]Kf8[]Kf6[]Kg8[]Qg7[]">
      <param name="whiteplayer" value="YanCheng">
      <param name="blackplayer" value="Chessmaster 5500">
      <param name="gameinfomation" value="Malaysia">
</applet>
</center>

The Source Code
===============
Source code may be purchased by US50.00. To those who are interested, e-mail to the author by yccheok@yahoo.com


Note When Using Algebraic Notation
==================================
1. Current version still doesn't fully support standard algebraic notation. It needs full description to move a piece if there is another same type of piece in the same file or same rank. 

eg: there are two rooks at a1 and a5 respectively and a pawn block on a2, to move rook at a5 to a3 (In standard algebraic notation, this described as Ra3. However, this may move the a1 rook), you need to type R5a3 or Ra5a3
for more information, refer to
http://www.geocities.com/yccheok/jchess/bug/index.html

2. When checking, simply ignore the '+' sign.
eg: change Ha3+ to Ha3

3. For promotion, simply add =q in the end of the string. (lower case)
eg: c8=q

Note When Using Coordinate Notation
===================================
1. When En Passant occurs, add 'ep' at the end of the string
eg: cexd6ep

2. For promotion, simply add =q in the end of the string. (upper case)
eg: h7-h8=Q

Bug Report/Feedback
===================
Please email bug report or feedback to yccheok@yahoo.com 

Development History
===================
3/24/2000 Beta version
Initial release, support only coordinate notation

4/25/2000 Bugs fixed
En Passant function fixed. Turn the class file into jar type to increase download time. 

4/26/2000 Lower case
Support lower case.

5/16/2000 1.00 version
Major upgrading, support both coordinate and algebraic notation. 
Fixed the bug on En Passant (change from exp to ep).
Visitors can click on the logo to access my web site.