--- CharLib version 0.3 (29/03/10) ---
by Geoffrey White

CharLib is a lightweight library for displaying ASCII tiles nicely in a windowed environment, using SDL.
 * Cross platform C++ code (C-style)
 * Full colour ASCII tiles
 * Scales to fit resizable window

- LICENSE -
I release this library, consisting of the files listed below, as public domain.  There are no restrictions
on use, copying, redistribution etc, including for profit.  I do not guarantee fitness for purpose.
	Source/charlib.cpp       (source code)
	Source/charlib.h
	Source/main.cpp          (demo program)
	Source/resourcescript.rc (Windows resource script, for embedding the icon into the .exe)
	Data/icon1.ico           (icon embedded into the .exe)
	Data/icon32.bmp          (icon loaded by the code)
	Data/tiles_ascii.bmp     (tile graphics)
	readme.txt               (this file)
	makefile                 (Linux makefile)
	CharLib.dsp              (Visual Studio project)
	CharLib.dsw              (Visual Studio workspace)
These files were authored by myself, with the exception that data in tiles_ascii.bmp was created with the
aid of the 'DejaVu Sans Mono' font.  It is my understanding that this kind of content (bitmaps of fonts)
isn't subject to copyright.

- REQUIREMENTS -
	C++ compiler
	SDL development library

- TESTED PLATFORMS -
	Demo program - Microsoft Windows XP Home Edition, Visual Studio 6.0, SDL 1.2.13 (29/03/10)
	Demo program - Ubuntu Linux 9.10 (running on VirtualBox), g++ 4.4.1, SDL 1.2.13 (29/03/10)

- INSTRUCTIONS -

Visual Studio:
Load CharLib.dsw (this is a Visual Studio 6.0 workspace file; newer versions of Visual Studio will probably
convert it).  You may need to configure the following:
	update the SDL files in the project if SDL is installed anywhere other than C:\Program Files\SDL-1.2.13:
		SDL-1.2.13\lib\SDL.lib
		SDL-1.2.13\lib\SDLmain.lib 
	ensure that your include paths (Tools > Options > Directories > Include files) contain:
		C:\Program Files\SDL-1.2.13\SDL-1.2.13\include
	in either the executable directory or c:\Windows\System32 should be:
		sdl.dll

g++:
Go into the project directory and type 'make'

general:
The 'main.cpp' program demonstrates the capabilities of the library.  I suggest browsing it and the charlib.h
header file, where you will find a brief explanation of each function.

End user builds should be distributed with the SDL runtime package.

- VERSION HISTORY -
	0.3 (29/03/10) - mk_char_style added
			 char_int_str added
			 changed from SDL_PumpEvents to SDL_PollEvent (to avoid event queue growth)
			 SDL_INIT_NOPARACHUTE fixed
			 fixed a bug where tiles were occasionally drawn (but not coloured) 1 pixel to large
	0.2 (02/03/10) - cleaned up code
	0.l (28/02/10) - initial release


- CONTACT -

The official web site of 'CharLib' is:
	http://www.randomstuff.org.uk/~geoffrey/roguelikes/charlib.html

Contact me at:
	[my first name]-charlib@randomstuff.org.uk