README
------

This is SDL_bgi, a graphics library based on SDL2. SDL_bgi provides
graphics primitives, and is much easier to use than SDL2.

SDL_bgi is nearly fully compatible with BGI, the Borland Graphics
Interface that was the de facto standard in PC graphics back in DOS
days. (It compiles and runs the original 'bgidemo.c' almost
perfectly.) It's pretty fast, very easy to use, and it also provides
extensions for ARGB colours and mouse support. It should run on any
platform supported by SDL2; it was only tested in Linux, though.

I wrote SDL_bgi because I wanted a simple but fast graphics library
for my experiments with fractals and cellular automata, using the BGI
syntax I'm used to. Obviously, native SDL2 functions can be used in
SDL_bgi programs.

A few examples are provided in the src/test/ directory.

If you don't need BGI compatibility, I suggest that you check out
SDL_gfx, a graphics library more complete and more powerful than
SDL_bgi.

Links:

0. WinBGIm, a BGI Windows port:
   http://www.cs.colorado.edu/~main/cs1300/doc/bgi/

1. The SDL library:
   https://www.libsdl.org/

2. SDL_gfx, graphics drawing primitives and more:
   http://cms.ferzkopp.net/index.php/software/13-sdl-gfx

3. BGI on Wikipedia:
   https://en.wikipedia.org/wiki/Borland_Graphics_Interface

4. Xbgi, a BGI XLib port:
   http://libxbgi.sourceforge.net/

This library is licensed under the Zlib license; please see the file
LICENSE. The 8x8 font comes from A. Schiffler's SDL_gfx.

Brought to you by Guido Gonzato, PhD <guido.gonzato at gmail.com>
