manual/plugins/goban.tex

   1 \subsection{Goban}
   2 \screenshot{plugins/images/ss-goban}{Goban}{The Rockbox Goban plugin}
   3 Goban is a a plugin for playing, viewing and recording games of Go (also known
   4 as Weiqi, Baduk, Igo and Goe).  It uses standard Smart Game Format (SGF) files
   5 for saving and loading games.  You can find a short introduction to Go at
   6 \url{http://senseis.xmp.net/?WhatIsGo} and more information about SGF files
   7 can be read at \url{http://senseis.xmp.net/?SmartGameFormat} or the SGF
   8 specification at \url{http://www.red-bean.com/sgf/}.\\
   9
  10 This plugin can load all modern SGF files (file format 3 or 4) with few problems.
  11 It attempts to preserve SGF properties which it doesn't understand, and most common
  12 SGF properties are handled fully.  It is possible to view (and edit if you like)
  13 Kogo's Joseki Dictionary (\url{http://waterfire.us/joseki.htm}) with this plugin,
  14 although the load and save times can be on the order of a minute or two on
  15 particularly slow devices.  Large SGF files may stop audio playback for the duration
  16 of the plugin's run in order to free up more memory and some very large SGF files will
  17 not even load on devices with little available memory.\\
  18
  19 \note{The plugin does \emph{NOT} support SGF files with multiple games in
  20 one file.  These are rare, but if you have one don't even try it (the file will most
  21 likely be corrupted if you save over it).  You have been warned.\\}
  22
  23 The file \fname {"/sgf/gbn\_def.sgf"} is used by the plugin to store any unsaved
  24 changes in the most recently loaded game.  This means that if you forget to save your
  25 changes, you should load \fname {"/sgf/gbn\_def.sgf"} immediately to offload the changes
  26 to another file.  If you load another file first then your changes will be lost
  27 permanently.  The \fname {"/sgf/gbn\_def.sgf"} file is also the file loaded if another
  28 is not selected.\\
  29
  30 The information panel which displays the current move number may also contain
  31 these markers: \\
  32
  33 \begin{table}
  34     \begin{rbtabular}{\textwidth}{lX}%
  35       {\textbf{Mark} & \textbf{Meaning}}{}{}
  36       \emph{+ } & There are nodes after the current node in the SGF tree. \\
  37       \emph{* } & There are sibling variations which can be navigated to using the %
  38       \emph{Next Variation} menu option of the \emph{Context Menu}%
  39       \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_FUZE_PAD,SANSA_CLIP_PAD,%
  40          RECORDER_PAD,MROBE100_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IRIVER_H100_PAD,%
  41          IRIVER_H300_PAD}{ or the %
  42          \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonRec}%
  43          \opt{SANSA_FUZE_PAD,SANSA_CLIP_PAD}{\ButtonHome}%
  44          \opt{RECORDER_PAD}{\ButtonOn}%
  45          \opt{MROBE100_PAD}{\ButtonPower}%
  46          \opt{GIGABEAT_PAD}{\ButtonA}%
  47          \opt{GIGABEAT_S_PAD}{\ButtonPlay}%
  48          \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec} button}. \\
  49       \emph{C } & There is a comment at the current node.  It can be viewed/edited using
  50                 the \emph{Add/Edit Comment} menu option of the \emph{Context Menu}. \\
  51     \end{rbtabular}
  52 \end{table}
  53
  54 \subsubsection{Controls}
  55 \begin{table}
  56     \begin{btnmap}{}{}
  57     \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_CLIP_PAD,SANSA_M200_PAD,SANSA_C200_PAD,%
  58          GIGABEAT_PAD,GIGABEAT_S_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,MROBE100_PAD,%
  59          IAUDIO_X5_PAD,RECORDER_PAD,ONDIO_PAD}{\ButtonUp}%
  60         \opt{IPOD_1G2G_PAD,IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonMenu}%
  61         \opt{IRIVER_H10_PAD}{\ButtonScrollUp}
  62         \opt{COWON_D2_PAD}{\TouchTopMiddle}
  63        \opt{HAVEREMOTEKEYMAP}{& }
  64     & Move cursor up \\
  65     \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_CLIP_PAD,SANSA_M200_PAD,SANSA_C200_PAD,%
  66          GIGABEAT_PAD,GIGABEAT_S_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,MROBE100_PAD,%
  67          IAUDIO_X5_PAD,RECORDER_PAD,ONDIO_PAD}{\ButtonDown}%
  68         \opt{IPOD_1G2G_PAD,IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonPlay}%
  69         \opt{IRIVER_H10_PAD}{\ButtonScrollDown}
  70         \opt{COWON_D2_PAD}{\TouchBottomMiddle}
  71        \opt{HAVEREMOTEKEYMAP}{& }
  72     & Move cursor down \\
  73     \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_CLIP_PAD,SANSA_M200_PAD,IPOD_1G2G_PAD,%
  74          IPOD_3G_PAD,IPOD_4G_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IRIVER_H10_PAD,%
  75          IRIVER_H100_PAD,IRIVER_H300_PAD,MROBE100_PAD,IAUDIO_X5_PAD,RECORDER_PAD,%
  76          ONDIO_PAD}{\ButtonLeft}
  77         \opt{COWON_D2_PAD}{\TouchMidLeft}
  78        \opt{HAVEREMOTEKEYMAP}{& }
  79     & Move cursor left %
  80             \opt{ONDIO_PAD}{if in \emph{board} navigation mode, or %
  81                             retreat one node in the game tree if in %
  82                             \emph{tree} navigation mode} \\
  83     \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_CLIP_PAD,SANSA_M200_PAD,IPOD_1G2G_PAD,%
  84          IPOD_3G_PAD,IPOD_4G_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IRIVER_H10_PAD,%
  85          IRIVER_H100_PAD,IRIVER_H300_PAD,MROBE100_PAD,IAUDIO_X5_PAD,RECORDER_PAD,%
  86          ONDIO_PAD}{\ButtonRight}
  87         \opt{COWON_D2_PAD}{\TouchMidRight}
  88        \opt{HAVEREMOTEKEYMAP}{& }
  89     & Move cursor right
  90             \opt{ONDIO_PAD}{if in \emph{board} navigation mode, or advance one node in
  91                             the game tree if in \emph{tree} navigation mode} \\
  92     \opt{ONDIO_PAD}{\ButtonOff & Toggle between \emph{board} and \emph{tree}
  93                                    navigation modes \\}
  94     \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_1G2G_PAD,IPOD_3G_PAD,IPOD_4G_PAD,%
  95          SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,%
  96          MROBE100_PAD,IAUDIO_X5_PAD,SANSA_CLIP_PAD,SANSA_M200_PAD}{\ButtonSelect}%
  97         \opt{IRIVER_H10_PAD,RECORDER_PAD}{\ButtonPlay}%
  98         \opt{ONDIO_PAD}{\ButtonMenu}
  99         \opt{COWON_D2_PAD}{\TouchCenter}
 100        \opt{HAVEREMOTEKEYMAP}{& }
 101     & Play a move (or use a tool if play-mode has been changed). \\
 102     \nopt{ONDIO_PAD}{
 103         \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_1G2G_PAD,IPOD_3G_PAD,%
 104              IPOD_4G_PAD}{\ButtonScrollBack}%
 105             \opt{SANSA_CLIP_PAD,SANSA_M200_PAD,SANSA_C200_PAD,GIGABEAT_PAD,%
 106                  GIGABEAT_S_PAD}{\ButtonVolDown}%
 107             \opt{IRIVER_H10_PAD}{\ButtonFF}%
 108             \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}%
 109             \opt{MROBE100_PAD}{\ButtonMenu}%
 110             \opt{IAUDIO_X5_PAD}{\ButtonPlay}%
 111             \opt{RECORDER_PAD}{\ButtonFOne}
 112             \opt{COWON_D2_PAD}{\TouchBottomLeft}
 113        \opt{HAVEREMOTEKEYMAP}{& }
 114         & Retreat one node in the game tree \\
 115         \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_1G2G_PAD,IPOD_3G_PAD,IPOD_4G_PAD,%
 116              IPOD_1G2G_PAD,IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonScrollFwd}%
 117             \opt{SANSA_CLIP_PAD,SANSA_M200_PAD,SANSA_C200_PAD,GIGABEAT_PAD,%
 118                  GIGABEAT_S_PAD}{\ButtonVolUp}%
 119             \opt{IRIVER_H10_PAD}{\ButtonRew}%
 120             \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}%
 121             \opt{MROBE100_PAD}{\ButtonPlay}%
 122             \opt{IAUDIO_X5_PAD}{\ButtonRec}%
 123             \opt{RECORDER_PAD}{\ButtonFThree}
 124             \opt{COWON_D2_PAD}{\TouchBottomRight}
 125        \opt{HAVEREMOTEKEYMAP}{& }
 126         & Advance one node in the game tree \\
 127     }
 128     \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_CLIP_PAD,SANSA_M200_PAD,SANSA_C200_PAD,%
 129          IRIVER_H10_PAD,IAUDIO_X5_PAD}{\ButtonPower}%
 130         \opt{MROBE100_PAD}{\ButtonDisplay}%
 131         \opt{IPOD_1G2G_PAD,IPOD_3G_PAD,IPOD_4G_PAD}{Long \ButtonSelect}%
 132         \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonMenu}%
 133         \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}%
 134         \opt{RECORDER_PAD}{\ButtonFTwo}%
 135         \opt{ONDIO_PAD}{Long \ButtonMenu}
 136         \opt{COWON_D2_PAD}{\TouchTopLeft}
 137        \opt{HAVEREMOTEKEYMAP}{& }
 138     & Main Menu \\
 139     \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,%
 140          IRIVER_H100_PAD,IRIVER_H300_PAD,MROBE100_PAD,IAUDIO_X5_PAD,%
 141          IRIVER_H10_PAD}{%
 142         \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_CLIP_PAD,SANSA_M200_PAD,SANSA_C200_PAD,%
 143              GIGABEAT_PAD,GIGABEAT_S_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,MROBE100_PAD,%
 144              IAUDIO_X5_PAD}{Long \ButtonSelect}%
 145             \opt{IRIVER_H10_PAD}{Long \ButtonPlay}
 146         \opt{COWON_D2_PAD}{Long \TouchCenter}
 147        \opt{HAVEREMOTEKEYMAP}{& }
 148     & Context Menu \\ }
 149     \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_FUZE_PAD,RECORDER_PAD,MROBE100_PAD,%
 150          GIGABEAT_PAD,GIGABEAT_S_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,SANSA_CLIP_PAD}{%
 151         \opt{SANSA_E200_PAD}{\ButtonRec}%
 152         \opt{SANSA_FUZE_PAD,SANSA_CLIP_PAD}{\ButtonHome}%
 153         \opt{SANSA_C200_PAD}{\ButtonRec}%
 154         \opt{RECORDER_PAD}{\ButtonOn}%
 155         \opt{MROBE100_PAD}{\ButtonPower}%
 156         \opt{GIGABEAT_PAD}{\ButtonA}%
 157         \opt{GIGABEAT_S_PAD}{\ButtonPlay}%
 158         \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec}
 159         \opt{COWON_D2_PAD}{\TouchTopRight}
 160        \opt{HAVEREMOTEKEYMAP}{& }
 161     & Go to the next variation when at the first node in a branch \\ }
 162     \end{btnmap}
 163 \end{table}
 164
 165 \subsubsection{Menus}
 166 \begin {description}
 167 \item [Main Menu. ]
 168     The main menu for game setup and access to other menus.
 169
 170     \emph {New. } Create a new game with your choice of board size and handicaps. \\
 171     \emph {Save. } Save the current state of the game.  It will be saved to
 172     \fname {"/sgf/gbn\_def.sgf"} unless otherwise set. \\
 173     \emph {Save As. } Save to a specified file. \\
 174     \emph {Game Info. } View and modify the metadata of the current game. \\
 175     \emph {Playback Control. } Control the playback of the current playlist and
 176     modify the volume of your player. \\
 177     \emph {Zoom Level. } Zoom in or out on the board.  If you set the zoom level, it
 178     will be saved and used again the next time you open this plugin. \\
 179     \emph {Options. } Open the Options Menu. \\
 180     \emph {Context Menu. } Open the Context Menu which allows you to set play modes
 181     and other tools. \\
 182     \emph {Quit. } Leave the plugin.  Any unsaved changes are saved to
 183     \fname {"/sgf/gbn\_def.sgf"}. \\
 184
 185 \item [Game Info. ]
 186     The menu for modifying game info (metadata) of the current game.  This
 187     information will be saved to the SGF file and can be viewed in almost all
 188     SGF readers.
 189
 190     \emph {Basic Info. } Shows a quick view of the basic game metadata, if any
 191     has been set (otherwise does nothing).  This option does not allow editing. \\
 192     \emph {Time Limit. } The time limit of the current game. \\
 193     \emph {Overtime. } The overtime settings of the current game. \\
 194     \emph {Result. } The result of the current game.  This text must follow the
 195     format specified at \url{http://www.red-bean.com/sgf/properties.html#RE} to
 196     be read by other SGF readers.  Some examples are \emph {B+R} (Black wins by
 197     resignation), \emph {B+5.5} (Black wins by 5.5 points), \emph {W+T} (White wins
 198     on Time). \\
 199     \emph {Handicap. } The handicap of the current game. \\
 200     \emph {Komi. } The komi of the current game (compensation to the white
 201     player for black having the first move). \\
 202     \emph {Ruleset. } The name of the ruleset in use for this game.  The \emph{NZ}
 203     and \emph{GOE} rulesets include suicide as a legal move (for multi-stone
 204     suicide only); the rest do not. \\
 205     \emph {Black Player. } The name of the black player. \\
 206     \emph {Black Rank. } Black's rank, in dan or kyu. \\
 207     \emph {Black Team. } The name of black's team, if any. \\
 208     \emph {White Player. } The name of the white player. \\
 209     \emph {White Rank. }  White's rank, in dan or kyu. \\
 210     \emph {White Team. } The name of white's team, if any. \\
 211     \emph {Date. } The date that this game took place.  This text must follow the
 212     format specified at \url{http://www.red-bean.com/sgf/properties.html#DT} to
 213     be read by other SGF readers. \\
 214     \emph {Event. } The name of the event which this game was a part of, if any.
 215     \\
 216     \emph {Place. } The place that this game took place. \\
 217     \emph {Round. } If part of a tournament, the round number for this game. \\
 218     \emph {Done. } Return to the previous menu. \\
 219
 220 \item [Options. ]
 221     Customize the behavior of the plugin in certain ways.
 222
 223     \emph {Show Child Variations? } Enable this to mark child variations on the board
 224     if there are more than one.  Note: variations which don't start with a move are
 225     not visible in this way. \\
 226     \emph {Disable Idle Poweroff? } Enable this if you do not want the \dap{} to turn
 227     off after a certain period of inactivity (depends on your global Rockbox
 228     settings). \\
 229     \emph {Idle Autosave Time. } Set the amount of idle time to wait before
 230     automatically saving any unsaved changes.  These autosaves go to the file
 231     \fname {"/sgf/gbn\_def.sgf"} regardless of if you have loaded a game or used
 232     \emph {Save As} to save the game before or not.  Set to \emph {Off} to disable
 233     this functionality completely. \\
 234     \emph {Automatically Show Comments? } If this is enabled and you navigate to a
 235     node containing game comments, they will automatically be displayed. \\
 236
 237 \item [Context Menu. ]
 238     The menu for choosing different play modes and tools, adding or editing
 239     comments, adding pass moves, or switching between sibling variations.
 240
 241     \emph {Play Mode. } Play moves normally on the board.  If there are
 242     child moves from the current node, this mode will let you follow variations
 243     by simply playing the first move in the sequence.  Unless it is following a
 244     variation, this mode will not allow you to play illegal moves.  This is the
 245     default mode before another is set after loading a game or creating a new
 246     one. \\
 247     \emph {Add Black Mode. } Add black stones to the board as desired. These
 248     stones are not moves and do not perform captures or count as ko threats. \\
 249     \emph {Add White Mode. } Add white stones to the board as desired. These
 250     stones are not moves and do not perform captures or count as ko threats. \\
 251     \emph {Erase Stone Mode. } Remove stones from the board as desired.  These
 252     removed stones are not counted as captured, they are simply removed. \\
 253     \emph {Pass. } Play a single pass move.  This does not change the mode of
 254     play. \\
 255     \emph {Next Variation. } If the game is at the first move in a variation,
 256     this will navigate to the next variation after the current one.  This is
 257     the only way to reach variations which start with adding or removing
 258     stones, as you cannot follow them by "playing" the same move. \\
 259     \emph {Force Play Mode. } The same as Play Mode except that this mode will
 260     allow you to play illegal moves such as retaking a ko immediately without a
 261     ko threat, suicide on rulesets which don't allow it (including single stone
 262     suicide), and playing a move where there is already a stone. \\
 263     \emph {Mark Mode. } Add generic marks to the board, or remove them. \\
 264     \emph {Circle Mode. } Add circle marks to the board, or remove them. \\
 265     \emph {Square Mode. } Add square marks to the board, or remove them. \\
 266     \emph {Triangle Mode. } Add triangle marks to the board, or remove them. \\
 267     \emph {Label Mode. } Add one character labels to the board.  Each label
 268     starts at the letter 'a' and each subsequent application of a label will
 269     increment the letter.  To remove a label, click on it until it cycles
 270     through the allowed letters and disappears. \\
 271     \emph {Add/Edit Comment. } Add or edit a comment at the current node. \\
 272     \emph {Done. } Go back to the previous screen. \\
 273 \end{description}
 274