X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=manual%2Fhtml_node%2FUser-interface-options.html;h=8aa6db653396289b237af647e02d4818590ad754;hb=f8e035410d7c94ad891763384096e500f91646b1;hp=28ba2a8804e95afaa70fa237ce51eaaa7a0843f6;hpb=9f6acd5975d8441b8f12dd6410adee43c72c6bda;p=xboard.git diff --git a/manual/html_node/User-interface-options.html b/manual/html_node/User-interface-options.html index 28ba2a8..8aa6db6 100644 --- a/manual/html_node/User-interface-options.html +++ b/manual/html_node/User-interface-options.html @@ -32,23 +32,41 @@ Up: Options
-

4.5 User interface options

+

4.6 User interface options

-

+

-
-display
-geometry
-iconic
These and most other standard Xt options are accepted. -
-noGUI
Suppresses all GUI functions of XBoard -(to speed up automated ultra-fast engine-engine games, which you don’t want to watch). +
-display
-geometry
-iconic
-name
These and most other standard Xt options are accepted. +
-noGUI
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. -
-movesound/-xmovesound or -ringBellAfterMoves true/false
Sets the Move Sound menu option. See Options Menu. Default: false. +
-recentEngines number
-recentEngineList list
When the number is larger than zero, it determines how many recently +used engines will be appended at the bottom of the ‘Engines’ menu. +The engines will be saved in your settings file as the option +recentEngineList, 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. +
-oneClickMove true/false
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. +
-movesound/-xmovesound or -ringBellAfterMoves true/false
Sets the Move Sound menu option. See Options Menu. Default: false. For compatibility with old XBoard versions, -bell/-xbell are also accepted as abbreviations for this option. -
-exit/-xexit or -popupExitMessage true/false
Sets the Popup Exit Message menu option. See Options Menu. Default: true. -
-popup/-xpopup or -popupMoveErrors true/false
Sets the Popup Move Errors menu option. See Options Menu. Default: false. -
-queen/-xqueen or -alwaysPromoteToQueen true/false
Sets the Always Queen menu option. See Options Menu. Default: false. -
-legal/-xlegal or -testLegality true/false
Sets the Test Legality menu option. See Options Menu. Default: true. -
-size or -boardSize (sizeName | n1,n2,n3,n4,n5,n6,n7)
Determines how large the board will be, by selecting the pixel size +
-exit/-xexit or -popupExitMessage true/false
Sets the Popup Exit Message menu option. See Options Menu. Default: true. +
-popup/-xpopup or -popupMoveErrors true/false
Sets the Popup Move Errors menu option. See Options Menu. Default: false. +
-queen/-xqueen or -alwaysPromoteToQueen true/false
Sets the Always Queen menu option. See Options Menu. Default: false. +
-sweepPromotions true/false
Sets the ‘Almost Always Promote to Queen’ menu option. +See Options Menu. Default: false. +
-legal/-xlegal or -testLegality true/false
Sets the Test Legality menu option. See Options Menu. Default: true. +
-size or -boardSize (sizeName | n1,n2,n3,n4,n5,n6,n7)
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, @@ -75,7 +93,7 @@ The value n1 gives the piece size, n2 the width of the black border between squares, n3 the desired size for the clockFont, n4 the desired size for the coordFont, -n5 the desired size for the default font, +n5 the desired size for the messageFont, n6 the smallLayout flag (0 or 1), and n7 the tinyLayout flag (0 or 1). All dimensions are in pixels. @@ -85,11 +103,16 @@ If smallLayout is 1 and titleInWindow 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. -
-coords/-xcoords or -showCoords true/false
Sets the Show Coords menu option. See Options Menu. Default: false. +
-overrideLineGap n
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. +
-coords/-xcoords or -showCoords true/false
Sets the Show Coords menu option. See Options Menu. Default: false. The coordFont option specifies what font to use. -
-autoraise/-xautoraise or -autoRaiseBoard true/false
Sets the Auto Raise Board menu option. See Options Menu. Default: true. -
-autoflip/-xautoflip or -autoFlipView true/false
Sets the Auto Flip View menu option. See Options Menu. Default: true. -
-flip/-xflip or -flipView true/false
If Auto Flip View is not set, or if you are observing but not participating +
-autoraise/-xautoraise or -autoRaiseBoard true/false
Sets the Auto Raise Board menu option. See Options Menu. Default: true. +
-autoflip/-xautoflip or -autoFlipView true/false
Sets the Auto Flip View menu option. See Options Menu. Default: true. +
-flip/-xflip or -flipView true/false
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 @@ -97,24 +120,28 @@ top; if true, the black pawns move from the bottom to the top. In any case, the Flip menu option (see Options Menu) can be used to flip the board after the game starts. -
-title/-xtitle or -titleInWindow true/false
If this option is true, XBoard displays player names (for ICS +
-title/-xtitle or -titleInWindow true/false
If this option is true, XBoard displays player names (for ICS games) and game file names (for ‘Load Game’) 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. -
-buttons/-xbuttons or -showButtonBar True/False
If this option is False, xboard omits the [<<] [<] [P] [>] [>>] button +
-buttons/-xbuttons or -showButtonBar True/False
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. -
-mono/-xmono or -monoMode true/false
Determines whether XBoard displays its pieces and squares with +
-evalZoom factor
The score interval (-1,1) is blown up on the vertical axis of +the Evaluation Graph by the given factor. +Default: 1 +
-evalThreshold n
Score below n (centiPawn) are plotted as 0 in the Evaluation Graph. +Default: 25 +
-mono/-xmono or -monoMode true/false
Determines whether XBoard displays its pieces and squares with two colors (true) or four (false). You shouldn't have to specify monoMode; XBoard will determine if it is necessary. -
-showTargetSquares true/false
Determines whether XBoard can highlight the squares a piece has +
-showTargetSquares true/false
Determines whether XBoard can highlight the squares a piece has legal moves to, when you grab that piece with the mouse. -If this option is set, this feature can be controlled through -the Highlight Dragging menu item. -
-flashCount count
-flashRate rate
-flash/-xflash
These options enable flashing of pieces when they +Default: false. +
-flashCount count
-flashRate rate
-flash/-xflash
These options enable flashing of pieces when they land on their destination square. flashCount tells XBoard how many times to flash a piece after it @@ -127,24 +154,33 @@ sets flashCount to 3. xflash sets flashCount to 0. Defaults: flashCount=0 (no flashing), flashRate=5. -
-highlight/-xhighlight or -highlightLastMove true/false
Sets the Highlight Last Move menu option. See Options Menu. Default: false. -
-highlightMoveWithArrow true/false
Sets the Highlight with Arrow menu option. See Options Menu. Default: false. -
-blind/-xblind or -blindfold true/false
Sets the Blindfold menu option. See Options Menu. Default: false. -
-clockFont font
The font used for the clocks. If the option value is a pattern +
-highlight/-xhighlight or -highlightLastMove true/false
Sets the Highlight Last Move menu option. See Options Menu. Default: false. +
-highlightMoveWithArrow true/false
Sets the Highlight with Arrow menu option. See Options Menu. Default: false. +
-blind/-xblind or -blindfold true/false
Sets the Blindfold menu option. See Options Menu. Default: false. +
-periodic/-xperiodic or -periodicUpdates true/false
Controls updating of current move andnode counts in analysis mode. Default: true. +
-fSAN
-sSAN
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. +
-showEvalInMoveHistory true/false
Controls whether the evaluation scores and search depth of engine moves +are displayed with the move in the move-history window. +Default: true. +
-clockFont font
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–*-*-*-*-*-*-*-*. -
-coordFont font
The font used for rank and file coordinate labels if showCoords +
-coordFont font
The font used for rank and file coordinate labels if showCoords 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–*-*-*-*-*-*-*-*. -
-font font
The font used for popup dialogs, menus, comments, etc. +
-messageFont font
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–*-*-*-*-*-*-*-*. -
-fontSizeTolerance tol
In the font selection algorithm, a nonscalable font will be preferred +
-fontSizeTolerance tol
In the font selection algorithm, a nonscalable font will be preferred over a scalable font if the nonscalable font's size differs by tol pixels or less from the desired size. A value of -1 will force @@ -152,7 +188,7 @@ 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. -
-bm or -bitmapDirectory dir
-pixmap or -pixmapDirectory dir
These options control what piece images xboard uses. The XBoard +
-bm or -bitmapDirectory dir
-pixmap or -pixmapDirectory dir
These options control what piece images xboard uses. The XBoard distribution includes one set of pixmap pieces in xpm format, in the directory pixmaps, and one set of bitmap pieces in xbm format, in the directory bitmaps. Pixmap @@ -195,7 +231,7 @@ by supplying files named icon_white.bm, <

For more information about pixmap pieces and how to get additional sets, see zic2xpm below. -

-whitePieceColor color
-blackPieceColor color
-lightSquareColor color
-darkSquareColor color
-highlightSquareColor color
-lowTimeWarningColor color
Colors to use for the pieces, squares, and square highlights. +
-whitePieceColor color
-blackPieceColor color
-lightSquareColor color
-darkSquareColor color
-highlightSquareColor color
-preoveHighlightColor color
-lowTimeWarningColor color
Colors to use for the pieces, squares, and square highlights. Defaults: 
          -whitePieceColor       #FFFFCC
@@ -216,17 +252,52 @@ Defaults:
           -premoveHighlightColor gray70
           -lowTimeWarningColor   gray70
-
-drag/-xdrag or -animateDragging true/false
Sets the Animate Dragging menu option. See Options Menu. Default: true. -
-animate/-xanimate or -animateMoving true/false
Sets the Animate Moving menu option. See Options Menu. Default: true. -
-animateSpeed n
Number of milliseconds delay between each animation frame when Animate +
-useBoardTexture true/false
-liteBackTextureFile filename
-darkBackTextureFile filename
Indicate the pixmap 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. +Default: false and "" +
-drag/-xdrag or -animateDragging true/false
Sets the Animate Dragging menu option. See Options Menu. Default: true. +
-animate/-xanimate or -animateMoving true/false
Sets the Animate Moving menu option. See Options Menu. Default: true. +
-animateSpeed n
Number of milliseconds delay between each animation frame when Animate Moves is on. -
-autoDisplayComment true/false
-autoDisplayTags true/false
If set to true, these options cause the window with the move comments, +
-autoDisplayComment true/false
-autoDisplayTags true/false
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. -
-pasteSelection true/false
If this option is set to true, the Paste Position and Paste Game +
-pasteSelection true/false
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. +
-autoCopyPV true|false
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. +
-dropMenu true|false
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. +
-pieceMenu true|false
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 clear board. +You can also promote or demote a clicked piece to convert +it into an unorthodox piece that is not directly in the menu, +or give the move to black or white. +
-variations true|false
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. +
-absoluteAnalysisScores true|false
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. +
-scoreWhite true|false
When true, scores will always be printed from the white point-of-view, +rather than the side-to-move point-of-view. +Default: False.