= Welcome to Derelict =

Derelict is a collection of D bindings to C shared (dynamic) libraries which are useful for multimedia applications, with a heavy bias toward game development-related libraries.

== Features ==

Derelict supports some useful features for project development, including:
 * Cross platform compatibility with shared libraries - Code that is developed on a Windows machine will compile on a Linux machine, provided both machines have the necessary libraries.

 * Selective symbol loading - This helps your application support machines that are missing the version of a library used during development. Specify which parts of a library your application will use and the program will work with all versions of the library that support those features.

== Getting Started ==

To start using Derelict, you will need [http://www.dsource.org/projects/build/wiki Derek Parnell's Build Utility] and the latest [http://www.dsource.org/projects/derelict/changeset/head/trunk?old_path=%2F&format=zip Derelict source].

=== Building Derelict ===

To build in debug mode:
{{{
cd Derelict
dmd -run buildme.d debug
}}}

To build in Release mode:
{{{
cd Derelict
dmd -run buildme.d
}}}

=== Obtaining and Learning Derelict ===

Download Derelict: [http://www.dsource.org/projects/derelict/changeset/head/trunk?old_path=%2F&format=zip here]

Alternate Download: Get Derelict via [http://www.dsource.org/projects/dsss DSSS]

Derelict Forums: [http://www.dsource.org/forums/viewforum.php?f=19 here]

Documentation: [http://svn.dsource.org/projects/derelict/trunk/docs/index.html here]

Tutorials: [http://dmedia.pengus.net/?n=Main.Tutorials DMedia] has a few tutorials on using DerelictSDL and DerelictGL.

== Libraries Supported By Derelict ==

Here is a list of the libraries for which Derelict currently provides bindings:
 * OpenAL
 * OpenGL
 * OpenGL Utility Library (GLU)
 * DevIL, ILU, and ILUT
 * SDL
 * SDL_image
 * SDL_mixer
 * SDL_net
 * SDL_ttf
 * !FreeType
 * libogg
 * libvorbis 

Although not official Derelict packages, members of the community have produced the following bindings (these packages may or may not be compilable with the latest DMD or GDC): 

 * [http://www.famolsen.dk/d/derelict/bassmod.zip BassMod], [http://www.yage3d.net/host/derelict.bassmod.zip Mirror]
 * [http://www.baysmith.com/d/baysmith.glut.zip GLUT], [http://www.yage3d.net/host/derelict.glut.zip Mirror]
 * [http://www.uni-ulm.de/~s_mpiepk/d/DerelictPhysFs.zip PhysFS], [http://www.yage3d.net/host/derelict.physfs.zip Mirror]
 * [http://expandingbrain.com/files/derelict_lua.zip Lua], [http://www.yage3d.net/host/derelict.lua.zip Mirror]

== Need More Help? ==

See the Derelict [http://svn.dsource.org/projects/derelict/trunk/docs/index.html documentation] for specific details on a particular package. If you are having problems installing or using Derelict, please visit the [http://www.dsource.org/forums/viewforum.php?f=19 forums].


== Projects that use Derelict ==

 * [http://www.dsource.org/projects/arclib ArcLib]
 * [http://www.dsource.org/projects/qonkd QonkD]
 * [http://www.yage3d.net Yage]
 * [http://www.dsource.org/projects/luigi Luigi]
 * [http://distanthumans.info/programming/D/bosconian/bosconian.php Bosskoneun]
 * [http://www.team0xf.com/eng/ Deadlock]