Dokumentation des Winboard-Konverters fr Chess Genius 6 + 6.5
=========================
Release 1999-01-31

Der von Stefan Meyer-Kahlen entwickelte Winboard-Konverter ermglicht
die Anbindung von allen Schachprogrammen, die mit der Freeware-Oberflche
Winboard 4.0 kompatibel sind.


1. Inhalt des Ordners
2. Installation
3. Wie funktioniert die Anbindung unter Chess Genius 6.5?
4. Was ist das Winboard?
5. Beispiel fr die Anbindung einer Winboard engine:
6. Anmerkungen
6.1 Prinzipiell
6.2 Engine Optionen
6.2.1 Permanent brain
6.2.2 Bewertung fr Weiss im Analysemodus
6.2.3 Aktuellen Zug anzeigen
6.3 Weitere Einstellungen
6.3.1 HashTables Grsse
6.3.2 Erffnungsbuch
6.3.3 Engine matches
6.3.4 Andere Engine-Einstellungen


1. Inhalt?
Im Ordner finden Sie zwei bentigte Dateien fr die Anbindung der Winboard-Engines
unter Chess Genius.

WBConv.dll     Der Winboard Converter.
Winboard.eng   Ein Muster fr die Schnittstelle (Dateiendung *.eng), um
neue Winboard-Engines hinzuzufgen.

2. Funktionsweise

Sowohl Winboard als auch Chess Genius stellen eine Benutzerschnittstelle fr
Schachprogramme unterschiedlicher Autoren zur Verfgung. Beide Oberflchen unterscheiden 
sich erheblich vom Funktionsumfang und der Konzeption. Aus diesem Grund gibt es keine direkte 
Mglichkeit, Winboard-Engines unter Chess Genius 6.5 zu starten. Der beiliegende Winboard-Konverter
fungiert quasi als Dolmetscher zwischen der Benutzeroberflche von Chess Genius 6.5 und dem Schachprogramm
(=Engine).
Eine Schnittstellendatei mit der Endung *.Eng enthlt alle informationen fr den Winboard-Konverter, um eine 
problemlose Kommunikation zwischen Winboard-Engine und dem Interface von Chess Genius 6.5 sicherzustellen. Die
Schnittstellendateien liegen als Textdatei vor und knnen mit jedem beliebigen Texteditor bearbeitet und an die
Spezifikationen der einzelnen Winboard-Engines angepasst werden.

3. Was bedeutet Winboard?
Winboard ist eine als Freeware vertriebene, grafische Benutzeroberflche fr Schachprogramme. Gleichzeitig kann
das Programm als Interface zum Schachspielen (online!) im Internet genutzt werden.Winboard untersttzt mittlerweile
eine Vielzahl von frei verfgbaren Engines.
Die aktuellste Version des Winboards finden Sie im Internet unter:
http://www.research.digital.com/SRC/personal/Tim_Mann/chess.html
Auf dieser Seite finden Sie auch zahlreiche Links (Bezugsadressen)fr diverse kompatible Schachprogramme, also
Engines.


4. Beispiel zur Anbindung einer WB-Engine unter Chess Genius 6.5

  1.  Legen Sie ein Unterverzeichnis mit der Bezeichnung "Genius65\engines" an.
  2.  Kopieren Sie die Winboard-Engine incl. der bentigten Dateien in dieses Verzeichnis.
  3.  Kopieren Sie die Datei "WBConv.dll" in das gleiche Unterverzeichnis.
  4.  Kopieren Sie die mitgelieferte Datei "Winboard.eng" in das Stammverzeichnis des Genius 6.5 und benennen Sie die
	Datei z.B. in "MyEngine.eng" um.
  5.  Passen Sie die Datei an die Vorgaben des Programms an und beachten Sie die Hinweise innerhalb der Textdatei.


6. Anmerkungen
6.1 Prinzipiell
Der Winboard-Konverter funktioniert ausschliesslich mit Engines, die zu Winboard4 kompatibel sind. Einige Engines
untersttzen nicht alle Features des Winboards, z.B. Analysemodi, Permanent Brain oder Stellungseingaben. Chess Genius 6.5
ignoriert in solchen Fllen die Vorgaben der WB-Engine. In manchen Fllen ist es notwendig, die Engine zu schliessen und 
unter Chess Genius neu zu starten.

Bei manchen Winboard-Engines wurden der Befehlssatz des Winboards nicht korrekt implementiert. Dies kann u.U. zu nicht 
vorauszusehenden Resultaten fhren.Aufgrund der hufig nicht korrekt implementierten Standards von Seiten der WB-Programmierer kann es vorkommen, dass manche Engines nicht vollstndig korrekt laufen. Analyseresultate werden nicht korrekt
angezeigt u.s.w.Zwischnezeitlich laufen aber diverse Engines zufriedenstellend unter Chess Genius 6.5.

6.2 Engine-Optionen
Drei elementare Optionen knnen unter Genius 6.5 gesetzt werden.

6.2.1 Permanent brain
Permanent Brain (Rechnen whrend der gegnerischen Bedenkzeit) kann an- oder abgeschaltet werden. Bedingung:
die jeweilige Engine muss dieses Feature untersttzen. 

6.2.2 Analyseanzeige aus weisser Sicht
Die Engines zeigen die Bewertung der aktuellen Brettstellung immer aus der Sicht von Weiss, nicht aus der
Sicht der Partei, die gerade am Zug ist, an.

6.2.3 Aktuellen Zug anzeigen
Die Engine kann den momentan berechneten Zug anzeigen.

6.3 Zustzliche Einstelloptionen

6.3.1 HashTables
Die Grsse der HashTabellen einer Winboard-Engine stellen Sie ber die 
Initialisierungsdateien der jeweiligen Winboard-Engine ein. Im Lieferumfang der Winbaord-Engines finden
Sie in den mitgelieferte Textdateien zahlreiche Hinweise zur Konfiguration der HashTables. Bitte achten Sie auf
diese und die in der musterdatei "Winboard.Eng" enthaltenen Hinweise.
Manche Engines setzen mehrere Tabellen (z.B. Bewertungstabellen)im Arbeitsspeicher ein, um den Suchvorgang zu 
optimieren.Falls die Werte zu hoch eingestellt wurden, kann es passieren, dass die Engine unter Chess Genius gar
nicht oder nur zhflssig luft. Beachten Sie unbedingt die Dokumentation der jeweiligen Engine. 

6.3.2 Erffnungsbuch
Unter ChessGenius 6.5 benutzen fast alle Winboard Engines das Buch von Genius 6.5. Aus diesem Grund empfiehlt es
sich, den Zugriff der Engine auf interne Bcher abzuschalten.

6.3.3 Engine Matches
Permanent Brain sollte fr aussagekrftige Resultate bei Engine-Matches abgeschaltet werden.Schalten Sie ebenfalls
den Zugriff auf Endspieldatenbanken unter Genius 6.5 (Grundeinstellungen) ab.

6.3.4 Andere Engine Einstellungen
Es gibt keinen Support fr Winboard-Kommandos, um die Engineeinstellungen via Konverter zu steuern. Alle 
Einstellungen werden ber Initialisieungsdateien vorgenommen. Beachten Sie die Dokumentationen der jeweiligen
Autoren.

7. Eng-Dateien
Eine wichtige Schnittstelle zwischen Winboard-Engine und Genius 6.5 sind die Dateien mit der Endung *.eng. Im
Verlauf der Installation des Genius 6.5 werden bereits zwei Winboard-Engines (Crafty + Wbnimzo2000b) unter dem 
System eingebunden. Schauen Sie sich zum besseren Verstndnis unbedingt die beiden Eng-Dateien im Stammverzeichnis
des Genius 6.5 an. Die Dateien liegen im Textformat vor. 
Die Eng-Dateien enthalten von  der Benutzerschnittstelle des Genius 6.5 bentigte Informationen, damit die jeweilige
WB-Engine anstandslos luft. Sie mssen z.B.in der Textdatei die Pfadangabe der Engine angeben u.s.w.

Anbei eine Beschreibung der prinzipiellen Vorgehensweise zur Einbindung einer WB-Engine:

a.) Legen Sie im Verzeichnis des Chess Genius einen Unterordner "Engines" an.
b.) Kopieren Sie die WB-Engine incl. der bentigten Dateien in diesen Ordner.
c.) Beachten Sie die Dokumentation der jeweiligen Engine und passen die Initialiserungsdateien an.
d.) Bennen Sie die mitgelieferte Datei "Winboard.Eng" um, z.B. in Crafty.eng.
e.) Nehmen Sie nahand der Musterdatei die entsprechenden Anpassungen fr die Engine vor. Beachten
Sie die Hinweise innerhalb dieser Textdatei.
f.) Die jeweilige Engine knnen Sie unter Genius 6.5 im Men OPTIONEN unter Engine laden aktivieren.

Zur Orientierung und dem besseren Verstndnis der Funktionsweise betrachten Sie sich die Eintrge der
bereits vorinstallierten Winboard-Engines Crafty und WbNimzo2000b.

=====================================================================
Winboard Converter Copyright (c) 1999 von Stefan Meyer-Kahlen.

Die Rechte fr den Winboard-Konverter liegen bei Stefan Meyer-Kahlen.

Der Winbaord-Konverter darf unter Vorbehalt weitergegeben werden. Die vorliegende Dokumentation darf dabei
in keinster Weise verndert werden.

Millennium2000 GmbH
Liebigstr. 28
80 538 Mnchen
http://www.computerchess.com
support: rm@computerchess.com