fentoboardimage 1.0.1

FenToBoardImage takes a Fen string representing a Chess position, and renders a Pillow image of the resulting position.

About

FenToBoardImage takes a Fen string representing a Chess position, and renders a PIL image of the resulting position.

You can customize:

• the size and color of the board
• piece sprites
• black or white perspective
• Board highlighting for last move
• Arrows

Installation

Install the package using pip

$ pip install fenToBoardImage

Then import the fenToImage and loadPiecesFolder functions and use them as follows:

from fenToBoardImage import fenToImage, loadPiecesFolder

boardImage = fenToImage(
	fen="rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1",
	squarelength=100,
	pieceSet=loadPiecesFolder("./pieces"),
	darkColor="#D18B47",
	lightColor="#FFCE9E"
)

In order to load a piece set, the pieces must follow this file structure, and must be a .png:

-piece_set_name
  -white
    - Knight.png
    - Rook.png
    - Pawn.png
    - Bishop.png
    - Queen.png
    - King.png
  -black
    - Knight.png
    - Rook.png
    - Pawn.png
    - Bishop.png
    - Queen.png
    - King.png

Usage

The fenToBoardImage has these parameters:

fen: str

Fen string representing a position

squarelength: int

the length of one square on the board

resulting board will be 8 * squarelength long

pieceSet: loadPiecesFolder

the piece set, loaded using the loadPiecesFolder function

darkColor: str

dark square color on the board

lightColor: str

light square color on the board

flipped: boolean

default = False

Whether to flip to board, and render it from black's perspective

The loadPiecesFolder has one parameter:

path: str

Loads piece set located at the path provided.

Dependencies

• Pillow