5 <title>WinBoard 4.3.15</title>
\r
9 <table><tr><td halign="top">
\r
10 <h1>WinBoard 4.3.15</h1>
\r
11 <h2>"For the ultimate WinBoard experience"</h2>
\r
12 <h3>Introduction</h3>
\r
14 The WinBoard 4.3 series is a continuation of the WinBoard_x line by Allessandro Scotti.
\r
15 It is been further developed, and is maintained, by H.G. Muller.
\r
16 Most addtions and improvements that went into this since the last version produced
\r
17 by the GNU-Savannah xboard project team, WinBoard 4.2.7b,
\r
18 are unfortunately not parallelled in xboard.
\r
19 On the contrary, they have destroyed the compatibility of the back-end sources
\r
20 shared by WinBoard and xboard with the xboard front-end of version 4.2.7b.
\r
21 Since WinBoard 4.3.14, however, the releases again coms with a compatible xboard front-end.
\r
22 That does not mean that all the features added to WinBoard can already be used
\r
23 in this xboard version.
\r
24 But some can, an in 4.3.15 many more have been added.
\r
26 The description below applies specifically to WinBoard,
\r
27 although we have tried to mark features that can also be used in xboard by (x) everywhere.
\r
28 This version of xboard does does have som new menus added to control such features.
\r
29 Other functionss, if they work at all, must be switched on from the command line.
\r
31 </td><td width="20">
\r
32 </td><td width="200" halign="center" cellpdding="20">
\r
33 <img src="mini.gif">
\r
35 <h3>New features since 4.2.7b</h3>
\r
37 Below follows a table that lists the new features,
\r
38 the command-line option needed to control them,
\r
39 and if there is a menu provided that can switch the option while WinBoard is running
\r
40 (command-line options exert their effect only at startup).
\r
41 Note that, unlike WinBoard 4.2.7, the WinBoard 4.3 series is fully castling and e.p. aware,
\r
42 and handles the castling, e.p. and 50-move field in FENs on input and output as should be expected.
\r
44 <table cellpadding="3" border="1"><tr><td width="220">
\r
45 <h3>command-line option</h3>
\r
47 <h3>description</h3>
\r
48 </td><td width="250">
\r
52 </td><td bgcolor="lightblue">
\r
53 <strong>ENGINE-ENGINE ADJUDICATION OPTIONS<strong>
\r
57 -adjudicateLossThreshold 0 (*x)
\r
59 adjudicates engine-engine game based on score
\r
61 Options -> Engine... (x)
\r
63 -checkMates false (*x)
\r
65 detect and end game on checkmates and stalemates
\r
67 Options -> Engine... (x)
\r
69 -testClaims false (*x)
\r
71 WinBoard corrects false RESULT claims
\r
73 Options -> Engine.. (x)
\r
75 -materialDraws false (*x)
\r
77 adjudicate draw when no mating material present
\r
79 Options -> Engine.. (x)
\r
81 -trivialDraws false (*x)
\r
83 adjudicate draw in endgames like KRKR and KNNK
\r
85 Options -> Engine.. (x)
\r
87 -adjudicateDrawMoves 0 (*)
\r
89 adjudicate draw when game lasts too long
\r
91 Options -> Engine.. (x)
\r
95 number of reversible moves after which to adjudicate draw
\r
97 Options -> Engine.. (x)
\r
99 -repeatsToDraw 6 (*x)
\r
101 adjudicate draw when a position occurs this many times
\r
103 Options -> Engine.. (x)
\r
105 -firstScoreAbs false (x)
\r
107 -secondScoreAbs false (x)
\r
109 Engine indicates score for white, even when playing black
\r
111 Options -> Adjudications.. (xboard-only)
\r
115 Adjudicate the game in progress as win to white, win to black, or draw
\r
117 Action -> Adjudicate to White
\r
119 Action -> Adjudicate to Black
\r
121 Action -> Adjudicate Draw
\r
124 </td><td bgcolor="lightblue">
\r
125 <strong>TIME-CONTROL AND TIMING OPTIONS</strong>
\r
129 -firstTimeOdds 1 (x)
\r
131 -secondTimeOdds 1 (x)
\r
133 reduce the thinking time of the mentioned engine by the given factor
\r
135 Options -> Engine Settings.. (xboard only)
\r
137 -timeOddsMode 1 (*x)
\r
139 determines what happens when both engine have time odds
\r
141 Options -> Engine Settings.. (xboard only)
\r
147 engine must use node count for its time control, as if running at specified rate
\r
151 -matchPause 10000 (*x)
\r
153 number of msec to wait between games in match mode
\r
157 -delayBeforeQuit 0 (*)
\r
159 -delayAfterQuit 0 (*)
\r
161 timing parameter specifying how to terminate the engine processes
\r
167 adjust the clocks by 1 minute (up or down)
\r
169 left- or right-cick on clock in edit-game mode
\r
172 </td><td bgcolor="lightblue">
\r
173 <strong>DISPLAY-LOOK OPTIONS</strong>
\r
177 -liteBackTextureFile "" (*)
\r
179 -darkBackTextureFile "" (*)
\r
181 -liteBackTextureMode 1 (*)
\r
183 -darkBackTextureMode 1 (*)
\r
185 Allows you to use any bitmap picture for displaying the board square
\r
189 -renderPiecesWithFont "" (*)
\r
191 specifies a true-type Chess font to be used for piece symbols
\r
195 -fontPieceToCharTable "" (*)
\r
197 specifies which font character to use for the various piece types
\r
201 -overrideLineGap 1 (*)
\r
203 controls the width of the black grid lines between squares
\r
207 -fontPieceBackColorWhite #0 (*)
\r
209 -fontPieceForeColorWhite #0 (*)
\r
211 -fontPieceBackColorBlack #0 (*)
\r
213 -fontPieceForeColorBlack #0 (*)
\r
215 control piece colors in font-based rendering
\r
219 -fontPieceSize 80 (*)
\r
221 tunes the size of pieces in font-based rendering (% of square size)
\r
225 -highlightMoveWithArrow false (*)
\r
227 draws a big arrow to indicate the move last played
\r
229 Options -> General...
\r
231 -highlightArrowColor #FFFF80 (*)
\r
233 controls the color of the highlight arrow
\r
239 Swap white and black clock
\r
241 Options -> Swap Clocks
\r
244 </td><td bgcolor="lightblue">
\r
245 <strong>UCI ENGINE OPTIONS</strong>
\r
249 -polyglotDir "" (*)
\r
251 tells WinBoard where you installed Polyglot, for automatic invocation with UCI engines
\r
253 Options -> UCI... (x)
\r
255 -polyglotBook "" (*)
\r
257 tells WinBoard which opening book it should use, or should make Polyglot use.
\r
259 Options -> UCI... (x)
\r
261 -usePolyglotBook false (*)
\r
263 turns the use of the Polygot book on or off
\r
265 Options -> UCI... (x)
\r
267 -defaultPathEGTB "c:\egtb" (*)
\r
269 folder where to find end-game tables
\r
271 Options -> UCI... (x)
\r
273 -defaultCacheSizeEGTB 4 (*)
\r
275 specifies the cache size for UCI engines
\r
277 Options -> UCI... (x)
\r
279 -defaultHashSize 64 (*)
\r
281 Specifies the size of the main hash table for UCI engines
\r
283 Options -> UCI... (x)
\r
293 tells WinBoard the corresponding engine should be run through Polyglot
\r
297 -firstHasOwnBookUCI true
\r
299 -secondHasOwnBookUCI true
\r
301 -fNoOwnBookUCI true
\r
303 -sNoOwnBookUCI true
\r
305 tells Polyglot if the engine should use its own opening book
\r
307 Options -> Engine Settings... (xboard only)
\r
311 Sets the maximum number of CPUs an SMP engine can use.
\r
312 (only affects engines that support the <strong>cores</strong> command of WB protocol)
\r
314 Options -> Engine Settings... (xboard only)
\r
316 -egtFormats "" (*x)
\r
318 Specifies which end-game tables are installed on the computer,
\r
319 and where they can be found
\r
320 (e.g. "nalimov:\chess\egtb,scorpio:\chess\bitbases")
\r
325 </td><td bgcolor="lightblue">
\r
326 <strong>CHESS-VARIANT OPTIONS</strong>
\r
330 -boardHeight -1 (*x)
\r
332 -boardWidth -1 (*x)
\r
334 -holdingsSize -1 (*x)
\r
336 specifies the board format and nr of piece types that can be dropped,
\r
337 when you want it to be different from what is usual in the chosen varint
\r
339 File -> New Variant...
\r
341 -variant normal (x)
\r
343 supports many new variants: xiangqi, shogi, fischerandom, capabanca, gothic, caparandom, janus,
\r
344 shatranj, courier, knightmate, berolina, falcon, cylinder, fairy, super
\r
346 File -> New Variant... (x)
\r
348 -defaultFrcOpening -1 (x)
\r
350 allows you to play from a specific opening shuffle, or make a new shuffle each game
\r
352 File -> New Shuffle Game... (x)
\r
354 -pieceToCharTable "" (x)
\r
356 allows you to specify by which letters pieces are referred to in FEN and SAN,
\r
357 if you want to deviate from what is usual for the current variant
\r
361 -flipBlack fase (*x)
\r
363 displays opponent pieces uppside down (for Shogi)
\r
365 Options -> Board...
\r
367 -allWhite false (*x)
\r
369 use white bitmaps (with black outline) also for display of black pieces (for Shogi)
\r
371 Options -> Board...
\r
374 </td><td bgcolor="lightblue">
\r
375 <strong>PGN FILE OPTIONS</strong>
\r
379 -pgnExtendedInfo false (*x)
\r
381 save engine output (depth, score time) in PGN
\r
383 Options->General...
\r
385 -pgnEventHeader </br>"Computer Chess Game" (*x)
\r
387 specify the event for the PGN event tag
\r
391 -saveOutOfBookInfo true (*)
\r
393 include an 'annotator' tag in the PGN file
\r
397 -hideThinkingFromHuman false (*x)
\r
399 suppresses the engine thinking output in the display, without the need to switch it off
\r
400 (so it can still appear in the PGN file)
\r
402 Options -> General... (x)
\r
405 </td><td bgcolor="lightblue">
\r
406 <strong>USER-INTERFACE OPTIONS AND WINDOW CONTROL</strong>
\r
410 -moveHistoryUP true (*)
\r
412 -moveHistoryX 0 (*)
\r
414 -moveHistoryY 0 (*)
\r
416 -moveHistoryW 0 (*)
\r
418 -moveHistoryH 0 (*)
\r
420 controls opening, placement and size of a window containing the moves of the current game
\r
422 Mode -> Show Move History (x)
\r
424 -evalGraphUp true (*)
\r
434 controls opening, placement and size of a window containing a graph of the
\r
435 evaluation score of the engine(s) as a function of move number of the current game
\r
437 Mode -> Show Evaluation Graph
\r
439 -engineOutputUp true (*)
\r
441 -engineOutputX 0 (*)
\r
443 -engineOutputY 0 (*)
\r
445 -engineOutputW 0 (*)
\r
447 -engineOutputH 0 (*)
\r
449 controls opening, placement and size of a window containing the thinking output of the engine(s)
\r
451 Mode -> Show Engine Output (x)
\r
453 -stickyWindows true (*)
\r
455 make the various windows snap onto each other, and stick together
\r
459 -showEvalInMoveHistory true (*)
\r
461 depth/score info of the engine is included as comments in the move history window
\r
463 Options -> General...
\r
465 -evalHistColorWhite #FFFFB0 (*)
\r
467 -evalHistColorBlack #AD5D3D (*)
\r
469 determines the color of the eval-score comments in the move-history window
\r
473 -autoDisplayComment true (*)
\r
475 causes a window for displaying PGN comments to pop up automatically when such a comment is encountered
\r
479 -autoDisplayTags true (*)
\r
481 causes a window with PGN tags to be displayed as soon as a PGN file is loaded
\r
485 -gameListTags "eprd" (*)
\r
487 specifies the PGN tags that should be displayed in the game list
\r
489 Options -> Game List...
\r
492 </td><td bgcolor="lightblue">
\r
493 <strong>MISCELLANEOUS</strong>
\r
497 -debugFile "winboard.debug"
\r
499 -nameOfDebugFile "winboard.debug"
\r
501 allows you to specify an alternative name for saving the debug information
\r
507 save chess-board display as diagram in bitmap file
\r
508 (only works for the smaller board formats!)
\r
510 File -> Save Diagram...
\r
514 display only those lines in the game list that contain a given string
\r
516 in Game-List window
\r
520 A nonzero value for this option causes the loadGameIndex or loadPositionIndex
\r
521 to rewind to the beginning of the Games or Position file when it reaches
\r
522 the given value in auto-increment match mode.
\r
523 This mode is specified by a negative value as argument of the /lgi or /lpi options,
\r
524 where -1 increments the index after every game of the match,
\r
525 and -2 after every two games (so that each position is played with black and white).
\r
530 The value with which the option is listed is the default value.
\r
531 If it is false or true, it is a Boolean option, a number implies an integer option.
\r
532 A value starting with # indicates an RGB color indication in hexadecimal notation.
\r
533 Options the settings of which are saved into the winboard.ini file are marked with (*).
\r