Bright Copyright (C) 2006-2010 AJ Siemelink. All rights reserved.
==============================================================================


License
==============================================================================
See license.txt for the license that applies to this software.


Installation
==============================================================================
Bright is a chess engine. To be able to actually play a game, you will need a
chess GUI. If you do not have a chess GUI, you can download a free one here:
http://www.playwitharena.com.

To install the engine, follow these steps:
- extract the 7zip-file to a directory of your choice
- configure your gui to execute the file 'bright-<version>.exe' to start bright.
- configure your gui to use the UCI-protocol for communications with bright.
- if your GUI does not support the UCI-protocol, but it does support the 
  Winboard-protocol, you can try if the experimental native Winboard support 
  works for you.
  Alternatively,you can use Polyglot by Fabien Letouzey to run bright.
  PolyGlot can be downloaded here:
  http://wbec-ridderkerk.nl/html/details/PolyGlot.html

- optionally, you can start bright from a commandline: 

	bright-<version>.exe [inifile]

  If no ini file is supplied, bright will look for the file "bright.ini" in 
  the current directory.
  type help to see the available options.



Multiple CPU cores
==============================================================================
Bright will automatically detect if your computer has multiple CPU cores and 
will by default make use of all of the cores.

If you are running other CPU intensive programs, you may want to limit the 
number of cores that bright uses. To accomplish this, you can either
a) set the UCI Threads option to the desired number of cores (use your GUI)
b) edit the bright.ini file: change the line that reads "search.nthreads=" to
   read "search.nthreads=x"
   where x is the desired number of cores.

When you start bright.exe from a command line, it will report the number of 
cores it will use. Look for the message that says
	"!--using parallel search with [x] threads!", 
Here, [x] is the number of cores that will be used. 
If you do not see this message, only 1 core will be used.



EGBB configuration
==============================================================================
- If you do not yet have Scorpio EGBB's installed, they can be downloaded from
  http://wbec-ridderkerk.nl/html/details/Scorpio.html
- open the file bright.ini
- change the entry "egbb.dir=":
  make it point to the directory where you have installed the scorpio bitbases.
  e.g. egbb.dir=C:\chess\egbb
- You can test whether EGBB's are installed properly by starting bright from a
  command prompt. 
  If you see "egbb.3men=1", then 3 men egbb's were found and work correctly
  If you see "egbb.4men=1", then 4 men egbb's were found and work correctly
  If you see "egbb.5men=1", then 5 men egbb's were found and work correctly



Book Building
==============================================================================
When playing games, bright will look for the opening book file that is 
specified in the ini-file entry "book.file".

You can build your own opening book, by following these steps:
- start bright-xxx.exe from a dos box
- use the command "buildbook <pgnfile> [inifile]" to build a new book. 
  The inifile parameter is optional.  This will create a book in the current 
  directory and the name will be <pgnfile>.bbk.
  When the book has been created (it may take a while), the book contents for
  the initial position will be displayed.
  Consult the comments in the bright.ini file for information regarding
  custom book building options.
- Now, you can enter moves on the command line and query the contents of te
  book by using the "book" command.
- If not satisfied with the book contents, edit the book creation options in
  the ini-file and repeat all the steps outlined above.
- the command "mergebook <masterbook> <secondarybook> <resultbook>" may be 
  used two augment the masterbook with moves from the secondary book. 
  Moves from positions that occur in the masterbook are copied verbatim to the resultfile.
  Only when a position does not occur in the masterbook, but it does occur in 
  the secondary book, the moves from the secondary book are added to the result book.
  The option is useful two combine books of different quality, e.g. the masterbook
  may be a book that was built from a carefully authored pgn-file, while the secondary
  book may have been built with different parameters from a large file of unchecked 
  games by players with high elo.




Thanks to
==============================================================================
Graham Banks    (CCRL)
Ray Banks       (FRC testing)
Dr. Wael Deeb   (opening book)
Olivier Deville (Chesswar)
Leo Dijksman    (WBEC)
Sergio Martinez (La Liga)
Jorge Prada     (analysis)
Rainer Serfling (CEGT)
Daniel Shawul   (Scorpio/egbb)
Guenther Simon  (RWBC)
Swaminathan     (WCCC operator)
