| … | |
… | |
| 20 | Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
20 | Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 21 | --> |
21 | --> |
| 22 | </head> |
22 | </head> |
| 23 | <body> |
23 | <body> |
| 24 | |
24 | |
| 25 | <h1>$Revision: 1.12 $</h1> |
25 | <h1>$Revision: 1.13 $</h1> |
| 26 | |
26 | |
| 27 | <h1>KGS Protocol Description</h1> |
27 | <h1>KGS Protocol Description</h1> |
| 28 | |
28 | |
| 29 | <p>This XML document describes the KGS protocol. It is also used |
29 | <p>This XML document describes the KGS protocol. It is also used |
| 30 | to automatically generate the perl parser for all the messages and |
30 | to automatically generate the perl parser for all the messages and |
| … | |
… | |
| 124 | |
124 | |
| 125 | <type name="komi16" type="I16" multiplier="2"/> |
125 | <type name="komi16" type="I16" multiplier="2"/> |
| 126 | <type name="komi32" type="I32" multiplier="2"/> |
126 | <type name="komi32" type="I32" multiplier="2"/> |
| 127 | |
127 | |
| 128 | <p>Komi values are multiplied by 2 to make them integer in the |
128 | <p>Komi values are multiplied by 2 to make them integer in the |
| 129 | protocol. Of course, sometimes they are encoded in 16 bits, sometimes |
129 | protocol.</p> |
| 130 | in 32. Get used to this.</p> |
|
|
| 131 | |
130 | |
| 132 | <type name="result" type="I32" multiplier="2"/> |
131 | <type name="result" type="I32" multiplier="2"/> |
| 133 | |
132 | |
| 134 | <p>The game result is also multiplied by four to give it higher |
133 | <p>The game result is also multiplied by four to give it higher |
| 135 | resolution. There are also special values for wins by time etc.</p> |
134 | resolution. There are also special values for wins by time etc.</p> |
| 136 | |
135 | |
|
|
136 | <type name="score16" type="I16" multiplier="4"/> |
| 137 | <type name="score" type="I32" multiplier="4"/> |
137 | <type name="score32" type="I32" multiplier="4"/> |
| 138 | |
138 | |
| 139 | <p>A score value (used for displaying the score at the end of a game) |
139 | <p>A score value (used for displaying the score at the end of a game) |
| 140 | are multiplied by four for a change. I have not yet seen 0.25 scores, |
140 | are multiplied by four for a change. I have not yet seen 0.25 scores, |
| 141 | please somebody tell me where they happen, or if they happen.</p> |
141 | please somebody tell me where they happen, or if they happen.</p> |
| 142 | |
142 | |
| … | |
… | |
| 443 | <member name="games" type="U16"/> |
443 | <member name="games" type="U16"/> |
| 444 | <member name="name" type="STRING"/> |
444 | <member name="name" type="STRING"/> |
| 445 | </struct> |
445 | </struct> |
| 446 | |
446 | |
| 447 | <struct name="scorevalues" class="KGS::Score"> |
447 | <struct name="scorevalues" class="KGS::Score"> |
| 448 | <member name="score" type="score"/> |
448 | <member name="score" type="score32"/> |
| 449 | <member name="territory" type="U32"/> |
449 | <member name="territory" type="U32"/> |
| 450 | <member name="captures" type="U32"/> |
450 | <member name="captures" type="U32"/> |
| 451 | <member name="i3" type="U32"/> |
451 | <member name="i3" type="U32"/> |
| 452 | <member name="f2" type="U32"/> |
452 | <member name="f2" type="U32"/> |
| 453 | <member name="komi" type="komi32"/> |
453 | <member name="komi" type="komi32"/> |
