image

README

image

Introduction

image is an chess image utility that converts board positions into SVG, or Scalable Vector Graphics, images. svgo, the only outside dependency, is used to construct the SVG document.

Usage

SVG

The SVG function is the primary exported function of the package. It writes an SVG document to the io.Writer given.

file, _ := os.Open("output.svg")
defer file.Close()
fenStr := "rnbqkbnr/pppppppp/8/8/3P4/8/PPP1PPPP/RNBQKBNR b KQkq - 0 1"
pos := &chess.Position{}
pos.UnmarshalText([]byte(fenStr))
image.SVG(file, pos.Board())

Dark / Light Square Customization

The default colors, shown in the example SVG below, are (235, 209, 166) for light squares and (165, 117, 81) for dark squares. The light and dark squares can be customized using the SquareColors() option.

white := color.RGBA{255, 255, 255, 1}
gray := color.RGBA{120, 120, 120, 1}
sqrs := image.SquareColors(white, gray)
image.SVG(file, pos.Board(), sqrs)

Marked Squares

MarkSquares is designed to be used as an optional argument to the SVG function. It marks the given squares with the color. A possible usage includes marking squares of the previous move.

yellow := color.RGBA{255, 255, 0, 1}
mark := image.MarkSquares(yellow, chess.D2, chess.D4)
image.SVG(file, pos.Board(), mark)

Perspective

Perspective is designed to be used as an optional argument to the SVG function. It draws the board from the perspective of the given color. White is the default. The following generates a board from Black's perspective:

fromBlack := image.Perspective(chess.Black)
image.SVG(file, pos.Board(), fromBlack)

Example Program

package main

import (
	"image/color"
	"log"
	"os"

	"github.com/cubuzz/chess"
	"github.com/cubuzz/chess/image"
)

func main() {
    // create file
    f, err := os.Create("example.svg")
    if err != nil {
        log.Fatal(err)
    }
    defer f.Close()

    // create board position
    fenStr := "rnbqkbnr/pppppppp/8/8/3P4/8/PPP1PPPP/RNBQKBNR b KQkq - 0 1"
    pos := &chess.Position{}
    if err := pos.UnmarshalText([]byte(fenStr)); err != nil {
        log.Fatal(err)
    }

    // write board SVG to file
    yellow := color.RGBA{255, 255, 0, 1}
    mark := image.MarkSquares(yellow, chess.D2, chess.D4)
    if err := image.SVG(f, pos.Board(), mark); err != nil {
        log.Fatal(err)
    }
}

Example Program Result

Documentation

Overview

Package image is a go library that creates images from board positions

Index

• func MarkSquares(c color.Color, sqs ...chess.Square) func(*encoder)
• func Perspective(c chess.Color) func(*encoder)
• func SVG(w io.Writer, b *chess.Board, opts ...func(*encoder)) error
• func SquareColors(light, dark color.Color) func(*encoder)

Functions

func MarkSquares

func MarkSquares(c color.Color, sqs ...chess.Square) func(*encoder)

MarkSquares is designed to be used as an optional argument to the SVG function. It marks the given squares with the color. A possible usage includes marking squares of the previous move.

func Perspective

func Perspective(c chess.Color) func(*encoder)

Perspective is designed to be used as an optional argument to the SVG function. It draws the board from the perspective of the given color. White is the default.

func SVG

func SVG(w io.Writer, b *chess.Board, opts ...func(*encoder)) error

SVG writes the board SVG representation into the writer. An error is returned if there is there is an error writing data. SVG also takes options which can customize the image output.

func SquareColors

func SquareColors(light, dark color.Color) func(*encoder)

SquareColors is designed to be used as an optional argument to the SVG function. It changes the default light and dark square colors to the colors given.