LIBTERMIO(3)

LIBTERMIO provides minimal, cross-platform terminal I/O for BRL-CAD, supplying the essential terminal-handling functions needed by interactive text tools on both Windows and POSIX platforms. It is distributed as a single header (libtermio.h); defining LIBTERMIO_IMPLEMENTATION before including the header pulls in the implementation.

The library offers two tiers of interface. The first tier is a small set of functions that wrap the basic operations most BRL-CAD utilities need — saving, setting raw mode, and restoring the controlling terminal, and reading input a character at a time — kept deliberately simple so they work on as many platforms as possible. The second tier is a richer, more capable interface used by BRL-CAD’s minimalist interactive text editor (a fallback used when no suitable console editor is available), including support for editor interactions across the various Windows consoles.

Optional helper routines are provided for querying and sanitizing the runtime terminal environment and for enabling debug logging. Debug support is inert unless the library is built with LIBTERMIO_ENABLE_DEBUG defined. The complete API is documented in libtermio.h.

brlcad(1), libbu(3)

BRL-CAD Team

Published in 1986-2025 by the United States Government. This work is in the public domain.

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org