SGF File Format FF[4]

https://www.red-bean.com/sgf/
Admin
The official specification for the Smart Game Format (SGF), a text-based, tree-based format designed...
Tokens:84,871
Snippets:407
Trust Score:9.7
Update:1 year ago
Show doc for...
Tokens:
Raw
### SGF FF[4] Setup Properties

Source: https://www.red-bean.com/sgf/examples

Illustrates the use of setup properties like AB (Add Black), AW (Add White), AE (Remove stones), and PL (Player to move) with compressed point lists.

```APIDOC
SGF FF[4] Setup Properties:

  AB [point_list]
    - Adds black stones to the board at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  AW [point_list]
    - Adds white stones to the board at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  AE [point_list]
    - Removes stones from the board at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  PL [player]
    - Specifies the player to move next.
    - Parameters:
      - player: 'B' for Black, 'W' for White.
```

--------------------------------

### SGF FF[4] Setup Properties

Source: https://www.red-bean.com/sgf/examples/index

Illustrates the use of setup properties like AB (Add Black), AW (Add White), AE (Remove stones), and PL (Player to move) with compressed point lists.

```APIDOC
SGF FF[4] Setup Properties:

  AB [point_list]
    - Adds black stones to the board at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  AW [point_list]
    - Adds white stones to the board at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  AE [point_list]
    - Removes stones from the board at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  PL [player]
    - Specifies the player to move next.
    - Parameters:
      - player: 'B' for Black, 'W' for White.
```

--------------------------------

### SGF File Example

Source: https://www.red-bean.com/sgf/user_guide

Provides a short example of an SGF file, demonstrating its structure, properties like game information (FF, GM, SZ, AP, PB, PW, KM, RE, DT, TM), moves (B[], W[]), and annotations (C[], LB[], N[]). This snippet illustrates the core syntax for recording game data.

```sgf
(;FF[4]GM[1]SZ[19]AP[SGFC:1.13b]

PB[troy]BR[12k*]
PW[john]WR[11k*]
KM[0.5]RE[W+12.5]
DT[1998-06-15]
TM[600]

;B[pd];W[dp];B[pq];W[dd];B[qk];W[jd];B[fq];W[dj];B[jp];W[jj]
;B[cn]LB[dn:A][po:B]C[dada: other ideas are 'A' (d6) or 'B' (q5)]
;W[eo](;B[dl]C[dada: hm - looks troublesome.
Usually B plays the 3,3 invasion - see variation];W[qo];B[qp]
...
;W[sr];B[sk];W[sg];B[pa];W[gc];B[pi];W[ph];B[de];W[ed];B[kn]
;W[dh];B[eh];W[se];B[sd];W[af];B[ie];W[id];B[hf];W[hd];B[if]
;W[fp];B[gq];W[qj];B[sj];W[rh];B[sn];W[so];B[sm];W[ep];B[mn])
...
(;W[dq]N[wrong direction];B[qo];W[qp]))
```

--------------------------------

### SGF File Example

Source: https://www.red-bean.com/sgf/user_guide/index

Provides a short example of an SGF file, demonstrating its structure, properties like game information (FF, GM, SZ, AP, PB, PW, KM, RE, DT, TM), moves (B[], W[]), and annotations (C[], LB[], N[]). This snippet illustrates the core syntax for recording game data.

```sgf
(;FF[4]GM[1]SZ[19]AP[SGFC:1.13b]

PB[troy]BR[12k*]
PW[john]WR[11k*]
KM[0.5]RE[W+12.5]
DT[1998-06-15]
TM[600]

;B[pd];W[dp];B[pq];W[dd];B[qk];W[jd];B[fq];W[dj];B[jp];W[jj]
;B[cn]LB[dn:A][po:B]C[dada: other ideas are 'A' (d6) or 'B' (q5)]
;W[eo](;B[dl]C[dada: hm - looks troublesome.
Usually B plays the 3,3 invasion - see variation];W[qo];B[qp]
...
;W[sr];B[sk];W[sg];B[pa];W[gc];B[pi];W[ph];B[de];W[ed];B[kn]
;W[dh];B[eh];W[se];B[sd];W[af];B[ie];W[id];B[hf];W[hd];B[if]
;W[fp];B[gq];W[qj];B[sj];W[rh];B[sn];W[so];B[sm];W[ep];B[mn])
...
(;W[dq]N[wrong direction];B[qo];W[qp]))
```

--------------------------------

### Setup Element Definition

Source: https://www.red-bean.com/sgf/xml/html-doc/xgf-game-go

Defines the initial setup of pieces on the board for a game. It inherits from 'AbstractNode' and can contain 'Piece' elements.

```XML
<xs:element name="Setup" type="SetupType" substitutionGroup="AbstractNode"/>
```

--------------------------------

### SGFML DTD and Examples

Source: https://www.red-bean.com/sgf/xml/sgfml

Provides links to the SGFML DTD version 0.02 and example SGF and SGFML files for a server game and a commented game from GTL. These files illustrate the structure and usage of SGFML.

```APIDOC
SGFML DTD:
  [version 0.02](sgfml-0.02.dtd)
    - The XML DTD schema for SGFML.

Example Files:
  - Typical server game:
    - SGF: [server.sgf]
    - SGFML: [server-002.xml]
  - Commented game from GTL:
    - SGF: [review.sgf]
    - SGFML: [review-002.xml]
    - These examples demonstrate the application of the SGFML DTD to real game data.
```

--------------------------------

### SGF Game Tree Structure Example

Source: https://www.red-bean.com/sgf/ff1_3/ff1

Illustrates the hierarchical structure of a game tree in the SGF format, represented in preorder notation.

```SGF Example
(root(ab(c)(de))(f(ghi)(j)))
```

--------------------------------

### SGF Node Splitting for Move & Setup Properties

Source: https://www.red-bean.com/sgf/converting

Describes the process for handling SGF files where move and setup properties are mixed within a single node, a common issue in older file formats.

```APIDOC
SGF Node Splitting for Move & Setup Properties:

Issue: Old file formats did not distinguish between move and setup properties, leading to mixed properties in one node.
Conversion: If a node contains mixed setup and move properties, split the node into two. The first node should contain all setup, root, and game-info properties, plus the node name ('N[]'). The second node should contain all other properties. The node name must be in the first node as it might be the start of a variation.
```

--------------------------------

### SGF Game Tree Structure Example

Source: https://www.red-bean.com/sgf/sgf4

Demonstrates the hierarchical structure of a game tree in SGF format, showing nodes, properties, and variations. This example illustrates how game states and moves are represented.

```SGF
(;FF[4]C[root](;C[a];C[b](;C[c]) (;C[d];C[e])) (;C[f](;C[g];C[h];C[i]) (;C[j])))
```

--------------------------------

### SGF Game Setup and Display Properties (FG, DS)

Source: https://www.red-bean.com/sgf/discussion/19970501

Defines properties related to game setup and display preferences. DS controls numbering schemes for moves, while FG flags control aspects like coordinate printing.

```APIDOC
SGF Game Setup & Display Properties:

  DS (Display Style):
    Description: Controls numbering style for moves.
    Values:
      0: Don't number moves.
      1: Use standard move numbers.
      2: Use modulo 100 move numbers.

  FG (Flags for Game Display):
    Description: Flags to control game display features.
    Known Flags:
      - print coordinates: Indicates whether to print coordinates.
    - Other flags are open for suggestions.
```

--------------------------------

### SGF FF[4] Label Properties

Source: https://www.red-bean.com/sgf/examples

Illustrates the LB property for labeling points on the board, including handling of different label lengths.

```APIDOC
SGF FF[4] Label Properties:

  LB [point:label: ...]
    - Labels points on the board with text.
    - Parameters:
      - point: The coordinate of the point to label (e.g., C4).
      - label: The text to display as the label (1-8 characters recommended).
    - Example:
      LB[c4:A][d5:B]
```

--------------------------------

### SGF Game Properties

Source: https://www.red-bean.com/sgf/loa

Details common SGF properties used to define game state, setup, and player actions. Properties include AS (Adding Stones), IP (Initial Position), IY (Invert Y axis), SE (Marking Points), and SU (Setup Type).

```APIDOC
Property: AS
Propvalue: SimpleText
Propertytype: -
Function: Adding stones - the color of the player who is adding stones to the board. The valid strings are 'Black', 'White' or 'None'. The purpose of this property is to define a board position where the human is expected to continue placing stones on the board through some user interface.

Property: IP
Propvalue: SimpleText
Propertytype: game-info
Function: Designates the initial position in the game to be displayed by the viewer. The only value currently supported is 'End', which causes the viewer to initially display the final position of the game. The default is to display the position after setup but before any moves.

Property: IY
Propvalue: SimpleText
Propertytype: game-info
Function: Invert Y axis. Values are 'true' or 'false'. If 'true', the board should be displayed with numbers increasing in value from bottom to top of the screen. Default: 'false'

Property: SE
Propvalue: point
Propertytype: -
Function: Mark the given point and up to 8 additional points, depending on where the provided point (stone) could legally move.

Property: SU
Propvalue: SimpleText
Propertytype: game-info
Function: Setup type - designates the initial placement of pieces, and also the implicitly the variation on the basic rules to be employed. The currently valid values include the following strings: 'Standard', 'Scrambled-eggs', 'Parachute', 'Gemma' and 'Custom' (the initial board is empty, AB and AW properties will be used to establish the starting position). Default: 'Standard'. For details on the setups and rule variations, consult the LOA home pages.
```

--------------------------------

### SGF FF[4] Label Properties

Source: https://www.red-bean.com/sgf/examples/index

Illustrates the LB property for labeling points on the board, including handling of different label lengths.

```APIDOC
SGF FF[4] Label Properties:

  LB [point:label: ...]
    - Labels points on the board with text.
    - Parameters:
      - point: The coordinate of the point to label (e.g., C4).
      - label: The text to display as the label (1-8 characters recommended).
    - Example:
      LB[c4:A][d5:B]
```

--------------------------------

### SGF FF[4] Pass Moves

Source: https://www.red-bean.com/sgf/examples/index

Demonstrates the FF[4] syntax for representing pass moves using 'B[]' and 'W[]'.

```APIDOC
SGF FF[4] Pass Moves:

  B[]
    - Represents a pass move for Black.

  W[]
    - Represents a pass move for White.
```

--------------------------------

### SGF FF[4] Pass Moves

Source: https://www.red-bean.com/sgf/examples

Demonstrates the FF[4] syntax for representing pass moves using 'B[]' and 'W[]'.

```APIDOC
SGF FF[4] Pass Moves:

  B[]
    - Represents a pass move for Black.

  W[]
    - Represents a pass move for White.
```

--------------------------------

### Setup Property (RP)

Source: https://www.red-bean.com/sgf/octi

Documents the 'RP' (remove pod) property, which is used in the setup phase to remove a stone from the board. It is described as being more selective than 'AddEmpty'.

```APIDOC
Property: RP (remove pod)
Propvalue: list of stone
Propertytype: setup
Function: Removes a stone from the board. More selective than AddEmpty.
Related: AE
```

--------------------------------

### SGF FF[4] File Format Examples

Source: https://www.red-bean.com/sgf/DD_VW

Demonstrates the SGF FF[4] format for representing game states, specifically highlighting the use of AB (Black Stones), AW (White Stones), DD (Dimmed Stones), and VW (View) properties. Includes examples of both expanded and compressed point list notations.

```sgf
(;GM[1]SZ[9]FF[4]
  AB[ac][bc][cc][dc][ec][fc][gc][hc][ic]
  AW[ae][be][ce][de][ee][fe][ge][he][ie]
 ;DD[aa][ab][ac][ad][ae][af][ag][ah][ai][bi][bh][bg][bf]
    [be][bd][bc][bb][ba][ca][cb][cc][cd][ce]
  VW[aa:bi][ca:ee][ge:ie][ga:ia][gc:ic][gb][ib]
)
```

```sgf
(;GM[1]SZ[9]FF[4]
  AB[ac:ic]AW[ae:ie]
 ;DD[aa:bi][ca:ce]
  VW[aa:bi][ca:ee][ge:ie][ga:ia][gc:ic][gb][ib]
)
```

--------------------------------

### Game Name (GN)

Source: https://www.red-bean.com/sgf/user_guide

Provides a specific name or title for the game being recorded.

```APIDOC
GN[] Game name
  - Description: Name of the game.
```

--------------------------------

### Game Name (GN)

Source: https://www.red-bean.com/sgf/user_guide/index

Provides a specific name or title for the game being recorded.

```APIDOC
GN[] Game name
  - Description: Name of the game.
```

--------------------------------

### Board Setup and Player Properties

Source: https://www.red-bean.com/sgf/ff1_3/ff1

Details SGF properties used for setting up game positions, including adding or removing stones, and specifying the first player.

```APIDOC
"AB": add black stones [point list, game-specific]
"AW": add white stones [point list, game-specific]
"AE": add empty = remove stones [point list, game-specific]
"PL": player to play first [color]
```

--------------------------------

### SGF FF[4] Style Property

Source: https://www.red-bean.com/sgf/examples

Illustrates the ST (Style) property, which affects how children or siblings are displayed, particularly in relation to board markup.

```APIDOC
SGF FF[4] Style Property:

  ST [style_value]
    - Controls the display style of nodes, affecting how variations or siblings are rendered.
    - Parameters:
      - style_value: Typically '1' (siblings) or '2' (children).
    - Example:
      ST[2] (children / no board markup)
      ST[1] (siblings / auto-board markup)
```

--------------------------------

### SGF FF[4] Lines, Arrows, and Dimmed Points

Source: https://www.red-bean.com/sgf/examples

Demonstrates new FF[4] properties for drawing lines (LN), arrows (AR), and indicating dimmed points (DD).

```APIDOC
SGF FF[4] Lines, Arrows, and Dimmed Points:

  AR [point1:point2: ...]
    - Draws arrows between specified points.
    - Parameters:
      - point1: The starting point of the arrow.
      - point2: The ending point of the arrow.
    - Example:
      AR[c4:d5]

  LN [point1:point2: ...]
    - Draws lines between specified points.
    - Parameters:
      - point1: The starting point of the line.
      - point2: The ending point of the line.
    - Example:
      LN[c4:d5]

  DD [point_list]
    - Marks specified points as dimmed.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).
```

--------------------------------

### SGF FF[4] Lines, Arrows, and Dimmed Points

Source: https://www.red-bean.com/sgf/examples/index

Demonstrates new FF[4] properties for drawing lines (LN), arrows (AR), and indicating dimmed points (DD).

```APIDOC
SGF FF[4] Lines, Arrows, and Dimmed Points:

  AR [point1:point2: ...]
    - Draws arrows between specified points.
    - Parameters:
      - point1: The starting point of the arrow.
      - point2: The ending point of the arrow.
    - Example:
      AR[c4:d5]

  LN [point1:point2: ...]
    - Draws lines between specified points.
    - Parameters:
      - point1: The starting point of the line.
      - point2: The ending point of the line.
    - Example:
      LN[c4:d5]

  DD [point_list]
    - Marks specified points as dimmed.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).
```

--------------------------------

### Alternative Moves Same Level (SGF)

Source: https://www.red-bean.com/sgf/ff1_3/style

Shows the correct SGF method for displaying alternative moves by placing them as child nodes at the same tree level.

```sgf
(
(;B[cb];N[The game]W[db];B[bd])
(;B[ec]N[Diagram 1];W[cb])
)
```

--------------------------------

### SGF FF[4] View Property

Source: https://www.red-bean.com/sgf/examples

Explains the VW property, which defines a restricted view of the board, not directly encoded but illustrated via external references.

```APIDOC
SGF FF[4] View Property:

  VW [point_list]
    - Defines a restricted view of the board, indicating which points are visible.
    - Parameters:
      - point_list: A comma-separated list of points that are visible.
    - Note: The VW property is not directly encoded into the SGF file itself but is used to illustrate view restrictions.
```

--------------------------------

### SGF FF[4] Style Property

Source: https://www.red-bean.com/sgf/examples/index

Illustrates the ST (Style) property, which affects how children or siblings are displayed, particularly in relation to board markup.

```APIDOC
SGF FF[4] Style Property:

  ST [style_value]
    - Controls the display style of nodes, affecting how variations or siblings are rendered.
    - Parameters:
      - style_value: Typically '1' (siblings) or '2' (children).
    - Example:
      ST[2] (children / no board markup)
      ST[1] (siblings / auto-board markup)
```

--------------------------------

### SGF: Setup Position Properties

Source: https://www.red-bean.com/sgf/ff1_3/ff3

Properties used to initialize or modify the board state before or during a game. This includes adding stones of a specific color or removing stones.

```APIDOC
AB[point list]
  - Adds black stones to the board.
  - Parameters:
    - point list: A sequence of points (e.g., 'dd', 'kk') where black stones are placed.

AW[point list]
  - Adds white stones to the board.
  - Parameters:
    - point list: A sequence of points (e.g., 'dd', 'kk') where white stones are placed.

AE[point list]
  - Adds empty points, effectively removing stones from the board.
  - Parameters:
    - point list: A sequence of points (e.g., 'dd', 'kk') to be emptied.

PL[color]
  - Specifies the player whose turn it is to play first.
  - Parameters:
    - color: 'B' for Black or 'W' for White.
```

--------------------------------

### SGF Basic Tree Structure

Source: https://www.red-bean.com/sgf/var

A fundamental example of an SGF file structure, showcasing how nested parentheses define game trees and variations. This serves as a baseline for understanding more complex SGF layouts.

```SGF
(;FF[4]C[root](;C[a];C[b](;C[c]) (;C[d];C[e])) (;C[f](;C[g];C[h];C[i]) (;C[j])))
```

--------------------------------

### SGF FF[4] View Property

Source: https://www.red-bean.com/sgf/examples/index

Explains the VW property, which defines a restricted view of the board, not directly encoded but illustrated via external references.

```APIDOC
SGF FF[4] View Property:

  VW [point_list]
    - Defines a restricted view of the board, indicating which points are visible.
    - Parameters:
      - point_list: A comma-separated list of points that are visible.
    - Note: The VW property is not directly encoded into the SGF file itself but is used to illustrate view restrictions.
```

--------------------------------

### Examples of Special Moves

Source: https://www.red-bean.com/sgf/twixt

Illustrates the syntax for invoking specific special moves within the game notation, often prefixed by the player's color.

```Twixt Notation
W[resign]
```

```Twixt Notation
B[swap-pieces]
```

```Twixt Notation
B[forfeit]
```

```Twixt Notation
;B[swap-firstpeg]
```

--------------------------------

### Player Names (PB/PW)

Source: https://www.red-bean.com/sgf/user_guide

Specifies the names of the Black (PB) and White (PW) players. Consistency in naming, especially for professional players, is recommended by referencing established databases.

```APIDOC
PB[]/PW[] Name Property Notes
  - Description: Name of the player who played black/white.
  - Recommendation: Try to be consistent in using names. For professional players, it's suggested to use the same names as Jan van der Steen in his database (http://gobase.org/information/players/browser/).
  - Example: "Player Name"
```

--------------------------------

### Correct Game Tree Structure (SGF)

Source: https://www.red-bean.com/sgf/ff1_3/style

Demonstrates the correct SGF structure where the main game branch is placed first (leftmost) in the game tree. Variations should be in subsequent branches.

```sgf
(
(;B[cb];N[The game]W[db];B[bd])
(;B[ec]N[Diagram 1];W[cb])
)
```

--------------------------------

### Amazons Game Defaults

Source: https://www.red-bean.com/sgf/amazons

Specifies the default board size and starting positions for the Amazons game. The default board size is 10x10, with specific default starting points unless overridden by setup properties.

```APIDOC
Default Board Size: SZ[10]

Default Start Position (Two Player):
  AB[dj][gj][ag][jg]
  AW[da][ga][ad][jd]

Note: If setup properties (AB/AW/AE/AA) exist in the root node, they define the start position instead.
```

--------------------------------

### SGF Example: One Variation at Move 3

Source: https://www.red-bean.com/sgf/var

Illustrates an SGF game tree with a single variation introduced at the third move. The variation is represented by a new game tree starting after the main line's move.

```SGF
(;FF[4]GM[1]SZ[19];B[aa];W[bb](;B[cc];W[dd];B[ad];W[bd]) (;B[hh];W[hg]))
```

--------------------------------

### SetupType XML Schema Definition

Source: https://www.red-bean.com/sgf/xml/html-doc/xgf-game-go

Defines the 'SetupType' complex type, extending 'AbstractNodeType'. It represents game setup information, specifically detailing the placement of 'Piece' elements with their color and position, and indicating the next player.

```xml
<xs:complexType name="SetupType">\n  <xs:complexContent>\n    <xs:extension base="AbstractNodeType">\n      <xs:sequence>\n        <xs:element name="Piece" maxOccurs="unbounded">\n          <xs:complexType>\n            <xs:attribute name="color" type="ColorType" use="required"/>\n            <xs:attribute name="piece" type="PieceType" use="optional"/>\n            <xs:attribute name="at" type="PositionType" use="required"/>\n          </xs:complexType>\n        </xs:element>\n      </xs:sequence>\n      <xs:attribute name="nextToPlay" type="ColorType" use="optional"/>\n    </xs:extension>\n  </xs:complexContent>\n</xs:complexType>
```

--------------------------------

### SGF Node Properties: Setup, Markup, Labels, Arrows

Source: https://www.red-bean.com/sgf/examples/ff4_ex

Details SGF properties for setting up the board state, applying visual markup, labeling points, and drawing arrows. Covers initial stone placement, erasing stones, and various graphical annotations.

--------------------------------

### SGF FF[4] Time Limits, Captures, and Move Numbers

Source: https://www.red-bean.com/sgf/examples

Demonstrates properties related to game timing, captures, and move numbering: BL (Black time left), WL (White time left), OB (Black captures), OW (White captures), and MN (Move number).

```APIDOC
SGF FF[4] Time Limits, Captures, and Move Numbers:

  BL [time]
    - Specifies the remaining time for Black.
    - Parameters:
      - time: The time remaining, typically in seconds.

  WL [time]
    - Specifies the remaining time for White.
    - Parameters:
      - time: The time remaining, typically in seconds.

  OB [captures]
    - Indicates the number of stones captured by Black.
    - Parameters:
      - captures: The count of captured stones.

  OW [captures]
    - Indicates the number of stones captured by White.
    - Parameters:
      - captures: The count of captured stones.

  MN [number]
    - Specifies the move number for the current node.
    - Parameters:
      - number: The sequential move number.
```

--------------------------------

### XGF Schema Overview

Source: https://www.red-bean.com/sgf/xml/html-doc/xgf-game-go

Provides an overview of the primary XGF XML schema, its target namespace, and related schema locations.

```APIDOC
XGF Schema:
  Schema Location: C:\\Source\\misc\\xgf\\xml-spec\\xgf.xsd
  Target Namespace: http://xmp.net/xgf/namespaces/xgf/20020407

Related Schemas:
  xlink Schema Location: C:\\Source\\misc\\xgf\\xml-spec\\xlink.xsd
  xlink Target Namespace: http://www.w3.org/1999/xlink

  xlink-util Schema Location: C:\\Source\\misc\\xgf\\xml-spec\\xlink-util.xsd
  xlink-util Target Namespace: http://xmp.net/xgf/namespaces/xlink-util/20020406
```

--------------------------------

### SGF FF[4] Time Limits, Captures, and Move Numbers

Source: https://www.red-bean.com/sgf/examples/index

Demonstrates properties related to game timing, captures, and move numbering: BL (Black time left), WL (White time left), OB (Black captures), OW (White captures), and MN (Move number).

```APIDOC
SGF FF[4] Time Limits, Captures, and Move Numbers:

  BL [time]
    - Specifies the remaining time for Black.
    - Parameters:
      - time: The time remaining, typically in seconds.

  WL [time]
    - Specifies the remaining time for White.
    - Parameters:
      - time: The time remaining, typically in seconds.

  OB [captures]
    - Indicates the number of stones captured by Black.
    - Parameters:
      - captures: The count of captured stones.

  OW [captures]
    - Indicates the number of stones captured by White.
    - Parameters:
      - captures: The count of captured stones.

  MN [number]
    - Specifies the move number for the current node.
    - Parameters:
      - number: The sequential move number.
```

--------------------------------

### Place Name (PC)

Source: https://www.red-bean.com/sgf/user_guide

Stores the location, such as city or country, where the game was played.

```APIDOC
PC[] Place
  - Description: Name of place (e.g. city, country) where game took place.
```

--------------------------------

### Place Name (PC)

Source: https://www.red-bean.com/sgf/user_guide/index

Stores the location, such as city or country, where the game was played.

```APIDOC
PC[] Place
  - Description: Name of place (e.g. city, country) where game took place.
```

--------------------------------

### Ruleset (RU)

Source: https://www.red-bean.com/sgf/user_guide

Specifies the rule set used for the game, such as Japanese, Chinese, or AGA rules.

```APIDOC
RU[] Rules
  - Description: Name of rule set used (e.g. Japanese, Chinese, AGA, GOE, etc.).
```

--------------------------------

### Event Name (EV)

Source: https://www.red-bean.com/sgf/user_guide

Records the name of the event, such as a tournament or match, where the game took place.

```APIDOC
EV[] Event
  - Description: Name of event (e.g. tournament name).
```

--------------------------------

### SGF Print and Layout Properties

Source: https://www.red-bean.com/sgf/examples

Covers properties used for storing print and layout information, including FG (Figure), VW (View), PM (Print Margin), and MN (Move Number).

```APIDOC
SGF Print and Layout Properties:

  FG [figure_type]
    - Specifies the type of figure or graphic associated with the node.
    - Parameters:
      - figure_type: Identifier for the figure.

  VW [point_list]
    - Defines the visible area of the board.
    - Parameters:
      - point_list: A comma-separated list of points that are visible.

  PM [margin_value]
    - Specifies print margin information.
    - Parameters:
      - margin_value: Value indicating the margin.

  MN [number]
    - Specifies the move number, also used for layout sequencing.
```

--------------------------------

### Ruleset (RU)

Source: https://www.red-bean.com/sgf/user_guide/index

Specifies the rule set used for the game, such as Japanese, Chinese, or AGA rules.

```APIDOC
RU[] Rules
  - Description: Name of rule set used (e.g. Japanese, Chinese, AGA, GOE, etc.).
```

--------------------------------

### SGF Print and Layout Properties

Source: https://www.red-bean.com/sgf/examples/index

Covers properties used for storing print and layout information, including FG (Figure), VW (View), PM (Print Margin), and MN (Move Number).

```APIDOC
SGF Print and Layout Properties:

  FG [figure_type]
    - Specifies the type of figure or graphic associated with the node.
    - Parameters:
      - figure_type: Identifier for the figure.

  VW [point_list]
    - Defines the visible area of the board.
    - Parameters:
      - point_list: A comma-separated list of points that are visible.

  PM [margin_value]
    - Specifies print margin information.
    - Parameters:
      - margin_value: Value indicating the margin.

  MN [number]
    - Specifies the move number, also used for layout sequencing.
```

--------------------------------

### Event Name (EV)

Source: https://www.red-bean.com/sgf/user_guide/index

Records the name of the event, such as a tournament or match, where the game took place.

```APIDOC
EV[] Event
  - Description: Name of event (e.g. tournament name).
```

--------------------------------

### Round Number (RO)

Source: https://www.red-bean.com/sgf/user_guide

Indicates the specific round number within a tournament or event for the recorded game.

```APIDOC
RO[] Round
  - Description: Number of tournament round.
```

--------------------------------

### Date (DT)

Source: https://www.red-bean.com/sgf/user_guide

Stores the date when the game was played, adhering to the ISO 8601 standard format (YYYY-MM-DD).

```APIDOC
DT[] Date
  - Description: Date when game was played.
  - Mandatory format: Use the ISO-standard format "YYYY-MM-DD".
  - Example: A game played on the 5th March 1997 would be encoded as: "1997-03-05".
  - Avoid other separators such as "/" or " " or ".".
```

--------------------------------

### Many Faces of Go SGF Placement and File Handling

Source: https://www.red-bean.com/sgf/discussion/19970712a

Details specific rules for placing SGF properties like AB, AW, AE within the file structure and how 'Many Faces of Go' handles non-standard file beginnings and moves in the root node.

```APIDOC
SGF Placement and File Handling Rules:

Placement Rules for AB, AW, AE:
MF only allows AB, AW, AE at the root or at leafs, unless there is only one AB or AW in a node, and no move. MF will not correct mixed move and setup properties, but will give an error and not read the file.

Root Node Move Handling:
If an input file has a move in the root node, MF adds a new node after the root and moves the root move there.

Junk and File Start Handling:
MF can skip junk in front of the initial (; (like e-mail headers), and can handle files starting with ( instead of (;

Line Break Handling:
MF probably does not handle soft and hard linebreaks correctly.

Compressed Point Lists:
MF expands compressed point lists on input, and will never write a compressed point list.
```

--------------------------------

### Round Number (RO)

Source: https://www.red-bean.com/sgf/user_guide/index

Indicates the specific round number within a tournament or event for the recorded game.

```APIDOC
RO[] Round
  - Description: Number of tournament round.
```

--------------------------------

### SGF General Properties Mapping to SGFML

Source: https://www.red-bean.com/sgf/xml/sgfml/proplist_t

This section details general SGF properties, their descriptions, types, and corresponding SGFML Version 0.02 counterparts. It serves as a reference for mapping SGF data structures to SGFML, covering move properties, setup properties, markup, and root/game-info properties.

```APIDOC
SGF General Properties:

ID   Description     property type    SGFML V0.02 counterpart
----	---------------	----------------	--------------------------------------
B    Black           move             <move move= side=>
BL   Black time left move             <move timeleft=>
BM   Bad move        move             <move annotate="BAD|VERYBAD">
DO   Doubtful        move             <move annotate="DOUBTFUL">
IT   Interesting     move             <move annotate="INTERESTING">
KO   Ko              move             -
MN   set MoveNumber  move             <move number=>
OB   OtStones Black  move             -
OW   OtStones White  move             -
TE   Tesuji          move             <move annotate="GOOD|VERYGOOD">
W    White           move             <move move= side=>
WL   White time left move             <move timeleft=>

AB   Add Black       setup            in <addstone>: <stone side=>
AE   Add Empty       setup            in <addstone>: <stone side=>
AW   Add White       setup            in <addstone>: <stone side=>
PL   Player to play  setup            <setup sidetoplay=>

AR   Arrow           -                <line type="ARROW">
C    Comment         -                <comment>
CR   Circle          -                <markup type="CIRCLE">
DD   Dim points      - (inherit)      <markup type="DIM">
DM   Even position   -                <annotate type="EVENPOS" emphasis= side=>
FG   Figure          -
GB   Good for Black  -                <annotate type="GOOD" emphasis= side=>
GW   Good for White  -                <annotate type="GOOD" emphasis= side=>
HO   Hotspot         -                <annotate type="HOTSPOT" emphasis= side=>
LB   Label           -                <markup type="LABEL">
LN   Line            -                <line type="LINE">
MA   Mark            -                <markup type="MARK">
N    Nodename        -                <title>
PM   Print move mode - (inherit)
SL   Selected        -
SQ   Square          -                <markup type="SQUARE">
TR   Triangle        -                <markup type="TRIANGLE">
UC   Unclear pos     -                <annotate type="UNCLEARPOS" emphasis= side=>
V    Value           -                <value>
VW   View            - (inherit)      <markup type="VIEW">

AP   Application     root	      <application name= version=>
CA   Charset         root	      in <?xml ?> definition
FF   Fileformat      root	      <sgfml version=>
GM   Game            root	      <game type=>
ST   Style           root
SZ   Size            root	      <board size=>

AN   Annotation      game-info        <person role="ANNOTATOR">
BR   Black rank      game-info        in <person>: <rating>
BT   Black team      game-info        <team id=> plus <person team=>
CP   Copyright       game-info        <copyright>
DT   Date            game-info        <date> plus <dateitem>
EV   Event           game-info        <event>
GC   Game comment    game-info        in <gameheader>: <comment>
GN   Game name       game-info        in <gameheader>: <title>
ON   Opening         game-info        -
OT   Overtime        game-info        ?
PB   Player Black    game-info        <person role="PLAYER" side=> plus <name>
PC   Place           game-info        <place;
PW   Player White    game-info        <person role="PLAYER" side=> plus <name>
RE   Result          game-info        ?
RO   Round           game-info        in <event>: <round>
RU   Rules           game-info        <rules>
SO   Source          game-info        <source type=>
TM   Timelimit       game-info        ?
US   User            game-info        <person role="RECORDER" side=>
WR   White rank      game-info        in <person>: <rating>
WT   White team      game-info        <team id=> plus <person team=>
```

--------------------------------

### Date (DT)

Source: https://www.red-bean.com/sgf/user_guide/index

Stores the date when the game was played, adhering to the ISO 8601 standard format (YYYY-MM-DD).

```APIDOC
DT[] Date
  - Description: Date when game was played.
  - Mandatory format: Use the ISO-standard format "YYYY-MM-DD".
  - Example: A game played on the 5th March 1997 would be encoded as: "1997-03-05".
  - Avoid other separators such as "/" or " " or ".".
```

--------------------------------

### Handicap Stones (HA)

Source: https://www.red-bean.com/sgf/user_guide

Specifies the number of handicap stones used in a game. This value must be a positive integer.

```APIDOC
HA[] Handicap
  - Description: Number of handicap stones.
  - Mandatory format: Use integer values greater than zero, e.g., "1", "5", "9".
  - Avoid: "2 stones", "three".
```

--------------------------------

### Handicap Stones (HA)

Source: https://www.red-bean.com/sgf/user_guide/index

Specifies the number of handicap stones used in a game. This value must be a positive integer.

```APIDOC
HA[] Handicap
  - Description: Number of handicap stones.
  - Mandatory format: Use integer values greater than zero, e.g., "1", "5", "9".
  - Avoid: "2 stones", "three".
```

--------------------------------

### SGF Example: No Variations

Source: https://www.red-bean.com/sgf/var

Demonstrates an SGF game tree with no branching variations. This represents a single, linear sequence of moves in a game.

```SGF
(;FF[4]GM[1]SZ[19];B[aa];W[bb];B[cc];W[dd];B[ad];W[bd])
```

--------------------------------

### Result (RE)

Source: https://www.red-bean.com/sgf/user_guide

Specifies the final outcome of the game. The format is strict, using '0' for a draw, 'B+score' or 'W+score' for wins by points, and 'B+R'/'W+R' for wins by resignation.

```APIDOC
RE[] Result
  - Description: Final result of the game.
  - Mandatory format:
    - "0" for a draw (jigo).
    - "B+score" for a black win (e.g., "B+2.5", "B+0.5").
    - "W+score" for a white win (e.g., "W+64", "W+10.5").
    - "B+R" or "B+Resign" for a win by resignation.
    - "W+R" or "W+Resign" for a win by resignation.
  - Note: Do NOT write "Black resigns".
```

--------------------------------

### SGF FF[4] Board Markup Properties

Source: https://www.red-bean.com/sgf/examples

Demonstrates various board markup properties including MA (Mark incorrect), TR (Triangle), CR (Circle), SQ (Square), SL (Stone Label), TB (Shade Black), and TW (Shade White).

```APIDOC
SGF FF[4] Board Markup Properties:

  MA [point_list]
    - Marks stones at specified points as incorrect.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  TR [point_list]
    - Draws a triangle at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  CR [point_list]
    - Draws a circle at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  SQ [point_list]
    - Draws a square at the specified points.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  SL [point_list]
    - Labels stones at specified points with a single character.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  TB [point_list]
    - Shades the specified points with black.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).

  TW [point_list]
    - Shades the specified points with white.
    - Parameters:
      - point_list: A comma-separated list of points (e.g., C4,D5).
```
Tokens:
Raw