= 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.

== Useful Links ==

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

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

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

== Libraries ==

Here is a list of the libraries for which Derelict currently provides bindings:
 * OpenAL
 * OpenGL
 * OpenGL Utility Library (GLU)
 * GLFW
 * 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.  They should work with Derelict with little to no modification.
 * [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]

== Features ==

Derelict supports some useful features for project development, including:
 * Cross platform compatability with shared libaries - 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 don't have the same version of a library as the development machine. Specify what 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
}}}

'''Setting up a Build Environment'''

Coming soon!

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/arcgames ArcGames]
 * [http://www.dsource.org/projects/qonkd QonkD]