\section{Piedras, jugadas y prisioneros}
\label{sec:piedras}

Las piedras se dibujan con |\stone| y |\stones|; las jugadas, con |\moves|, y los prisioneros, con |\prisoner| y |\prisoners|.

\subsection{Piedras}

\begin{command}{\stone\opt{\oarg{options}}\marg{intersection}}
	Dibuja una piedra en la intersección (por ejemplo, |C2|). Las opciones cambian su estilo: el color, el tamaño, una marca, etc. Si no se indica el jugador (|b|, |w| o |n|), la piedra es \emph{neutral}.
\end{command}


\begin{command}{\stones\opt{\oarg{options}}\marg{intersection \opt{, intersection, ...}}}
	Como |\stone|, pero con varias intersecciones, escritas con la sintaxis de coordenadas (pág.~\pageref{subsec:sintaxis-de-coordenadas}). Si no se indica el jugador, las piedras también son \emph{neutrales}: para piedras negras hay que escribir |\stones[b]{...}|.
\end{command}

Las piedras, marcas y etiquetas que caen fuera de la región visible de un tablero parcial no se dibujan. Una coordenada que no existe en el tablero (por ejemplo, |E9| en un tablero de 5$\times$5) se ignora y produce una advertencia.

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{options} (default true)}
	Opciones del relleno de la piedra.
\end{key}

\begin{key}{/pgfgo/stone/fill/true}
	Dibuja el relleno.
\end{key}

\begin{key}{/pgfgo/stone/fill/false}
	No dibuja el relleno.

	\begin{codeexample}[]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {5, partial = B2:D4}}

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

		% Lo que se ve en la figura es lo que queda de la piedra: sombras y brillos.
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w, fill = false]{B4}
		\end{goban}
	\end{codeexample}
\end{key}


\begin{key}{/pgfgo/stone/fill/color = \meta{color}}	
	Color del relleno.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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)}
	
	Opacidad del relleno.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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} (default true, initially true)}
	Opciones del borde de la piedra.
\end{key}

\begin{key}{/pgfgo/stone/line/true}
	Dibuja el borde.

	\begin{codeexample}[]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {5, partial = B2:D4}}

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

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

\begin{key}{/pgfgo/stone/line/false}
	No dibuja el borde.
\end{key}

\begin{key}{/pgfgo/stone/line/color = \meta{color} (initially black)}
	
	Color del borde.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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)}
	
	Opacidad del borde.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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.7pt)}
	
	Grosor del borde.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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 5.5pt)}
	
	Radio de la piedra.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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)}
	
	Escala la piedra entera: el radio, el borde y las marcas.

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\stones[b, mark = circle]{C2}
			\stones[b, scale = 0.7, mark = circle]{D3}
			\stone[w, scale = 1.3, mark = triangle]{B4}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/black}
	
	La piedra es del primer jugador, con su estilo. Sin |black| (o |b|), |\stone| y |\stones| dibujan piedras neutrales.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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|.
\end{key}

\begin{key}{/pgfgo/stone/white}
	
	La piedra es del segundo jugador, con su estilo.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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|.
\end{key}

\begin{key}{/pgfgo/stone/neutral}
	La piedra es del jugador neutral. Es el jugador por defecto de |\stone| y de |\stones|.

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\stones[b]{C2}
			\stones[w]{D3}
			\stone{B4}
			\stone[n]{C3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/n}
	Abreviatura de «neutral».
\end{key}

\begin{key}{/pgfgo/stone/shadow = \meta{options} (default true)}
	Sombra de la piedra, dibujada debajo. Por defecto tiene la silueta de la piedra: el círculo, o la forma de la imagen si la piedra es una imagen (|image|). Con |shadow/image|, la sombra es una imagen propia. En los dos casos se corre |offset| hacia |angle| y se agranda |scale| veces.

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

		\begin{goban}
			\stones[b, shadow = {true, angle = -45, offset = 1.5pt}]{C2,D3}
			\stone[w, shadow = {true, angle = -45, offset = 1.5pt}]{B4}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shadow/true}
	Dibuja la sombra.
\end{key}

\begin{key}{/pgfgo/stone/shadow/false}
	No dibuja la sombra.
	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}

		\pgfgoset{players = {white = {stone = {shadow = false}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shadow/angle = \meta{float} (initially 0)}
	Hacia dónde cae la sombra, en grados: con |0|, a la derecha; con |-45|, abajo a la derecha. No gira la forma de la sombra.
	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}

		\pgfgoset{players = {white = {stone = {shadow = {angle = 225}}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shadow/offset = \meta{dimension} (initially 1pt)}
	Cuánto se corre la sombra respecto del centro de la piedra, en la dirección |angle|.
	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}

		\pgfgoset{players = {white = {stone = {shadow = {offset = 0.125cm}}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shadow/opacity = \meta{float} (initially 0.5)}
	Opacidad de la sombra (también la de la sombra con imagen).
	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}

		\pgfgoset{players = {white = {stone = {
			shadow = {offset = 0.125cm, opacity = 0.1}}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shadow/color = \meta{color} (initially black)}
	El color de la sombra. Una sombra con imagen tiene sus propios colores, salvo con |image/silhouette|.

	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}
		\pgfgoset{players = {white = {stone = {
			shadow = {color = blue, offset = 0.1cm}}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shadow/scale = \meta{float} (initially 1)}
	Agranda (o achica) la sombra respecto de la piedra. Una sombra más grande que la piedra la hace parecer más alta. También agranda la sombra con imagen.

	\begin{codeexample}[width=4cm]
		\pgfgoset{goban = {partial = A1:C3, scale = 2}}

		\begin{goban}
			\stone[b, shadow = {true, angle = -45}]{A1}
			\stone[b, shadow = {true, angle = -45,
				scale = 1.3}]{C2}
			\stone[w, shadow = {true, offset = 0pt,
				scale = 1.3, color = red}]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shadow/image = \meta{options}}
	Una sombra propia: una imagen con transparencia (PNG o PDF), centrada en la piedra y dibujada tal cual en lugar de la silueta, por ejemplo una sombra difusa. Se corre y se agranda como la silueta (|angle|, |offset|, |scale|) y usa |opacity|, pero no |color|. No gira con la imagen de la piedra (|stone/image/rotate|), así que cae siempre hacia el mismo lado. Cada archivo se guarda una sola vez en el PDF.

	\begin{codeexample}[width=4cm]
		\pgfgoset{goban = {partial = A1:C3, scale = 2}}
		\pgfgoset{stone = {shadow = {true, angle = -45,
			offset = 1.5pt, opacity = 0.8,
			image = {file = pgfgo-shadow.png, width = 13pt}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shadow/image/file = \meta{file}}
	El archivo de la imagen. Se busca como con |\includegraphics|.
\end{key}

\begin{key}{/pgfgo/stone/shadow/image/width = \meta{dimension} (initially el diámetro de la piedra)}
	El ancho de la imagen; el alto mantiene la proporción.
\end{key}

\begin{key}{/pgfgo/stone/shadow/image/rotate = \meta{ángulo} (initially 0)}
	Gira la imagen de la sombra, igual en todas las piedras.
\end{key}

\begin{key}{/pgfgo/stone/shadow/image/silhouette = \meta{boolean} (default true, initially false)}
	Usa solo la forma de la imagen (su transparencia), pintada con |shadow/color|, en lugar de la imagen tal cual. Necesita pdf\LaTeX\ o Lua\LaTeX\ con salida PDF; con otros motores la sombra no se dibuja y aparece un aviso.

	\begin{codeexample}[width=4cm]
		\pgfgoset{goban = {partial = A1:C3, scale = 2}}
		\pgfgoset{stone = {shadow = {true, angle = -45,
			offset = 2pt, color = blue,
			image = {file = pgfgo-star.pdf, width = 16pt,
				rotate = 18, silhouette}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{stylekey}{/pgfgo/stone/shadow/image/false}
	Quita la imagen: vuelve la silueta de la piedra.
\end{stylekey}

\begin{key}{/pgfgo/stone/shine = \meta{options} (default true)}
	Brillo de la piedra, dibujado encima de ella, sea un círculo o una imagen.

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

		\begin{goban}
			\stones[b, shine]{C2,D3}
			\stone[w, shine = {true, color = gray}]{B4}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shine/true}
	Dibuja el brillo.
\end{key}

\begin{key}{/pgfgo/stone/shine/false}
	No dibuja el brillo.
	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}

		\pgfgoset{players = {black = {stone = {shine = false}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shine/angle = \meta{float} (initially 0)}
	Gira el brillo dibujado. Con |0|, la luz viene de arriba a la izquierda.
	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}

		\pgfgoset{players = {black = {stone = {shine = {angle = 45}}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shine/opacity = \meta{float} (initially 1)}
	Opacidad del brillo (también la del brillo con imagen).
	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}

		\pgfgoset{players = {black = {stone = {shine = {opacity = 0.5}}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shine/color = \meta{color} (initially gray!50!white)}
	Color del brillo dibujado.

	\begin{codeexample}[width=4cm]
		\pgfgoset{profile = pgfgosmooth}
		\pgfgoset{goban = {partial = A1:C3}}
		\pgfgoset{players = {black = {stone = {shine = {color = red}}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shine/image = \meta{options}}
	Un brillo propio: una imagen con transparencia (PNG o PDF), centrada en la piedra, en lugar del brillo dibujado. Si la piedra también es una imagen, el brillo se dibuja encima y no gira con ella (|stone/image/rotate|): las piedras pueden tener vetas giradas al azar y la luz siempre del mismo lado. Cada archivo se guarda una sola vez en el PDF.

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\stones[w, image = {file = pgfgo-yunzi-white-1.png, rotate = random},
				shine = {true, image = {file = pgfgo-shine.png}}]{B2, C2, D2, B3, C3, D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shine/image/file = \meta{file}}
	El archivo de la imagen. Se busca como con |\includegraphics|.
\end{key}

\begin{key}{/pgfgo/stone/shine/image/width = \meta{dimension} (initially el diámetro de la piedra)}
	El ancho de la imagen; el alto mantiene la proporción.
\end{key}

\begin{key}{/pgfgo/stone/shine/image/rotate = \meta{ángulo} (initially 0)}
	Gira la imagen del brillo, igual en todas las piedras.

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\stones[w, image = {file = pgfgo-yunzi-white-1.png},
				shine = {true, image = {file = pgfgo-shine.png, width = 0.3cm,
					rotate = 90}}]{B2:D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/shine/image/silhouette = \meta{boolean} (default true, initially false)}
	Usa solo la forma de la imagen (su transparencia), pintada con |shine/color|, en lugar de la imagen tal cual. Necesita pdf\LaTeX\ o Lua\LaTeX\ con salida PDF; con otros motores el brillo no se dibuja y aparece un aviso.

	\begin{codeexample}[width=4cm]
		\pgfgoset{goban = {partial = A1:C3, scale = 2}}
		\pgfgoset{players = {black = {stone = {shine = {true,
			color = red, image = {file = pgfgo-shine.png, silhouette}}}}}}

		\begin{goban}
			\stones[b]{B1,C2}
			\stone[w]{A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{stylekey}{/pgfgo/stone/shine/image/false}
	Quita la imagen: vuelve el brillo dibujado.
\end{stylekey}


\label{subsec:piedrasimagen}\begin{key}{/pgfgo/stone/image = \meta{options}}
	Dibuja la piedra con una imagen (PNG, JPG o PDF) en lugar del círculo: no se dibujan el relleno ni el borde, y la imagen no tiene por qué ser redonda. Si el brillo (|shine|) está prendido, se dibuja encima de la imagen. La sombra (|shadow|) se dibuja con la forma de la imagen; para eso la imagen tiene que tener transparencia (un PNG con canal alfa o un PDF): la sombra de un JPG es un rectángulo. Un prisionero con imagen se ve translúcido, como cualquier prisionero.

	Los archivos se buscan como con |\includegraphics| (por ejemplo, en las carpetas de |\graphicspath|) y, si no están, entre las imágenes que trae \pgfgoname, junto a |pgf-go.sty| (las de los perfiles |shell|, |yunzi| y |baduktv|, pág.~\pageref{subsec:perfilshell}). Cada archivo, con cada tamaño, se guarda una sola vez en el PDF, por más piedras que lo usen (pág.~\pageref{subsubsec:imagenespdf}). La sombra con la forma de la imagen necesita pdf\LaTeX\ o Lua\LaTeX\ (con salida PDF); con otros motores la piedra se dibuja sin sombra y con un aviso.

	Un nombre de archivo con coma va entre llaves dobles, |file = {{a,b.png}}|; con llaves simples, la coma separa dos archivos. Como con |\includegraphics|, el nombre no puede tener |&|, |#|, |%|, |$|, |{| ni |}|, ni dos espacios seguidos.

	Las imágenes SVG no se pueden usar directamente: hay que convertirlas antes a PDF, por ejemplo con Inkscape o con rsvg-convert. Lo mismo vale para el fondo, la cuadrícula, los puntos de estrella y las marcas.

	\begin{codeexample}[code only]
		inkscape --export-type=pdf piedra.svg
		rsvg-convert -f pdf -o piedra.pdf piedra.svg
	\end{codeexample}

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

		\begin{goban}
			\stones[b, image = {file = pgfgo-yunzi-black.png},
				shadow = {true, angle = -45, offset = 1.5pt}]{C2,D3}
			\stone[w, image = {file = pgfgo-yunzi-white-1.png},
				shadow = {true, angle = -45, offset = 1.5pt}]{B4}
		\end{goban}
	\end{codeexample}

	Para todas las piedras de un jugador, la imagen se da en sus opciones:

	\begin{codeexample}[]
		\pgfgoset{players = {
			black = {stone = {image = {file = pgfgo-yunzi-black.png}}},
			white = {stone = {image = {file = pgfgo-yunzi-white-1.png}}}}}

		\begin{goban}[5, partial = B2:D4]
			\moves[numbers = false]{C3, D3, C2, B3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/image/file = \meta{file \opt{, file, ...}}}
	El archivo de la imagen. Con varios archivos, cada piedra usa uno, elegido por su posición: una piedra en un punto muestra siempre la misma imagen, en todos los diagramas.

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\stones[w, image = {file = {pgfgo-yunzi-white-1.png, pgfgo-yunzi-white-2.png}}]{B2, C2, D2, B3, C3, D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/image/width = \meta{dimension} (initially el diámetro de la piedra)}
	El ancho de la imagen; el alto mantiene la proporción. Por defecto es el diámetro de la piedra: $2 \times$ |radius| $\times$ |scale|.
\end{key}

\begin{key}{/pgfgo/stone/image/rotate = \meta{ángulo}, |random| o \meta{mínimo}|:|\meta{máximo} (initially 0)}
	Gira la imagen \meta{ángulo} grados, en sentido antihorario. Con |random|, cada piedra se gira un ángulo distinto, elegido por su posición: una piedra en un punto queda siempre igual, en todos los diagramas y en todos los cuadros de una animación. La sombra gira con la imagen, pero sigue cayendo hacia el mismo lado.

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\stones[w, image = {file = pgfgo-yunzi-white-1.png,
				rotate = random}]{B2, C2, D2, B3, C3, D3}
		\end{goban}
	\end{codeexample}

	Con un rango \meta{mínimo}|:|\meta{máximo}, el ángulo se elige igual que con |random|, pero entre \meta{mínimo} y \meta{máximo} grados (|random| es lo mismo que |0:360|).

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\stones[w, image = {file = pgfgo-yunzi-white-1.png,
				rotate = -20:20}]{B2, C2, D2, B3, C3, D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/stone/image/opacity = \meta{float} (initially 1)}
	La opacidad de la imagen.

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\stones[b, image = {file = pgfgo-yunzi-black.png}]{C2}
			\stones[b, image = {file = pgfgo-yunzi-black.png, width = 8pt}]{D3}
			\stone[w, image = {file = pgfgo-yunzi-white-1.png, opacity = 0.5}]{B4}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{stylekey}{/pgfgo/stone/image/false}
	Quita la imagen: la piedra vuelve a ser un círculo.
\end{stylekey}

\begin{key}{/pgfgo/stone/mark = \meta{mark keys}}
	
	Una marca sobre la piedra, con las opciones de |\mark| (pág.~\pageref{sec:marcas}): |mark = triangle|, |mark = {circle, line = {color = red}}|.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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}

	|resume| no trae esta piedra (p.~\pageref{subsec:recordar}). Queda en la memoria del |goban| con nombre: |\pgfgoview| la muestra con |forgotten|.

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

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

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

\begin{key}{/pgfgo/stone/prisoner=\meta{prisoner options} (default fill opacity = 0.5)}
	
	La piedra es un prisionero: por defecto, con el relleno a media opacidad. Las opciones que se agreguen se aplican después del estilo de los prisioneros (|/pgfgo/prisoner| y el del jugador).

	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2: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}

	En las opciones de un jugador (|\pgfgoset{players = {white = {stone = {prisoner = ...}}}}|), es el estilo de sus prisioneros: los de |\prisoner|, |\prisoners| y la \emph{key} |prisoner| de |\stone| y |\stones|, y las piedras capturadas con |captures = fade|. Se aplica después de la opacidad de relleno 0.5 y de |/pgfgo/prisoner|, y antes de las opciones de la piedra. Las demás piedras del jugador no cambian.

	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		\pgfgoset{players = {white = {stone = {prisoner = {line = {color = red}}}}}}

		\begin{goban}
			\stones[w]{B3}
			\prisoner[b]{C3}
			\prisoner[w]{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\subsubsection{Imágenes y tamaño del PDF}
\label{subsubsec:imagenespdf}

Con pdf\LaTeX\ o Lua\LaTeX\ (con salida PDF), cada imagen (de las piedras, el fondo, la cuadrícula, los hoshi, las marcas, el brillo o la sombra) se guarda en el PDF una sola vez, la primera vez que se usa; después, en todo el documento, cada piedra o baldosa que la usa solo la nombra. Una partida dibujada con |profile = shell| guarda la madera, las seis piedras y la sombra una vez, aunque tenga cientos de piedras repartidas en muchos diagramas. Girar una imagen (|rotate|) no agrega otra copia, y la sombra con la forma de la imagen (también con |silhouette|) usa la misma copia. Lo que sí agrega una copia es otro tamaño: la misma imagen con otro |width|, o en tableros con otro |scale| (por ejemplo, con |fit|), se guarda una vez por cada tamaño. Con otros motores (Xe\LaTeX, o salida DVI), la imagen se incluye cada vez que se usa, y el PDF crece con cada piedra.

Las piedras dibujadas, sin imagen, no se guardan así: cada una es un círculo y unas pocas instrucciones de dibujo, casi lo mismo que nombrar una copia guardada. Una piedra vectorial más elaborada (degradados, vetas dibujadas) puede hacerse en un PDF y usarse con |stone/image|: se ve nítida con cualquier escala y se guarda una sola vez, como las demás imágenes.





\subsection{Movimientos}
\label{subsec:movimientos}

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

	Juega las intersecciones en el orden en que se escriben, alternando negras y blancas, y las numera (|numbers|). Una intersección puede repetirse (por ejemplo, para retomar un ko con |captures|). Acepta la sintaxis de |\stones| (pág.~\pageref{subsec:sintaxis-de-coordenadas}) y juega cada elemento en su orden (pág.~\pageref{subsec:orden-coordenadas}): un camino (|A1 -- A3 -- C3|) va de su primer punto al último, y un segmento, del primer extremo al segundo (|C:A 4| va de C4 a A4; |C5:1|, de C5 a C1). Lo que no tiene un recorrido fijo (rectángulos, |r|, columnas y filas enteras, |*|) se juega igual, con un aviso. Los grupos sustractivos (|;|) dan error: |\moves| solo agrega jugadas.

	\begin{codeexample}[]
		\begin{goban}[5]
			\moves{B1 -| D3, C:A 4, E5}
		\end{goban}
	\end{codeexample}
\end{command}

Dentro de un mismo |goban|, la numeración y el turno continúan de un |\moves| al siguiente. Cada |goban| nuevo empieza en la jugada 1 con negras; para continuar una partida en otro diagrama, se usan |from| y |b| o |w|, o bien |resume|.

Las opciones de |\moves| también aceptan las del estilo de la piedra (|fill|, |line|, |radius|, |shine|, |image|, etc.) y |mark|, como |\stones|. Por ejemplo, para marcar la última jugada:

\begin{codeexample}[]
	\begin{goban}[5, partial = B2:D4]
		\moves[numbers = false]{C3, D3, C2}
		\moves[numbers = false, mark = circle]{B3}
	\end{goban}
\end{codeexample}

Es posible cambiar las opciones de todos los jugadores mediante |\pgfgoset{move = {...}}| que es equivalente a |\pgfgoset{players = {all = {move = {...}}}}|, salvo |numbers|, que no es de un jugador: vale para todas las jugadas.

\begin{key}{/pgfgo/move/numbers=\meta{boolean} (default true, initially true)}

	Si las jugadas llevan su número. Sin números, las jugadas igual cuentan: la jugada siguiente sigue la numeración y el turno. Como opción de |\moves| vale para esas jugadas; con |\pgfgoset{move = {numbers = false}}| o |\begin{goban}[move = {numbers = false}]|, para todas las que siguen.

	\begin{codeexample}[]
		\begin{goban}[5, partial = B2:D4]
			\moves[numbers = false]{C3, D3}
			\moves{C2, B3}
		\end{goban}

		\begin{goban}[5, partial = B2:D4, move = {numbers = false}]
			\moves{C3, D3}
			\moves[numbers]{C2, B3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/black}
	
	La secuencia empieza con negras.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\begin{goban}
			\moves[numbers = false, b]{C2,B4}
			\moves[numbers = false]{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/white}
	
	La secuencia empieza con blancas.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\begin{goban}
			\moves[numbers = false, white]{C2,B4}
			\moves[numbers = false]{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/b}
	Abreviatura de |black|.
\end{key}

\begin{key}{/pgfgo/move/w}
	Abreviatura de |white|.
\end{key}

\begin{key}{/pgfgo/move/from = \meta{number}}
	
	Número de la primera jugada de la secuencia.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\begin{goban}
			\moves[from = 7]{C2,B4}
			\moves{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label = \meta{options}}
	
	Opciones de los números de las jugadas.

	\begin{codeexample}[width=4cm]
		\pgfgoset{players = {white = {move = {label = {
			color = red, font = \itshape, font size = 6pt, opacity = 0.6}}}}}

		\begin{goban}[3]
			\moves{A1, B2, C3, A3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/font = \meta{font commands} (initially \texttt{\string\bfseries})}
	Fuente de los números.
\end{key}

\begin{key}{/pgfgo/move/label/font size=\meta{dimension} (initially automático)}

	Tamaño de los números. Si no se indica, se ajusta solo según la cantidad de cifras.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\begin{goban}
			\moves[from = 7]{C2,B4}
			\moves[label = {font size = 0.5em}]{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format = \meta{options} (initially arabic)}
	
	Formato de los números: |arabic|, |alph|, |Alph|, |roman|, |Roman| o |kanji|.
\end{key}

\begin{key}{/pgfgo/move/label/format/arabic}
	
	Números arábigos. Es el valor inicial.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\begin{goban}
			\moves[from = 7]{C2,B4}
			\moves{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/alph}
	
	Letras minúsculas.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\pgfgoset{move={label = {format=alph}}}
		\begin{goban}
			\moves[from = 7]{C2,B4}
			\moves{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/Alph}
	
	Letras mayúsculas.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\pgfgoset{move = {label = {format = Alph}}}
		\begin{goban}
			\moves[from = 7]{C2,B4}
			\moves{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/roman}
	
	Números romanos en minúscula.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\pgfgoset{move = {label = {format = roman}}}
		\begin{goban}
			\moves{C2,B4}
			\moves{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/Roman}
	
	Números romanos en mayúscula.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\stones[b]{C2,D3}
			\stone[w]{B4}
		\end{goban}
		
		\pgfgoset{move = {label = {format = Roman}}}
		\begin{goban}
			\moves{C2,B4}
			\moves{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/format/kanji}
	Números en kanji ({\pgfgokanji 一, 二, …, 十, 十一, …, 百}), como los de |goban/label/columns = kanji|. Necesitan una fuente que los tenga, elegida con |label/font| (ver |/pgfgo/mark/label/format|, pág.~\pageref{key:kanji}).
\end{key}

\begin{key}{/pgfgo/move/label/color = \meta{color}}
	
	Color de los números.
	
	\begin{codeexample}[]
		\pgfgoset{goban = {5, partial = B2:D4}}
		
		\begin{goban}
			\moves{C2,B4}
			\moves{D3}
		\end{goban}
		
		\begin{goban}
			\moves[label = {color = red}]{C2,B4}
			\moves[label = {color = blue}]{D3}
		\end{goban}
	\end{codeexample}
\end{key}

\begin{key}{/pgfgo/move/label/opacity = \meta{float} (initially 1)}
	Opacidad de los números.
\end{key}

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

	Con |resume = {..., numbers}|, esta jugada viene sin su número (p.~\pageref{subsec:recordar}). Con |\pgfgoview|, el número solo se ve con |forgotten|.

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

		\begin{goban}[name = a]
			\moves{C2}
			\moves[label = forget]{B4}
			\moves{D3}
		\end{goban}

		\begin{goban}[resume = {a, numbers}]
			\moves{C:D4}
		\end{goban}
	\end{codeexample}
\end{key}

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

	|resume| no trae estas jugadas, ni la piedra ni el número. La numeración sigue desde la última jugada que trae.
\end{key}


\subsection{Prisioneros}

Los prisioneros son piedras capturadas que siguen en el tablero; por defecto se dibujan translúcidos.

\begin{command}{\prisoner\opt{\oarg{options}}\marg{intersection}}
	
	Dibuja un prisionero en la intersección. Acepta las opciones de |\stone|.
\end{command}

\begin{command}{\prisoners\opt{\oarg{options}}\marg{intersection \opt{, intersection, ...}}}
	
	Como |\prisoner|, con varias intersecciones.
\end{command}

\begin{key}{/pgfgo/prisoner=\meta{stone options} (default fill opacity = 0.5)}
	
	Estilo de los prisioneros: por defecto, el relleno con opacidad 0.5. Acepta las opciones de |\stone|. Vale para los prisioneros de los tres jugadores; el estilo de cada uno (|stone/prisoner| en las opciones del jugador) va después.

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

		\begin{goban}
			\stones[b]{C2}
			\prisoners[b]{D3}
			\prisoner[w]{B4}
		\end{goban}

		\pgfgoset{prisoner = {fill = {opacity = 0.2}, line = {color = red}}}

		\begin{goban}
			\stones[b]{C2}
			\prisoners[b]{D3}
			\prisoner[w]{B4}
		\end{goban}
	\end{codeexample}
\end{key}