TCG - terminal cell graphics

Go Graphics library for use in a text terminal. Only 1bit graphics can be used with two colors. Used unicode block symbols for drawing. 2x3 mode is supported by the latest versions of the Iosevka font.

Features

• Available 4 graphics mode, from 2x3 pixels grid for terminal symbol to 1x1, 1x2 and 2x2
• Set/get one pixel
• Drawings: lines (vertical, horizontal, or with any angle), boxes, circles, arcs
• Fill area with a different options, for example fill with patterns
• Buffer manipulating: cut, clone, convert to/from stdlib Image or text
• Buffer transform: BitBlt, clear, flip, invert, scroll (vertical, horizontal)
• Sub-package for turtle graphics, also available drawing by text script

Install

go get -u github.com/msoap/tcg

Usage

package main

import (
	"log"

	"github.com/gdamore/tcell/v2"
	"github.com/msoap/tcg"
)

func main() {
	tg, err := tcg.New(tcg.Mode2x3) // each terminal symbol contains a 2x3 pixels grid, also you can use 1x1, 1x2, and 2x2 modes
	if err != nil {
		log.Fatalf("create tg: %s", err)
	}

	i := 0
	for {
		pixColor := tg.Buf.At(10, 10)       // get color of pixel
		tg.Buf.Set(11, 11, pixColor)        // draw one pixel with color from 10,10
		tg.Buf.Line(0, 0, 50, i, tcg.Black) // draw a diagonal line
		tg.Show()                           // synchronize buffer with screen

		if ev, ok := tg.TCellScreen.PollEvent().(*tcell.EventKey); ok && ev.Rune() == 'q' {
			break // exit by 'q' key
		}
		i++
	}

	tg.Finish() // finish application and restore screen
}

See more examples in examples folder.

Screenshot

Game of Life example in iTerm2 terminal with Iosevka font:

TODO

• [ ] fonts support
• [ ] sprites, maybe with animation

See also

• Go library for terminal - github.com/gdamore/tcell
• Turtle graphics

Unicode symbols:

• Block Elements - wikipedia
• Block Elements - unicode.org
• Symbols for Legacy Computing - wikipedia
• Symbols for Legacy Computing - unicode.org

Supported fonts:

• Iosevka font