2b3ac872f236da36a7bba413d24e5fd6d887d258
[xboard.git] / manual / html_node / Mode-Menu.html
1 <html lang="en">
2 <head>
3 <title>Mode Menu - XBoard</title>
4 <meta http-equiv="Content-Type" content="text/html">
5 <meta name="description" content="XBoard">
6 <meta name="generator" content="makeinfo 4.13">
7 <link title="Top" rel="start" href="index.html#Top">
8 <link rel="up" href="Menus.html#Menus" title="Menus">
9 <link rel="prev" href="View-Menu.html#View-Menu" title="View Menu">
10 <link rel="next" href="Action-Menu.html#Action-Menu" title="Action Menu">
11 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
12 <meta http-equiv="Content-Style-Type" content="text/css">
13 <style type="text/css"><!--
14   pre.display { font-family:inherit }
15   pre.format  { font-family:inherit }
16   pre.smalldisplay { font-family:inherit; font-size:smaller }
17   pre.smallformat  { font-family:inherit; font-size:smaller }
18   pre.smallexample { font-size:smaller }
19   pre.smalllisp    { font-size:smaller }
20   span.sc    { font-variant:small-caps }
21   span.roman { font-family:serif; font-weight:normal; } 
22   span.sansserif { font-family:sans-serif; font-weight:normal; } 
23 --></style>
24 </head>
25 <body>
26 <div class="node">
27 <a name="Mode-Menu"></a>
28 <p>
29 Next:&nbsp;<a rel="next" accesskey="n" href="Action-Menu.html#Action-Menu">Action Menu</a>,
30 Previous:&nbsp;<a rel="previous" accesskey="p" href="View-Menu.html#View-Menu">View Menu</a>,
31 Up:&nbsp;<a rel="up" accesskey="u" href="Menus.html#Menus">Menus</a>
32 <hr>
33 </div>
34
35 <h3 class="section">3.4 Mode Menu</h3>
36
37 <p><a name="index-Menu_002c-Mode-54"></a><a name="index-Mode-Menu-55"></a>
38      <dl>
39 <dt>Machine White<dd><a name="index-Machine-White_002c-Menu-Item-56"></a>Tells the chess engine to play White. 
40 The <kbd>Ctrl-W</kbd> key is a keyboard equivalent. 
41 <br><dt>Machine Black<dd><a name="index-Machine-Black_002c-Menu-Item-57"></a>Tells the chess engine to play Black. 
42 The <kbd>Ctrl-B</kbd> key is a keyboard equivalent. 
43 <br><dt>Two Machines<dd><a name="index-Two-Machines_002c-Menu-Item-58"></a>Plays a game between two chess engines. 
44 The <kbd>Ctrl-T</kbd> key is a keyboard equivalent. 
45 <br><dt>Analysis Mode<dd><a name="index-Analysis-Mode_002c-Menu-Item-59"></a><a name="index-null-move-60"></a>XBoard tells the chess engine to start analyzing the current game/position
46 and shows you the analysis as you move pieces around. 
47 The <kbd>Ctrl-A</kbd> key is a keyboard equivalent. 
48 Note: Some chess engines do not support Analysis mode.
49
50      <p>To set up a position to analyze, you do the following:
51
52      <p>1. Select Edit Position from the Mode Menu
53
54      <p>2. Set up the position.  Use the middle and right buttons to
55 bring up the white and black piece menus.
56
57      <p>3. When you are finished, click on either the Black or White
58 clock to tell XBoard which side moves first.
59
60      <p>4. Select Analysis Mode from the Mode Menu to start the analysis.
61
62      <p>You can now play legal moves to create follow-up positions for the
63 engine to analyze, while the moves will be remembered as a stored game,
64 and then step backward through this game to take the moves back. 
65 Note that you can also click on the clocks to set the opposite
66 side to move (adding a so-called &lsquo;<samp><span class="samp">null move</span></samp>&rsquo; to the game).
67
68      <p>The analysis function can also be used when observing games on an ICS
69 with an engine loaded (zippy mode); the engine then will analyse
70 the positions as they occur in the observed game. 
71 <br><dt>Analyze Game<dd><a name="index-Analyze-Game_002c-Menu-Item-61"></a>This option subjects the currently loaded game to automatic
72 analysis by the loaded engine. 
73 The <kbd>Ctrl-G</kbd> key is a keyboard equivalent. 
74 XBoard will start auto-playing the game from the currently displayed position,
75 while the engine is analyzing the current position. 
76 The game will be annotated with the results of these analyses. 
77 In particlar, the score and depth will be added as a comment,
78 and the PV will be added as a variation. 
79 The time the engine spends on analyzing each move can be controlled
80 through the command-line option &lsquo;<samp><span class="samp">-timeDelay</span></samp>&rsquo;. 
81 Note: Some chess engines do not support Analysis mode. 
82 <br><dt>Edit Game<dd>Duplicate of the item in the Edit menu. 
83 Note that &lsquo;<samp><span class="samp">Edit Game</span></samp>&rsquo; is the idle mode of XBoard, and can be used
84 to get you out of other modes. E.g. to stop analyzing, stop a game
85 between two engines or stop editing a position. 
86 <br><dt>Edit Position<dd>Duplicate of the item in the Edit menu. 
87 <br><dt>Training<dd><a name="index-Training_002c-Menu-Item-62"></a>Training mode lets you interactively guess the moves of a game for one
88 of the players. You guess the next move of the game by playing the
89 move on the board. If the move played matches the next move of the
90 game, the move is accepted and the opponent's response is auto-played. 
91 If the move played is incorrect, an error message is displayed.  You
92 can select this mode only while loading a game (that is, after
93 selecting &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo; from the File menu).  While XBoard is in
94 &lsquo;<samp><span class="samp">Training</span></samp>&rsquo; mode, the navigation buttons are disabled. 
95 <br><dt>ICS Client<dd><a name="index-ICS-Client_002c-Menu-Item-63"></a>This is the normal mode when XBoard
96 is connected to a chess server.  If you have moved into
97 Edit Game or Edit Position mode, you can select this option to get out.
98
99      <p>To use xboard in ICS mode, run it in the foreground with the -ics
100 option, and use the terminal you started it from to type commands and
101 receive text responses from the chess server.  See
102 <a href="Chess-Servers.html#Chess-Servers">Chess Servers</a> below for more information.
103
104      <p>XBoard activates some special position/game editing features when you
105 use the <kbd>examine</kbd> or <kbd>bsetup</kbd> commands on ICS and you have
106 &lsquo;<samp><span class="samp">ICS Client</span></samp>&rsquo; selected on the Mode menu.  First, you can issue the
107 ICS position-editing commands with the mouse.  Move pieces by dragging
108 with mouse button 1.  To drop a new piece on a square, press mouse
109 button 2 or 3 over the square.  This brings up a menu of white pieces
110 (button 2) or black pieces (button 3).  Additional menu choices let
111 you empty the square or clear the board.  Click on the White or Black
112 clock to set the side to play.  You cannot set the side to play or
113 drag pieces to arbitrary squares while examining on ICC, but you can
114 do so in <kbd>bsetup</kbd> mode on FICS.  In addition, the menu commands
115 &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">Stop Examining</span></samp>&rsquo;
116 have special functions in this mode; see below. 
117 <br><dt>Machine Match<dd><a name="index-Machine-match_002c-Menu-Item-64"></a>Starts a match between two chess programs,
118 with a number of games and other parameters set through
119 the &lsquo;<samp><span class="samp">Match Options</span></samp>&rsquo; menu dialog. 
120 When a match is already running, selecting this item will make
121 XBoard drop out of match mode after the current game finishes. 
122 <br><dt>Pause<dd><a name="index-Pause_002c-Menu-Item-65"></a>Pauses updates to the board, and if you are playing against a chess engine,
123 also pauses your clock. To continue, select &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; again, and the
124 display will automatically update to the latest position. 
125 The &lsquo;<samp><span class="samp">P</span></samp>&rsquo; button and keyboard <kbd>Pause</kbd> key are equivalents.
126
127      <p>If you select Pause when you are playing against a chess engine and
128 it is not your move, the chess engine's clock
129 will continue to run and it will eventually make a move, at which point
130 both clocks will stop. Since board updates are paused, however,
131 you will not see the move until you exit from Pause mode (or select Forward). 
132 This behavior is meant to simulate adjournment with a sealed move.
133
134      <p>If you select Pause while you are observing or examining a game on a
135 chess server, you can step backward and forward in the current history
136 of the examined game without affecting the other observers and
137 examiners, and without having your display jump forward to the latest
138 position each time a move is made. Select Pause again to reconnect
139 yourself to the current state of the game on ICS.
140
141      <p>If you select &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; while you are loading a game, the game stops
142 loading. You can load more moves manually by selecting &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, or
143 resume automatic loading by selecting &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; again. 
144 </dl>
145
146    </body></html>
147