X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=engine-intf.html;h=b8b09fb01f59fdcef7ad43e960080d68489f8b6d;hb=e458db4d65d5c54cccda5ee8c51659e882d9b0b4;hp=058f14755665abffa4c473dd43720876e274f409;hpb=0d88a109c226fc27d24f0e28cd3f4c7da1b59367;p=xboard.git diff --git a/engine-intf.html b/engine-intf.html index 058f147..b8b09fb 100644 --- a/engine-intf.html +++ b/engine-intf.html @@ -1139,6 +1139,9 @@ The "lift" command is sent by the GUI when the user 'picks up' (or selects) a pi so that the engine can reply with a "highlight" command to mark the squares where that piece can move to. The "put" command similarly indicates where the user releases that piece; as the GUI clears the highlights on that event by itself, usually no engine response would be required. +For promotion moves you can get a double "put" command, the first one sent when the piece lands on the square, +without being decided yet what it promotes to, so the engine can send a "choice" command to +specify the promotion choice the GUI should offer when promotion wasn't already implied by the "lift" location. The "hover" command is sent whenever the mouse pointer enters a square that is currently marked in red, (reserved for captures) so that the engine can (optionally) reply with a "highlight" command to mark victims of non-standard capture @@ -1850,8 +1853,9 @@ Some colors have special meaning to the GUI:
color | used for | effect |
---|---|---|
red | capture | hovering over the square makes the GUI send a "hover" command |
magenta | promotion | moving to the square will be treated by the GUI as a promotion |
cyan | multi-move | moving to the square will not complete the move entry |
magenta | promotion choice | moving to the square will be treated by the GUI as a promotion |
blue | forced promotion | moving to the square will automatically promote the piece as specified in a 'choice' command |
cyan | multi-leg moving | moving to the square will not complete the move entry |
green | victims | no real effect, but used by convention to indicate capture victims on "hover" |