<h3 class="section">3.5 User interface options</h3>
-<p><a name="index-User-interface-options-279"></a><a name="index-Options_002c-User-interface-280"></a>
+<p><a name="index-User-interface-options-280"></a><a name="index-Options_002c-User-interface-281"></a>
<dl>
-<dt>-display<dt>-geometry<dt>-iconic<dd><a name="index-display_002c-option-281"></a><a name="index-geometry_002c-option-282"></a><a name="index-iconic_002c-option-283"></a>These and most other standard Xt options are accepted.
-<br><dt>-noGUI<dd><a name="index-noGUI_002c-option-284"></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-285"></a><a name="index-bell_002c-option-286"></a><a name="index-ringBellAfterMoves_002c-option-287"></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-288"></a><a name="index-popupExitMessage_002c-option-289"></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-290"></a><a name="index-popupMoveErrors_002c-option-291"></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-292"></a><a name="index-alwaysPromoteToQueen_002c-option-293"></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-294"></a><a name="index-testLegality_002c-option-295"></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-296"></a><a name="index-boardSize_002c-option-297"></a><a name="index-board-size-298"></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-299"></a><a name="index-showCoords_002c-option-300"></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-301"></a><a name="index-autoRaiseBoard_002c-option-302"></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-303"></a><a name="index-autoFlipView_002c-option-304"></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-305"></a><a name="index-flipView_002c-option-306"></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-307"></a><a name="index-titleInWindow_002c-option-308"></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-309"></a><a name="index-showButtonBar_002c-option-310"></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-311"></a><a name="index-monoMode_002c-option-312"></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-313"></a><a name="index-flashRate_002c-option-314"></a><a name="index-flash_002c-option-315"></a><a name="index-xflash_002c-option-316"></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-317"></a><a name="index-highlightLastMove_002c-option-318"></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-319"></a><a name="index-blindfold_002c-option-320"></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-321"></a><a name="index-Font_002c-clock-322"></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-323"></a><a name="index-Font_002c-coordinates-324"></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-325"></a><a name="index-Font-326"></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-327"></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-328"></a><a name="index-bitmapDirectory_002c-option-329"></a><a name="index-pixmap_002c-option-330"></a><a name="index-pixmapDirectory_002c-option-331"></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<dd><a name="index-Colors-332"></a><a name="index-whitePieceColor_002c-option-333"></a><a name="index-blackPieceColor_002c-option-334"></a><a name="index-lightSquareColor_002c-option-335"></a><a name="index-darkSquareColor_002c-option-336"></a><a name="index-highlightSquareColor_002c-option-337"></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
+<dt>-display<dt>-geometry<dt>-iconic<dd><a name="index-display_002c-option-282"></a><a name="index-geometry_002c-option-283"></a><a name="index-iconic_002c-option-284"></a>These and most other standard Xt options are accepted.\r
+<br><dt>-noGUI<dd><a name="index-noGUI_002c-option-285"></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-286"></a><a name="index-bell_002c-option-287"></a><a name="index-ringBellAfterMoves_002c-option-288"></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-289"></a><a name="index-popupExitMessage_002c-option-290"></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-291"></a><a name="index-popupMoveErrors_002c-option-292"></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-293"></a><a name="index-alwaysPromoteToQueen_002c-option-294"></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-295"></a><a name="index-testLegality_002c-option-296"></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-297"></a><a name="index-boardSize_002c-option-298"></a><a name="index-board-size-299"></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-300"></a><a name="index-showCoords_002c-option-301"></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-302"></a><a name="index-autoRaiseBoard_002c-option-303"></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-304"></a><a name="index-autoFlipView_002c-option-305"></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-306"></a><a name="index-flipView_002c-option-307"></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-308"></a><a name="index-titleInWindow_002c-option-309"></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-310"></a><a name="index-showButtonBar_002c-option-311"></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-312"></a><a name="index-monoMode_002c-option-313"></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-314"></a><a name="index-flashRate_002c-option-315"></a><a name="index-flash_002c-option-316"></a><a name="index-xflash_002c-option-317"></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-318"></a><a name="index-highlightLastMove_002c-option-319"></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-320"></a><a name="index-blindfold_002c-option-321"></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-322"></a><a name="index-Font_002c-clock-323"></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-324"></a><a name="index-Font_002c-coordinates-325"></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-326"></a><a name="index-Font-327"></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-328"></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-329"></a><a name="index-bitmapDirectory_002c-option-330"></a><a name="index-pixmap_002c-option-331"></a><a name="index-pixmapDirectory_002c-option-332"></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-333"></a><a name="index-whitePieceColor_002c-option-334"></a><a name="index-blackPieceColor_002c-option-335"></a><a name="index-lightSquareColor_002c-option-336"></a><a name="index-darkSquareColor_002c-option-337"></a><a name="index-highlightSquareColor_002c-option-338"></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
</pre>
- <p>On a grayscale monitor you might prefer:
-
- <pre class="example"> -whitePieceColor gray100
- -blackPieceColor gray0
- -lightSquareColor gray80
- -darkSquareColor gray60
- -highlightSquareColor gray100
- -premoveHighlightColor gray70
+ <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
</pre>
- <br><dt>-drag/-xdrag or -animateDragging true/false<dd><a name="index-drag_002c-option-338"></a><a name="index-animateDragging_002c-option-339"></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-340"></a><a name="index-animateMoving_002c-option-341"></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-342"></a>Number of milliseconds delay between each animation frame when Animate
-Moves is on.
+ <br><dt>-drag/-xdrag or -animateDragging true/false<dd><a name="index-drag_002c-option-339"></a><a name="index-animateDragging_002c-option-340"></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-341"></a><a name="index-animateMoving_002c-option-342"></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-343"></a>Number of milliseconds delay between each animation frame when Animate\r
+Moves is on.\r
</dl>
+ \r
</body></html>
projects / xboard.git / blobdiff