<title>User interface options - XBoard</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="XBoard">
-<meta name="generator" content="makeinfo 4.12">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Options.html#Options" title="Options">
<link rel="prev" href="Load-and-Save-options.html#Load-and-Save-options" title="Load and Save options">
</head>
<body>
<div class="node">
-<p>
<a name="User-interface-options"></a>
+<p>
Next: <a rel="next" accesskey="n" href="Adjudication-Options.html#Adjudication-Options">Adjudication Options</a>,
Previous: <a rel="previous" accesskey="p" href="Load-and-Save-options.html#Load-and-Save-options">Load and Save options</a>,
Up: <a rel="up" accesskey="u" href="Options.html#Options">Options</a>
<hr>
</div>
-<h3 class="section">3.5 User interface options</h3>
+<h3 class="section">4.6 User interface options</h3>
-<p><a name="index-User-interface-options-282"></a><a name="index-Options_002c-User-interface-283"></a>
+<p><a name="index-User-interface-options-430"></a><a name="index-Options_002c-User-interface-431"></a>
<dl>
-<dt>-display<dt>-geometry<dt>-iconic<dd><a name="index-display_002c-option-284"></a><a name="index-geometry_002c-option-285"></a><a name="index-iconic_002c-option-286"></a>These and most other standard Xt options are accepted.\r
-<br><dt>-noGUI<dd><a name="index-noGUI_002c-option-287"></a>Suppresses all GUI functions of XBoard \r
-(to speed up automated ultra-fast engine-engine games, which you dont want to watch). \r
-There will be no board or clock updates, no printing of moves, \r
-and no update of the icon on the task bar in this mode.\r
-<br><dt>-movesound/-xmovesound or -ringBellAfterMoves true/false<dd><a name="index-movesound_002c-option-288"></a><a name="index-bell_002c-option-289"></a><a name="index-ringBellAfterMoves_002c-option-290"></a>Sets the Move Sound menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-For compatibility with old XBoard versions, -bell/-xbell are also \r
-accepted as abbreviations for this option.\r
-<br><dt>-exit/-xexit or -popupExitMessage true/false<dd><a name="index-exit_002c-option-291"></a><a name="index-popupExitMessage_002c-option-292"></a>Sets the Popup Exit Message menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-popup/-xpopup or -popupMoveErrors true/false<dd><a name="index-popup_002c-option-293"></a><a name="index-popupMoveErrors_002c-option-294"></a>Sets the Popup Move Errors menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-<br><dt>-queen/-xqueen or -alwaysPromoteToQueen true/false<dd><a name="index-queen_002c-option-295"></a><a name="index-alwaysPromoteToQueen_002c-option-296"></a>Sets the Always Queen menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-<br><dt>-legal/-xlegal or -testLegality true/false<dd><a name="index-legal_002c-option-297"></a><a name="index-testLegality_002c-option-298"></a>Sets the Test Legality menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-size or -boardSize (sizeName | n1,n2,n3,n4,n5,n6,n7)<dd><a name="index-size_002c-option-299"></a><a name="index-boardSize_002c-option-300"></a><a name="index-board-size-301"></a>Determines how large the board will be, by selecting the pixel size\r
-of the pieces and setting a few related parameters.\r
-The sizeName can be one of: Titanic, giving 129x129 pixel pieces,\r
-Colossal 116x116, Giant 108x108, Huge 95x95, Big 87x87, Large 80x80, Bulky 72x72,\r
-Medium 64x64, Moderate 58x58, Average 54x54, Middling 49x49, Mediocre\r
-45x45, Small 40x40, Slim 37x37, Petite 33x33, Dinky 29x29, Teeny 25x25,\r
-or Tiny 21x21.\r
-Pieces of all these sizes are built into XBoard.\r
-Other sizes can\r
-be used if you have them; see the pixmapDirectory and bitmapDirectory\r
-options.\r
-The default depends on the size of your screen; it is approximately the\r
-largest size that will fit without clipping.\r
-\r
-You can select other sizes or vary other layout parameters by providing\r
-a list of comma-separated values (with no spaces) as the argument.\r
-You do not need to provide all the values; for any you omit from the\r
-end of the list, defaults are taken from the nearest built-in size.\r
-The value <code>n1</code> gives the piece size, <code>n2</code> the width of the\r
-black border\r
-between squares, <code>n3</code> the desired size for the \r
-clockFont, <code>n4</code> the desired size for the coordFont,\r
-<code>n5</code> the desired size for the default font,\r
-<code>n6</code> the smallLayout flag (0 or 1), \r
-and <code>n7</code> the tinyLayout flag (0 or 1). \r
-All dimensions are in pixels.\r
-If the border between squares is eliminated (0 width), the various\r
-highlight options will not work, as there is nowhere to draw the highlight.\r
-If smallLayout is 1 and <code>titleInWindow</code> is true, \r
-the window layout is rearranged to make more room for the title.\r
-If tinyLayout is 1, the labels on the menu bar are abbreviated\r
-to one character each and the buttons in the button bar are made narrower.\r
-<br><dt>-coords/-xcoords or -showCoords true/false<dd><a name="index-coords_002c-option-302"></a><a name="index-showCoords_002c-option-303"></a>Sets the Show Coords menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-The <code>coordFont</code> option specifies what font to use.\r
-<br><dt>-autoraise/-xautoraise or -autoRaiseBoard true/false<dd><a name="index-autoraise_002c-option-304"></a><a name="index-autoRaiseBoard_002c-option-305"></a>Sets the Auto Raise Board menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-autoflip/-xautoflip or -autoFlipView true/false<dd><a name="index-autoflip_002c-option-306"></a><a name="index-autoFlipView_002c-option-307"></a>Sets the Auto Flip View menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-flip/-xflip or -flipView true/false<dd><a name="index-flip_002c-option-308"></a><a name="index-flipView_002c-option-309"></a>If Auto Flip View is not set, or if you are observing but not participating\r
-in a game, then the positioning of the board at the start of each game\r
-depends on the flipView option. If flipView is false (the default),\r
-the board is positioned so that the white pawns move from the bottom to the\r
-top; if true, the black pawns move from the bottom to the top.\r
-In any case, the Flip menu option (see <a href="Options-Menu.html#Options-Menu">Options Menu</a>)\r
-can be used to flip the board after\r
-the game starts.\r
-<br><dt>-title/-xtitle or -titleInWindow true/false<dd><a name="index-title_002c-option-310"></a><a name="index-titleInWindow_002c-option-311"></a>If this option is true, XBoard displays player names (for ICS\r
-games) and game file names (for ‘<samp><span class="samp">Load Game</span></samp>’) inside its main\r
-window. If the option is false (the default), this information is\r
-displayed only in the window banner. You probably won't want to\r
-set this option unless the information is not showing up in the\r
-banner, as happens with a few X window managers.\r
-<br><dt>-buttons/-xbuttons or -showButtonBar True/False<dd><a name="index-buttons_002c-option-312"></a><a name="index-showButtonBar_002c-option-313"></a>If this option is False, xboard omits the [<<] [<] [P] [>] [>>] button\r
-bar from the window, allowing the message line to be wider. You can\r
-still get the functions of these buttons using the menus or their keyboard\r
-shortcuts. Default: true.\r
-<br><dt>-mono/-xmono or -monoMode true/false<dd><a name="index-mono_002c-option-314"></a><a name="index-monoMode_002c-option-315"></a>Determines whether XBoard displays its pieces and squares with\r
-two colors (true) or four (false). You shouldn't have to\r
-specify <code>monoMode</code>; XBoard will determine if it is necessary.\r
-<br><dt>-flashCount count<dt>-flashRate rate<dt>-flash/-xflash<dd><a name="index-flashCount_002c-option-316"></a><a name="index-flashRate_002c-option-317"></a><a name="index-flash_002c-option-318"></a><a name="index-xflash_002c-option-319"></a>These options enable flashing of pieces when they\r
-land on their destination square.\r
-<code>flashCount</code>\r
-tells XBoard how many times to flash a piece after it\r
-lands on its destination square.\r
-<code>flashRate</code>\r
-controls the rate of flashing (flashes/sec).\r
-Abbreviations:\r
-<code>flash</code>\r
-sets flashCount to 3.\r
-<code>xflash</code>\r
-sets flashCount to 0.\r
-Defaults: flashCount=0 (no flashing), flashRate=5.\r
-<br><dt>-highlight/-xhighlight or -highlightLastMove true/false<dd><a name="index-highlight_002c-option-320"></a><a name="index-highlightLastMove_002c-option-321"></a>Sets the Highlight Last Move menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-<br><dt>-blind/-xblind or -blindfold true/false<dd><a name="index-blind_002c-option-322"></a><a name="index-blindfold_002c-option-323"></a>Sets the Blindfold menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-<br><dt>-clockFont font<dd><a name="index-clockFont_002c-option-324"></a><a name="index-Font_002c-clock-325"></a>The font used for the clocks. If the option value is a pattern\r
-that does not specify the font size, XBoard tries to choose an\r
-appropriate font for the board size being used.\r
-Default: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*.\r
-<br><dt>-coordFont font<dd><a name="index-coordFont_002c-option-326"></a><a name="index-Font_002c-coordinates-327"></a>The font used for rank and file coordinate labels if <code>showCoords</code>\r
-is true. If the option value is a pattern that does not specify\r
-the font size, XBoard tries to choose an appropriate font for\r
-the board size being used.\r
-Default: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*.\r
-<br><dt>-font font<dd><a name="index-font_002c-option-328"></a><a name="index-Font-329"></a>The font used for popup dialogs, menus, comments, etc.\r
-If the option value is a pattern that does not specify\r
-the font size, XBoard tries to choose an appropriate font for\r
-the board size being used.\r
-Default: -*-helvetica-medium-r-normal–*-*-*-*-*-*-*-*.\r
-<br><dt>-fontSizeTolerance tol<dd><a name="index-fontSizeTolerance_002c-option-330"></a>In the font selection algorithm, a nonscalable font will be preferred\r
-over a scalable font if the nonscalable font's size differs\r
-by <code>tol</code> pixels\r
-or less from the desired size. A value of -1 will force\r
-a scalable font to always be used if available; a value of 0 will\r
-use a nonscalable font only if it is exactly the right size; \r
-a large value (say 1000) will force a nonscalable font to always be\r
-used if available. Default: 4.\r
-<br><dt>-bm or -bitmapDirectory dir<dt>-pixmap or -pixmapDirectory dir<dd><a name="index-bm_002c-option-331"></a><a name="index-bitmapDirectory_002c-option-332"></a><a name="index-pixmap_002c-option-333"></a><a name="index-pixmapDirectory_002c-option-334"></a>These options control what piece images xboard uses. The XBoard\r
-distribution includes one set of pixmap pieces in xpm format, in the\r
-directory <samp><span class="file">pixmaps</span></samp>, and one set of bitmap pieces in xbm format,\r
-in the directory <samp><span class="file">bitmaps</span></samp>. Pixmap\r
-pieces give a better appearance on the screen: the white pieces have\r
-dark borders, and the black pieces have opaque internal details. With\r
-bitmaps, neither piece color has a border, and the internal details\r
-are transparent; you see the square color or other background color\r
-through them.\r
-\r
-If XBoard is configured and compiled on a system that includes libXpm,\r
-the X pixmap library, the xpm pixmap pieces are compiled in as the\r
-default. A different xpm piece set can be selected at runtime with\r
-the <code>pixmapDirectory</code> option, or a bitmap piece set can be selected\r
-with the <code>bitmapDirectory</code> option.\r
-\r
-If XBoard is configured and compiled on a system that does not include\r
-libXpm (or the <code>--disable-xpm</code> option is given to the configure\r
-program), the bitmap pieces are compiled in as the default. It is not\r
-possible to use xpm pieces in this case, but pixmap pieces in another\r
-format called "xim" can be used by giving the <code>pixmapDirectory</code> option.\r
-Or again, a different bitmap piece set can be selected with the\r
-<code>bitmapDirectory</code> option.\r
-\r
-Files in the <code>bitmapDirectory</code> must be named as follows:\r
-The first character of a piece bitmap name gives the piece it \r
-represents (‘<samp><span class="samp">p</span></samp>’, ‘<samp><span class="samp">n</span></samp>’, ‘<samp><span class="samp">b</span></samp>’, ‘<samp><span class="samp">r</span></samp>’, ‘<samp><span class="samp">q</span></samp>’, or ‘<samp><span class="samp">k</span></samp>’),\r
-the next characters give the size in pixels, the\r
-following character indicates whether the piece is\r
-solid or outline (‘<samp><span class="samp">s</span></samp>’ or ‘<samp><span class="samp">o</span></samp>’),\r
-and the extension is ‘<samp><span class="samp">.bm</span></samp>’.\r
-For example, a solid 80x80 knight would be named <samp><span class="file">n80s.bm</span></samp>.\r
-The outline bitmaps are used only in monochrome mode.\r
-If bitmap pieces are compiled in and the bitmapDirectory is missing\r
-some files, the compiled in pieces are used instead.\r
-\r
-If the bitmapDirectory option is given,\r
-it is also possible to replace xboard's icons and menu checkmark,\r
-by supplying files named <samp><span class="file">icon_white.bm</span></samp>, <samp><span class="file">icon_black.bm</span></samp>, and\r
-<samp><span class="file">checkmark.bm</span></samp>.\r
-\r
-For more information about pixmap pieces and how to get additional\r
-sets, see <a href="zic2xpm.html#zic2xpm">zic2xpm</a> below.\r
-<br><dt>-whitePieceColor color<dt>-blackPieceColor color<dt>-lightSquareColor color<dt>-darkSquareColor color<dt>-highlightSquareColor color<dd><a name="index-Colors-335"></a><a name="index-whitePieceColor_002c-option-336"></a><a name="index-blackPieceColor_002c-option-337"></a><a name="index-lightSquareColor_002c-option-338"></a><a name="index-darkSquareColor_002c-option-339"></a><a name="index-highlightSquareColor_002c-option-340"></a>Colors to use for the pieces, squares, and square highlights.\r
-Defaults:\r
-\r
- <pre class="example"> -whitePieceColor #FFFFCC\r
- -blackPieceColor #202020\r
- -lightSquareColor #C8C365\r
- -darkSquareColor #77A26D\r
- -highlightSquareColor #FFFF00\r
- -premoveHighlightColor #FF0000\r
+<dt>-display<dt>-geometry<dt>-iconic<dt>-name<dd><a name="index-display_002c-option-432"></a><a name="index-geometry_002c-option-433"></a><a name="index-iconic_002c-option-434"></a><a name="index-resource-name_002c-option-435"></a>These and most other standard Xt options are accepted.
+<br><dt>-noGUI<dd><a name="index-noGUI_002c-option-436"></a>Suppresses all GUI functions of XBoard
+(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.
+<br><dt>-logoSize N<dd><a name="index-logoSize_002c-option-437"></a>This option controls the drawing of player logos next to the clocks.
+The integer N specifies the width of the logo in pixels;
+the logo height will always be half the width.
+When N = 0, no logos will be diplayed.
+Default: 0.
+<br><dt>-firstLogo imagefile<dt>-secondLogo imagefile<dd><a name="index-firstLogo_002c-option-438"></a><a name="index-secondLogo_002c-option-439"></a>Specify the images to be used as player logos when <code>logoSize</code>
+is non-zero, next to the white and black clocks, respectively.
+<br><dt>-autoLogo true/false<br><dt>-logoDir filename<dd><a name="index-autoLogo_002c-option-440"></a><a name="index-logoDir_002c-option-441"></a>When <code>autoLogo</code> is set, XBoard will search for a PNG image file
+with the name of the engine or ICS in the directory specified
+by <code>logoDir</code>.
+<br><dt>-recentEngines number<dt>-recentEngineList list<dd><a name="index-recentEngines_002c-option-442"></a><a name="index-recentEngineList_002c-option-443"></a>When the number is larger than zero, it determines how many recently
+used engines will be appended at the bottom of the ‘<samp><span class="samp">Engines</span></samp>’ menu.
+The engines will be saved in your settings file as the option
+<code>recentEngineList</code>, by their nicknames,
+and the most recently used one will always be sorted to the top.
+If the list after that is longer than the specified number,
+the last one is discarded.
+Changes in the list will only become visible the next session,
+provided you saved the settings.
+Default: 6.
+<br><dt>-autoInstall list<dd><a name="index-autoInstall_002c-option-444"></a>When the list is set to a non-empty string, XBoard will scan the
+operating system's plugin directory for engines supporting UCI
+and XBoard protocol at startup.
+When it finds an engine that was installed after it last saved
+its settings, a line to launch that engine (as per specs in
+the plugin file) is appended to the -firstChessProgramNames
+list of installed engines.
+In the future it will be possible to use the list to limit
+this automatic adding of engines to a certain types of variants.
+<br><dt>-oneClickMove true/false<dd><a name="index-oneClickMove_002c-option-445"></a>When set, this option allows you to enter moves by only clicking the to-
+or from-square, when only a single legal move to or from that square
+is possible.
+Double-clicking a piece (or clicking an already selected piece)
+will instruct that piece to make the only capture it can legally do.
+Default: false.
+<br><dt>-movesound/-xmovesound or -ringBellAfterMoves true/false<dd><a name="index-movesound_002c-option-446"></a><a name="index-bell_002c-option-447"></a><a name="index-ringBellAfterMoves_002c-option-448"></a>Sets the Move Sound menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+For compatibility with old XBoard versions, -bell/-xbell are also
+accepted as abbreviations for this option.
+<br><dt>-exit/-xexit or -popupExitMessage true/false<dd><a name="index-exit_002c-option-449"></a><a name="index-popupExitMessage_002c-option-450"></a>Sets the Popup Exit Message menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-popup/-xpopup or -popupMoveErrors true/false<dd><a name="index-popup_002c-option-451"></a><a name="index-popupMoveErrors_002c-option-452"></a>Sets the Popup Move Errors menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-queen/-xqueen or -alwaysPromoteToQueen true/false<dd><a name="index-queen_002c-option-453"></a><a name="index-alwaysPromoteToQueen_002c-option-454"></a>Sets the Always Queen menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-sweepPromotions true/false<dd><a name="index-sweepPromotion_002c-option-455"></a>Sets the ‘<samp><span class="samp">Almost Always Promote to Queen</span></samp>’ menu option.
+See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-legal/-xlegal or -testLegality true/false<dd><a name="index-legal_002c-option-456"></a><a name="index-testLegality_002c-option-457"></a>Sets the Test Legality menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-size or -boardSize (sizeName | n1,n2,n3,n4,n5,n6,n7)<dd><a name="index-size_002c-option-458"></a><a name="index-boardSize_002c-option-459"></a><a name="index-board-size-460"></a>Determines how large the board will be, by selecting the pixel size
+of the pieces and setting a few related parameters.
+The sizeName can be one of: Titanic, giving 129x129 pixel pieces,
+Colossal 116x116, Giant 108x108, Huge 95x95, Big 87x87, Large 80x80, Bulky 72x72,
+Medium 64x64, Moderate 58x58, Average 54x54, Middling 49x49, Mediocre
+45x45, Small 40x40, Slim 37x37, Petite 33x33, Dinky 29x29, Teeny 25x25,
+or Tiny 21x21.
+Xboard installs with a set of scalable (svg) piece images,
+which it scales to any of the requested sizes.
+The square size can further be continuously scaled by sizing the board window,
+but this only adapts the size of the pieces,
+and has no effect on the width of the grid lines or the font choice
+(both of which would depend on he selected boardSize).
+The default depends on the size of your screen; it is approximately the
+largest size that will fit without clipping.
+
+ <p>You can select other sizes or vary other layout parameters by providing
+a list of comma-separated values (with no spaces) as the argument.
+You do not need to provide all the values; for any you omit from the
+end of the list, defaults are taken from the nearest built-in size.
+The value <code>n1</code> gives the piece size, <code>n2</code> the width of the
+black border
+between squares, <code>n3</code> the desired size for the
+clockFont, <code>n4</code> the desired size for the coordFont,
+<code>n5</code> the desired size for the messageFont,
+<code>n6</code> the smallLayout flag (0 or 1),
+and <code>n7</code> the tinyLayout flag (0 or 1).
+All dimensions are in pixels.
+If the border between squares is eliminated (0 width), the various
+highlight options will not work, as there is nowhere to draw the highlight.
+If smallLayout is 1 and <code>titleInWindow</code> is true,
+the window layout is rearranged to make more room for the title.
+If tinyLayout is 1, the labels on the menu bar are abbreviated
+to one character each and the buttons in the button bar are made narrower.
+<br><dt>-overrideLineGap n<dd><a name="index-overrideLineGap_002c-option-461"></a>When n >= 0, this forces the width of the black border between squares
+to n pixels for any board size. Mostly used to suppress the grid
+entirely by setting n = 0, e.g. in xiangqi or just getting a prettier
+picture. When n < 0 this the size-dependent width of the grid lines
+is used. Default: -1.
+<br><dt>-coords/-xcoords or -showCoords true/false<dd><a name="index-coords_002c-option-462"></a><a name="index-showCoords_002c-option-463"></a>Sets the Show Coords menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+The <code>coordFont</code> option specifies what font to use.
+<br><dt>-autoraise/-xautoraise or -autoRaiseBoard true/false<dd><a name="index-autoraise_002c-option-464"></a><a name="index-autoRaiseBoard_002c-option-465"></a>Sets the Auto Raise Board menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-autoflip/-xautoflip or -autoFlipView true/false<dd><a name="index-autoflip_002c-option-466"></a><a name="index-autoFlipView_002c-option-467"></a>Sets the Auto Flip View menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-flip/-xflip or -flipView true/false<dd><a name="index-flip_002c-option-468"></a><a name="index-flipView_002c-option-469"></a>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 Flip menu option (see <a href="Options-Menu.html#Options-Menu">Options Menu</a>)
+can be used to flip the board after
+the game starts.
+<br><dt>-title/-xtitle or -titleInWindow true/false<dd><a name="index-title_002c-option-470"></a><a name="index-titleInWindow_002c-option-471"></a>If this option is true, XBoard displays player names (for ICS
+games) and game file names (for ‘<samp><span class="samp">Load Game</span></samp>’) inside its main
+window. If the option is false (the default), this information is
+displayed only in the window banner. You probably won't want to
+set this option unless the information is not showing up in the
+banner, as happens with a few X window managers.
+<br><dt>-buttons/-xbuttons or -showButtonBar True/False<dd><a name="index-buttons_002c-option-472"></a><a name="index-showButtonBar_002c-option-473"></a>If this option is False, xboard omits the [<<] [<] [P] [>] [>>] button
+bar from the window, allowing the message line to be wider. You can
+still get the functions of these buttons using the menus or their keyboard
+shortcuts. Default: true.
+<br><dt>-evalZoom factor<dd><a name="index-evalZoom_002c-option-474"></a>The score interval (-1,1) is blown up on the vertical axis of
+the Evaluation Graph by the given factor.
+Default: 1
+<br><dt>-evalThreshold n<dd><a name="index-evalThreshold_002c-option-475"></a>Score below n (centiPawn) are plotted as 0 in the Evaluation Graph.
+Default: 25
+<br><dt>-mono/-xmono or -monoMode true/false<dd><a name="index-mono_002c-option-476"></a><a name="index-monoMode_002c-option-477"></a>Determines whether XBoard displays its pieces and squares with
+two colors (true) or four (false). You shouldn't have to
+specify <code>monoMode</code>; XBoard will determine if it is necessary.
+<br><dt>-showTargetSquares true/false<dd><a name="index-showTargetSquares_002c-option-478"></a>Determines whether XBoard can highlight the squares a piece has
+legal moves to, when you grab that piece with the mouse.
+Default: false.
+<br><dt>-flashCount count<dt>-flashRate rate<dt>-flash/-xflash<dd><a name="index-flashCount_002c-option-479"></a><a name="index-flashRate_002c-option-480"></a><a name="index-flash_002c-option-481"></a><a name="index-xflash_002c-option-482"></a>These options enable flashing of pieces when they
+land on their destination square.
+<code>flashCount</code>
+tells XBoard how many times to flash a piece after it
+lands on its destination square.
+<code>flashRate</code>
+controls the rate of flashing (flashes/sec).
+Abbreviations:
+<code>flash</code>
+sets flashCount to 3.
+<code>xflash</code>
+sets flashCount to 0.
+Defaults: flashCount=0 (no flashing), flashRate=5.
+<br><dt>-highlight/-xhighlight or -highlightLastMove true/false<dd><a name="index-highlight_002c-option-483"></a><a name="index-highlightLastMove_002c-option-484"></a>Sets the Highlight Last Move menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-highlightMoveWithArrow true/false<dd><a name="index-highlight-Arrow_002c-option-485"></a><a name="index-highlightMoveWithArrow_002c-option-486"></a>Sets the Highlight with Arrow menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-blind/-xblind or -blindfold true/false<dd><a name="index-blind_002c-option-487"></a><a name="index-blindfold_002c-option-488"></a>Sets the Blindfold menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-periodic/-xperiodic or -periodicUpdates true/false<dd><a name="index-periodic_002c-option-489"></a><a name="index-periodicUpdates_002c-option-490"></a>Controls updating of current move andnode counts in analysis mode. Default: true.
+<br><dt>-fSAN<dt>-sSAN<dd><a name="index-fSAN_002c-option-491"></a><a name="index-sSAN_002c-option-492"></a>Causes the PV in thinking output of the mentioned engine to be converted
+to SAN before it is further processed.
+Warning: this might lose engine output not understood by the parser,
+and uses a lot of CPU power.
+Default: the PV is displayed exactly as the engine produced it.
+<br><dt>-showEvalInMoveHistory true/false<dd><a name="index-showEvalInMoveHistory_002c-option-493"></a>Controls whether the evaluation scores and search depth of engine moves
+are displayed with the move in the move-history window.
+Default: true.
+<br><dt>-clockFont font<dd><a name="index-clockFont_002c-option-494"></a><a name="index-Font_002c-clock-495"></a>The font used for the clocks. If the option value is a pattern
+that does not specify the font size, XBoard tries to choose an
+appropriate font for the board size being used.
+Default Xaw: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*.
+Default GTK: Sans Bold %d.
+<br><dt>-coordFont font<dd><a name="index-coordFont_002c-option-496"></a><a name="index-Font_002c-coordinates-497"></a>The font used for rank and file coordinate labels if <code>showCoords</code>
+is true. If the option value is a pattern that does not specify
+the font size, XBoard tries to choose an appropriate font for
+the board size being used.
+Default Xaw: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*.
+Default GTK: Sans Bold %d.
+<br><dt>-messageFont font<dd><a name="index-messageFont_002c-option-498"></a><a name="index-Font_002c-message-499"></a>The font used for popup dialogs, menus, etc.
+If the option value is a pattern that does not specify
+the font size, XBoard tries to choose an appropriate font for
+the board size being used.
+Default Xaw: -*-helvetica-medium-r-normal–*-*-*-*-*-*-*-*.
+Default GTK: Sans Bold %d.
+<a name="index-tagsFont_002c-option-500"></a><a name="index-Font_002c-tags-501"></a>The font used in the Edit Tags dialog.
+If the option value contains %d, XBoard will replace it by
+an appropriate font for the board size being used.
+(Only used in GTK build.)
+Default: Sans Normal %d.
+<a name="index-commentFont_002c-option-502"></a><a name="index-Font_002c-comment-503"></a>The font used in the Edit Comment dialog.
+If the option value contains %d, XBoard will replace it by
+an appropriate font for the board size being used.
+(Only used in GTK build.)
+Default: Sans Normal %d.
+<a name="index-icsFont_002c-option-504"></a><a name="index-Font_002c-ics-505"></a>The font used to display ICS output in the ICS Chat window.
+As ICS output often contains tables aligned by spaces,
+a mono-space font is recommended here.
+If the option value contains %d, XBoard will replace it by
+an appropriate font for the board size being used.
+(Only used in GTK build.)
+Default: Monospace Normal %d.
+<a name="index-moveHistoryFont_002c-option-506"></a><a name="index-Font_002c-moveHistory-507"></a>The font used in Move History and Engine Output windows.
+As these windows display mainly moves,
+one could use a figurine font here.
+If the option value contains %d, XBoard will replace it by
+an appropriate font for the board size being used.
+(Only used in GTK build.)
+Default: Sans Normal %d.
+<a name="index-gameListFont_002c-option-508"></a><a name="index-Font_002c-gameList-509"></a>The font used in the listbox of the Game List window.
+If the option value contains %d, XBoard will replace it by
+an appropriate font for the board size being used.
+(Only used in GTK build.)
+Default: Sans Bold %d.
+<br><dt>-fontSizeTolerance tol<dd><a name="index-fontSizeTolerance_002c-option-510"></a>In the font selection algorithm, a nonscalable font will be preferred
+over a scalable font if the nonscalable font's size differs
+by <code>tol</code> pixels
+or less from the desired size. A value of -1 will force
+a scalable font to always be used if available; a value of 0 will
+use a nonscalable font only if it is exactly the right size;
+a large value (say 1000) will force a nonscalable font to always be
+used if available. Default: 4.
+<br><dt>-pid or -pieceImageDirectory dir<dd><a name="index-pid_002c-option-511"></a><a name="index-pieceImageDirectory_002c-option-512"></a>This options control what piece images xboard uses.
+XBoard will look in the specified directory for an image in png
+or svg format for every piece type, with names like BlackQueen.svg,
+WhiteKnight.svg etc.
+When neither of these is found (or no valid directory is specified)
+XBoard will use the svg piece that was installed with it
+(from the source-tree directory ‘<samp><span class="samp">svg</span></samp>’).
+Both svg and png images will be scaled by XBoard to the required size,
+but the png pieces lose much in quality when scaled too much.
+
+ <br><dt>-whitePieceColor color<dt>-blackPieceColor color<dt>-lightSquareColor color<dt>-darkSquareColor color<dt>-highlightSquareColor color<dt>-preoveHighlightColor color<dt>-lowTimeWarningColor color<dd><a name="index-Colors-513"></a><a name="index-whitePieceColor_002c-option-514"></a><a name="index-blackPieceColor_002c-option-515"></a><a name="index-lightSquareColor_002c-option-516"></a><a name="index-darkSquareColor_002c-option-517"></a><a name="index-highlightSquareColor_002c-option-518"></a><a name="index-premoveHighlightColor_002c-option-519"></a><a name="index-lowTimeWarningColor_002c-option-520"></a>Colors to use for the pieces, squares, and square highlights.
+Defaults:
+
+ <pre class="example"> -whitePieceColor #FFFFCC
+ -blackPieceColor #202020
+ -lightSquareColor #C8C365
+ -darkSquareColor #77A26D
+ -highlightSquareColor #FFFF00
+ -premoveHighlightColor #FF0000
+ -lowTimeWarningColor #FF0000
</pre>
- <p>\r
-On a grayscale monitor you might prefer:\r
-\r
- <pre class="example"> -whitePieceColor gray100\r
- -blackPieceColor gray0\r
- -lightSquareColor gray80\r
- -darkSquareColor gray60\r
- -highlightSquareColor gray100\r
- -premoveHighlightColor gray70\r
+ <p>On a grayscale monitor you might prefer:
+
+ <pre class="example"> -whitePieceColor gray100
+ -blackPieceColor gray0
+ -lightSquareColor gray80
+ -darkSquareColor gray60
+ -highlightSquareColor gray100
+ -premoveHighlightColor gray70
+ -lowTimeWarningColor gray70
</pre>
- <br><dt>-drag/-xdrag or -animateDragging true/false<dd><a name="index-drag_002c-option-341"></a><a name="index-animateDragging_002c-option-342"></a>Sets the Animate Dragging menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-animate/-xanimate or -animateMoving true/false<dd><a name="index-animate_002c-option-343"></a><a name="index-animateMoving_002c-option-344"></a>Sets the Animate Moving menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-animateSpeed n<dd><a name="index-g_t_002danimateSpeed_002c-option-345"></a>Number of milliseconds delay between each animation frame when Animate\r
-Moves is on.\r
+ <p>The PieceColor options only work properly if the image files
+defining the pieces were pure black & white
+(possibly anti-aliased to produce gray scales
+and semi-transparancy),
+like the pieces images that come with the install.
+Their effect on colored pieces is undefined.
+The SquareColor option only have an effect
+when no board textures are used.
+<br><dt>-trueColors true/false<dd><a name="index-trueColors_002c-option-521"></a>When set, this option suppresses the effect of the
+PieceColor options mentioned above.
+This is recommended for images that are already colored.
+<br><dt>-useBoardTexture true/false<dt>-liteBackTextureFile filename<dt>-darkBackTextureFile filename<dd><a name="index-useBoardTexture_002c-option-522"></a><a name="index-liteBackTextureFile_002c-option-523"></a><a name="index-darkBackTextureFile_002c-option-524"></a>Indicate the png image files to be used for drawing the board squares,
+and if they should be used rather than using simple colors.
+The algorithm for cutting squares out of a given bitmap is such that
+the picture is perfectly reproduced when a bitmap the size of
+the complete board is given.
+If the filename ends in "-NxM.png", with integer N and M,
+it is assumed to contain a bitmap of a complete board of N files
+and M ranks, and XBoard will scale it to exactly match the
+current square size.
+If N=M=0 it scales the entire bitmap to the size of the board,
+irrespective of the number of files and ranks of the latter.
+Without any -NxM suffix textures are only blown up by an integer
+factor when they are smaller than the square size, or,
+when the name starts with "xq", too small to cover the
+complete Xiangqi board.
+Default: false and ""
+<br><dt>-drag/-xdrag or -animateDragging true/false<dd><a name="index-drag_002c-option-525"></a><a name="index-animateDragging_002c-option-526"></a>Sets the Animate Dragging menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-animate/-xanimate or -animateMoving true/false<dd><a name="index-animate_002c-option-527"></a><a name="index-animateMoving_002c-option-528"></a>Sets the Animate Moving menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-animateSpeed n<dd><a name="index-g_t_002danimateSpeed_002c-option-529"></a>Number of milliseconds delay between each animation frame when Animate
+Moves is on.
+<br><dt>-autoDisplayComment true/false<dt>-autoDisplayTags true/false<dd><a name="index-g_t_002dautoDisplayComment_002c-option-530"></a><a name="index-g_t_002dautoDisplayTags_002c-option-531"></a>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. Default: true.
+<br><dt>-pasteSelection true/false<dd><a name="index-g_t_002dpasteSelection_002c-option-532"></a>If this option is set to true, the Paste Position and Paste Game
+options paste from the currently selected text. If false, they paste
+from the clipboard. Default: false.
+<br><dt>-autoCopyPV true|false<dd><a name="index-autoCopyPV_002c-option-533"></a>When this option is set, the position displayed on the board when
+you terminate a PV walk
+(initiated by a right-click on board or engine-output window)
+will be automatically put on the clipboard as FEN.
+Default: false.
+<br><dt>-dropMenu true|false<dd><a name="index-dropMenu_002c-option-534"></a>This option allows you to emulate old behavior,
+where the right mouse button brings up the (now deprecated) drop menu
+rather than displaying the position at the end of the principal variation.
+Default: False.
+<br><dt>-pieceMenu true|false<dd><a name="index-pieceMenu_002c-option-535"></a>This option allows you to emulate old behavior,
+where the right mouse button brings up the (now deprecated) piece menu
+in Edit Position mode.
+From this menu you can select the piece to put on the square you
+clicked to bring up the menu,
+or select items such as <kbd>clear board</kbd>.
+You can also <kbd>promote</kbd> or <kbd>demote</kbd> a clicked piece to convert
+it into an unorthodox piece that is not directly in the menu,
+or give the move to <kbd>black</kbd> or <kbd>white</kbd>.
+<br><dt>-variations true|false<dd><a name="index-variations_002c-option-536"></a>When this option is on, you can start new variations in Edit Game or
+Analyze mode by holding the Shift key down while entering a move.
+When it is off, the Shift key will be ignored.
+Default: False.
+<br><dt>-appendPV true|false<dd><a name="index-appendPV_002c-option-537"></a>When this option is on, right-clicking a PV in the Engine Output window
+will play the first move of that PV in Analyze mode,
+or as many moves as you walk through by moving the mouse.
+Default: False.
+<br><dt>-absoluteAnalysisScores true|false<dd><a name="index-absoluteAnalysisScores_002c-option-538"></a>When true, scores on the Engine Output window during analysis
+will be printed from the white point-of-view, rather than the
+side-to-move point-of-view.
+Default: False.
+<br><dt>-scoreWhite true|false<dd><a name="index-scoreWhite_002c-option-539"></a>When true, scores will always be printed from the white point-of-view,
+rather than the side-to-move point-of-view.
+Default: False.
+<br><dt>-memoHeaders true|false<dd><a name="index-memoHeaders_002c-option-540"></a>When true, column headers will be displayed in the Engine Output window
+for the depth, score, time and nodes data.
+Right-clicking on these headers will hide or show the corresponding data.
+(Not intended for dynamic use, as already printed data of the current search
+will not be affected!)
+Defaul: False.
</dl>
- \r
</body></html>
projects / xboard.git / blobdiff