=====================================
The Doryen library v1.4.1
=====================================
Library content :

Core

Base toolkits

Roguelike toolkits

0. Compiling with libtcod
1. Colors
2. Console emulator
3. System layer

4. Line drawing toolkit
5. Image toolkit
6. Mouse support
7. File parser
8. All purposes container
9. Pseudorandom number generator
10. Noise generator
11. Compression toolkit

12. Field of view toolkit
13. Path finding
14. BSP toolkit
15. Heightmap toolkit


Compiling
To use the library, just include the right file :

C++ : #include "libtcod.hpp"
C   : #include "libtcod.h"
Py  : import libtcodpy as libtcod

For C/C++, you have to put the libtcod include directory in your compiler include path.

Linking
With Visual Studio, add the libtcod-VS.lib in your linker inputs.
With Mingw32, add -L./lib -ltcod-mingw to your linking command to link with lib/libtcod-mingw.a.
With gcc on Linux, add -ltcod to your linking command to link with libtcod.so.
With g++ on Linux, add -ltcod -ltcod++ to your linking command to link with libtcod++.so.
With g++ on MacOSX, add -ltcod -ltcod++ to your linking command to link with libtcod++.a

gcc -O3 sample.c -o samples_c -L. -ltcod -I include
g++ -O3 sample.cpp -o samples_cpp -L. -ltcod -ltcod++ -I include


Running
On windows, libtcod-*.dll must be in the same directory as your game exe or py.
On Linux, libtcod.so (and libtcod++.so if you're using C++) must be in your LD_LIBRARY_PATH :

export LD_LIBRARY_PATH=.
./samples_c

insert a comment
RotateMe on 2009-02-18 20:36:51
It would be helpful to add a bigger example as last section of the documentation.

jice : the binary downloads contain samples that demonstrate the use of the library for every languages (C, C++ and python). You can get them from this page