Chapter 4. Main Window
Prev |  | Next

## Chapter 4. Main Window

## Go Board

Clicking on an empty field in the Go board plays a move there. In setup mode, score mode or after certain analyze commands, clicking on a field has a special meaning (see Setup Mode, Score, and Chapter 7, Analyze Commands).

If Show Cursor is enabled in the Settings menu, then fields can be selected with the keyboard by moving the cursor (the red square corners) with the cursor keys to the target field and pressing Enter. Holding Shift while pressing a cursor key moves the cursor to the next handicap line in this direction or to the edge of the board.

## Info Panel

The panel on the right side of the board shows information about the current position, for example the last move and the variation number. A text field exists for displaying and editing comment text for the current position. If you select text in the comment field, it will automatically parsed for valid points, which will be marked on the board while the text is selected. Selected text in the comment is also used as a default text for Find in Comments.

## File Menu

Open

  Open a game from a file in SGF format.

  ### Note

  Only a subset of the SGF definition is supported. Most notably game collections and certain kind of setup positions are not supported. The current GTP standard does not define a setup command. Setup stones are always translated to play commands for the Go program, which is problematic, if the setup stones lead to a Go position that contains blocks with no liberties. Currently, no check for this situation is performed, even if it causes the Go program to capture the blocks and therefore be out-of-sync with the game tree. Delete points are sent as play empty commands to the Go program, which should respond with an error, because play empty is not valid according to the GTP standard. Unknown SGF properties are preserved, if the game is saved to a file again.

Open Recent

  Open a game from a list of recently used files.

Save

  Save the current game to the associated filename. If the game has no filename, this menu item acts like Save As.

Save As

  Save the current game to a file. If the file name ending is `sgf`, the game is saved in SGF format. If the file name ending is `tex`, the game is exported to LaTeX using PSGO style.

Export / SGF Position

  Export the current position to a file in SGF format.

Export / LaTeX Main Variation

  Export the main variation of the current game to a LaTeX file using PSGO style.

Export / LaTeX Position

  Export the current position to a LaTeX file using PSGO style. Some board markups are also exported (string labels, marked and selected points).

Export / Text Position

  Export the current position to a text file.

Print

  Print a screen shot of the current board position, including all markups from analyze commands.

Attach Program

  Attach a Go program to the current game at the current position.

Detach Program

  Detach currently attached Go program from game and terminate the Go program.

Quit

  Quit GoGui.

## Game Menu

New Game

  Start a new game.

Computer Color

  Choose what side the Go program plays.

Play

  Change the computer color to the color to move and make the computer start playing.

Play Single Move

  Make the computer play a move, but do not change the computer color.

Interrupt

  Interrupt the command that is currently running. This menu item is only active if a lengthy command (like move generation) is running and if the Go program supports interrupting (see Chapter 9, Interrupting Commands).

Clock

  Halt or resume the clock. If time settings were used, the remaining time for the players is stored in the tree nodes and can be restored with the Restore item.

Pass

  Make a pass move.

Cleanup

  Generate cleanup moves. Cleanup moves are moves played after the game has ended with two passes in a row. They should not pass before all dead stones are captured. This item is only enabled, if the program supports the kgs-genmove_cleanup or genmove_cleanup command. It will be automatically set after two pass moves have been played.

Score

  Score the current game. A window will be opened containing score information. First the Go program will be asked what stones are dead with the final_status_list dead command. Dead stones are marked with a cross-hair. If the Go program does not support this command, or you don't agree with it, you can change the status of stones by clicking on them. You leave score mode by closing the score window.

## Edit Menu

Find in Comments

  Find next game node containing a search pattern. The search is case insensitive. The pattern is a regular expression as used by the Java java.util.regex.Pattern class, similar to Perl syntax.

Find Next

  Find next game node containing the last entered search pattern.

Game Info

  Edit the game information. Changes to the komi and rules are transmitted to the Go program. The only supported rules are "Chinese" and "Japanese". The program is informed about the komi and the rules with GTP commands, if supported (see Chapter 3, Compatibility).

Size

  Change the board size and start a new game.

Handicap

  Set the number of handicap stones.

Make Main Variation

  Make the current variation to the main variation.

Delete Side Variation

  Delete all variations except for the main variation.

Keep Only Position

  Delete all variations and create a new game tree with the current position as setup stones.

Truncate

  Truncate the current variation beginning at and including the current node.

Truncate Children

  Truncate all children variations of the current node.

Setup Mode

  Enter or leave setup mode. In setup mode you can place or remove stones of the current color. The current color can be changed with the Black and White menu item from the Setup menu. It is also possible to place stones of the other than current color, without switching the color, by pressing a modifier key while placing a stone (Ctrl, Alt or Meta) or using the right mouse button.

  ### Note

  Setting up a position is not reversible. After leaving setup mode, you are in a new game starting with the current position and the current color to move.

Setup Black

  Set the current color for setting up stones and the color to move to Black.

Setup White

  Set the current color for setting up stones and the color to move to White.

## Go Menu

Beginning

  Go to beginning of game.

Backward 10

  Go backward 10 moves.

Backward

  Go backward one move.

Forward

  Go forward one move.

Forward 10

  Go forward 10 moves.

End

  Go to end of the current variation.

Go to Move

  Go to a certain move number in the current variation.

Next Variation

  Go to the next variation.

Previous Variation

  Go to the previous variation.

Next Earlier Variation

  Go to the next variation earlier in the game tree.

Previous Earlier Variation

  Go to the previous variation earlier in the game tree.

Back to Main Variation

  Go back to the main variation.

Go to Variation

  Go to the start node of a certain variation.

## Shell Menu

Save Log

  Save the GTP streams to a log file.

Save Commands

  Save the sent GTP commands to a file.

Send File

  Send GTP commands from a file to the engine.

Send Recent

  Send GTP commands from a recently opened file to the engine.

## Bookmarks Menu

Add Bookmark

  Add a new bookmark.

Edit Bookmarks

  Edit bookmarks.

## Settings Menu

Show Toolbar

  Show toolbar.

Show Info Panel

  Show panel on the right side of the board containing game information.

Show Tree

  Show the game tree window.

Show Shell

  Show the GTP shell window.

Show Analyze

  Show the Analyze window.

Configure Board / Show Cursor

  Show cursor on board for keyboard navigation. Fields can be selected on with the Enter key.

Configure Board / Show Grid

  Show grid.

Configure Board / Show Last Move

  Mark the last move with a red circle.

Configure Board / Show Variations

  Mark the moves of all variations from this position with letters starting with 'A' ('+' will be used after 'Z'). If multiple variations start with the same move, a '.' is appended.

Configure Board / Beep After Move

  Beep after each computer move. With most versions of Java the PC speaker is used for the beep.

Configure Board / Fixed Size Comment Font

  Use fixed-width font for comment.

Configure Tree / Labels

  Configure the labels on the tree nodes.

Configure Tree / Size

  Configure the size of the tree nodes.

Configure Tree / Show Subtree Sizes

  Show the number of nodes in the subtree for nodes that are not expanded.

Configure Shell / Popup Completions

  Popup a window with command completions while entering a command.

Configure Shell / Auto Number

  Automatically number GTP commands. Note that some Go programs don't comply to the GTP standard by not supporting GTP commands with a numerical ID. They will usually answer with "Unknown command", because they try to parse the ID as a command.

Configure Shell / Timestamp

  Prepend each sent or received line with a time stamp.

Configure Analyze / Only Supported Commands

  Only show commands supported by the current Go engine.

Configure Analyze / Sort Alphabetically

  Sort command labels alphabetically. Otherwise the analyze command list has the same order as in the configuration files.

Configure Analyze / Reload Configuration

  Reload configuration files defining the commands after they were edited.

## Help Menu

GoGui Documentation

  Open a window for browsing the GoGui documentation.

About

  Show the version of GoGui and the Go program (if there is a program attached).

Prev |  | Next
Chapter 3. Compatibility | Home | Chapter 5. Game Tree Window