Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jcmoyer/halt

Hardware accelerated terminal.
https://github.com/jcmoyer/halt

Last synced: about 1 month ago
JSON representation

Hardware accelerated terminal.

Awesome Lists containing this project

README

        

# HALT

Hardware accelerated terminal implementation written in C++ and OpenGL.

## Installation

### Windows

HALT has a dependency on the OpenGL Extension Wrangler Library. You must
download it from [here](http://glew.sourceforge.net/).

While you can build HALT standalone, it is recommended that you use
[CMake](http://www.cmake.org/) instead as it is much easier.

#### CMake

First, clone the repository:

>git clone git://github.com/jcmoyer/HALT.git

Then, inside the HALT folder create a new folder called build:

>cd HALT
>mkdir build
>cd build

You can then invoke CMake from the command line or by using the CMake GUI. Here
is how you do it from the command line:

>cmake ..

CMake will then generate files to compile HALT in the build directory.

#### Visual Studio (Standalone)

Clone the repository into a folder:

>git clone git://github.com/jcmoyer/HALT.git

Then, in Visual Studio, create a new project from source. Select the HALT
directory. You need to configure your build settings so that Visual Studio
builds either a static library or DLL (consult your documentation). Then, link
in `OpenGL32.lib` and `glew32.lib`. Build normally.

The examples have an additional dependency on SDL 1.2. They can be built by
linking `SDL.lib` and `Halt.lib` (default).

### Linux

#### Debian/Ubuntu

First, download the required dependencies. These are required to build HALT in
one way or another:

$ sudo apt-get install build-essential libglew-dev libgl1-mesa-dev

Then, clone the repository:

$ git clone git://github.com/jcmoyer/HALT.git

##### CMake

Go into the HALT directory and create a new directory called build:

$ cd HALT/
$ mkdir build && cd build

Then, you can use CMake to generate makefiles for HALT:

$ cmake ..

Or, if you prefer a GUI that lists all of the compile settings:

$ ccmake ..

Then you can build it and install it if you wish:

$ make && make install

## Usage

You can view the documentation [here](http://jcmoyer.github.io/HALT/). You can
also find working examples in the examples directory. The examples depend on SDL
1.2 and HALT.

## License (MIT)

Copyright (c) 2011-2012 J.C. Moyer

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.