Fix table alignments
[xboard.git] / whats_new / 4.4.0 / WinBoardF.html
1 <!--#include virtual="/server/html5-header.html" -->
2 <title>XBoard - GNU Project - Free Software Foundation - NEWS</title>
3 <!--#include virtual="/server/banner.html" -->
4 <!--#set var="article_name" value="/server/standards/boilerplate" -->
5 <!--#include virtual="/server/gnun/initial-translations-list.html" -->
6 <h2>What is new in WinBoard 4.3?</h2>
7
8  <table cellpadding="20"><tr valign="top"><td>
9   <h4>New Features</h4>
10   <ul>
11    <li><a href="#tag-B1">Castling awareness</a></li>
12    <li><a href="#tag-B2">Extensions of WB protocol</a></li>
13    <li><a href="#tag-A1">Support for unorthodox pieces</a></li>
14    <li><a href="#tag-A2">Configuring the board format</a></li>
15    <li><a href="#tag-A3">SAN and FEN with fairy pieces</a></li>
16    <li><a href="#tag-A4">Support of complete chess variants</a></li>
17    <li><a href="#tag-A5">Bughouse piece drops and holdings display</a></li>
18    <li><a href="#tag-A6">Distinguishing promoted pieces in Bughouse</a></li>
19    <li><a href="#tag-A7">Displaying player logos</a></li>
20    <li><a href="#tag-A8">Japanese Shogi bitmaps</a></li>
21    <li><a href="#tag-C1">Added command-line options</a></li>
22
23   </ul>
24  </td><td valign="top">
25   <img src="../4.5.0/winboardF.png">
26  </td><td valign="top">
27   <p>
28    <a href="index.html">Follow-up release (4.4.0)</a>
29   </p>
30   <p>
31    <a href="Winboard_x.html">Preceding fork (Winboard_x)</a>
32   </p>
33  </td></tr></table>
34
35   <h3><a name="tag-B1">Treating castling and e.p. rights seriously</a></h3>
36   <p>
37    One of the most important changes betwen WinBoard 3.4 and predecessors is that it is fully aware of the game state.
38    That is, it keeps track of castling rights and e.p. status,
39    and takes that knowledge into account in legality checking of the moves and mate testing.
40    As a result it can do 100% reliable adjudications:
41    forfeit engines that do illegal moves, or make false result claims,
42    and terminate the game on 3-fold repetition of due to the 50-move rule.
43   </p>
44
45  <table cellpadding="20"><tr><td valign="top">
46   <h3><a name="tag-A1">Supporting fairy pieces</a></h3>
47   <p>
48    WinBoard F does not only support the six piece types of orthdox chess,
49    but expanded the number to 22.
50    Most of these have well-specified moves known to WinBoard,
51    such as the Archbishop (a B+N compound) and the Chancellor (R+N) of Capablanca Chess.
52    Others are wild cards just supplied as graphics, and can only be used with legality testing off.
53   </p><p>
54    In board sizes middling (49) and bulky (72) a bitmap for each of these 22 pieces is supplied,
55    while size petite (33) supports most.
56    In the intermediate sizes, only Archbishop and Chancellor are available,
57    while for sizes below 33 and above 72, none are.
58    Some of the more common piece types, such as those for Chinese or Capablanca Chess,
59    were added to the piece menu in Edit Position mode,
60    while others can be made by 'promoting' or 'demoting' the more common ones.
61   </p>
62  </td><td valign="top">
63   <img src="fairies.png">
64  </td></tr></table>
65
66  <table cellpadding="20"><tr><td valign="top">
67   <img src="couriersmall.gif">
68  </td><td valign="top">
69   <h3><a name="tag-A2">Configurable and non-square board formats</a></h3>
70   <p>
71    WinBoard F allows the use of other boards than 8x8.
72    In particular, the number of ranks does not have to be equal to the number of files.
73    Options -boardWidth and -boardHeight can be used to specify exactly the board you want,
74    but a value -1 for these options means WinBoard will use the default size for the
75    variant you are playing (so 8x8 for normal chess or suicide).
76   </p>
77   <h3><a name="tag-A3">Piece-ID letters in SAN and FEN</a></h3>
78   <p>
79    Unfortunately the names of fairy pieces are not as standardized as they are in orthodoc chess:
80    a piece that moves in the same way can be called Marshall in one variant, Chancellor in another,
81    and Champion in a third.
82    This affects the single-letter abbreviation one would use for writing SAN moves in notations for these variants.
83    WinBoard accounts for this through the -pieceToCharTable option, 
84    where you can define for each of the 44 colored piece types what letter should be used for them.
85    This can also used to disable pieces, by setting their character to a period.
86    For each of the predefined variants, WinBoard has a default table, and uses that as soon as you select the variant.
87   </p>
88  </td></tr></table>
89
90  <table cellpadding="20"><tr><td valign="top">
91   <h3><a name="tag-A4">Predefined variants</a></h3>
92   <p>
93    With the unorthodox piece types and board formats WinBoard F can support a large number of chess variants.
94    Some of these variants are pre-defined:
95    they can be selected through a New Variant item in the File menu,
96    which brings you to a dialog where you can pick one,
97    and optionally change its board size from the default.
98   </p>
99   <p>
100    For these predefined variants, WinBoard usually knows the rules exactly,
101    meaning that it can do legality checking, reliably detect checkmate, etc.
102    Some variants are only partially supported, however, and need to be played with legality testing off.
103    The predefined new variants are:
104   </p>
105   <ul>
106    <li>Xiangqi (Chinese chess)</li>
107    <li>Shogi (Japanese chess)</li>
108    <li>Capablanca, Gothic and Capa-random Chess (on 10x8 board)</li>
109    <li>Courier chess (a medieval precursor of modern chess)</li>
110    <li>Shatranj (ancient Arabic chess)</li>
111    <li>Knightmate (King moves as Knight, and vice versa)</li>
112    <li>Cylinder chess (the board wraps around at the edge files)</li>
113    <li>Berolina chess (Pawns capture straight and move diagonally)</li>
114   </ul>
115   <p>
116    The latter two can only be played with legality testing off.
117    The ICS variants that were already supported in 4.2.7
118    (Fischerandom, Suicide, Losers, Giveaway, Atomic, Twokings, Threechecks)
119    are all fully supported in local mode,
120    and WinBoard is aware of their rules for victory, so it can adjudicate.
121   </p>
122   <p>
123    Normally all these variants would be played with the piece symbols shown above.
124    But the almost infinite configurability of the WinBoard look
125    through board textures and font-based rendering
126    does allow you to perfectly mimic traditional representation of Asian variants, for example.
127    On the right you see how suppressing the grid that normally separates the squares,
128    and using a drawing of a Xiangqi board and the XIANGQI font for piece rendering
129    can give a very good looking Xiangqi interface.
130   </p>
131  </td><td valign="top">
132   <img src="WinBoardXQ2.png">
133  </td></tr></table>
134
135  <h3><a name="tag-A5">Dragging and dropping from displayed holdings in Bughouse</a></h3>
136  <table cellpadding="20"><tr><td valign="top">
137   <img src="crazy.gif">
138  </td><td valign="top">
139   <p>
140    Drop variants like Bughouse and Crazyhouse used to keep track of the holdings as text in the title bar,
141    and required a drop menu to select dropped pieces from.
142    This only worked in ICS mode, as the holdings were not updated in local play.
143    In WinBoard F, the holdings are displayed beside the board,
144    and you can grab and drag the piece to drop from there.
145    They are also fully updated in local Crazyhouse play.
146    (Bughouse still can only be played on an ICS, being a 4-player game where WinBoard is only a 2-player GUI.)
147   </p>
148   <p>
149    Shogi is also a drop game, and uses the same mechanism.
150    In fact WinBoard F allows you to play any variant as a Crazyhouse-style drop game,
151    by configuring holdings for it through the options -holdingsSize,
152    where you can specify the number of piece types for which space should be reserved in the holdings.
153    (Beware: for practical reasons this cannot be larger than the number of board ranks!)
154    Piece types for which no space is reserved will revert to Pawn oon capture.
155   </p>
156   <h3><a name="tag-A6">Promoted Pawn or primordial piece?</a></h3>
157   <p>
158    In Bughouse promoted Pawns revert to Pawn on capture, and are thus in principle different pieces
159    than the primordial pieces of the same type.
160    WinBoard F shows this difference by using alternate representations for pieces obtained through promotions.
161    In sizes where these are available, fairy pieces are used;
162    in other sizes a slightly smaller representation of the normal chess piece.
163   </p>
164  </td></tr></table>
165
166  <table cellpadding="20"><tr><td valign="top">
167   <h3><a name="tag-A7">Displaying engine logos</a></h3>
168   <p>
169    WinBoard F offers the possibility to display logos of the playing engines next to the clock.
170    The options -firstLogo, -secondLogo allow you to explicitly specify bitmap files for those.
171    The logos will be scaled to 2x1 aspect ratio, so results are better if they already have this to begin with.
172   </p>
173   <p>
174    There also is a persistent boolean option -autoLogo,
175    which makes WinBoard look automatically in the engine directory for a file called logo.bmp,
176    and display that if it finds it (and this is not overruled by an explicitly given file).
177    In ICS mode this option makes WinBoard look for a logo of the ICS in the logos folder,
178    e.g. freechess.org.bmp for FICS.
179   </p>
180   <h3><a name="tag-B2">Modernizing WinBoard protocol</a></h3>
181   <p>
182    WinBoard protocol lacked commands to control the engine's hash-table size and number of CPUs it could use.
183    This was of course because such things did not exist at the time when it was devised.
184    This situation was corrected in WinBoard 4.3, by adding the 'memory' and 'cores' commands.
185    These commands allow the GUI to specify the hash size and CPU number through the protocol interface,
186    with as a result they can now be set through the GUI, rather than requiring editing of obscure ini files.
187   </p>
188   <p>
189    Of course this only works on engines that actually support these features.
190    But (through Polyglot) all UCI engines do, so the dialogs to set these options were useful from the beginning.
191   </p>
192  </td><td valign="top">
193   <img src="marble.png">
194  </td></tr></table>
195
196  <table cellpadding="20"><tr><td valign="top">
197   <img src="Shogi.png">
198  </td><td valign="top">
199   <h3><a name="tag-A8">Bitmaps for traditional Japanese Shogi pieces</a></h3>
200   <p>
201    As an extra service to Japanese users, board size 'moderate' (58) uses a complete set of traditional Shogi pieces in variant shogi.
202    To properly use them, the options -allWhite and -flipBlack were added, and have to be set to true.
203    Other board sizes (i.e. middling and bulky) use the normal chess-style bitmaps,
204    except that special forms of the Gold are used to indicate some promoted pieces.
205   </p>
206  </td></tr></table>
207
208 <h3><a name="tag-C1">Overview of new command-line options</a></h3>
209 <p>
210 Below follows a table that lists the new features, 
211 the command-line option needed to control them,
212 and if there is a menu provided that can switch the option while WinBoard is running
213 (command-line options exert their effect only at startup).
214 Note that, unlike WinBoard 4.2.7, the WinBoard 4.3 series is fully castling and e.p. aware,
215 and handles the castling, e.p. and 50-move field in FENs on input and output as should be expected.
216 </p>
217 <table cellpadding="3" border="1"><tr><td width="310">
218       <h3>command-line option</h3>
219     </td><td>
220       <h3>description</h3>
221     </td><td width="250">
222       <h3>menu</h3>
223   </td></tr><tr><td>
224       
225     </td><td bgcolor="lightblue">
226       <strong>ENGINE-ENGINE ADJUDICATION OPTIONS<strong>
227     </td><td>
228       
229   </td></tr><tr><td>
230       -adjudicateLossThreshold 0 (*x)
231     </td><td>
232       adjudicates engine-engine game based on score
233     </td><td>
234       Options -> Engine... (x)
235   </td></tr><tr><td>
236       -checkMates false (*x)
237     </td><td>
238       detect and end game on checkmates and stalemates
239     </td><td>
240       Options -> Engine... (x)
241   </td></tr><tr><td>
242       -testClaims false (*x)
243     </td><td>
244       WinBoard corrects false RESULT claims
245     </td><td>
246       Options -> Engine.. (x)
247   </td></tr><tr><td>
248       -materialDraws false (*x)
249     </td><td>
250       adjudicate draw when no mating material present
251     </td><td>
252       Options -> Engine.. (x)
253   </td></tr><tr><td>
254       -trivialDraws false (*x)
255     </td><td>
256       adjudicate draw in endgames like KRKR and KNNK
257     </td><td>
258       Options -> Engine.. (x)
259   </td></tr><tr><td>
260       -adjudicateDrawMoves 0 (*x)
261     </td><td>
262       adjudicate draw when game lasts too long
263     </td><td>
264       Options -> Engine.. (x)
265   </td></tr><tr><td>
266       -ruleMoves 51 (*x)
267     </td><td>
268       number of reversible moves after which to adjudicate draw
269     </td><td>
270       Options -> Engine.. (x)
271   </td></tr><tr><td>
272       -repeatsToDraw 6 (*x)
273     </td><td>
274       adjudicate draw when a position occurs this many times
275     </td><td>
276       Options -> Engine.. (x)
277   </td></tr><tr><td>
278       -firstScoreAbs false (x)
279       <br>
280       -secondScoreAbs false (x)
281     </td><td>
282       Engine indicates score for white, even when playing black
283     </td><td>
284       Options -> Adjudications.. (xboard-only)
285   </td></tr><tr><td>
286       -
287     </td><td>
288       Adjudicate the game in progress as win to white, win to black, or draw
289     </td><td>
290       Action -> Adjudicate to White
291       <br>
292       Action -> Adjudicate to Black
293       <br>
294       Action -> Adjudicate Draw
295   </td></tr><tr><td>
296       
297     </td><td bgcolor="lightblue">
298       <strong>TIME-CONTROL AND TIMING OPTIONS</strong>
299     </td><td>
300       
301   </td></tr><tr><td>
302       -firstTimeOdds 1 (x)
303       <br>
304       -secondTimeOdds 1 (x)
305     </td><td>
306       reduce the thinking time of the mentioned engine by the given factor
307     </td><td>
308       Options -> Engine Settings.. (xboard only)
309   </td></tr><tr><td>
310       -timeOddsMode 1 (*x)
311     </td><td>
312       determines what happens when both engine have time odds
313     </td><td>
314       Options -> Engine Settings.. (xboard only)
315   </td></tr><tr><td>
316       -firstNPS -1 (x)
317       <br>
318       -secondNPS -1 (x)
319     </td><td>
320       engine must use node count for its time control, as if running at specified rate
321     </td><td>
322       -
323   </td></tr><tr><td>
324       -matchPause 10000 (*x)
325     </td><td>
326       number of msec to wait between games in match mode
327     </td><td>
328       -
329   </td></tr><tr><td>
330       -delayBeforeQuit 0 (*x)
331       <br>
332       -delayAfterQuit 0 (*x)
333     </td><td>
334       timing parameter specifying how to terminate the engine processes
335     </td><td>
336       -
337   </td></tr><tr><td>
338       -
339     </td><td>
340       adjust the clocks by 1 minute (up or down)
341     </td><td>
342       left- or right-cick on clock in edit-game mode
343   </td></tr><tr><td>
344       -niceEngines 0 (*x)
345     </td><td>
346       lower the CPU priority of the engines
347     </td><td>
348       -
349   </td></tr><tr><td>
350       
351     </td><td bgcolor="lightblue">
352       <strong>DISPLAY-LOOK OPTIONS</strong>
353     </td><td>
354       
355   </td></tr><tr><td>
356       -liteBackTextureFile "" (*)
357       <br>
358       -darkBackTextureFile "" (*)
359       <br>
360       -liteBackTextureMode 1 (*)
361       <br>
362       -darkBackTextureMode 1 (*)
363     </td><td>
364       Allows you to use any bitmap picture for displaying the board square
365     </td><td>
366       -
367   </td></tr><tr><td>
368       -renderPiecesWithFont "" (*)
369     </td><td>
370       specifies a true-type Chess font to be used for piece symbols
371     </td><td>
372       -
373   </td></tr><tr><td>
374       -fontPieceToCharTable "" (*)
375     </td><td>
376       specifies which font character to use for the various piece types
377     </td><td>
378       -
379   </td></tr><tr><td>
380       -overrideLineGap 1 (*)
381     </td><td>
382       controls the width of the black grid lines between squares
383     </td><td>
384       -
385   </td></tr><tr><td>
386       -fontPieceBackColorWhite #0 (*)
387       <br>
388       -fontPieceForeColorWhite #0 (*)
389       <br>
390       -fontPieceBackColorBlack #0 (*)
391       <br>
392       -fontPieceForeColorBlack #0 (*)
393     </td><td>
394       control piece colors in font-based rendering
395     </td><td>
396       -
397   </td></tr><tr><td>
398       -fontPieceSize 80 (*)
399     </td><td>
400       tunes the size of pieces in font-based rendering (% of square size)
401     </td><td>
402       -
403   </td></tr><tr><td>
404       -highlightMoveWithArrow false (*)
405     </td><td>
406       draws a big arrow to indicate the move last played
407     </td><td>
408       Options -> General...
409   </td></tr><tr><td>
410       -highlightArrowColor #FFFF80 (*)
411     </td><td>
412       controls the color of the highlight arrow
413     </td><td>
414       -
415   </td></tr><tr><td>
416       -autoLogo false (*)
417       <br>
418       -firstLogo ""
419       <br>
420       -secondLogo ""
421     </td><td>
422       causes WinBoard to display player logos above the board, next to the clocks.
423     </td><td>
424       -
425   </td></tr><tr><td>
426       -
427     </td><td>
428       Swap white and black clock
429     </td><td>
430       Options -> Swap Clocks
431   </td></tr><tr><td>
432       
433     </td><td bgcolor="lightblue">
434       <strong>(UCI) ENGINE OPTIONS</strong>
435     </td><td>
436       
437   </td></tr><tr><td>
438       -polyglotDir "" (*x)
439     </td><td>
440       tells WinBoard where you installed Polyglot, for automatic invocation with UCI engines
441     </td><td>
442       Options -> Global Settings... (x)
443   </td></tr><tr><td>
444       -polyglotBook "" (*x)
445     </td><td>
446       tells WinBoard which opening book it should use, or should make Polyglot use.
447     </td><td>
448       Options -> Global Settings... (x)
449   </td></tr><tr><td>
450       -usePolyglotBook false (*x)
451     </td><td>
452       turns the use of the Polygot book on or off
453     </td><td>
454       Options -> Global Settings... (x)
455   </td></tr><tr><td>
456       -defaultPathEGTB "c:\egtb" (*x)
457     </td><td>
458       folder where to find end-game tables
459     </td><td>
460       Options -> Global Settings... (x)
461   </td></tr><tr><td>
462       -defaultCacheSizeEGTB 4 (*x)
463     </td><td>
464       specifies the cache size for UCI engines
465     </td><td>
466       Options -> Global Settings... (x)
467   </td></tr><tr><td>
468       -defaultHashSize 64 (*x)
469     </td><td>
470       specifies the size of the main hash table for UCI engines and WinBoard engines implementing the memory command
471     </td><td>
472       Options -> Global Settings... (x)
473   </td></tr><tr><td>
474       -firstIsUCI false (x)
475       <br>
476       -secondIsUCI false (x)
477       <br>
478       -fUCI (x)
479       <br>
480       -sUCI (x)
481     </td><td>
482       tells WinBoard the corresponding engine should be run through Polyglot
483     </td><td>
484       -
485   </td></tr><tr><td>
486       -firstHasOwnBookUCI true (x)
487       <br>
488       -secondHasOwnBookUCI true (x)
489       <br>
490       -fNoOwnBookUCI true (x)
491       <br>
492       -sNoOwnBookUCI true (x)
493       <br>
494       -firstXBook (x)
495       <br>
496       -secondXBook (x)
497     </td><td>
498       tells WinBoard (or Polyglot) if the engine should use its own opening book
499     </td><td>
500       Options -> Global Settings... (x)
501   </td></tr><tr><td>
502       -smpCores 1 (*x)
503     </td><td>
504       sets the maximum number of CPUs an SMP engine can use.
505       (only affects engines that support the <strong>cores</strong> command of WB protocol)
506     </td><td>
507       Options -> Global Settings... (x)
508   </td></tr><tr><td>
509       -egtFormats "" (*x)
510     </td><td>
511       specifies which end-game tables are installed on the computer,
512       and where they can be found
513       (e.g. "nalimov:\chess\egtb,scorpio:\chess\bitbases")
514     </td><td>
515       -
516   </td></tr><tr><td>
517       -firstOptions "" (x)
518       <br>
519       -secondOptions "" (x)
520     </td><td>
521       sets engine-defined options of UCI engines and WinBoard engines that support the option feature.
522     </td><td>
523       Options -> Engine #1 Settings... (x)
524       <br>
525       Options -> Engine #2 Settings... (x)
526   </td></tr><tr><td>
527       -firstNeedsNoncompliantFEN "" (x)
528       <br>
529       -secondNeedsNoncompliantFEN "" (x)
530     </td><td>
531       directly specifies castling and e.p. field to be used in all FENs sent to mentioned engine
532     </td><td>
533       -
534   </td></tr><tr><td>
535       
536     </td><td bgcolor="lightblue">
537       <strong>CHESS-VARIANT OPTIONS</strong>
538     </td><td>
539       
540   </td></tr><tr><td>
541       -boardHeight -1 (*x)
542       <br>
543       -boardWidth -1 (*x)
544       <br>
545       -holdingsSize -1 (*x)
546     </td><td>
547       specifies the board format and nr of piece types that can be dropped,
548       when you want it to be different from what is usual in the chosen varint
549     </td><td>
550       File -> New Variant...
551   </td></tr><tr><td>
552       -variant normal (x)
553     </td><td>
554       supports many new variants: xiangqi, shogi, fischerandom, capabanca, gothic, caparandom, janus,
555       shatranj, courier, knightmate, berolina, falcon, cylinder, fairy, super, great
556     </td><td>
557       File -> New Variant... (x)
558   </td></tr><tr><td>
559       -defaultFrcOpening -1 (x)
560     </td><td>
561       allows you to play from a specific opening shuffle, or make a new shuffle each game
562     </td><td>
563       File -> New Shuffle Game... (x)
564   </td></tr><tr><td>
565       -pieceToCharTable "" (x)
566     </td><td>
567       allows you to specify by which letters pieces are referred to in FEN and SAN,
568       if you want to deviate from what is usual for the current variant
569     </td><td>
570       -
571   </td></tr><tr><td>
572       -flipBlack fase (*x)
573     </td><td>
574       displays opponent pieces uppside down (for Shogi)
575     </td><td>
576       Options -> Board...
577   </td></tr><tr><td>
578       -allWhite false (*x)
579     </td><td>
580       use white bitmaps (with black outline) also for display of black pieces (for Shogi)
581     </td><td>
582       Options -> Board...
583   </td></tr><tr><td>
584       
585     </td><td bgcolor="lightblue">
586       <strong>PGN FILE OPTIONS</strong>
587     </td><td>
588       
589   </td></tr><tr><td>
590       -pgnExtendedInfo false (*x)
591     </td><td>
592       save engine output (depth, score time) in PGN
593     </td><td>
594       Options->General...
595   </td></tr><tr><td>
596       -pgnEventHeader </br>"Computer Chess Game" (*x)
597     </td><td>
598       specify the event for the PGN event tag
599     </td><td>
600       -
601   </td></tr><tr><td>
602       -saveOutOfBookInfo true (*)
603     </td><td>
604       include an 'annotator' tag in the PGN file
605     </td><td>
606       
607   </td></tr><tr><td>
608       -hideThinkingFromHuman false (*x)
609     </td><td>
610       suppresses the engine thinking output in the display, without the need to switch it off
611       (so it can still appear in the PGN file)
612     </td><td>
613       Options -> General... (x)
614   </td></tr><tr><td>
615       -userName "" (x)
616     </td><td>
617       sets the name of the human player
618     </td><td>
619       Mode -> Enter Username... (x)
620   </td></tr><tr><td>
621       
622     </td><td bgcolor="lightblue">
623       <strong>USER-INTERFACE OPTIONS AND WINDOW CONTROL</strong>
624     </td><td>
625       
626   </td></tr><tr><td>
627       -moveHistoryUp true (*)
628       <br>
629       -moveHistoryX 0 (*)
630       <br>
631       -moveHistoryY 0 (*)
632       <br>
633       -moveHistoryW 0 (*)
634       <br>
635       -moveHistoryH 0 (*)
636     </td><td>
637       controls opening, placement and size of a window containing the moves of the current game
638       (new in 4.4 is that all X and Y coordinates of auxiliary windows are stored relative to the main window)
639     </td><td>
640       Mode -> Show Move History (x)
641   </td></tr><tr><td>
642       -evalGraphUp true (*)
643       <br>
644       -evalGraphX 0 (*)
645       <br>
646       -evalGraphY 0 (*)
647       <br>
648       -evalGraphW 0 (*)
649       <br>
650       -evalGraphH 0 (*)
651     </td><td>
652       controls opening, placement and size of a window containing a graph of the
653       evaluation score of the engine(s) as a function of move number of the current game
654     </td><td>
655       Mode -> Show Evaluation Graph
656   </td></tr><tr><td>
657       -engineOutputUp true (*)
658       <br>
659       -engineOutputX 0 (*)
660       <br>
661       -engineOutputY 0 (*)
662       <br>
663       -engineOutputW 0 (*)
664       <br>
665       -engineOutputH 0 (*)
666     </td><td>
667       controls opening, placement and size of a window containing the thinking output of the engine(s)
668     </td><td>
669       Mode -> Show Engine Output (x)
670   </td></tr><tr><td>
671       -stickyWindows true (*)
672     </td><td>
673       make the various windows snap onto each other, and stick together
674     </td><td>
675       -
676   </td></tr><tr><td>
677       -showEvalInMoveHistory true (*)
678     </td><td>
679       depth/score info of the engine is included as comments in the move history window
680     </td><td>
681       Options -> General...
682   </td></tr><tr><td>
683       -evalHistColorWhite #FFFFB0 (*)
684       <br>
685       -evalHistColorBlack #AD5D3D (*)
686     </td><td>
687       determines the color of the eval-score comments in the move-history window
688     </td><td>
689       -
690   </td></tr><tr><td>
691       -autoDisplayComment true (*)
692     </td><td>
693       causes a window for displaying PGN comments to pop up automatically when such a comment is encountered
694     </td><td>
695       -
696   </td></tr><tr><td>
697       -autoDisplayTags true (*)
698     </td><td>
699       causes a window with PGN tags to be displayed as soon as a PGN file is loaded
700     </td><td>
701       -
702   </td></tr><tr><td>
703       -gameListTags "eprd" (*)
704     </td><td>
705       specifies the PGN tags that should be displayed in the game list
706     </td><td>
707       Options -> Game List...
708   </td></tr><tr><td>
709       -noGUI (x)
710     </td><td>
711       suppress update of display on all machine and ICS moves (moves, clocks, icon)
712     </td><td>
713       -
714   </td></tr><tr><td>
715       
716     </td><td bgcolor="lightblue">
717       <strong>ICS OPTIONS</strong>
718     </td><td>
719       
720   </td></tr><tr><td>
721       -autoKibitz (x)
722     </td><td>
723       kibitz engine Thinking Output to ICS, and capture opponent kibitz for in PGN
724     </td><td>
725       -
726   </td></tr><tr><td>
727       -zippyShortGame 0 (x)
728     </td><td>
729       ban opponents on ICS that abort without playing
730     </td><td>
731       -
732   </td></tr><tr><td>
733       
734     </td><td bgcolor="lightblue">
735       <strong>MISCELLANEOUS</strong>
736     </td><td>
737       
738   </td></tr><tr><td>
739       -debugFile "winboard.debug" (x)
740       <br>
741       -nameOfDebugFile "winboard.debug" (x)
742     </td><td>
743       allows you to specify an alternative name for saving the debug information
744     </td><td>
745       -
746   </td></tr><tr><td>
747       -engineDebugOutput 0 (x)
748     </td><td>
749       tells WinBoard if and how to put protocol-violating output in the debug file
750     </td><td>
751       -
752   </td></tr><tr><td>
753       -
754     </td><td>
755       save chess-board display as diagram in bitmap file
756       (only works for the smaller board formats!)
757     </td><td>
758       File -> Save Diagram...
759   </td></tr><tr><td>
760       -defaultFrcPosition -1 (*x)
761     </td><td>
762       specify the number of the starting position in shuffle Chess variants
763     </td><td>
764       File -> New Shuffle Game... (x)
765   </td></tr><tr><td>
766       -
767     </td><td>
768       display only those lines in the game list that contain a given string
769     </td><td>
770       in Game-List window
771   </td></tr><tr><td>
772       -rewindFile 0 (x)
773     </td><td>
774       A nonzero value for this option causes the loadGameIndex or loadPositionIndex
775       to rewind to the beginning of the Games or Position file when it reaches
776       the given value in auto-increment match mode. 
777       This mode is specified by a negative value as argument of the /lgi or /lpi options,
778       where -1 increments the index after every game of the match,
779       and -2 after every two games (so that each position is played with black and white).
780     </td><td>
781       -
782   </td></tr><tr><td>
783       -sameColorGames 0 (x)
784     </td><td>
785       play a match, but without alternating the colors (overrules -matchGames)
786     </td><td>
787       -
788 </td></tr></table>
789 <p>
790 The value with which the option is listed is the default value.
791 If it is false or true, it is a Boolean option, a number implies an integer option.
792 A value starting with # indicates an RGB color indication in hexadecimal notation.
793 Options the settings of which are saved into the winboard.ini file are marked with (*).
794 </p>
795
796 </div><!-- for id="content", starts in the include above -->
797 <!--#include virtual="/server/footer.html" -->
798 <div id="footer">
799
800 <p>Please send general FSF &amp; GNU inquiries to
801 <a href="mailto:gnu@gnu.org">&lt;gnu@gnu.org&gt;</a>.
802 There are also <a href="/contact/">other ways to contact</a>
803 the FSF.<br />
804 Please send broken links and other corrections or suggestions to
805 <a href="mailto:bug-xboard@gnu.org">&lt;bug-xboard@gnu.org&gt;</a>.</p>
806
807 <p>Please see the <a
808 href="/server/standards/README.translations.html">Translations
809 README</a> for information on coordinating and submitting translations
810 of this article.</p>
811
812 <p>Copyright &copy; 2009, 2010, 2011, 2012 Free Software Foundation, Inc.</p>
813
814 <p>This page is licensed under a <a rel="license"
815 href="http://creativecommons.org/licenses/by-nd/3.0/us/">Creative
816 Commons Attribution-NoDerivs 3.0 United States License</a>.</p>
817
818 <p>Updated:
819 <!-- timestamp start -->
820 $Date: 2012/01/11 04:40:00 $
821 <!-- timestamp end -->
822 </p>
823 </div>
824 </div>
825 </body>
826 </html>