\section{Las piedras, movimientos y prisioneros}

Las piedras son los elementos fundamentales. En \pgfgoname, se proporcionan comandos y opciones para dibujarlas de manera flexible, permitiendo personalizar su apariencia y comportamiento según las necesidades del diagrama.

\subsection{Piedras}

\begin{command}{\stone\opt{\oarg{options}}\marg{intersection}}
       Este comando dibuja una piedra individual en la intersección especificada. El argumento obligatorio es la coordenada (ej. «C2»), mientras que las opciones opcionales permiten ajustar su estilo, como color, tamaño o mar, siguiendo la convención del primer jugador en Go.
\end{command}


\begin{command}{\stones\opt{\oarg{options}}\marg{intersection \opt{, intersection, ...}}}
       Similar a |\stone|, pero permite colocar múltiples piedras con la sintaxis correspondiente (Ver Sintaxis de coordenadas).
\end{command}

Es posible cambiar una opci\'on en todos los jugadores mediante |\pgfgoset{stone = {...}}|. Esto es equivalente a |\pgfgoset{players = {all = {stone = {...}}}}|.


\begin{key}{/pgfgo/stone/fill = \meta{option} (default true)}
       Controla las opciones de relleno de una piedra.
\end{key}


\begin{key}{/pgfgo/stone/fill/color = \meta{color}}
       Define el color de relleno de una piedra.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[fill = {color = cyan!80!black}]{C2,D3}
                       \stone[fill = {color = magenta!80!black}]{B4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/fill/opacity = \meta{float} (initially 1)}

       Controla la opacidad del relleno de la piedra, desde 0 (transparente) hasta 1 (opaco).

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[b, fill = {opacity = 0.8}]{C2,D3}
                       \stone[w, fill = {opacity = 0.5}]{B4}
               \end{goban}
       \end{codeexample}
\end{key}


\begin{key}{/pgfgo/stone/line = \meta{option} (initially true)}
       Controla las opciones de la frontera de una piedra.
\end{key}

\begin{key}{/pgfgo/stone/line/color = \meta{color} (initially black)}

       Establece el color del borde de la piedra, que por defecto es negro para todas las piedras.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[b, line = {color = magenta}]{C2,D3}
                       \stone[w, line = {color = cyan}]{B4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/line/opacity = \meta{float} (initially 1)}

       Define la opacidad del borde de la piedra, permitiendo hacerlo más sutil o transparente.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[b, line = {opacity = 0.5}]{C2,D3}
                       \stone[w, line = {opacity = 0.8}]{B4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/line/width = \meta{dimension} (initially 0.9pt)}

       Controla el grosor del borde de la piedra.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w, line = {width = 2pt}]{B4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/radius = \meta{dimension} (initially 0.55em)}

       Establece el tamaño de la piedra mediante su radio.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[b, radius = 0.15cm]{C2,D3}
                       \stone[w, radius = 0.25cm]{B4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/scale = \meta{float} (initially 1)}

       Define un factor de escala que afecta todos los elementos de la piedra (radio, borde, marcas), manteniendo sus proporciones.
\end{key}

\begin{key}{/pgfgo/stone/black}

       Asigna a la piedra las características del primer jugador (negro por defecto), incluyendo color de relleno y borde. Es el estado inicial de toda piedra si no se especifica otra opción.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[black]{B4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/b}

       Abreviatura de «black», con idéntica funcionalidad.
\end{key}

\begin{key}{/pgfgo/stone/white}

       Asigna a la piedra las características del segundo jugador (blanco por defecto), con relleno blanco y borde negro.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[white]{B4}
               \end{goban}

               \begin{goban}
                       \stones[white]{C2,D3}
                       \stone[white]{B4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/w}

       Abreviatura de «white», con la misma funcionalidad.
\end{key}

\begin{key}{/pgfgo/stone/mark = \meta{mark keys}}

       Coloca una marca sobre la piedra (ej. triángulo, círculo). Las marcas pueden personalizarse ulteriormente con otras claves, como color o tamaño.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[b, mark = triangle]{C2,D3}
                       \stone[w, mark = t-circle]{B4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/forget}

       Cuando el tablero usa un sistema de memoria (|new remember|, |resume|), esta opción indica que la piedra no debe recordarse, permitiendo excluirla de estados posteriores.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}[new remember]
                       \stones[b]{C2,D3}
                       \stone[w, forget]{B4}
               \end{goban}

               \begin{goban}[resume]
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/remember}

       En un tablero con memoria activa, asegura que la piedra se recuerde incluso si el entorno general usa |forget|.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}[forget]
                       \stones[b]{C2,D3}
                       \stone[w, remember]{B4}
               \end{goban}

               \begin{goban}[resume]
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/prisoner=\meta{prisoner options} (default fill opacity = 0.5)}

       Caracteriza a una piedra como prisionera, típicamente con una opacidad reducida (0.5 por defecto) para indicar que ha sido capturada. Pueden añadirse otras opciones para personalizar su apariencia.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \stones[b, prisoner]{C2,D3}
                       \stone[white]{B4}
               \end{goban}
       \end{codeexample}
\end{key}





\subsection{Movimientos}

Los comandos de movimientos permiten representar secuencias de jugadas alternando automáticamente entre negro y blanco. Incluyen opciones para numerar las jugadas y personalizar las piedras asociadas.

\begin{command}{\move\opt{*}\opt{\oarg{options}}\marg{intersection}}

       Dibuja una piedra como parte de una secuencia de movimientos, alternando colores automáticamente (negro, blanco, negro, etc.). La versión estrellada (|\move*|) añade una etiqueta numérica a la piedra.
\end{command}

\begin{command}{\moves\opt{*}\opt{\oarg{options}}\marg{intersection \opt{, intersection, ...}}}

       Similar a |\move|, pero aplica la secuencia a múltiples intersecciones en una sola línea.
\end{command}

Es posible cambiar las opciones de todos los jugadores mediante |\pgfgoset{move = {...}}| que es equivalente a |\pgfgoset{players = {all = {move = {...}}}}|.

\begin{key}{/pgfgo/move/black}

       Establece que la secuencia de movimientos comienza con el jugador negro, útil para forzar el inicio de una jugada en diagramas específicos.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \moves[b]{C2,B4}
                       \move{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/white}

       Establece que la secuencia comienza con el jugador blanco, alterando el orden natural de las jugadas.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \moves[white]{C2,B4}
                       \move{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/from = \meta{number}}

       Define el número inicial de una secuencia numerada de movimientos, permitiendo continuar desde un punto específico en lugar de empezar en 1.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \moves*[from = 7]{C2,B4}
                       \move*{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label = \meta{options}}

       Controla las propiedades de las etiquetas numéricas en los movimientos estrellados, como tamaño, color o formato.
\end{key}

\begin{key}{/pgfgo/move/label/font size=\meta{dimension} (initially 0.5em)}

       Ajusta el tamaño de la fuente de las etiquetas, permitiendo adaptarlas al tamaño de las piedras o al diseño general.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \moves*[from = 7]{C2,B4}
                       \move*[label = {font size = 0.125em}]{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format = \meta{options} (initially arabic)}

       Define el estilo de numeración de las etiquetas.
\end{key}

\begin{key}{/pgfgo/move/label/format/arabic}

       Usa números arábigos, el formato por defecto para las etiquetas de movimientos.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \begin{goban}
                       \moves*[from = 7]{C2,B4}
                       \move*{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/alph}

       Usa letras minúsculas para las etiquetas.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \pgfgoset{move={label = {format=alph}}}
               \begin{goban}
                       \moves*[from = 7]{C2,B4}
                       \move*{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/Alph}

       Usa letras mayúsculas.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \pgfgoset{move = {label = {format = Alph}}}
               \begin{goban}
                       \moves*[from = 7]{C2,B4}
                       \move*{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/roman}

       Usa números romanos minúsculos.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \pgfgoset{move = {label = {format = roman}}}
               \begin{goban}
                       \moves*{C2,B4}
                       \move*{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/Roman}

       Usa números romanos mayúsculos.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \stones[b]{C2,D3}
                       \stone[w]{B4}
               \end{goban}

               \pgfgoset{move = {label = {format = Roman}}}
               \begin{goban}
                       \moves*{C2,B4}
                       \move*{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/color = \meta{color}}

       Define el color de las etiquetas.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}
                       \moves*{C2,B4}
                       \move*{D3}
               \end{goban}

               \begin{goban}
                       \moves*[label = {color = red}]{C2,B4}
                       \move*[label = {color = blue}]{D3}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/forget}

       Evita que las etiquetas de movimientos se guarden en la memoria del tablero cuando se usa |remember|, permitiendo que las piedras persistan sin sus números.

       \begin{codeexample}[]
               \pgfgoset{goban = {5, partial = {from = B2 to D4}}}

               \begin{goban}[new remember]
                       \moves*[label = forget]{C2,B4,D3}
               \end{goban}

               \begin{goban}[resume]
                       \moves*{C:D4}
               \end{goban}
       \end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/remember}

       Garantiza que las etiquetas se guarden en la memoria, incluso si el entorno usa |forget|, asegurando su continuidad en diagramas posteriores.
\end{key}

\begin{key}{/pgfgo/move/forget}

       Indica que los movimientos no se recuerden en la memoria del tablero, eliminándolos de estados futuros al usar |resume|.
\end{key}

\begin{key}{/pgfgo/move/remember}

       Asegura que los movimientos se recuerden, preservándolos para su reutilización con |resume|.
\end{key}







\subsection{Prisioneros}

\pgfgoname\ ofrece comandos específicos para representar prisioneros, generalmente con una opacidad reducida para distinguirlas de las piedras activas.

\begin{command}{\prisoner\opt{\oarg{options}}\marg{intersection}}

       Dibuja una piedra prisionera en una intersección específica, con opciones para personalizar su estilo.
\end{command}

\begin{command}{\prisoners\opt{\oarg{options}}\marg{intersection \opt{, intersection, ...}}}

       Coloca múltiples piedras prisioneras en una sola línea, eficiente para mostrar grupos capturados.
\end{command}

\begin{key}{/pgfgo/prisoner=\meta{stone options} (default fill opacity = 0.5)}

       Define las características de las piedras prisioneras, con una opacidad de relleno de 0.5 por defecto para indicar su estado. Pueden aplicarse otras opciones de |\stone|, como color o tamaño.

\end{key}