style 12

 

Style for machine interfaces like xboard or slics.

The data is all on one line: Here is an example:

<12> rnbqkb-r pppppppp -----n-- -------- ----P--- --------
  PPPPKPPP RNBQ-BNR B -1 0 0 1 1 0 7 Quimbee Darooha 1 2 12 39 39
    119 122 2 K/e1-e2 (0:06) Ke2 0

This always begins on a new line, and there are always exactly 31 non-empty fields separated by blanks. They are:

• The string "<12>" to identify this line.
• eight fields representing the board position. The first one is file 8, then file 7, etc, regardless of who's move it is.
• color whose turn it is to move ("B" or "W")
• -1 if the previous move was NOT a double pawn push, otherwise the file (numbered 0-7 for a-h) in which the double push was made
• can white still castle short? (0=no, 1=yes)
• can white still castle long?
• can black still castle short?
• can black still castle long?
• the number of moves made since the last irreversible move. (0 if last move was irreversible. If this is >= 100, the game can be declared a draw due to the 50 move rule.)
• The game number
• White's name
• Black's name
• my relation to this game:
  

  -2 observing examined game

  2 the examiner of this game

  -1 I am playing, it's the opponent's move

  1 I am playing and it's my move

  0 observing played game

• initial time (in minutes) of the match
• increment (in seconds) of the match
• white strength
• black strength
• white's remaining time
• black's remaining time
• the number of the move about to be made (standard chess numbering - White's and Black's first moves are both 1, etc.)
• verbose coordinate notation for the previous move ("none" if there were none)
• time taken to make previous move "(min:sec)".
• pretty notation for the previous move ("none" if there is none)
• flip field for board orientation: 1 = black down, 0 = white down.

New fields may be added to the end in the future, so programs should parse from left to right.

See also: style, style 10, interfaces