25723ead13ebf89cdfbbaf35e913f8298705ff9e
[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-52"></a><a name="index-Mode-Menu-53"></a>
38      <dl>
39 <dt>Machine White<dd><a name="index-Machine-White_002c-Menu-Item-54"></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-55"></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-56"></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-57"></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>The analysis function can also be used when observing games on an ICS
63 with an engine loaded (zippy mode); the engine then will analyse
64 the positions as they occur in the observed game. 
65 <br><dt>Analyze File<dd><a name="index-Analyze-File_002c-Menu-Item-58"></a>This option lets you load a game from a file (PGN, XBoard format, etc.) 
66 and analyze it. The <kbd>Ctrl-F</kbd> key is a keyboard equivalent. 
67 When you select this menu item, a pop-up window appears
68 and asks for a file name to load. 
69 If the file contains multiple games, another pop up appears that lets
70 you select which game you wish to analyze. 
71 After a game is loaded, XBoard will start auto-playing the game,
72 while the engine is analyzing the current position. 
73 The game will be annotated with the results of these analyses. 
74 In particlar, the score and depth will be added as a comment,
75 and the PV will be added as a variation. 
76 The time the engine spends on analyzing each move can be controlled
77 through the command-line option &lsquo;<samp><span class="samp">-timeDelay</span></samp>&rsquo;. 
78 Note: Some chess engines do not support Analysis mode. 
79 <br><dt>Edit Game<dd>Duplicate of the item in the Edit menu. 
80 Note that &lsquo;<samp><span class="samp">Edit Game</span></samp>&rsquo; is the idle mode of XBoard, and can be used
81 to get you out of other modes. E.g. to stop analyzing, stop a game
82 between two engines or stop editing a position. 
83 <br><dt>Edit Position<dd>Duplicate of the item in the Edit menu. 
84 <br><dt>Training<dd><a name="index-Training_002c-Menu-Item-59"></a>Training mode lets you interactively guess the moves of a game for one
85 of the players. You guess the next move of the game by playing the
86 move on the board. If the move played matches the next move of the
87 game, the move is accepted and the opponent's response is auto-played. 
88 If the move played is incorrect, an error message is displayed.  You
89 can select this mode only while loading a game (that is, after
90 selecting &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo; from the File menu).  While XBoard is in
91 &lsquo;<samp><span class="samp">Training</span></samp>&rsquo; mode, the navigation buttons are disabled. 
92 <br><dt>ICS Client<dd><a name="index-ICS-Client_002c-Menu-Item-60"></a>This is the normal mode when XBoard
93 is connected to a chess server.  If you have moved into
94 Edit Game or Edit Position mode, you can select this option to get out.
95
96      <p>To use xboard in ICS mode, run it in the foreground with the -ics
97 option, and use the terminal you started it from to type commands and
98 receive text responses from the chess server.  See
99 <a href="Chess-Servers.html#Chess-Servers">Chess Servers</a> below for more information.
100
101      <p>XBoard activates some special position/game editing features when you
102 use the <kbd>examine</kbd> or <kbd>bsetup</kbd> commands on ICS and you have
103 &lsquo;<samp><span class="samp">ICS Client</span></samp>&rsquo; selected on the Mode menu.  First, you can issue the
104 ICS position-editing commands with the mouse.  Move pieces by dragging
105 with mouse button 1.  To drop a new piece on a square, press mouse
106 button 2 or 3 over the square.  This brings up a menu of white pieces
107 (button 2) or black pieces (button 3).  Additional menu choices let
108 you empty the square or clear the board.  Click on the White or Black
109 clock to set the side to play.  You cannot set the side to play or
110 drag pieces to arbitrary squares while examining on ICC, but you can
111 do so in <kbd>bsetup</kbd> mode on FICS.  In addition, the menu commands
112 &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;
113 have special functions in this mode; see below. 
114 <br><dt>Machine Match<dd><a name="index-Machine-match_002c-Menu-Item-61"></a>Starts a match between two chess programs,
115 with a number of games and other parameters set through
116 the &lsquo;<samp><span class="samp">Match Options</span></samp>&rsquo; menu dialog. 
117 <br><dt>Pause<dd><a name="index-Pause_002c-Menu-Item-62"></a>Pauses updates to the board, and if you are playing against a chess engine,
118 also pauses your clock. To continue, select &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; again, and the
119 display will automatically update to the latest position. 
120 The &lsquo;<samp><span class="samp">P</span></samp>&rsquo; button and keyboard <kbd>Pause</kbd> key are equivalents.
121
122      <p>If you select Pause when you are playing against a chess engine and
123 it is not your move, the chess engine's clock
124 will continue to run and it will eventually make a move, at which point
125 both clocks will stop. Since board updates are paused, however,
126 you will not see the move until you exit from Pause mode (or select Forward). 
127 This behavior is meant to simulate adjournment with a sealed move.
128
129      <p>If you select Pause while you are observing or examining a game on a
130 chess server, you can step backward and forward in the current history
131 of the examined game without affecting the other observers and
132 examiners, and without having your display jump forward to the latest
133 position each time a move is made. Select Pause again to reconnect
134 yourself to the current state of the game on ICS.
135
136      <p>If you select &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; while you are loading a game, the game stops
137 loading. You can load more moves manually by selecting &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, or
138 resume automatic loading by selecting &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; again. 
139 </dl>
140
141    </body></html>
142