Archives/notcurses
2
0
Fork 0
mirror of https://github.com/dankamongmen/notcurses.git synced 2024-11-04 06:00:30 +00:00
Code Issues Packages Projects Releases Wiki Activity
blingful character graphics/TUI library. definitely not curses.
35 Commits 26 Branches 140 Tags 116 MiB
C 82.3%
C++ 14.9%
Python 1.7%
CMake 0.8%
Shell 0.3%
9a5d893ce7
Go to file
nick black 9a5d893ce7 demo: setlocale(), blit some characters like a boss
2019-11-21 08:51:57 -05:00
debian dep on ncurses for tinfo 2019-11-18 09:40:28 -05:00
include ncplane: add ncplane_putwc() 2019-11-21 08:51:57 -05:00
src demo: setlocale(), blit some characters like a boss 2019-11-21 08:51:57 -05:00
tests ncplane: more basic unit testing 2019-11-21 08:51:57 -05:00
tools version string, notcurses_version() 2019-11-17 05:04:41 -05:00
.drone.yml sign that fucker 2019-11-19 07:09:23 -05:00
CMakeLists.txt cmake: turn on -Wshadow 2019-11-21 08:51:57 -05:00
LICENSE Initial commit 2019-11-16 21:38:25 -05:00
README.md missing conjunction 2019-11-19 06:53:50 -05:00

README.md

notcurses

cleanroom TUI library for modern terminal emulators. definitely not curses.

Build Status

  • What it is: a library facilitating complex TUIs on modern terminal emulators, supporting vivid colors and wide characters to the maximum degree possible. Many tasks delegated to Curses can be achieved using notcurses (and vice versa).

  • What it is not: a source-compatible X/Open Curses implementation, nor a replacement for NCURSES on existing systems, nor a widely-ported and -tested bedrock of Open Source, nor a battle-proven, veteran library.

notcurses abandons the X/Open Curses API bundled as part of the Single UNIX Specification. The latter shows its age, and seems not capable of making use of terminal functionality such as unindexed 24-bit color ("DirectColor", not to be confused with 8-bit indexed 24-bit color, aka "TrueColor"). For some necessary background, consult Thomas E. Dickey's superb and authoritative NCURSES FAQ. As such, it is not a drop-in Curses replacement. notcurses furthermore makes use of the Terminfo library shipped with NCURSES. It is almost certainly less portable, and definitely tested on less hardware.

notcurses opens up advanced functionality for the interactive user on workstations, phones, laptops, and tablets, at the expense of e.g. industrial and retail terminals (or even the Linux virtual console, which offers only eight colors and limited glyphs).

Why use this non-standard library?

  • A svelter design than that codified in X/Open. All exported identifiers are prefixed with notcurses_ to avoid namespace pollution. Fewer identifiers overall. All APIs natively suport wide characters and 24-bit RGB color.

  • Visual features not directly available via NCURSES, including images, fonts, and video.

  • Thread safety, and use in parallel programs, has been a design consideration from the beginning.

On the other hand, if you're targeting industrial or critical applications, or wish to benefit from the time-tested reliability and portability of Curses, you should by all means use that fine library.