5 <title>WinBoard 4.4.0</title>
\r
9 <table><tr><td halign="top">
\r
10 <h1>WinBoard 4.4.0</h1>
\r
11 <h2>"For the ultimate WinBoard experience"</h2>
\r
12 <h3>Introduction</h3>
\r
14 The WinBoard 4.3 series was a continuation of the WinBoard_x line by Allessandro Scotti.
\r
15 It has 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 were unfortunately not parallelled in XBoard.
\r
19 On the contrary, they had 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 comes 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 the latest XBoard version.
\r
24 But some can, an in 4.3.15 many more have been added.
\r
26 WinBoard 4.4 is a merger of the WinBoard 4.3 line (WinBoard 4.3.pre16)
\r
27 and what was left in the GNU-Svannah XBoard repository (WinBoard 4.2.pre8).
\r
28 More WinBoard functionality has been ported to XBoard,
\r
29 but there still is a sizable gap to bridge.
\r
31 The description below applies specifically to WinBoard,
\r
32 although we have tried to mark features that can also be used in xboard by (x) everywhere.
\r
33 This version of XBoard now does have some new menus added to control such features.
\r
34 Other functions, if they work at all, must be switched on from the command line.
\r
36 </td><td width="20">
\r
37 </td><td width="200" halign="center" cellpdding="20">
\r
38 <img src="mini.gif">
\r
40 <h3>New features since 4.2.7b</h3>
\r
42 Below follows a table that lists the new features,
\r
43 the command-line option needed to control them,
\r
44 and if there is a menu provided that can switch the option while WinBoard is running
\r
45 (command-line options exert their effect only at startup).
\r
46 Note that, unlike WinBoard 4.2.7, the WinBoard 4.3 series is fully castling and e.p. aware,
\r
47 and handles the castling, e.p. and 50-move field in FENs on input and output as should be expected.
\r
49 <table cellpadding="3" border="1"><tr><td width="220">
\r
50 <h3>command-line option</h3>
\r
52 <h3>description</h3>
\r
53 </td><td width="250">
\r
57 </td><td bgcolor="lightblue">
\r
58 <strong>ENGINE-ENGINE ADJUDICATION OPTIONS<strong>
\r
62 -adjudicateLossThreshold 0 (*x)
\r
64 adjudicates engine-engine game based on score
\r
66 Options -> Engine... (x)
\r
68 -checkMates false (*x)
\r
70 detect and end game on checkmates and stalemates
\r
72 Options -> Engine... (x)
\r
74 -testClaims false (*x)
\r
76 WinBoard corrects false RESULT claims
\r
78 Options -> Engine.. (x)
\r
80 -materialDraws false (*x)
\r
82 adjudicate draw when no mating material present
\r
84 Options -> Engine.. (x)
\r
86 -trivialDraws false (*x)
\r
88 adjudicate draw in endgames like KRKR and KNNK
\r
90 Options -> Engine.. (x)
\r
92 -adjudicateDrawMoves 0 (*x)
\r
94 adjudicate draw when game lasts too long
\r
96 Options -> Engine.. (x)
\r
100 number of reversible moves after which to adjudicate draw
\r
102 Options -> Engine.. (x)
\r
104 -repeatsToDraw 6 (*x)
\r
106 adjudicate draw when a position occurs this many times
\r
108 Options -> Engine.. (x)
\r
110 -firstScoreAbs false (x)
\r
112 -secondScoreAbs false (x)
\r
114 Engine indicates score for white, even when playing black
\r
116 Options -> Adjudications.. (xboard-only)
\r
120 Adjudicate the game in progress as win to white, win to black, or draw
\r
122 Action -> Adjudicate to White
\r
124 Action -> Adjudicate to Black
\r
126 Action -> Adjudicate Draw
\r
129 </td><td bgcolor="lightblue">
\r
130 <strong>TIME-CONTROL AND TIMING OPTIONS</strong>
\r
134 -firstTimeOdds 1 (x)
\r
136 -secondTimeOdds 1 (x)
\r
138 reduce the thinking time of the mentioned engine by the given factor
\r
140 Options -> Engine Settings.. (xboard only)
\r
142 -timeOddsMode 1 (*x)
\r
144 determines what happens when both engine have time odds
\r
146 Options -> Engine Settings.. (xboard only)
\r
152 engine must use node count for its time control, as if running at specified rate
\r
156 -matchPause 10000 (*x)
\r
158 number of msec to wait between games in match mode
\r
162 -delayBeforeQuit 0 (*x)
\r
164 -delayAfterQuit 0 (*x)
\r
166 timing parameter specifying how to terminate the engine processes
\r
172 adjust the clocks by 1 minute (up or down)
\r
174 left- or right-cick on clock in edit-game mode
\r
176 -niceEngines 0 (*x)
\r
178 lower the CPU priority of the engines
\r
183 </td><td bgcolor="lightblue">
\r
184 <strong>DISPLAY-LOOK OPTIONS</strong>
\r
188 -liteBackTextureFile "" (*)
\r
190 -darkBackTextureFile "" (*)
\r
192 -liteBackTextureMode 1 (*)
\r
194 -darkBackTextureMode 1 (*)
\r
196 Allows you to use any bitmap picture for displaying the board square
\r
200 -renderPiecesWithFont "" (*)
\r
202 specifies a true-type Chess font to be used for piece symbols
\r
206 -fontPieceToCharTable "" (*)
\r
208 specifies which font character to use for the various piece types
\r
212 -overrideLineGap 1 (*)
\r
214 controls the width of the black grid lines between squares
\r
218 -fontPieceBackColorWhite #0 (*)
\r
220 -fontPieceForeColorWhite #0 (*)
\r
222 -fontPieceBackColorBlack #0 (*)
\r
224 -fontPieceForeColorBlack #0 (*)
\r
226 control piece colors in font-based rendering
\r
230 -fontPieceSize 80 (*)
\r
232 tunes the size of pieces in font-based rendering (% of square size)
\r
236 -highlightMoveWithArrow false (*)
\r
238 draws a big arrow to indicate the move last played
\r
240 Options -> General...
\r
242 -highlightArrowColor #FFFF80 (*)
\r
244 controls the color of the highlight arrow
\r
248 -autoLogo false (*)
\r
254 causes WinBoard to display player logos above the board, next to the clocks.
\r
260 Swap white and black clock
\r
262 Options -> Swap Clocks
\r
265 </td><td bgcolor="lightblue">
\r
266 <strong>(UCI) ENGINE OPTIONS</strong>
\r
270 -polyglotDir "" (*x)
\r
272 tells WinBoard where you installed Polyglot, for automatic invocation with UCI engines
\r
274 Options -> Global Settings... (x)
\r
276 -polyglotBook "" (*x)
\r
278 tells WinBoard which opening book it should use, or should make Polyglot use.
\r
280 Options -> Global Settings... (x)
\r
282 -usePolyglotBook false (*x)
\r
284 turns the use of the Polygot book on or off
\r
286 Options -> Global Settings... (x)
\r
288 -defaultPathEGTB "c:\egtb" (*x)
\r
290 folder where to find end-game tables
\r
292 Options -> Global Settings... (x)
\r
294 -defaultCacheSizeEGTB 4 (*x)
\r
296 specifies the cache size for UCI engines
\r
298 Options -> Global Settings... (x)
\r
300 -defaultHashSize 64 (*x)
\r
302 specifies the size of the main hash table for UCI engines and WinBoard engines implementing the memory command
\r
304 Options -> Global Settings... (x)
\r
306 -firstIsUCI false (x)
\r
308 -secondIsUCI false (x)
\r
314 tells WinBoard the corresponding engine should be run through Polyglot
\r
318 -firstHasOwnBookUCI true (x)
\r
320 -secondHasOwnBookUCI true (x)
\r
322 -fNoOwnBookUCI true (x)
\r
324 -sNoOwnBookUCI true (x)
\r
330 tells WinBoard (or Polyglot) if the engine should use its own opening book
\r
332 Options -> Global Settings... (x)
\r
336 sets the maximum number of CPUs an SMP engine can use.
\r
337 (only affects engines that support the <strong>cores</strong> command of WB protocol)
\r
339 Options -> Global Settings... (x)
\r
341 -egtFormats "" (*x)
\r
343 specifies which end-game tables are installed on the computer,
\r
344 and where they can be found
\r
345 (e.g. "nalimov:\chess\egtb,scorpio:\chess\bitbases")
\r
349 -firstOptions "" (x)
\r
351 -secondOptions "" (x)
\r
353 sets engine-defined options of UCI engines and WinBoard engines that support the option feature.
\r
355 Options -> Engine #1 Settings... (x)
\r
357 Options -> Engine #2 Settings... (x)
\r
359 -firstNeedsNoncompliantFEN "" (x)
\r
361 -secondNeedsNoncompliantFEN "" (x)
\r
363 directly specifies castling and e.p. field to be used in all FENs sent to mentioned engine
\r
368 </td><td bgcolor="lightblue">
\r
369 <strong>CHESS-VARIANT OPTIONS</strong>
\r
373 -boardHeight -1 (*x)
\r
375 -boardWidth -1 (*x)
\r
377 -holdingsSize -1 (*x)
\r
379 specifies the board format and nr of piece types that can be dropped,
\r
380 when you want it to be different from what is usual in the chosen varint
\r
382 File -> New Variant...
\r
384 -variant normal (x)
\r
386 supports many new variants: xiangqi, shogi, fischerandom, capabanca, gothic, caparandom, janus,
\r
387 shatranj, courier, knightmate, berolina, falcon, cylinder, fairy, super, great
\r
389 File -> New Variant... (x)
\r
391 -defaultFrcOpening -1 (x)
\r
393 allows you to play from a specific opening shuffle, or make a new shuffle each game
\r
395 File -> New Shuffle Game... (x)
\r
397 -pieceToCharTable "" (x)
\r
399 allows you to specify by which letters pieces are referred to in FEN and SAN,
\r
400 if you want to deviate from what is usual for the current variant
\r
404 -flipBlack fase (*x)
\r
406 displays opponent pieces uppside down (for Shogi)
\r
408 Options -> Board...
\r
410 -allWhite false (*x)
\r
412 use white bitmaps (with black outline) also for display of black pieces (for Shogi)
\r
414 Options -> Board...
\r
417 </td><td bgcolor="lightblue">
\r
418 <strong>PGN FILE OPTIONS</strong>
\r
422 -pgnExtendedInfo false (*x)
\r
424 save engine output (depth, score time) in PGN
\r
426 Options->General...
\r
428 -pgnEventHeader </br>"Computer Chess Game" (*x)
\r
430 specify the event for the PGN event tag
\r
434 -saveOutOfBookInfo true (*)
\r
436 include an 'annotator' tag in the PGN file
\r
440 -hideThinkingFromHuman false (*x)
\r
442 suppresses the engine thinking output in the display, without the need to switch it off
\r
443 (so it can still appear in the PGN file)
\r
445 Options -> General... (x)
\r
449 sets the name of the human player
\r
451 Mode -> Enter Username... (x)
\r
454 </td><td bgcolor="lightblue">
\r
455 <strong>USER-INTERFACE OPTIONS AND WINDOW CONTROL</strong>
\r
459 -moveHistoryUp true (*)
\r
461 -moveHistoryX 0 (*)
\r
463 -moveHistoryY 0 (*)
\r
465 -moveHistoryW 0 (*)
\r
467 -moveHistoryH 0 (*)
\r
469 controls opening, placement and size of a window containing the moves of the current game
\r
470 (new in 4.4 is that all X and Y coordinates of auxiliary windows are stored relative to the main window)
\r
472 Mode -> Show Move History (x)
\r
474 -evalGraphUp true (*)
\r
484 controls opening, placement and size of a window containing a graph of the
\r
485 evaluation score of the engine(s) as a function of move number of the current game
\r
487 Mode -> Show Evaluation Graph
\r
489 -engineOutputUp true (*)
\r
491 -engineOutputX 0 (*)
\r
493 -engineOutputY 0 (*)
\r
495 -engineOutputW 0 (*)
\r
497 -engineOutputH 0 (*)
\r
499 controls opening, placement and size of a window containing the thinking output of the engine(s)
\r
501 Mode -> Show Engine Output (x)
\r
503 -stickyWindows true (*)
\r
505 make the various windows snap onto each other, and stick together
\r
509 -showEvalInMoveHistory true (*)
\r
511 depth/score info of the engine is included as comments in the move history window
\r
513 Options -> General...
\r
515 -evalHistColorWhite #FFFFB0 (*)
\r
517 -evalHistColorBlack #AD5D3D (*)
\r
519 determines the color of the eval-score comments in the move-history window
\r
523 -autoDisplayComment true (*)
\r
525 causes a window for displaying PGN comments to pop up automatically when such a comment is encountered
\r
529 -autoDisplayTags true (*)
\r
531 causes a window with PGN tags to be displayed as soon as a PGN file is loaded
\r
535 -gameListTags "eprd" (*)
\r
537 specifies the PGN tags that should be displayed in the game list
\r
539 Options -> Game List...
\r
543 suppress update of display on all machine and ICS moves (moves, clocks, icon)
\r
548 </td><td bgcolor="lightblue">
\r
549 <strong>ICS OPTIONS</strong>
\r
555 kibitz engine Thinking Output to ICS, and capture opponent kibitz for in PGN
\r
559 -zippyShortGame 0 (x)
\r
561 ban opponents on ICS that abort without playing
\r
566 </td><td bgcolor="lightblue">
\r
567 <strong>MISCELLANEOUS</strong>
\r
571 -debugFile "winboard.debug" (x)
\r
573 -nameOfDebugFile "winboard.debug" (x)
\r
575 allows you to specify an alternative name for saving the debug information
\r
579 -engineDebugOutput 0 (x)
\r
581 tells WinBoard if and how to put protocol-violating output in the debug file
\r
587 save chess-board display as diagram in bitmap file
\r
588 (only works for the smaller board formats!)
\r
590 File -> Save Diagram...
\r
592 -defaultFrcPosition -1 (*x)
\r
594 specify the number of the starting position in shuffle Chess variants
\r
596 File -> New Shuffle Game... (x)
\r
600 display only those lines in the game list that contain a given string
\r
602 in Game-List window
\r
606 A nonzero value for this option causes the loadGameIndex or loadPositionIndex
\r
607 to rewind to the beginning of the Games or Position file when it reaches
\r
608 the given value in auto-increment match mode.
\r
609 This mode is specified by a negative value as argument of the /lgi or /lpi options,
\r
610 where -1 increments the index after every game of the match,
\r
611 and -2 after every two games (so that each position is played with black and white).
\r
615 -sameColorGames 0 (x)
\r
617 play a match, but without alternating the colors (overrules -matchGames)
\r
622 The value with which the option is listed is the default value.
\r
623 If it is false or true, it is a Boolean option, a number implies an integer option.
\r
624 A value starting with # indicates an RGB color indication in hexadecimal notation.
\r
625 Options the settings of which are saved into the winboard.ini file are marked with (*).
\r