node-drawille

drawing in terminal with unicode braille characters. The idea is based on drawille by @asciimoo.

cube

install

install the package with npm:

$ npm install --save drawille

usage

See examples.

this module provides a very basic API only, for fancy things, like drawing lines, use another module, like bresenham.

drawille-canvas provides HTML5 Canvas API for drawille.

api

`Canvas(w, h)`

Create a new canvas with the given dimensions. w must be multiple of 2, h must be multiple of 4. Uses columns & rows from process.stdout as default values for w and h.

`canvas.set(x, y)`

Draw point on canvas at the given position.

`canvas.unset(x, y)`

Delete point on canvas at the given position.

`canvas.toggle(x, y)`

Toggle point on canvas at the given position.

`canvas.clear()`

Clear the whole canvas (delete every point).

`canvas.frame(delimiter)`

return the current content of canvas, as a delimiter-delimited string. delimiter defaults to \n.

it uses braille characters to represent points, so every line has length of w/2, and the string contains h/4 lines.

projects

vtop uses it to draw CPU and memory usage charts in the terminal
datop uses it to draw dat statistics
boscillate uses it to draw baudio soundwaves in real-time

license

MIT

Current Tags

2.0.2 ... latest (2 years ago)

node-drawille

install

usage

api

Canvas(w, h)

canvas.set(x, y)

canvas.unset(x, y)

canvas.toggle(x, y)

canvas.clear()

canvas.frame(delimiter)