\section{El tablero}
\label{sec:tablero}

Cuando hablamos de «tablero», nos referimos al entorno |goban|: la cuadrícula, el fondo, las coordenadas y todo lo que se dibuja encima.

\begin{environment}{{goban}\opt{\oarg{options}}}
	
	Inicializa el entorno del goban. Por defecto, dibuja un tablero cuadrado de 9×9 intersecciones, con un borde visible, fondo blanco y sin etiquetas en los laterales.
	
	\begin{codeexample}[width=5cm]
		\begin{goban}
		\end{goban}
	\end{codeexample}
	
	|goban| es un |tikzpicture|, así que adentro se puede dibujar con \tikzname. Cada intersección es un punto de su sistema de coordenadas, con A1 en |(1,1)|, o se escribe como en los comandos, con |(go cs:A1)| (pág.~\pageref{subsec:tikz}).
	
	\begin{codeexample}[width=5.85cm]
		\begin{goban}[19, partial = K1:T9,
			label = {at = {north, east}}]
			\stones[b] {L8,S8,R5,S5,P4,R4,M3,P3,N2,O2}
			\mark[black, circle] {L8}
			\stones[white] {L6,S4,S3,Q3,O1,P2,R2}
			
			\tikzset{flecha/.style = {-{latex[]}, line width = 2pt, blue}}
			\draw[flecha] (12,8)--(17,8);
		\end{goban}
	\end{codeexample}
	
	\label{subsec:usei}\begin{key}{/pgfgo/goban/use i=\meta{boolean} (default true, initially false)}
		
		Usa la letra «I» en las coordenadas y en las etiquetas del tablero. Por defecto no se usa, como es costumbre en el go: las columnas pasan de la «H» a la «J», y cualquier referencia a «I» se interpreta como «J».
		
		\begin{codeexample}[]
			\pgfgoset{goban = {13, label = {at = north}}}
			
			\begin{goban}[use i, label = {at = west}, partial = H1:M3]
				\stone[b]{J2}
			\end{goban}
			
			\begin{goban}[partial = H1:N3]
				\stone[b]{J2}
			\end{goban}
			
			\begin{goban}[label = {at = east}, partial = H1:N3]
				\stone[white, mark = {custom = !}] {I2} % Si es I, entonces pasa a J.
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/size=\meta{nlines or nlines |x| nlines} (initially 9)}
		
		Define el número de líneas verticales y horizontales del tablero. Puede omitirse la palabra «size» y especificarse directamente el valor. Si se indica un único entero (como |9|), el tablero será cuadrado (9×9). Si se usa una expresión como |5x3|, se creará un tablero rectangular de 5 columnas por 3 filas.
		
		\begin{codeexample}[width=6.5cm]
			\begin{goban}[5]
			\end{goban}
			
			\begin{goban}[5x3]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/sgf size=\meta{file}}
		Toma el tamaño del tablero de una partida SGF (su propiedad |SZ|). Solo con el kernel en Lua (pág.~\pageref{subsec:kernel}).

		\begin{codeexample}[]
			\begin{goban}[sgf size = variantes, label = {at = {north, west}}]
				\sgf{variantes}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/sgf view=\meta{file}}
		Como |sgf size| y, si el archivo tiene vista (|VW|), muestra solo esa parte del tablero, como |partial|. La vista puede cambiar durante la partida; se usa la de la jugada |sgf view move|.
	\end{key}

	\begin{key}{/pgfgo/goban/sgf view move=\meta{number} (initially 0)}
		La jugada de la que |sgf view| toma la vista. Un |VW| vale desde la jugada de su nodo (o desde la siguiente, si el nodo no tiene jugada) hasta el próximo |VW|, y |VW[]| vuelve a mostrar todo el tablero. Con 0, es la vista del principio. Puede ir antes o después de |sgf view|. |\sgfdiagrams|, |\sgfanimation| y |\sgfproblem| eligen la vista solos.

		\begin{codeexample}[code only]
			\begin{goban}[sgf view = partida, sgf view move = 120]
				\sgf[from = 101, to = 120]{partida}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/scale=\meta{float} (initially 1)}
		
		Escala del tablero: las medidas y también el grosor de las líneas.
		
		\begin{codeexample}[width=5.5cm]
			\begin{goban}[2, scale = 2]
				\stone[b, mark]{A1}
			\end{goban}
			
			\begin{goban}[2, scale = 1]
				\stone[b, mark]{A1}
			\end{goban}
			
			\begin{goban}[2, scale = 0.5]
				\stone[b, mark]{A1}
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\subsection{Cuadrícula}
	
	La cuadrícula son las líneas del tablero.
	
	\begin{key}{/pgfgo/goban/grid=\meta{options} (default true)}
		Opciones de la cuadrícula.
	\end{key}
	
	\begin{stylekey}{/pgfgo/goban/grid/true}

		Vuelve a dibujar la cuadrícula después de un |grid = false| (por ejemplo, uno global hecho con |\pgfgoset|).
	\end{stylekey}

	\begin{stylekey}{/pgfgo/goban/grid/false}
		
		Quita la cuadrícula y los puntos de estrella.
		
		\begin{codeexample}[]
			\begin{goban}[3]
				\stone[b]{A1}
				\stone[w]{B2}
			\end{goban}
			
			\begin{goban}[3, grid = false]
				\stone[b]{A1}
				\stone[w]{B2}
			\end{goban}
		\end{codeexample}
		
		El primer tablero muestra la cuadrícula por defecto.
	\end{stylekey}
	
	\begin{key}{/pgfgo/goban/grid/line=\meta{options} (default true)}
		Opciones de las líneas de la cuadrícula.
	\end{key}

	\begin{stylekey}{/pgfgo/goban/grid/line/true}
		Dibuja las líneas. Es el valor inicial.
	\end{stylekey}

	\begin{stylekey}{/pgfgo/goban/grid/line/false}
		No dibuja las líneas, pero sí los puntos de estrella (a diferencia de |grid = false|).

		\begin{codeexample}[]
			\begin{goban}[9, grid = {line = false}, hoshi = {radius = 2pt}]
				\stones[b]{C3, E5}
			\end{goban}
		\end{codeexample}
	\end{stylekey}
	
	\begin{key}{/pgfgo/goban/grid/line/color =\meta{color} (initially black)}
		
		Color de las líneas de la cuadrícula.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[grid = {line = {color = blue}}, name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[grid = {line = {color = red}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/grid/line/opacity =\meta{float} (initially 1)}
		
		Opacidad de las líneas de la cuadrícula.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[grid = {line = {opacity = 0.2}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/grid/line/width =\meta{dimension} (initially 0.55pt)}
		
		Grosor de las líneas de la cuadrícula.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[grid = {line = {width = 1.5pt}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/grid/x sep =\meta{dimension} (initially 1.25em)}
		Separación entre las líneas verticales.
	\end{key}
	
	\begin{key}{/pgfgo/goban/grid/y sep =\meta{dimension} (initially 1.25em)}
		Separación entre las líneas horizontales.
	\end{key}
	
	\begin{key}{/pgfgo/goban/grid/sep =\meta{dimension} (initially 1.25em)}
		Las dos separaciones a la vez.

		\begin{codeexample}[]
			\begin{goban}[5, grid = {x sep = 1.8em}]
				\stones[b]{B2, C3}
				\stone[w]{D3}
			\end{goban}

			\begin{goban}[5, grid = {sep = 0.9em}]
				\stones[b]{B2, C3}
				\stone[w]{D3}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/grid/image =\meta{options}}
		Dibuja una imagen en lugar de las líneas de la cuadrícula, con la opacidad de |grid/line/opacity|. Con |partial| se ve la parte que corresponde. Los puntos de estrella se siguen dibujando (ver |hoshi|).

		\begin{codeexample}[]
			\begin{goban}[9, grid = {image = {file = pgfgo-grid.png}}, hoshi = false]
				\stones[b]{C3}\stone[w]{D4}
			\end{goban}

			\begin{goban}[9, grid = {image = {file = pgfgo-grid.png}}, hoshi = false, partial = C3:G7]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/grid/image/file =\meta{file \opt{, file, ...}}}
		El archivo de la imagen. Con varios archivos y |fit = tile|, cada baldosa usa uno, elegido por su lugar en la malla: siempre el mismo en cada lugar, en todos los diagramas. Con |fit = stretch|, se usa el primero.

		\begin{codeexample}[]
			\begin{goban}[5, hoshi = false,
				grid = {image = {file = {pgfgo-cell.png, pgfgo-tile.png}, fit = tile}}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/grid/image/fit =\meta{stretch o tile} (initially stretch)}
		Con |stretch|, la imagen se estira desde A1 hasta la esquina opuesta del tablero completo, así que las líneas exteriores tienen que estar en los bordes de la imagen. Con |tile|, se dibuja una vez en cada casilla de la cuadrícula (entre cuatro intersecciones), estirada al tamaño de la casilla: con la imagen de un cuadrado se arma todo el tablero.

		\begin{codeexample}[]
			\begin{goban}[9, grid = {image = {file = pgfgo-cell.png, fit = tile}}, hoshi = false]
				\stones[b]{C3}\stone[w]{D4}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/grid/image/tiles =\meta{columnas}|x|\meta{filas} (initially una por casilla)}
		Con |fit = tile|, la malla en la que se repite la imagen, sobre el área que va de A1 a la esquina opuesta del tablero completo; cada imagen se estira al tamaño de su celda. Un solo número vale para las dos direcciones. Sin esta \emph{key}, hay una imagen por casilla.

		\begin{codeexample}[]
			\begin{goban}[9, grid = {image = {file = pgfgo-cell.png, fit = tile, tiles = 4}}, hoshi = false]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/grid/image/rotate =\meta{ángulo}, |random| o \meta{mínimo}|:|\meta{máximo} (initially 0)}
		Gira la imagen, como |background/fill/image/rotate|: en cuartos de vuelta, y con |random| o un rango, cada baldosa con el suyo.
	\end{key}

	\begin{stylekey}{/pgfgo/goban/grid/image/false}
		Quita la imagen: vuelven las líneas.
	\end{stylekey}

	\subsection{Puntos de estrella}
	\label{subsec:hoshi}

	Los puntos de estrella (\emph{hoshi}) se dibujan sobre la cuadrícula, con su color. Por defecto son los de siempre: en cada lado, la cuarta línea desde el borde (la tercera en los tableros de menos de 13 líneas); el centro si el tamaño es impar; y, desde 15 líneas, el medio de los lados. En un tablero de 19 hay nueve, y en uno de 13 o de 9, cinco. Los tableros de menos de 7 líneas no tienen. Las piedras los tapan.

	\begin{key}{/pgfgo/goban/hoshi=\meta{options} (default true)}
		Opciones de los puntos de estrella.

		\begin{codeexample}[]
			\begin{goban}[9]
				\stones[b]{C3, E5}
			\end{goban}

			\begin{goban}[9, hoshi = false]
				\stones[b]{C3, E5}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{stylekey}{/pgfgo/goban/hoshi/true}
		Dibuja los puntos de estrella. Es el valor inicial.
	\end{stylekey}

	\begin{stylekey}{/pgfgo/goban/hoshi/false}
		No dibuja los puntos de estrella.
	\end{stylekey}

	\begin{key}{/pgfgo/goban/hoshi/radius=\meta{dimension} (initially 1.5pt)}
		Radio de los puntos.
	\end{key}

	\begin{key}{/pgfgo/goban/hoshi/color=\meta{color}}
		Color de los puntos. Sin esta \emph{key}, toman el color de la cuadrícula.

		\begin{codeexample}[]
			\begin{goban}[9, hoshi = {radius = 2.5pt, color = red}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/hoshi/opacity=\meta{float}}
		Opacidad de los puntos (también de su imagen). Sin esta \emph{key}, toman la opacidad de la cuadrícula.

		\begin{codeexample}[]
			\begin{goban}[9, hoshi = {radius = 3pt, opacity = 0.3}]
				\stones[b]{C3}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/hoshi/at=\meta{coordinates}}
		Elige los puntos, con la misma sintaxis que |\stones|. Vacío, se usan los de siempre.

		\begin{codeexample}[]
			\begin{goban}[9, hoshi = {at = {C3, G7}}]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/hoshi/image=\meta{options}}
		Dibuja una imagen en cada punto de estrella, en lugar del círculo.

		\begin{codeexample}[]
			\begin{goban}[9, hoshi = {image = {file = pgfgo-hoshi.png}, radius = 3pt}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/hoshi/image/file=\meta{file}}
		El archivo de la imagen.
	\end{key}

	\begin{key}{/pgfgo/goban/hoshi/image/width=\meta{dimension} (initially $2 \times$ |radius|)}
		El ancho de la imagen; el alto mantiene la proporción.
	\end{key}

	\begin{key}{/pgfgo/goban/hoshi/image/rotate=\meta{ángulo}, |random| o \meta{mínimo}|:|\meta{máximo} (initially 0)}
		Gira la imagen, como |stone/image/rotate| (pág.~\pageref{subsec:piedrasimagen}): con |random| o un rango, cada punto con un ángulo distinto, siempre el mismo.

		\begin{codeexample}[]
			\begin{goban}[9, hoshi = {image = {file = pgfgo-hoshi.png, width = 8pt}}]
			\end{goban}

			\begin{goban}[9, hoshi = {image = {file = pgfgo-hoshi.png, width = 8pt, rotate = 45}}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{stylekey}{/pgfgo/goban/hoshi/image/false}
		Quita la imagen: vuelven los círculos.
	\end{stylekey}

	\subsection{Borde}
	
	El fondo del tablero es el rectángulo que va debajo de la cuadrícula, con su relleno y su borde. Por defecto, el relleno es blanco y el borde, negro.
	
	\begin{key}{/pgfgo/goban/background=\meta{options} (default true)}
		Opciones del fondo y del borde.
	\end{key}
	
	\begin{stylekey}{/pgfgo/goban/background/true}

		Vuelve a dibujar el fondo y el borde después de un |background = false|.
	\end{stylekey}

	\begin{stylekey}{/pgfgo/goban/background/false}
		
		Quita el fondo: el relleno y el borde.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[background = false, resume = a]
			\end{goban}
		\end{codeexample}
	\end{stylekey}
	
	\begin{key}{/pgfgo/goban/background/fill=\meta{options} (default true)}
		Opciones del relleno.
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/fill=\meta{boolean} (initially true)}
		
		Con |false|, el fondo es transparente y queda solo el borde.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[background = {line = {color = red}}, name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[background = {line = false}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/fill/color =\meta{color} (initially white)}
		
		Color del relleno.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[background = {fill = {color = orange!40}}, name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[background = {fill = {color = olive!30}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/fill/opacity =\meta{float} (initially 1)}
		
		Opacidad del relleno.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[background = {fill = {color = orange!40}}, name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[resume = a,
				background = {fill = {color = orange!40}, fill = {opacity = 0.5}}]
			\end{goban}
		\end{codeexample}
		
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/fill/image =\meta{options}}
		Una imagen de fondo (por ejemplo, la madera de un tablero), sobre el color de relleno y con su misma opacidad. La imagen se ubica según el tablero completo: con |partial| se ve la parte que le corresponde, recortada por el borde y sus esquinas redondeadas. Las marcas sobre puntos vacíos, que tapan la cuadrícula con el color del fondo, muestran la parte de la imagen que hay debajo, y lo mismo hace la marca |dim|. El halo de las flechas y líneas sigue siendo del color del fondo.

		\begin{codeexample}[]
			\begin{goban}[9,
				background = {fill = {image = {file = pgfgo-board.jpg}}}]
				\stones[b]{C3}\stone[w]{D4}
				\marks[circle]{E5, C3}
			\end{goban}

			\begin{goban}[9, partial = A1:E5,
				background = {fill = {image = {file = pgfgo-board.jpg}},
					rounded corners = 6pt}]
				\marks[triangle]{C3}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/background/fill/image/file =\meta{file \opt{, file, ...}}}
		El archivo de la imagen de fondo. Con varios archivos y |fit = tile|, cada baldosa usa uno, elegido por su lugar: siempre el mismo en cada lugar, también con |partial|. Así el tablero no se ve repetido. Las baldosas tienen el tamaño de la primera imagen (o el de su celda, con |tiles|). Con |stretch| y |cover|, se usa el primero.

		\begin{codeexample}[]
			\begin{goban}[9, background = {fill = {image = {
				file = {pgfgo-tile.png, pgfgo-cell.png, pgfgo-board.jpg},
				fit = tile, width = 1cm}}}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/background/fill/image/fit =\meta{stretch, cover o tile} (initially cover)}
		Cómo ocupa la imagen el fondo del tablero completo. |stretch| la estira hasta ocupar todo el fondo, sin mantener la proporción. |cover| la agranda o la achica, manteniendo la proporción, hasta cubrir el fondo, centrada: lo que sobra no se ve. |tile| la repite como baldosas, desde una esquina, un borde o el centro del tablero completo (ver |anchor|).

		\begin{codeexample}[]
			\begin{goban}[9, background = {fill = {image = {
				file = pgfgo-tile.png, fit = tile, width = 1cm}}}]
			\end{goban}

			\begin{goban}[9, partial = D4:H8, background = {fill = {image = {
				file = pgfgo-tile.png, fit = tile, width = 1cm}}}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/background/fill/image/anchor =\meta{posición} (initially south west)}
		Con |fit = tile|, desde dónde se ponen las baldosas, en el fondo del tablero completo. Con una esquina (|south west|, |south east|, |north west| o |north east|), en esa esquina queda una baldosa entera. Con un borde (|north|, |south|, |east| o |west|), la primera baldosa queda contra ese borde, centrada a lo largo de él. Con |center|, una baldosa queda en el centro del tablero.

		\begin{codeexample}[]
			\begin{goban}[5, background = {fill = {image = {
				file = pgfgo-tile.png, fit = tile, width = 1cm, anchor = north east}}}]
			\end{goban}

			\begin{goban}[5, background = {fill = {image = {
				file = pgfgo-tile.png, fit = tile, width = 1cm, anchor = north}}}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/background/fill/image/width =\meta{dimension} (initially el ancho natural)}
		Con |fit = tile|, el ancho de cada baldosa; el alto mantiene la proporción.
	\end{key}

	\begin{key}{/pgfgo/goban/background/fill/image/tiles =\meta{columnas}|x|\meta{filas}}
		Con |fit = tile|, en lugar de baldosas de ancho |width| desde |anchor|, divide el fondo del tablero completo en esa malla y pone la imagen en cada celda, estirada a su tamaño. Un solo número vale para las dos direcciones.

		\begin{codeexample}[]
			\begin{goban}[9, background = {fill = {image = {
				file = pgfgo-cell.png, fit = tile, tiles = 3x3}}}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/background/fill/image/rotate =\meta{ángulo}, |random| o \meta{mínimo}|:|\meta{máximo} (initially 0)}
		Gira la imagen en cuartos de vuelta: el ángulo se redondea a 0, 90, 180 o 270 grados, para que la imagen girada siga ocupando su lugar sin dejar huecos. Con 90 o 270, el ancho y el alto se intercambian: con |cover| la imagen mantiene la proporción, pero una baldosa de ancho |width| que no es cuadrada queda estirada. Con |random| o un rango, como en |stone/image/rotate| (pág.~\pageref{subsec:piedrasimagen}), cada baldosa tiene su propio giro, siempre el mismo.

		\begin{codeexample}[]
			\begin{goban}[5, background = {fill = {image = {
				file = pgfgo-board.jpg, rotate = 90}}}]
			\end{goban}

			\begin{goban}[5, background = {fill = {image = {
				file = pgfgo-board.jpg, fit = tile, width = 1cm, rotate = random}}}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{stylekey}{/pgfgo/goban/background/fill/image/false}
		Quita la imagen de fondo.
	\end{stylekey}

	\begin{key}{/pgfgo/goban/background/line=\meta{options} (default true)}
		Opciones del borde.
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/line=\meta{boolean} (initially true)}
		Dibuja (|true|) o quita (|false|) el borde.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[background = {line = {color = red}}, name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[background = {line = false}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/line/color =\meta{color} (initially black)}
		
		Color del borde.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[background = {line = {color = red}}, name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[background = {line = {color = blue}}, resume = a]
			\end{goban}
		\end{codeexample}		
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/line/opacity =\meta{float} (initially 1)}
		
		Opacidad del borde.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[background = {line = {color = red}}, name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[resume = a,
				background = {line = {color = red}, line = {opacity = 0.5}}]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/line/width =\meta{dimension} (initially 0.75pt)}
		
		Grosor del borde.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[background = {line = {width = 1.5pt}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/rounded corners =\meta{dimension} (initially 0pt)}
		
		Radio de las esquinas del fondo. Con |0pt|, son rectas.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = A1:C3}}
			
			\begin{goban}[name = a]
				\stones[b]{B1,C2}
				\stone[w]{A3}
			\end{goban}
			
			\begin{goban}[background = {rounded corners = 10pt}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	
	\begin{key}{/pgfgo/goban/background/rounded corners/outer =\meta{dimension} (initially 0pt)}
		
		Solo el de las esquinas exteriores.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = A1:C3}}
			
			\begin{goban}[background = {rounded corners = 0pt}, name = a]
				\stones[b]{B1,C2}
				\stone[w]{A3}
			\end{goban}
			
			\begin{goban}[background = {rounded corners = {outer = 10pt}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	
	\begin{key}{/pgfgo/goban/background/rounded corners/inner =\meta{dimension} (initially 0pt)}
		
		Solo el de las esquinas interiores (se ven en los tableros parciales).
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = A1:C3}}
			
			\begin{goban}[background = {rounded corners = 0pt}, name = a]
				\stones[b]{B1,C2}
				\stone[w]{A3}
			\end{goban}
			
			\begin{goban}[resume = a,
				background = {rounded corners = {outer = 8pt, inner = 2pt}}]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/sep =\meta{dimension} (initially 0.825em)}
		
		Separación entre la cuadrícula y el borde. Por defecto, 1.5 veces el radio de las piedras.
		
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}
			
			\begin{goban}[background = {sep = 0.625em}, name = a]
				\stones[b]{C2,D3}
				\stone[w]{B4}
			\end{goban}
			
			\begin{goban}[background = {sep = 1.5em}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/background/shadow=\meta{options} (default true)}
		Dibuja una sombra debajo del tablero. Sin valor, la activa.
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}

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

			\begin{goban}[background = {shadow = {color = blue, opacity = 0.3}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/background/shadow=\meta{boolean} (initially false)}
		Activa (|true|) o desactiva (|false|) la sombra.
	\end{key}

	\begin{key}{/pgfgo/goban/background/shadow/angle =\meta{float} (initially -45)}
		Dirección de la sombra, en grados.
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}

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

			\begin{goban}[background = {shadow = {angle = 45}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/background/shadow/offset =\meta{dimension} (initially 1.5pt)}
		Distancia entre el tablero y su sombra.
		\begin{codeexample}[]
			\pgfgoset{goban = {5, partial = B2:D4}}

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

			\begin{goban}[background = {shadow = {offset = 4pt}}, resume = a]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/background/shadow/opacity =\meta{float} (initially 0.5)}
		Opacidad de la sombra.
	\end{key}

	\begin{key}{/pgfgo/goban/background/shadow/color =\meta{color} (initially black)}
		Color de la sombra.
	\end{key}

	\subsection{Tablero parcial}
	\label{subsec:parcial}
	
	Muchas veces no hace falta el tablero completo, sino solo una parte. La \emph{key} |partial| la define con dos esquinas opuestas de un rectángulo, en cualquier orden. Por ejemplo, |partial = A1:D3| es equivalente a |partial = D3:A1|.
	
	\begin{figure}[H]
		\centering
		
		\begin{tikzpicture}
			\node[anchor=north] (X) {
				\begin{goban}[label = {at = {north, west}}]
					\coordinate (A) at (4,6);
					\coordinate (B) at (9,9);
					\coordinate (C) at (A|-B);
					\coordinate (D) at (A-|B);
					
					\tikzset{punto/.style = {circle, fill = #1, draw, inner sep=0.25em, fill opacity=0.5, anchor=center}}
					
					\node[punto = red] at (A){};
					\node[punto = red] at (B){};
					\node[punto = blue] at (C){};
					\node[punto = blue] at (D){};
					
					\draw[red, {latex}-{latex}, shorten <=5pt, shorten >= 5pt] (A)--(B);
					\draw[blue, {latex}-{latex}, shorten <=5pt, shorten >= 5pt] (C)--(D);
					
					\node[fit=(A)(B), draw, inner sep=0.6em, rounded corners, line width=1pt, fill opacity=0.1, fill=orange] {};
				\end{goban}
			};
			
			\node[anchor=north, xshift=15em] {
				\tikz{
					\node[inner sep=0] (Y) {
						\begin{goban}[label = {at = {north, west}}, partial = J9:D6]
						\end{goban}
					};
					\node[align = left, anchor=north, inner sep=0, yshift=-1em] at (Y.south){
						{\color{blue}\texttt{partial = D9:J6}}\\
						{\color{blue}\texttt{partial = J6:D9}}\\
						{\color{red} \texttt{partial = D6:J9}}\\
						{\color{red} \texttt{partial = J9:D6}}\\
					};
				}
			};
		\end{tikzpicture}
	\end{figure}
	
	\begin{key}{/pgfgo/goban/partial=\meta{intersection}|:|\meta{intersection}, |auto| o |false|}
		Muestra solo una parte del tablero: el rectángulo que tiene esas dos intersecciones como esquinas opuestas, en cualquier orden. También puede escribirse |partial = {B2, D4}| o |partial = {B2 to D4}|. Con |auto|, la parte la elige el tablero: la que usan las piedras, jugadas, marcas, flechas, líneas y territorios que se dibujan, con |partial margin| líneas más. Lo que se dibuja directamente con \tikzname\ no cuenta. Con |false|, vuelve a mostrar el tablero completo (por ejemplo, después de un |partial| global hecho con |\pgfgoset|).
	\end{key}
	
	\begin{codeexample}[]
		\tikzset{flecha/.style = {-{latex[]}, line width = 1pt, red}}
		
		\begin{goban}[partial = A1:D3]
			\draw[flecha] (1,1)--(4,3); % Desde A1 hasta D3
		\end{goban}
		
		\begin{goban}[partial = A9:J6]
			\draw[flecha] (1,9)--(9,6); % Desde A9 hasta J6
		\end{goban}
		
		\begin{goban}[partial = E2:B4]
			\draw[flecha] (5,2)--(2,4); % Desde E2 hasta B4
		\end{goban}
	\end{codeexample}

	\begin{key}{/pgfgo/goban/partial margin=\meta{number} (initially 1)}
		Líneas que |partial = auto| agrega alrededor de lo dibujado. Un lado que queda a dos líneas o menos del borde llega hasta el borde. Sin nada dibujado, se ve todo el tablero.

		\begin{codeexample}[]
			\begin{goban}[19, partial = auto]
				\moves{Q16, R14, R16, P17}
			\end{goban}

			\begin{goban}[19, partial = auto, partial margin = 0]
				\stones[b]{J10, K11}\stones[w]{K9}
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\subsection{Etiquetas del tablero}
	
	Las etiquetas son las coordenadas que se escriben a los lados del tablero.
	
	\begin{key}{/pgfgo/goban/label=\meta{options} (default true)}
		Opciones de las etiquetas.
	\end{key}
	
	\begin{key}{/pgfgo/goban/label/true}
		Pone las letras abajo y los números a la izquierda: |A1| se lee desde la esquina inferior izquierda. Es lo mismo que |label = {at = {south, west}}|; para los cuatro lados, |label = {at = all}|.

		\begin{codeexample}[]
			\begin{goban}[5, label]
				\stones[b]{A1}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/label/false}
		Desactiva todas las etiquetas.
	\end{key}
	
	\begin{key}{/pgfgo/goban/label/at =\meta{options}}
		
		En qué lados del tablero van las etiquetas: uno o varios puntos cardinales, |all| o |none|.
		
		\begin{stylekey}{/pgfgo/goban/label/at/all}
			
			En los cuatro lados.
		\end{stylekey}
		
		\begin{stylekey}{/pgfgo/goban/label/at/none}
			
			Lo mismo que |label = false|.
		\end{stylekey}
		
		\begin{stylekey}{/pgfgo/goban/label/at/east}
			A la derecha (los números).
		\end{stylekey}
		\begin{stylekey}{/pgfgo/goban/label/at/right}
			Equivalente a |east|.
		\end{stylekey}
		
		\begin{stylekey}{/pgfgo/goban/label/at/north}
			Arriba (las letras).
		\end{stylekey}
		\begin{stylekey}{/pgfgo/goban/label/at/above}
			Equivalente a |north|.
		\end{stylekey}
		
		\begin{stylekey}{/pgfgo/goban/label/at/south}
			Abajo (las letras).
		\end{stylekey}
		\begin{stylekey}{/pgfgo/goban/label/at/below}
			Equivalente a |south|.
		\end{stylekey}
		
		\begin{stylekey}{/pgfgo/goban/label/at/west}
			A la izquierda (los números).
		\end{stylekey}
		\begin{stylekey}{/pgfgo/goban/label/at/left}
			Equivalente a |west|.
		\end{stylekey}
		
		\begin{codeexample}[]
			\begin{goban}[12, label = {at = {all}}]
			\end{goban}
			
			\begin{goban}[partial = A6:I9, label = {at = north}]
			\end{goban}
			
			\begin{goban}[partial = B2:E4, label = {at = {north, east}}]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/label/font size = \meta{dimension} (initially el tamaño de la fuente actual)}

		Tamaño de la fuente de las etiquetas.

		\begin{codeexample}[]
			\begin{goban}[5, label = {at = {south, west}}]
			\end{goban}

			\begin{goban}[5, label = {at = {south, west}, font size = 6pt}]
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/label/font = \meta{font commands} (initially \texttt{\string\sffamily})}

		Fuente de las etiquetas.

		\begin{codeexample}[]
			\begin{goban}[5, label = {at = {south, west}, font = \bfseries}]
			\end{goban}
		\end{codeexample}
	\end{key}
	
	\begin{key}{/pgfgo/goban/label/sep = \meta{dimension} (initially 0.35cm)}
		
		Distancia entre las etiquetas y el borde del tablero.
	\end{key}
	
	\begin{key}{/pgfgo/goban/label/color = \meta{color} (initially black)}
		
		Color de las etiquetas.

		\begin{codeexample}[]
			\begin{goban}[5, label = {at = {south, west}, color = red, sep = 0.6cm}]
				\stones[b]{A1}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/label/columns = \meta{letters, numbers o kanji} (initially letters)}
		Cómo se escriben las coordenadas de las columnas (arriba y abajo): con letras (como en los comandos, sin la I salvo con |use i|), con números o con números en kanji ({\pgfgokanji 一, 二, …, 十, 十一}, …).
	\end{key}

	\begin{key}{/pgfgo/goban/label/rows = \meta{letters, numbers o kanji} (initially numbers)}
		Lo mismo para las filas (a los costados). Los kanji de las filas se alinean del lado del tablero, para que los de dos caracteres no lo pisen.
	\end{key}

	\begin{key}{/pgfgo/goban/label/columns direction = \meta{left to right o right to left} (initially left to right)}
		En qué sentido se cuentan las columnas.

		\begin{codeexample}[]
			\begin{goban}[5, label = {at = {north, east},
					columns direction = right to left, rows = letters}]
				\stones[b]{B4}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/label/rows direction = \meta{bottom to top o top to bottom} (initially bottom to top)}
		En qué sentido se cuentan las filas. Estas cuatro opciones cambian solo lo que se escribe en el borde: las coordenadas de los comandos (|C3|) siguen siendo las mismas. En un tablero parcial se cuenta desde el borde del tablero completo.

		\begin{codeexample}[]
			\begin{goban}[5, label = {at = {north, west}, columns = numbers,
				rows direction = top to bottom}]
				\stones[b]{C4}
			\end{goban}
		\end{codeexample}
	\end{key}

	\begin{key}{/pgfgo/goban/label/style = \meta{western, japanese o chinese} (initially western)}
		Fija las cuatro opciones anteriores según la costumbre de cada lugar.

		\begin{stylekey}{/pgfgo/goban/label/style/western}
			Columnas con letras desde la izquierda y filas con números desde abajo.
		\end{stylekey}

		\begin{stylekey}{/pgfgo/goban/label/style/japanese}
			Columnas con números desde la derecha y filas con kanji desde arriba, como en los libros japoneses: la esquina de arriba a la derecha es 1-{\pgfgokanji 一}.
		\end{stylekey}

		\begin{stylekey}{/pgfgo/goban/label/style/chinese}
			Columnas con números desde la izquierda y filas con kanji desde arriba.
		\end{stylekey}

		Los kanji necesitan una fuente que los tenga. Con Lua\LaTeX, por ejemplo, IPAex (incluida en \TeX\ Live y en MiK\TeX):

		\begin{codeexample}[]
			\font\kanji = {file:ipaexm.ttf} at 8pt
			\begin{goban}[9, label = {at = {north, east}, style = japanese, font = \kanji}]
				\stones[b]{G7}
			\end{goban}
		\end{codeexample}
	\end{key}
	
\end{environment}