tvision

Turbo Vision A modern port of Turbo Vision 2.0, the classical framework for text-based user interfaces. Now cross-platform and with Unicode support. I started this as a personal project at the very end of 2018. By May 2020 I considered it was very close to feature parity with the original, and decided to make it open. The original goals of this project were: Making Turbo Vision work on Unix/Linux by altering the legacy codebase as little as possible. Keeping it functional on DOS/Windows. Being as compatible as possible at the source code level with old Turbo Vision applications. This led me to implement some of the Borland C++ RTL functions, as explained below. At one point I considered I had done enough, and that any attempts at revamping the library and overcoming its original limitations would require either extending the API or breaking backward compatibility, and that a major rewrite would be most likely necessary. However, between July and August 2020 I found the way to integrate full-fledged Unicode support into the existing architecture, wrote the Turbo text editor and also made the new features available on Windows. So I am confident that Turbo Vision can now meet many of the expectations of modern users and programmers. The original location of this project is https://github.com/magiblot/tvision. Table of contents What is Turbo Vision good for? How do I use Turbo Vision? Releases and downloads Build environment Unix/Linux Windows (MSVC) Windows (MinGW) Windows/DOS (Borland C++) Vcpkg Turbo Vision as a CMake dependency Features API changes Applications using Turbo Vision Unicode support Clipboard interaction Extended color support What is Turbo Vision good for? A lot has changed since Borland created Turbo Vision in the early 90's. Many GUI tools today separate appearance specification from behaviour specification, use safer or dynamic languages which do not segfault on error, and support either parallel or asynchronous programming, or both. Turbo Vision does not excel at any of those, but it certainly overcomes many of the issues programmers still face today when writing terminal applications: Forget about terminal capabilities and direct terminal I/O. When writing a Turbo Vision application, all you have to care about is what you want your application to behave and look like—there is no need to add workarounds in your code. Turbo Vision tries its best to produce the same results on all environments. For example: in order to get a bright background color on the Linux console, the blink attribute has to be set. Turbo Vision does this for you. Reuse what has already been done. Turbo Vision provides many widget classes (also known as views), including resizable, overlapping windows, pull-down menus, dialog boxes, buttons, scroll bars, input boxes, check boxes and radio buttons. You may use and extend these; but even if you prefer creating your own, Turbo Vision already handles event dispatching, display of fullwidth Unicode characters, etc.: you do not need to waste time rewriting any of that. Can you imagine writing a text-based interface that works both on Unix/Linux and Windows (and thus is cross-platform) out-of-the-box, with no #ifdefs? Turbo Vision makes this possible. First: Turbo Vision keeps on using char arrays instead of relying on the implementation-defined and platform-dependent wchar_t or TCHAR. Second: thanks to UTF-8 support in setlocale in recent versions of Microsoft's RTL, code like the following will work as intended: std::ifstream f("コンピュータ.txt"); // On Windows, the RTL converts this to the system encoding on-the-fly. How do I use Turbo Vision? You can get started with the Turbo Vision For C++ User's Guide, and look at the sample applications hello, tvdemo and tvedit. Once you grasp the basics, I suggest you take a look at the Turbo Vision 2.0 Programming Guide, which is, in my opinion, more intuitive and easier to understand, despite using Pascal. By then you will probably be interested in the palette example, which contains a detailed description of how palettes are used. Don't forget to check out the features and API changes sections as well. Releases and downloads This project has no stable releases for the time being. If you are a developer, try to stick to the latest commit and report any issues you find while upgrading. If you just want to test the demo applications: Unix systems: you'll have to build Turbo Vision yourself. You may follow the build instructions below. Windows/DOS: you can find up-to-date binaries in the Actions section. Click on the first successful workflow (with a green tick) in the list. At the bottom of the workflow page, as long as you have logged in to GitHub, you'll find an Artifacts section with the following files: examples-x86.zip: 32-bit executables built with MSVC. Windows Vista or later required. examples-x64.zip: 64-bit executables built with MSVC. x64 Windows Vista or later required. examples-dos.zip: 16-bit DOS executables built with Borland C++. No Unicode support. examples-dpmi32.zip: 32-bit Windows/DOS executables built with Borland C++. No Unicode support. Build environment Unix/Linux Turbo Vision can be built as an static library with CMake and GCC/Clang. cmake . -B ./build -DCMAKE_BUILD_TYPE=Release && # Could also be 'Debug', 'MinSizeRel' or 'RelWithDebInfo'. cmake --build ./build # or `cd ./build; make` CMake versions older than 3.13 may not support the -B option. You can try the following instead: mkdir -p build; cd build cmake .. -DCMAKE_BUILD_TYPE=Release && cmake --build . The above produces the following files: libtvision.a, which is the Turbo Vision library. The demo applications hello, tvdemo, tvedit, tvdir, which were bundled with the original Turbo Vision (although some of them have a few improvements). The demo applications mmenu and palette from Borland's Technical Support. tvhc, the Turbo Vision Help Compiler. The library and executables can be found in ./build. The build re