47bd7788534cea7c8e626dbdc4a7ac276e3fb7cc
[xboard.git] / winboard / help / html / 16.htm
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\r
2 <HTML>\r
3 <HEAD>\r
4 <META HTTP-EQUIV="Content-Type" Content="text/html; charset=Windows-1252">\r
5 <TITLE>User Interface Options</TITLE>\r
6 </HEAD>\r
7 \r
8 <BODY BGCOLOR="#FFFFFF" TEXT="#000000">\r
9 \r
10 \r
11 \r
12 <P><B><A NAME="userinterfaceoptions"></A>User Interface Options</B></P>\r
13 \r
14 \r
15 \r
16 <P><B><A NAME="firstlogo"></A><font color="#3333ff">/firstLogo <I>filename</I></font></B></P>\r
17 \r
18 \r
19 \r
20 <P><B><A NAME="secondlogo"></A><font color="#3333ff">/secondLogo <I>filename</I></font></B></P>\r
21 \r
22 <P><font color="#3333ff">The appearance of either of these options causes WinBoard to reserve space for displaying logos on both sides of the clocks. Normally the first logo goes left, the second right, unless the option ‘swap clocks’ is in effect. The <I>filename</I> must refer to a bitmap file (.bmp) containing a logo for the particular player (usually a 130x65 or 100x50 bitmap, which will be scaled to the height of two clock lines.)</font></P>\r
23 \r
24 \r
25 \r
26 <P><B><A NAME="autologo"></A><font color="#3333ff">/autoLogo<I> true|false</I></font></B></P>\r
27 \r
28 <P><font color="#3333ff">When true, causes WinBoard to automatically supply a logo for the first and second chess program, by looking for a fie named logo.bmp in the engine directory (as specified by the /fd or /sd option), and then displays it like this file was given as an argument to the /firstLogo or /secondLogo option. In this mode it will also look in a sub-folder of its installation folder called “logos”, for finding logos with names corresponding to the ICS (e.g. “chessclub.com.bmp”) or to the human user, should they be involved in a game.</font></P>\r
29 \r
30 \r
31 \r
32 <P><B><A NAME="hidethinkingfromhuman"></A><font color="#ff0000">/hideThinkingFromHuman<I> true|false</I></font></B></P>\r
33 \r
34 <P><font color="#ff0000">Prevents the engine thinking output to appear in the display, without necessitating to suppress the sending of this information altogether (so it can still appear in the PGN).</font></P>\r
35 \r
36 \r
37 \r
38 <P><B><A NAME="nogui"></A><font color="#3333ff">/noGUI</font></B></P>\r
39 \r
40 <P><font color="#3333ff">Suppresses all GUI functions of WinBoard (to speed up automated ultra-fast engine-engine games, which you don’t want to watch). There will be no board or clock updates, no printing of moves, and no update of the icon on the task bar in this mode.</font></P>\r
41 \r
42 \r
43 \r
44 <P><B><A NAME="top"></A>/top </B>or <B>/xtop</B>, or<B> <A NAME="alwaysontopopt"></A>/alwaysOnTop<I> true|false</I></B></P>\r
45 \r
46 <P>Sets the <A HREF="07.htm#alwaysontop">Always On Top</A> option. Default: False.</P>\r
47 \r
48 \r
49 \r
50 <P><B><A NAME="queen"></A>/queen</B> or <B>/xqueen</B>,<B> </B>or<B> <A NAME="alwayspromotetoqueen"></A>/alwaysPromoteToQueen<I> true|false</I></B></P>\r
51 \r
52 <P>Sets the <A HREF="07.htm#alwaysqueen">Always Queen</A> option. Default: False.</P>\r
53 \r
54 \r
55 \r
56 <P><B><A NAME="drag"></A>/drag</B> or <B>/xdrag</B>,<B> </B>or<B> <A NAME="animatedraggingopt"></A>/animateDragging<I> true|false</I></B></P>\r
57 \r
58 <P>Sets the <A HREF="07.htm#animatedragging">Animate Dragging</A> option. Default: True.</P>\r
59 \r
60 \r
61 \r
62 <P><B><A NAME="animate"></A>/animate </B>or <B>/xanimate</B>, or<B> <A NAME="animatemovingopt"></A>/animateMoving<I> true|false</I></B></P>\r
63 \r
64 <P>Sets the <A HREF="07.htm#animatemoving">Animate Moving</A> option. Default: True.</P>\r
65 \r
66 \r
67 \r
68 <P><B><A NAME="flip"></A>/flip </B>or <B>/xflip</B>, or<B> <A NAME="flipviewoption"></A>/flipView<I> true|false</I></B></P>\r
69 \r
70 <P>If Auto Flip View is not set, or if you are observing but not participating in a game, then the positioning of the board at the start of each game depends on the flipView option.  If flipView is False (the default), the board is positioned so that the white pawns move from the bottom to the top; if True, the black pawns move from the bottom to the top. In any case, the <A HREF="07.htm#flipview">Flip View</A> menu command can be used to flip the board after the game starts</P>\r
71 \r
72 \r
73 \r
74 <P><B><A NAME="autoflip"></A>/autoflip</B> or <B>/xautoflip</B>, or <A NAME="autoflipviewoption"></A><B>/autoFlipView <I>true|false</I></B></P>\r
75 \r
76 <P>Sets the <A HREF="07.htm#autoflipview">Auto Flip View</A> option. Default: True.</P>\r
77 \r
78 \r
79 \r
80 <P><B><A NAME="autoraise"></A>/autoraise</B> or <B>/xautoraise</B>, or <A NAME="autoraiseboardoption"></A><B>/autoRaiseBoard <I>true|false</I></B></P>\r
81 \r
82 <P>Sets the <A HREF="07.htm#autoflipview">Auto Raise Board</A> option. Default: True.</P>\r
83 \r
84 \r
85 \r
86 <P><B><A NAME="highdrag"></A>/highdrag </B>or <B>/xhighdrag</B>, or<B> <A NAME="highlightdraggingopt"></A>/highlightDragging <I>true|false</I></B></P>\r
87 \r
88 <P>Sets the <A HREF="07.htm#highlightdragging">Highlight Dragging</A> option. Default: False.</P>\r
89 \r
90 \r
91 \r
92 <P><B><A NAME="highlight"></A>/highlight </B>or <B>/xhighlight</B>, or<B> <A NAME="highlightlastmoveopt"></A>/highlightLastMove<I> true|false</I></B></P>\r
93 \r
94 <P>Sets the <A HREF="#highlightlastmoveopt">Highlight Last Move</A> option. Default: False.</P>\r
95 \r
96 \r
97 \r
98 <P><B><A NAME="popup"></A>/exit</B> or <B>/xexit</B>,<B> </B>or<B> <A NAME="popupmoveerrorsopt"></A>/popupExitMessage<I> true|false</I></B></P>\r
99 \r
100 <P>Sets the <A HREF="07.htm#popupexitmessagecmd">Popup Exit Message</A> menu option. Default: False.</P>\r
101 \r
102 \r
103 \r
104 <P><B><A NAME="popup"></A>/popup</B> or <B>/xpopup</B>,<B> </B>or<B> <A NAME="popupmoveerrorsopt"></A>/popupMoveErrors<I> true|false</I></B></P>\r
105 \r
106 <P>Sets the <A HREF="07.htm#popupmoveerrorscmd">Popup Move Errors</A> menu option. Default: False.</P>\r
107 \r
108 \r
109 \r
110 <P><B><A NAME="coords"></A>/coords </B>or <B>/xcoords</B>, or<B> <A NAME="showcoords"></A>/showCoords<I> true|false</I></B></P>\r
111 \r
112 <P>Sets the <A HREF="#showcoords">Show Coords</A> option. Default: False.</P>\r
113 \r
114 \r
115 \r
116 <P><B><A NAME="legal"></A>/legal </B>or <B>/xlegal</B>, or<B> <A NAME="testlegality"></A>/testLegality<I> true|false</I></B></P>\r
117 \r
118 <P>Sets the <A HREF="07.htm#testlegalitycmd">Test Legality</A> option. Default: True.</P>\r
119 \r
120 \r
121 \r
122 <P><B><A NAME="size"></A>/size </B>or<B> <A NAME="boardsize"></A>/boardSize <I>sizename</I></B></P>\r
123 \r
124 <P>Sets the <A HREF="07.htm#boardsizecmd">Board Size</A> option. Also chooses which board size any following Font options will affect. The default is the largest size that will fit on your screen.</P>\r
125 \r
126 \r
127 \r
128 <P><B><A NAME="wpc"></A>/wpc</B> or <B><A NAME="whitepiececolor"></A>/whitePieceColor <I>color<BR>\r
129 </I><A NAME="bpc"></A>/bpc </B>or <B><A NAME="blackpiececolor"></A>/blackPieceColor <I>color<BR>\r
130 </I><A NAME="lsc"></A>/lsc </B>or<B><I> </I><A NAME="lightsquarecolor"></A>/lightSquareColor <I>color</I><SUP> </SUP><BR>\r
131 <A NAME="dsc"></A>/dsc </B>or<B> <A NAME="darksquarecolor"></A>/darkSquareColor <I>color</I><SUP> </SUP></B></P>\r
132 \r
133 <P>Color specifications for white pieces, black pieces, light squares, and dark squares. Colors can be specified only by red/green/blue intensity, either in hexadecimal (as <I>#rrggbb</I>) or in decimal (as <I>rrr,ggg,bbb</I>). In the latter format, you must enclose the string in quotation marks if you leave spaces after the commas. The defaults are respectively #FFFFCC, #202020, #C8C365, and #77A26D. Available on the <A HREF="07.htm#boardcolors">Board Colors</A> section of the <A HREF="07.htm#boardoptions">Board Options</A> dialog.</P>\r
134 \r
135 \r
136 \r
137 <P>If you are using a <A NAME="grayscale"></A>grayscale monitor, try setting the colors to:</P>\r
138 \r
139 <PRE><CODE>-whitePieceColor:#FFFFFF\r
140 -blackPieceColor:#000000\r
141 -lightSquareColor:#CCCCCC\r
142 -darkSquareColor:#999999</CODE></PRE>\r
143 \r
144 \r
145 \r
146 <P><B><A NAME="hsc"></A>/hsc </B>or<B> <A NAME="highlightsquarecolor"></A>/highlightSquareColor <I>color</I><SUP> </SUP><BR>\r
147 <A NAME="phc"></A>/phc </B>or <B><A NAME="premovehighlightcolor"></A>/premoveHighlightColor <I>color</I><SUP> </SUP></B></P>\r
148 \r
149 <P>Color specifications for the <A HREF="07.htm#highlightlastmove">Highlight Last Move</A> and <A HREF="07.htm#premovecmd">Premove</A> options, respectively. Colors can be specified only by red/green/blue intensity, either in hexadecimal (as <I>#rrggbb</I>) or in decimal (as <I>rrr,ggg,bbb</I>). In the latter format, you must enclose the string in quotation marks if you leave spaces after the commas. The defaults are respectively #FFFF00 and #FF0000, respectively.</P>\r
150 \r
151 \r
152 \r
153 <P><B><A NAME="mono"></A>/mono</B> or <B>/xmono</B>,<B> </B>or<B> <A NAME="monomode"></A>/monoMode<I> true|false</I></B></P>\r
154 \r
155 <P>Determines whether WinBoard displays its pieces and squares in black and white (True) or color (False, the default). Available in the <A HREF="07.htm#boardcolors">Board Colors</A> section of the <A HREF="07.htm#boardoptions">Board Options</A> dialog.</P>\r
156 \r
157 \r
158 \r
159 <P><B><A NAME="flipblack"></A><font color="#008000">/flipBlack<I> true|false</I></font></B></P>\r
160 \r
161 <P><font color="#008000">Determines whether WinBoard displays the black pieces upside down (or the white pieces in Flip View). Useful with Shogi with the traditional Japanese pieces, which are not distinguished by color but by orientation.</font></P>\r
162 \r
163 \r
164 \r
165 <P><B><A NAME="allwhite"></A><font color="#008000">/allWhite<I> true|false</I></font></B></P>\r
166 \r
167 <P><font color="#008000">Determines whether the white piece bitmaps will be used to display black pieces. The white pieces have a dark outline, which the black pieces lack. This makes the latter look vague if the color you give them is not very dark.</font></P>\r
168 \r
169 \r
170 \r
171 <P><B><A NAME="renderpieceswithfont"></A><font color="#ff0000">/renderPiecesWithFont <I>fontname</I></font></B></P>\r
172 \r
173 <P><font color="#ff0000">Uses the named true-type font to render the pieces, rather than the built-in bitmaps. The font must be installed on your computer. If the name starts with a *  it is ignored, allowing you to easily disable a font temporarily in the whinboard.ini file.</font></P>\r
174 \r
175 \r
176 \r
177 <P><B><A NAME="fontpiecetochartable"></A><font color="#ff0000">/fontPieceToCharTable <I>characterstring</I></font></B></P>\r
178 \r
179 <P><font color="#ff0000">If font-based rendering of the pieces is used, this table specifies which character of the font alphabet should be used for which piece. The format of the character strings is the same as that of the argument of /pieceToCharTable.</font></P>\r
180 \r
181 \r
182 \r
183 <P><B><A NAME="fontpiecesize"></A><font color="#ff0000">/fontPieceSize <I>number</I></font></B></P>\r
184 \r
185 <P><font color="#ff0000">The number gives the size of the piece, as a percentage of the square size.</font></P>\r
186 \r
187 \r
188 \r
189 <P><font color="#ff0000"><B><A NAME="fontpiecebackcolorwhite"></A>/fontPieceBackColorWhite <I>color<BR>\r
190 </I><A NAME="fontpieceforecolorwhite"></A>/fontPieceForeColorWhite <I>color<BR>\r
191 </I><A NAME="fontpiecebackcolorblack"></A>/fontPieceBackColorBlack <I>color<BR>\r
192 </I><A NAME="fontpieceforecolorblack"></A>/fontPieceForeColorBlack <I>color</I><SUP> </SUP></B></font></P>\r
193 \r
194 <P><font color="#ff0000">Color specifications for white pieces, black pieces that are generated with font-based rendering.</font></P>\r
195 \r
196 \r
197 \r
198 <P><B><A NAME="litebacktexturefile"></A><font color="#ff0000">/liteBackTextureFile <I>filename</I></font></B></P>\r
199 \r
200 \r
201 \r
202 <P><B><A NAME="darkbacktexturefile"></A><font color="#ff0000">/darkBackTextureFile <I>filename</I></font></B></P>\r
203 \r
204 <P><font color="#ff0000">The filename indicates a bitmap file that should be used to display the light or dark squares, allowing you to make boards that look like wood, marble, etc. A filename starting with * is ignored.</font></P>\r
205 \r
206 \r
207 \r
208 <P><B><A NAME="litebacktexturemode"></A><font color="#ff0000">/liteBackTextureMode <I>number</I></font></B></P>\r
209 \r
210 \r
211 \r
212 <P><B><A NAME="darkbacktexturemode"></A><font color="#ff0000">/darkBackTextureMode <I>number</I></font></B></P>\r
213 \r
214 <P><font color="#ff0000">The number indicates the way the files given in the background-texture options should be used to fill in the squares. Valid texture modes are 1 (default) and 2. In mode 1 the squares are taken from portions of the texture bitmap and copied without further processing. In mode 2, squares can also be rotated, mirrored and so on in order to provide a little more variety to the texture. The operations are selected at random so the board will look slightly different every time the program is run.</font><BR>\r
215 </P>\r
216 \r
217 \r
218 \r
219 <P><B><A NAME="overidelinegap"></A><font color="#ff0000">/overideLineGap <I>number</I></font></B></P>\r
220 \r
221 <P><font color="#ff0000">The number specifies the width, in pixels, of the grid lines used to separate the squares. If it is very small (like a single pixel), it becomes vey hard to see which squares are highlighted (to indicate the last move), as this highlighting is a color change of these grid lines. Highlighting the moves with an arrow is then recommended.</font></P>\r
222 \r
223 \r
224 \r
225 <P><B><A NAME="highlightmoveswitharrow"></A><font color="#ff0000">/highlightMovesWithArrow <I>true|false</I></font></B></P>\r
226 \r
227 <P><font color="#ff0000">If this option is true, a big, fat arrow is drawn to indicate the last move.</font></P>\r
228 \r
229 \r
230 \r
231 <P><B><A NAME="highlightarrowcolor"></A><font color="#ff0000">/highlightArrowColor <I>color</I></font></B></P>\r
232 \r
233 <P><font color="#ff0000">Specifies the color of the arrow that highlights the moves.</font></P>\r
234 \r
235 \r
236 \r
237 <P><B><A NAME="evalhistocolorwhite"></A><font color="#ff0000">/evalHistoColorWhite <I>color</I></font></B></P>\r
238 \r
239 \r
240 \r
241 <P><B><A NAME="evalhistocolorblack"></A><font color="#ff0000">/evalHistoColorBlack <I>color</I></font></B></P>\r
242 \r
243 <P><font color="#ff0000">Specifies the colors to be used to plot the white and black scores in the evaluation graph.</font><BR>\r
244 </P>\r
245 \r
246 \r
247 \r
248 <P><B><A NAME="colorshout"></A>/colorShout<I> “effects color”<BR>\r
249 </I><A NAME="colorsshout"></A>/colorSShout <I>“effects color”<BR>\r
250 </I><A NAME="colorchannel1"></A>/colorChannel1 <I>“effects color”</I><BR>\r
251 <A NAME="colorchannel"></A>/colorChannel <I>“effects color”</I><BR>\r
252 <A NAME="colorkibitz"></A>/colorKibitz <I>“effects color”</I><BR>\r
253 <A NAME="colortell"></A>/colorTell <I>“effects color”</I><BR>\r
254 <A NAME="colorchallenge"></A>/colorChallenge <I>“effects color”</I><BR>\r
255 <A NAME="colorrequest"></A>/colorRequest <I>“effects color”</I><BR>\r
256 <A NAME="colorseek"></A>/colorSeek <I>“effects color”</I><BR>\r
257 <A NAME="colornormal"></A>/colorNormal <I>“effects color”</I></B></P>\r
258 \r
259 <P>Select colors and effects to colorize messages in the ICS Interaction window. The effects may be any combination of <B>b</B>old, <B>i</B>talic, <B>u</B>nderline, and <B>s</B>trikeout. Colors are specified as for squares and pieces. Available on the <A HREF="07.htm#icsinteractioncolors">ICS Interaction Colors</A> section of the <A HREF="07.htm#icsoptions">ICS Options</A> dialog. Limitation: On 256 color displays, Windows chooses the nearest solid color from the system palette, which will not always be close to the color you selected.</P>\r
260 \r
261 \r
262 \r
263 <P><B><A NAME="colorbackground"></A>/colorBackground <I>color</I></B></P>\r
264 \r
265 <P>Sets the background color for the ICS Interaction window. Available on the <A HREF="07.htm#icsinteractioncolors">ICS Interaction Colors</A> section of the <A HREF="07.htm#icsoptions">ICS Options</A> dialog.</P>\r
266 \r
267 \r
268 \r
269 <P><B><A NAME="colorize"></A>/colorize<SUP> </SUP></B>or <B>/xcolorize</B>, or<B> <A NAME="colorizemessages"></A>/colorizeMessages<I> true|false</I></B></P>\r
270 \r
271 <P>If True, WinBoard colorizes messages in the ICS Interaction window with the colors listed above. Default: True. Available in the <A HREF="07.htm#icsinteractioncolors">ICS Interaction Colors</A> section of the <A HREF="07.htm#icsoptions">ICS Options</A> dialog.</P>\r
272 \r
273 \r
274 \r
275 <P><B><A NAME="clockfont"></A>/clockFont “<I>fontname:size effects</I>”<BR>\r
276 <A NAME="messagefont"></A>/messageFont “<I>fontname:size effects</I>”<BR>\r
277 <A NAME="coordfont"></A>/coordFont “<I>fontname:size effects</I>”<BR>\r
278 <A NAME="tagsfont"></A>/tagsFont “<I>fontname:size effects</I>”<BR>\r
279 <A NAME="commentfont"></A>/commentFont “<I>fontname:size effects</I>”<BR>\r
280 <A NAME="icsfont"></A>/icsFont “<I>fontname:size effects</I>”</B></P>\r
281 \r
282 <P>The fonts used respectively for the clocks, the message display line, rank and file coordinate labels, the Edit Tags dialog, the Edit Comment dialog, and the ICS Interaction window. These options may be given more than once. Each occurrence affects the fonts for the current board size; that is, the size given in the last preceding /boardSize option, if any, or else the default size. The font size may contain a decimal point, and the effects may be any combination of <B>b</B>old, <B>i</B>talic, <B>u</B>nderline, and <B>s</B>trikeout. Example: <CODE>/clockFont="Arial:20.0 bi".</CODE> Available on the <A HREF="07.htm#fonts">Fonts</A> menu.</P>\r
283 \r
284 \r
285 \r
286 <P><B><A NAME="soundshout"></A>/soundShout<I> sound<BR>\r
287 </I><A NAME="soundsshout"></A>/soundSShout <I>sound<BR>\r
288 </I><A NAME="soundchannel1"></A>/soundChannel1 <I>sound</I><BR>\r
289 <A NAME="soundchannel"></A>/soundChannel <I>sound</I><BR>\r
290 <A NAME="soundkibitz"></A>/soundKibitz <I>sound</I><BR>\r
291 <A NAME="soundtell"></A>/soundTell <I>sound</I><BR>\r
292 <A NAME="soundchallenge"></A>/soundChallenge <I>sound</I><BR>\r
293 <A NAME="soundrequest"></A>/soundRequest <I>sound</I><BR>\r
294 <A NAME="soundmove"></A>/soundMove <I>sound</I><SUP> </SUP><BR>\r
295 <A NAME="soundbell"></A>/soundBell <I>sound</I><SUP> </SUP></B></P>\r
296 \r
297 \r
298 \r
299 <P><B><A NAME="soundicswin"></A>/soundIcsWin <I>sound</I><BR>\r
300 <A NAME="soundicsloss"></A>/soundIcsLoss <I>sound</I><SUP> </SUP><BR>\r
301 <A NAME="soundicsdraw"></A>/soundIcsDraw <I>sound</I><SUP> </SUP><BR>\r
302 <A NAME="soundicsunfinished"></A>/soundIcsUnfinished <I>sound</I><SUP> </SUP></B></P>\r
303 \r
304 \r
305 \r
306 <P><B><A NAME="soundicsalarm"></A>/soundIcsAlarm <I>sound</I><SUP> </SUP></B></P>\r
307 \r
308 <P>Associate sounds with WinBoard events. Most of the events are the same ones that cause text colorization. In addition, <B>soundMove</B> is played if a chess engine or another player makes a move. <B>SoundBell</B> is played if the chess server sends an ASCII BEL character (Ctrl+G). Available on the <A HREF="07.htm#sounds">Sounds</A> menu.</P>\r
309 \r
310 <P><B>SoundIcsWin</B>, <B>soundIcsLoss</B>, <B>soundIcsDraw</B> and <B>soundIcsUnfinished</B> are played at the conclusion of an ICS game.  The result of the game determines which sound is played.</P>\r
311 \r
312 <P><B>SoundIcsAlarm</B> is played when your game clock counts down to <A HREF="14.htm#icsalarmtime">icsAlarmTime</A>. </P>\r
313 \r
314 <P>The <I>sound</I> argument may be one of the following:\r
315 \r
316 <UL>\r
317         <LI>The name of a <CODE>.wav</CODE> file. The filename is interpreted relative to WinBoard's installation directory (the directory containing WinBoard.exe).<BR><BR></LI>\r
318 \r
319         <LI><CODE>$</CODE>, indicating the default system sound.<BR><BR></LI>\r
320 \r
321         <LI><CODE>!</CODE> followed by the name of a built-in WinBoard wave resource.<BR><BR></LI>\r
322 \r
323         <LI><CODE>!</CODE> alone, or “” (empty string), indicating silence.</LI>\r
324 </UL>\r
325 \r
326 <P>The default for soundMove and soundBell is <CODE>$</CODE>, while the others default to silence.</P>\r
327 \r
328 \r
329 \r
330 <P><B><A NAME="icsmenu"></A>/icsMenu={<I>entries</I>} </B>or <B>/icsMenu=@<I>filename</I></B></P>\r
331 \r
332 <P>This option lets you customize the right-button <A HREF="09.htm">context menu</A> that is available in the upper (output) pane of the ICS Interaction window. It consists of a list of menu entries, one per line. If the option value starts with an @ sign, it is the name of a file that contains the entries. Each entry contains either four fields separated by commas or the single character <CODE>"-"</CODE>. The fields are:\r
333 \r
334 <OL>\r
335         <LI>The menu text. If this field begins with <CODE>"|"</CODE>, the item begins a new column in the menu and the <CODE>"|"</CODE> is not shown. If this field contains an <CODE>"&amp;"</CODE>, the character after the ampersand is underlined in the menu and acts as a keyboard shortcut for the item when the menu is displayed. Do not assign the same shortcut key to two different menu items.<BR><BR></LI>\r
336 \r
337         <LI>Text to insert into the input pane. The text cannot include a comma. You can use ICS aliases to get around this limitation.<BR><BR></LI>\r
338 \r
339         <LI>A flag (1 or 0) saying whether to insert a space and <I>name </I>(see <A HREF="09.htm#tell">above</A>) after the text. If you set this flag, you might also want to put "(name)" into the menu text as a memory aid.<BR><BR></LI>\r
340 \r
341         <LI>A flag (1 or 0) saying whether the result should be sent immediately to ICS or left in the input pane for further editing.</LI>\r
342 </OL>\r
343 \r
344 <P>The entry <CODE>"-"</CODE> produces a separator line in the menu. The top three menu entries are always <B>Copy and Paste</B>, <B>Copy</B>, and <B>Paste</B>, but you have full control over the rest of the menu.</P>\r
345 \r
346 <P>The default menu is:</P>\r
347 \r
348 <PRE><CODE>–\r
349 &amp;Who,who,0,1\r
350 Playe&amp;rs,players,0,1\r
351 &amp;Games,games,0,1\r
352 &amp;Sought,sought,0,1\r
353 |&amp;Tell (name),tell,1,0\r
354 M&amp;essage (name),message,1,0\r
355 –\r
356 &amp;Finger (name),finger,1,1\r
357 &amp;Vars (name),vars,1,1\r
358 &amp;Observe (name),observe,1,1\r
359 &amp;Match (name),match,1,1\r
360 Pl&amp;ay (name),play,1,1</CODE></PRE>\r
361 \r
362 <P>There is no graphical user interface to set this option. To change it, edit your <A HREF="19.htm#settings">settings</A> file with a plain text editor such as Notepad.</P>\r
363 \r
364 \r
365 \r
366 <P><B><A NAME="icsnames"></A>/icsNames={<I>names</I>} </B>or <B>/icsNames=@<I>filename</I></B></P>\r
367 \r
368 <P>This option lets you customize the drop-down list of ICS names that appears in the WinBoard startup dialog. It consists of a list of strings, one per line. If the option value starts with an @ sign, it is the name of a file that contains the strings. When you select a string from the drop-down list, WinBoard prepends the text ”/ics /icsHost=” and adds the result to the command-line options. There is no graphical user interface to set this option. To change it, edit your <A HREF="19.htm#settings">settings</A> file with a plain text editor such as Notepad.</P>\r
369 \r
370 \r
371 \r
372 <P><B><A NAME="firstchessprogramnames"></A>/firstChessProgramNames={<I>names</I>} </B>or <B>/firstChessProgramNames="@<I>filename</I>"</B></P>\r
373 \r
374 <P>This option lets you customize the first drop-down list of chess engine names that appears in the WinBoard startup dialog. It consists of a list of strings, one per line. If the option value starts with an @ sign, it is the name of a file that contains the strings. When you select a string from the drop-down list, WinBoard prepends the text ”/cp /firstChessProgram=” and adds the result to the command-line options. </P>\r
375 \r
376 <P>There is no graphical user interface to set this option. To change it, edit your <A HREF="19.htm#settings">settings</A> file with a plain text editor such as Notepad. Example:</P>\r
377 \r
378 <PRE><CODE>/firstChessProgramNames={GNUChess\r
379 WCrafty-15_11 /fd="C:\Program Files\Crafty"\r
380 ArasanX /fd="C:\Program Files\Arasan\Arasan 4.1"\r
381 "EXchess xb" /fd=C:\EXchess\r
382 Comet-WB /fd=C:\Comet\r
383 }</CODE></PRE>\r
384 \r
385 \r
386 \r
387 <P><B><A NAME="secondchessprogramnames"></A>/secondChessProgramNames={<I>names</I>}</B> or <B>/secondChessProgramNames="@<I>filename</I>"</B></P>\r
388 \r
389 <P>This option lets you customize the second drop-down list of chess engine names that appears in the WinBoard startup dialog. It consists of a list of strings, one per line. If the option value starts with an @ sign, it is the name of a file that contains the strings. When you select a string from the drop-down list, WinBoard prepends the text ”/cp /secondChessProgram=” and adds the result to the command-line options.</P>\r
390 \r
391 <P>There is no graphical user interface to set this option. To change it, edit your <A HREF="19.htm#settings">settings</A> file with a plain text editor such as Notepad. Example:</P>\r
392 \r
393 <P><CODE>/secondChessProgramNames={GNUChess<BR>\r
394 WCrafty-15_11 /sd="C:\\Program Files\\Crafty\"<BR>\r
395 ArasanX /sd="C:\Program Files\Arasan\Arasan 4.1"<BR>\r
396 "EXchess xb" /sd=C:\EXchess<BR>\r
397 Comet-WB /sd=C:\Comet<BR>\r
398 }</CODE></P>\r
399 \r
400 \r
401 \r
402 <P><B><A NAME="xy"></A>/x=<I>xcoord  </I>/y=<I>ycoord</I></B></P>\r
403 \r
404 <P>Sets the initial location of the board window, giving the screen coordinates of the upper left-hand corner. Both arguments must be given together.</P>\r
405 \r
406 \r
407 \r
408 <P><B><A NAME="xywh"></A>/analysisX=<I>xcoord  </I>/analysisY=<I>ycoord</I>  /analysisW=<I>width</I>  /analysisH=<I>height</I></B></P>\r
409 \r
410 <P><font color="#3333ff">These options have been deprecated, as the analysis window is replaced by the more general engine-output window. They are recognized, but ignored, and no longer saved in the winboard.ini file.</font></P>\r
411 \r
412 \r
413 \r
414 <P><B><A NAME="xywh"></A>/commentX=<I>xcoord  </I>/commentY=<I>ycoord</I>  /commentW=<I>width</I>  /commentH=<I>height</I></B></P>\r
415 \r
416 <P>Sets the initial location and size of the Comment window, giving the screen coordinates of the upper left-hand corner <font color="#3333ff">(relative to the main window)</font>, the width, and the height. All four arguments must be given together.</P>\r
417 \r
418 \r
419 \r
420 <P><B><A NAME="xywh"></A>/gameListX=<I>xcoord  </I>/gameListY=<I>ycoord</I>  /gameListW=<I>width</I>  /gameListH=<I>height</I></B></P>\r
421 \r
422 <P>Sets the initial location and size of the Game List window, giving the screen coordinates of the upper left-hand corner <font color="#3333ff">(relative to the main window)</font>, the width, and the height. All four arguments must be given together.</P>\r
423 \r
424 \r
425 \r
426 <P><B><A NAME="xywh"></A>/icsX=<I>xcoord  </I>/icsY=<I>ycoord</I>  /icsW=<I>width</I>  /icsH=<I>height</I></B></P>\r
427 \r
428 <P>Sets the initial location and size of the ICS Interaction window, giving the screen coordinates of the upper left-hand corner <font color="#3333ff">(relative to the main window)</font>, the width, and the height. All four arguments must be given together.</P>\r
429 \r
430 \r
431 \r
432 <P><B><A NAME="xywh"></A>/tagsX=<I>xcoord  </I>/tagsY=<I>ycoord</I>  /tagsW=<I>width</I>  /tagsH=<I>height</I></B></P>\r
433 \r
434 <P>Sets the initial location and size of the Tags window, giving the screen coordinates of the upper left-hand corner <font color="#3333ff">(relative to the main window)</font>, the width, and the height. All four arguments must be given together.</P>\r
435 \r
436 \r
437 \r
438 <P><font color="#ff0000"><B><A NAME="xywh"></A>/moveHistoryX=<I>xcoord  </I>moveHistoryY=<I>ycoord</I>  /moveHistoryW=<I>width</I>  /moveHistoryH=<I>height</I></B></font></P>\r
439 \r
440 <P><font color="#ff0000">Sets the initial location and size of the move-history window, giving the screen coordinates of the upper left-hand corner</font> <font color="#3333ff">(relative to the main window)</font><font color="#ff0000">, the width, and the height. All four arguments must be given together.</font></P>\r
441 \r
442 \r
443 \r
444 <P><font color="#ff0000"><B><A NAME="xywh"></A>/evalGraphX=<I>xcoord  </I>/evalGraphY=<I>ycoord</I>  /evalGraphW=<I>width</I>  /evalGraphH=<I>height</I></B></font></P>\r
445 \r
446 <P><font color="#ff0000">Sets the initial location and size of the evaluation-graph window, giving the screen coordinates of the upper left-hand corner</font> <font color="#3333ff">(relative to the main window)</font><font color="#ff0000">, the width, and the height. All four arguments must be given together.</font></P>\r
447 \r
448 \r
449 \r
450 <P><font color="#ff0000"><B><A NAME="xywh"></A>/engineOutputX=<I>xcoord  </I>/engineOutputY=<I>ycoord</I>  </B></font></P>\r
451 \r
452 <P><font color="#ff0000"><B>/engineOutputW=<I>width</I>  /engineOutputH=<I>height</I></B></font></P>\r
453 \r
454 <P><font color="#ff0000">Sets the initial location and size of the engine-output window, giving the screen coordinates of the upper left-hand corner</font> <font color="#3333ff">(relative to the main window)</font><font color="#ff0000">, the width, and the height. All four arguments must be given together.</font></P>\r
455 \r
456 \r
457 \r
458 <P><font color="#ff0000"><B><A NAME="windowup"></A>/engineOutputUp <I>true|false </I></B></font></P>\r
459 \r
460 \r
461 \r
462 <P><font color="#ff0000"><B><A NAME="windowup"></A>/evalGraphUp <I>true|false</I></B></font></P>\r
463 \r
464 \r
465 \r
466 <P><font color="#ff0000"><B><A NAME="windowup"></A>/moveHistoryUp <I>true|false</I></B></font></P>\r
467 \r
468 <P><font color="#ff0000">If set to True, the corresponding window is displayed, if False, the window is absent.</font></P>\r
469 \r
470 \r
471 \r
472 <P><font color="#ff0000"><B><A NAME="stickywindows"></A>/stickyWindows <I>true|false</I></B></font></P>\r
473 \r
474 <P><font color="#ff0000">Auxiliary windows touching the main window will stay attached to the latter when you move it.</font></P>\r
475 \r
476 \r
477 \r
478 <P><font color="#ff0000"><B><A NAME="autodisplaycomment"></A>/autoDisplayComment <I>true|false</I></B></font></P>\r
479 \r
480 \r
481 \r
482 <P><font color="#ff0000"><B><A NAME="autodisplaytags"></A>/autoDisplayTags <I>true|false</I></B></font></P>\r
483 \r
484 <P><font color="#ff0000">If set to True, these options cause the window with the move comments, and the window with PGN tags, respectively, to pop up automatically when such tags or comments are encountered during the replaying a stored or loaded game.</font></P>\r
485 \r
486 \r
487 \r
488 <P><font color="#ff0000"><B><A NAME="gamelisttags"></A>/gameListTags <I>string</I></B></font></P>\r
489 \r
490 <P><font color="#ff0000">The <I>string</I> contains single-character codes specifying the PGN tags that have to be listed for each game in the game-list window, and their order. The meaning of the characters is a=out-of-book info, b=black Elo, e=event, d=date, o=round, p=players, r=result, w=white Elo, s=site, t=time control and v=variant, Default: “eprd”.</font></P>\r
491 \r
492 </BODY>\r
493 </HTML>\r