<h3 class="section">3.5 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-283"></a><a name="index-Options_002c-User-interface-284"></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<dd><a name="index-display_002c-option-285"></a><a name="index-geometry_002c-option-286"></a><a name="index-iconic_002c-option-287"></a>These and most other standard Xt options are accepted.
+<br><dt>-noGUI<dd><a name="index-noGUI_002c-option-288"></a>Suppresses all GUI functions of XBoard
+(to speed up automated ultra-fast engine-engine games, which you dont 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>-movesound/-xmovesound or -ringBellAfterMoves true/false<dd><a name="index-movesound_002c-option-289"></a><a name="index-bell_002c-option-290"></a><a name="index-ringBellAfterMoves_002c-option-291"></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-292"></a><a name="index-popupExitMessage_002c-option-293"></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-294"></a><a name="index-popupMoveErrors_002c-option-295"></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-296"></a><a name="index-alwaysPromoteToQueen_002c-option-297"></a>Sets the Always Queen 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-298"></a><a name="index-testLegality_002c-option-299"></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-300"></a><a name="index-boardSize_002c-option-301"></a><a name="index-board-size-302"></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.
+Pieces of all these sizes are built into XBoard.
+Other sizes can
+be used if you have them; see the pixmapDirectory and bitmapDirectory
+options.
+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 default font,
+<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>-coords/-xcoords or -showCoords true/false<dd><a name="index-coords_002c-option-303"></a><a name="index-showCoords_002c-option-304"></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-305"></a><a name="index-autoRaiseBoard_002c-option-306"></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-307"></a><a name="index-autoFlipView_002c-option-308"></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-309"></a><a name="index-flipView_002c-option-310"></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-311"></a><a name="index-titleInWindow_002c-option-312"></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-313"></a><a name="index-showButtonBar_002c-option-314"></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>-mono/-xmono or -monoMode true/false<dd><a name="index-mono_002c-option-315"></a><a name="index-monoMode_002c-option-316"></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>-flashCount count<dt>-flashRate rate<dt>-flash/-xflash<dd><a name="index-flashCount_002c-option-317"></a><a name="index-flashRate_002c-option-318"></a><a name="index-flash_002c-option-319"></a><a name="index-xflash_002c-option-320"></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-321"></a><a name="index-highlightLastMove_002c-option-322"></a>Sets the Highlight Last Move 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-323"></a><a name="index-blindfold_002c-option-324"></a>Sets the Blindfold menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-clockFont font<dd><a name="index-clockFont_002c-option-325"></a><a name="index-Font_002c-clock-326"></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: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*.
+<br><dt>-coordFont font<dd><a name="index-coordFont_002c-option-327"></a><a name="index-Font_002c-coordinates-328"></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: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*.
+<br><dt>-font font<dd><a name="index-font_002c-option-329"></a><a name="index-Font-330"></a>The font used for popup dialogs, menus, comments, 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: -*-helvetica-medium-r-normal–*-*-*-*-*-*-*-*.
+<br><dt>-fontSizeTolerance tol<dd><a name="index-fontSizeTolerance_002c-option-331"></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>-bm or -bitmapDirectory dir<dt>-pixmap or -pixmapDirectory dir<dd><a name="index-bm_002c-option-332"></a><a name="index-bitmapDirectory_002c-option-333"></a><a name="index-pixmap_002c-option-334"></a><a name="index-pixmapDirectory_002c-option-335"></a>These options control what piece images xboard uses. The XBoard
+distribution includes one set of pixmap pieces in xpm format, in the
+directory <samp><span class="file">pixmaps</span></samp>, and one set of bitmap pieces in xbm format,
+in the directory <samp><span class="file">bitmaps</span></samp>. Pixmap
+pieces give a better appearance on the screen: the white pieces have
+dark borders, and the black pieces have opaque internal details. With
+bitmaps, neither piece color has a border, and the internal details
+are transparent; you see the square color or other background color
+through them.
+
+ <p>If XBoard is configured and compiled on a system that includes libXpm,
+the X pixmap library, the xpm pixmap pieces are compiled in as the
+default. A different xpm piece set can be selected at runtime with
+the <code>pixmapDirectory</code> option, or a bitmap piece set can be selected
+with the <code>bitmapDirectory</code> option.
+
+ <p>If XBoard is configured and compiled on a system that does not include
+libXpm (or the <code>--disable-xpm</code> option is given to the configure
+program), the bitmap pieces are compiled in as the default. It is not
+possible to use xpm pieces in this case, but pixmap pieces in another
+format called "xim" can be used by giving the <code>pixmapDirectory</code> option.
+Or again, a different bitmap piece set can be selected with the
+<code>bitmapDirectory</code> option.
+
+ <p>Files in the <code>bitmapDirectory</code> must be named as follows:
+The first character of a piece bitmap name gives the piece it
+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>’),
+the next characters give the size in pixels, the
+following character indicates whether the piece is
+solid or outline (‘<samp><span class="samp">s</span></samp>’ or ‘<samp><span class="samp">o</span></samp>’),
+and the extension is ‘<samp><span class="samp">.bm</span></samp>’.
+For example, a solid 80x80 knight would be named <samp><span class="file">n80s.bm</span></samp>.
+The outline bitmaps are used only in monochrome mode.
+If bitmap pieces are compiled in and the bitmapDirectory is missing
+some files, the compiled in pieces are used instead.
+
+ <p>If the bitmapDirectory option is given,
+it is also possible to replace xboard's icons and menu checkmark,
+by supplying files named <samp><span class="file">icon_white.bm</span></samp>, <samp><span class="file">icon_black.bm</span></samp>, and
+<samp><span class="file">checkmark.bm</span></samp>.
+
+ <p>For more information about pixmap pieces and how to get additional
+sets, see <a href="zic2xpm.html#zic2xpm">zic2xpm</a> below.
+<br><dt>-whitePieceColor color<dt>-blackPieceColor color<dt>-lightSquareColor color<dt>-darkSquareColor color<dt>-highlightSquareColor color<dt>-lowTimeWarningColor color<dd><a name="index-Colors-336"></a><a name="index-whitePieceColor_002c-option-337"></a><a name="index-blackPieceColor_002c-option-338"></a><a name="index-lightSquareColor_002c-option-339"></a><a name="index-darkSquareColor_002c-option-340"></a><a name="index-highlightSquareColor_002c-option-341"></a><a name="index-lowTimeWarningColor_002c-option-342"></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
+ <br><dt>-drag/-xdrag or -animateDragging true/false<dd><a name="index-drag_002c-option-343"></a><a name="index-animateDragging_002c-option-344"></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-345"></a><a name="index-animateMoving_002c-option-346"></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-347"></a>Number of milliseconds delay between each animation frame when Animate
+Moves is on.
</dl>
- \r
</body></html>
projects / xboard.git / blobdiff