DerelictSDLttf

DerelictSDLttf is a D binding to Sam Lantinga's SDL_ttf, a cross-platform library that allows you to use TrueType fonts with SDL.

The current version of DerelictSDLttf requires SDL_ttf 2.0.7 or later.

Building

To compile DerelictSDLttf, add the DerelictSDLttf make target to the command line when compiling Derelict. For example, to build DerelictSDLttf on Windows with DMD, you would execute the following: 

make -fwin32.mak DerelictSDLttf DC=DMD
For more information on compiling Derelict libraries, see Building the Derelict Bindings.

Using

  1. Always make sure the DerelictSDLttf source modules are available on your import path.
  2. In modules that make use of DerelictSDLttf, you will need to import the derelict.sdl.ttf and derelict.sdl.sdl modules.
  3. You must link your application with the DerelictSDL, DerelictSDLttf and DerelictUtil libraries.
  4. Before calling any SDL_ttf functions, you need to make a call to DerelictSDLttf.load(). This will load the shared library.

The following is a complete program that loads DerelictSDLttf: 


import derelict.sdl.ttf;

void main()
{
    DerelictSDLttf.load();

    // now you can call SDL_ttf functions
}

As with other Derelict bindings, DerelictSDLttf will throw an exception if an error occurs while loading the shared library. For more information on Derelict exceptions, see the documentation for Using the Derelict Bindings.

Finally, the method DerelictSDLttf.unload() is provided for convenience. In normal practice you do not need to call this function, as Derelict will unload the library automatically when the app exits. You generally should only use this function if you need to unload DerelictSDLttf while the application is running or if you disable the automatic unloading of shared libraries (as per the documentation for the loader module).