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

search

	Buy GNU books!

GNU Go Documentation

7.2.1 Functions that manipulate sgftrees

• void sgftree_clear(SGFTree *tree)

  Clear the root and lastnode pointers of tree. `NOTE:' This function does not free any memory. That has to be done separately.

• int sgftree_readfile(SGFTree *tree, const char *infilename)

  Read an SGF file with the name infilename and store it in tree. Return 1 if successful, otherwise return 0. lastnode will be set to NULL.

• SGFNode *sgftreeNodeCheck(SGFTree *tree, SGFNode *node)

  Return the node to work on as described above. This is:

  1. node if non-NULL
  2. tree->lastnode if non-NULL
  3. The current end of the tree.

  in that order.

• SGFNode *sgftreeAddPlay(SGFTree *tree, SGFNode *node, int color int movex, int movey)

  Add a move of color at (movex,movey) to the tree. See section sgfAddPlay.

• SGFNode *sgftreeAddPlayLast(SGFTree *tree, SGFNode *node, int color, int movex, int movey)

  Add a variation of color at (movex,movey) to the tree. See section sgfAddPlayLast.

• SGFNode *sgftreeAddStone(SGFTree *tree, SGFNode *node, int color, int movex, int movey)

  Add a stone of color at (movex,movey) to the tree.

• void sgftreeWriteResult(SGFTree *tree, float score, int overwrite)

  Add the result to the tree. If there already is a result, only overwrite it if overwrite is non-zero.

• SGFNode *sgftreeCircle (SGFTree *tree, SGFNode *node, int i, int j)

  Add a circle property at (i, j) to the tree.

• SGFNode *sgftreeSquare (SGFTree *tree, SGFNode *node, int i, int j)

  Add a square property at (i, j) to the tree.

• SGFNode *sgftreeTriangle(SGFTree *tree, SGFNode *node, int i, int j)

  Add a triangle property at (i, j) to the tree.

• SGFNode *sgftreeMark(SGFTree *tree, SGFNode *node, int i, int j)

  Add a mark property at (i, j) to the tree.

• SGFNode *sgftreeAddComment(SGFTree *tree, SGFNode *node, const char *comment)

  Add a comment property to the tree. This is a property of the node itself, and has no position on the board.

• SGFNode *sgftreeBoardText(SGFTree *tree, SGFNode *node, int i, int j, const char *text)

  Add a text property at (i, j) to the tree.

• SGFNode *sgftreeBoardChar(SGFTree *tree, SGFNode *node, int i, int j, char c)

  Add a character at (i, j) to the tree.

• SGFNode *sgftreeBoardNumber(SGFTree *tree, SGFNode *node, int i, int j, int number)

  Add a number at (i, j) to the tree.

• SGFNode *sgftreeStartVariant(SGFTree *tree, SGFNode *node)

  Start a new variation in the tree. See section sgfStartVariant.

• SGFNode *sgftreeStartVariantFirst(SGFTree *tree, SGFNode *node)

  Start a new main variation in the tree. See section sgfStartVariantFirst.

• SGFNode *sgftreeCreateHeaderNode(SGFTree *tree, int boardsize, float komi)

  Add a header node first in tree.

• void sgftreeSetLastNode(SGFTree *tree, SGFNode *last_node)

  Explicitly set the last accessed node in tree to last_node.