Awesome

Drawille

Pixel graphics in terminal implemented with unicode braille characters

About

This project is a Java port of the original drawille python project by asciimoo. This project serves as a library for Java to draw in the console using braille letters that are part of the unicode character space. Braille characters in unicode have a 4 by 2 matrix that can be used as a sub-matrix for each character in a console screen. This braille dot matrix effectively raises the resolution of any console by eight times. The examples below were rendered in the console using this Java library. The original ideas for these examples came from the original project repository.

Examples

Canvas canvas = new Canvas ( 75, 6 );
for ( int x = 0; x <= canvas.getWidth () * 8; x++ ) {
	canvas.set ( x / 10, ( int ) Math.round ( 10 + Math.cos ( x * Math.PI / 180 ) * 10 ) );
}
canvas.render ();

Turtle turtle = new Turtle ( 75, 50 );
turtle.move ( turtle.getWidth () / 2, turtle.getHeight () / 2 );
turtle.down ();
for ( int x = 0; x < 72; x++ ) {
	turtle.right ( 20 );
	for ( int y = 0; y < 72; y++ ) {
		turtle.right ( 20 );
		turtle.forward ( 10 );
	}
}
turtle.render ();

Building & Running

This project uses maven as a build system. Therefore to package this library into a jar, execute mvn package while in the project root directory. Since braille characters are part of the unicode domain, it is important to append the -Dfile.encoding=UTF-8 flag when running your Java application. This will ensure that the braille characters are rendered correctly in your console. If this flag is not passed, then you will likely see the ? character in place of it.

Development Environment

Docker can be used to spin up a quick development environment:

docker build -t drawille .
docker run -it -v `pwd`:/usr/src/drawille drawille bash

Once inside the container, you can compile and run the examples:

mvn package
javac -cp target/drawille-1.0.3.jar docs/examples/*Demo.java
java -cp .:target/drawille-1.0.3.jar docs/examples/CanvasDemo
java -cp .:target/drawille-1.0.3.jar docs/examples/TurtleDemo

Bugs / Feature Requests

If you have any feature requests, please open up an issue. Similarly if there are any bugs found, please report them by opening up an issue. If a bug is found, please include steps to reproduce the issue, alongside the expected and actual behavior.