www.delorie.com/gnu/docs/gnugo/gnugo_81.html

search

	Buy GNU books!

GNU Go Documentation

7.1.3 Functions which manipulate SGF nodes

• SGFNode *sgfAddStone(SGFNode *node, int color, int movex, int movey)

  Add a stone to node. Properties added is either AB (black stone) or AW (white stone).

• SGFNode *sgfAddPlay(SGFNode *node, int who, int movex, int movey)

  Add a child node with a move to node. Properties added is either B (black move) or W (white move). A pass is coded by (-1, -1).

  This function does not add a property to the node itself, but adds a child node instead. If there are previous child nodes, the new node is placed before the other ones, so this function should be used if you want to add a main branch to the tree. To add a variation, use sgfAddPlayLast instead.

• SGFNode *sgfAddPlayLast(SGFNode *node, int who, int movex, int movey)

  Add a child node with a move to node. Properties added is either B (black move) or W (white move). A pass is coded by (-1, -1).

  If there are previous child nodes in node, the move is added by adding the child node last, so this function should be used when you want to add a variation to the game tree.

• int sgfPrintCharProperty(FILE *file, SGFNode *node, const char *name)

  Print the properties of type name in node on file.

• int sgfPrintCommentProperty(FILE *file, SGFNode *node, const char *name)

  Print the comment properties of type name in node on file.

• void sgfWriteResult(SGFNode *node, float score, int overwrite)

  Add a RE (result) property to node. This property will contain the game result. If overwrite is zero the result is written only if no previous result property exists.

• SGFNode *sgfCircle(SGFNode *node, int i, int j)

  Add a CR (circle) property at (i, j) to node.

• SGFNode *sgfSquare(SGFNode *node, int i, int j)

  Calls sgfMark to add a MA (mark) property at (i, j) to node.

• SGFNode *sgfTriangle(SGFNode *node, int i, int j)

  Add a TR (triangle) property at (i, j) to node.

• SGFNode *sgfMark(SGFNode *node, int i, int j)

  Add a MA (mark) property at (i, j) to node.

• SGFNode *sgfAddComment(SGFNode *node, const char *comment)

  Add a C (comment) property to node.

• SGFNode *sgfBoardText(SGFNode *node, int i, int j, const char *text)

  Add a LB (label) property at (i, j) to node.

• SGFNode *sgfBoardChar(SGFNode *node, int i, int j, char c)

  Add a LB (label) property at (i, j) to node. This functions is a utility function that converts the character to a string and calls sgfBoardText.

• SGFNode *sgfBoardNumber(SGFNode *node, int i, int j, int number)

  Add a numeric label at (i, j) by calling sgfBoardText.

• SGFNode *sgfStartVariant(SGFNode *node)

  Start a new variation in the game tree. This means that the next pointer of node is followed to the end of the list and a new node is inserted there. A pointer to the new node is returned.

• SGFNode *sgfStartVariantFirst(SGFNode *node)

  Same as sgfStartVariant, except that the node is placed first in the list. This means that the new variation will be the main variation of the game tree. Returns a pointer to the new node.

• SGFNode *sgfAddChild(SGFNode *node)

  Adds a child node to node. If there already are children, the new node is placed last in the list. Returns a pointer to the new node.