SVG rendering

The chess.svg module renders SVG Tiny 1.2 images (mostly for IPython/Jupyter Notebook integration). The piece images by Colin M.L. Burnett are triple licensed under the GFDL, BSD and GPL.

chess.svg.piece(piece: Piece, size: int | None = None) str[source]

Renders the given chess.Piece as an SVG image.

>>> import chess
>>> import chess.svg
>>>
>>> chess.svg.piece(chess.Piece.from_symbol("R"))  
R
chess.svg.board(board: BaseBoard | None = None, *, orientation: chess.Color = True, lastmove: Move | None = None, check: chess.Square | None = None, arrows: Iterable[Arrow | Tuple[chess.Square, chess.Square]] = [], fill: Dict[chess.Square, str] = {}, squares: chess.IntoSquareSet | None = None, size: int | None = None, coordinates: bool = True, colors: Dict[str, str] = {}, flipped: bool = False, borders: bool = False, style: str | None = None) str[source]

Renders a board with pieces and/or selected squares as an SVG image.

Parameters:
  • board – A chess.BaseBoard for a chessboard with pieces, or None (the default) for a chessboard without pieces.

  • orientation – The point of view, defaulting to chess.WHITE.

  • lastmove – A chess.Move to be highlighted.

  • check – A square to be marked indicating a check.

  • arrows – A list of Arrow objects, like [chess.svg.Arrow(chess.E2, chess.E4)], or a list of tuples, like [(chess.E2, chess.E4)]. An arrow from a square pointing to the same square is drawn as a circle, like [(chess.E2, chess.E2)].

  • fill – A dictionary mapping squares to a colors that they should be filled with.

  • squares – A chess.SquareSet with selected squares to mark with an X.

  • size – The size of the image in pixels (e.g., 400 for a 400 by 400 board), or None (the default) for no size limit.

  • coordinates – Pass False to disable the coordinate margin.

  • colors – A dictionary to override default colors. Possible keys are square light, square dark, square light lastmove, square dark lastmove, margin, coord, inner border, outer border, arrow green, arrow blue, arrow red, and arrow yellow. Values should look like #ffce9e (opaque), or #15781B80 (transparent).

  • flipped – Pass True to flip the board.

  • borders – Pass True to enable a border around the board and, (if coordinates is enabled) the coordinate margin.

  • style – A CSS stylesheet to include in the SVG image.

>>> import chess
>>> import chess.svg
>>>
>>> board = chess.Board("8/8/8/8/4N3/8/8/8 w - - 0 1")
>>>
>>> chess.svg.board(
...     board,
...     fill=dict.fromkeys(board.attacks(chess.E4), "#cc0000cc"),
...     arrows=[chess.svg.Arrow(chess.E4, chess.F6, color="#0000cccc")],
...     squares=chess.SquareSet(chess.BB_DARK_SQUARES & chess.BB_FILE_B),
...     size=350,
... )  
8/8/8/8/4N3/8/8/8

Deprecated since version 1.1: Use orientation with a color instead of the flipped toggle.

class chess.svg.Arrow(tail: chess.Square, head: chess.Square, *, color: str = 'green')[source]

Details of an arrow to be drawn.

tail: int

Start square of the arrow.

head: int

End square of the arrow.

color: str

Arrow color.

pgn() str[source]

Returns the arrow in the format used by [%csl ...] and [%cal ...] PGN annotations, e.g., Ga1 or Ya2h2.

Colors other than red, yellow, and blue default to green.

classmethod from_pgn(pgn: str) Arrow[source]

Parses an arrow from the format used by [%csl ...] and [%cal ...] PGN annotations, e.g., Ga1 or Ya2h2.

Also allows skipping the color prefix, defaulting to green.

Raises:

ValueError if the format is invalid.