home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 Mobile / Chip_Mobile_2001.iso / palm / spiele / palmches / palmches.exe / chesscli / misc / style12.txt next >
Encoding:
Text File  |  1998-12-08  |  3.6 KB  |  88 lines
  1. style12
  2.  
  3.   Style 12 is a type of machine parseable output that many of the FICS
  4. interfaces use.  The output is documented here for those who wish to write new
  5. interfaces.  Style 12 is also fully compatible with ICC (The Internet Chess
  6. Club).
  7.  
  8.   The data is all on one line (displayed here as two lines, so it will show on
  9. your screen).  Here is an example:  [Note: the beginning and ending quotation
  10. marks are *not* part of the data string; they are needed in this help file
  11. because some interfaces cannot display the string when in a text file.]
  12.  
  13. "<12> rnbqkb-r pppppppp -----n-- -------- ----P--- -------- PPPPKPPP RNBQ-BNR
  14.  B -1 0 0 1 1 0 7 Newton Einstein 1 2 12 39 39 119 122 2 K/e1-e2 (0:06) Ke2 0"
  15.  
  16. This string always begins on a new line, and there are always exactly 31 non-
  17. empty fields separated by blanks. The fields are:
  18.  
  19. * the string "<12>" to identify this line.
  20. * eight fields representing the board position.  The first one is file 8,
  21.   then file 7, etc, regardless of who's move it is.
  22. * color whose turn it is to move ("B" or "W")
  23. * -1 if the previous move was NOT a double pawn push, otherwise the chess 
  24.   board file  (numbered 0--7 for a--h) in which the double push was made
  25. * can White still castle short? (0=no, 1=yes)
  26. * can White still castle long?
  27. * can Black still castle short?
  28. * can Black still castle long?
  29. * the number of moves made since the last irreversible move.  (0 if last move
  30.   was irreversible.  If the value is >= 100, the game can be declared a draw
  31.   due to the 50 move rule.)
  32. * The game number
  33. * White's name
  34. * Black's name
  35. * my relation to this game:
  36.     -3 isolated position, such as for "ref 3" or the "sposition" command
  37.     -2 I am observing game being examined
  38.      2 I am the examiner of this game
  39.     -1 I am playing, it is my opponent's move
  40.      1 I am playing and it is my move
  41.      0 I am observing a game being played
  42. * initial time (in seconds) of the match
  43. * increment In seconds) of the match
  44. * White material strength
  45. * Black material strength
  46. * White's remaining time
  47. * Black's remaining time
  48. * the number of the move about to be made (standard chess numbering -- White's
  49.   and Black's first moves are both 1, etc.)
  50. * verbose coordinate notation for the previous move ("none" if there were
  51.   none) [note this used to be broken for examined games]
  52. * time taken to make previous move "(min:sec)".
  53. * pretty notation for the previous move ("none" if there is none)
  54. * flip field for board orientation: 1 = Black at bottom, 0 = White at bottom.
  55.  
  56. In the future, new fields may be added to the end of the data string, so
  57. programs should parse from left to right.
  58. Special information for bughouse games
  59. --------------------------------------
  60.  
  61. When showing positions from bughouse games, a second line showing piece
  62. holding is given, with "<b1>" at the beginning, for example:
  63.  
  64.   <b1> game 6 white [PNBBB] black [PNB]
  65.  
  66. Also, when pieces are "passed" during bughouse, a short data string -- not the
  67. entire board position -- is sent.  For example:
  68.  
  69.   <b1> game 52 white [NB] black [N] <- BN
  70.  
  71. The final two letters indicate the piece that was passed; in the above
  72. example, a knight (N) was passed to Black.
  73.  
  74. A prompt may preceed the <b1> header.
  75.  
  76. Credits
  77. -------
  78.  
  79.   Style12 was designed by Daniel Sleator (sleator+@cs.cmu.edu) (Darooha@ICC)
  80.  
  81.   A big thanks to ICC for letting us use the specification document as the
  82. basis for this helpfile.  There are only a couple of modifications to the
  83. document to use FICS terminology.
  84.  
  85.   This helpfile may be used by others as long as the credit to ICC above
  86. remains.
  87.  
  88.