termbox ~master

Termbox

This is a wrapper of the TUI library Termbox.

From the termbox Readme:

Termbox is a library that provides minimalistic API which allows the programmer to write text-based user interfaces.

It is based on a very simple abstraction. The main idea is viewing terminals as a table of fixed-size cells and input being a stream of structured messages. Would be fair to say that the model is inspired by windows console API. The abstraction itself is not perfect and it may create problems in certain areas. The most sensitive ones are copy & pasting and wide characters (mostly Chinese, Japanese, Korean (CJK) characters). When it comes to copy & pasting, the notion of cells is not really compatible with the idea of text. And CJK runes often require more than one cell to display them nicely. Despite the mentioned flaws, using such a simple model brings benefits in a form of simplicity. And KISS principle is important.

At this point one should realize, that CLI (command-line interfaces) aren't really a thing termbox is aimed at. But rather pseudo-graphical user interfaces.

Installation

Termbox-d is meant to be used as a dub package. Just install it by putting it in your dub.sdl or dub.json file.

dependency "termbox" version="~master"

or

"dependencies": {
    "termbox": { "version": "~master" }
}

Getting Started

See the examples/ directory for some examples of how to use Termbox.

The library consists of the following functions:

init() // Start termbox
shutdown() // Shutdown

width() // Width of the terminal screen
height() // Height of the terminal screen

clear() // Clear the screen
setClearAttributes(ushort fg, ushort bg) // Attributes for clearing the screen
flush() // Sync internal buffer with terminal

putCell(int x, int y, Cell* cell) // Draw cell at position x y
setCell(int x, int y, uint ch, ushort fg, ushort bg) // Put the character ch at position x y with color fg and bg

setInputMode(InputMode mode) // Change the input mode
setOutputMode(OutputMode mode) // Change the output mode

peekEvent(Event* e) // Peek an event
pollEvent(Event* e) // Wait for an event

setCursor(int x, int y) // Put the cursor at x, y
hideCursor() // Hide the cursor

For full detail, source/termbox/package.d.

Links

• https://github.com/nsf/termbox - Termbox library
• http://pecl.php.net/package/termbox - PHP Termbox wrapper
• https://github.com/nsf/termbox-go - Go pure Termbox implementation
• https://github.com/gchp/rustbox - Rust Termbox wrapper
• https://github.com/fouric/cl-termbox - Common Lisp Termbox wrapper

License

Termbox-d is (like termbox) provided under the MIT license.