DerelictSDLImage
Introduction
DerelictSDLImage is a D binding to Sam Lantinga's
SDL_image, a cross
platform image loading library designed to be used together with
SDL.
This version of DerelictSDLImage requires SDL_image 1.2.3 or later.
Using
- Always make sure the DerelictSDLImage source modules are available on your import
path.
- In modules that make use of DerelictSDLImage, you will need to import the
derelict.SDLImage.SDLImage module.
- Before calling any SDLImage functions, you need to make a call to DerelictSDLImage.load.
This will load the shared library.
The following is a complete program that loads DerelictSDLImage:
import derelict.sdl.image;
void main()
{
DerelictSDLImage.load();
// now you can call SDL_image functions
}
As with other Derelict packages, DerelictSDLImage will throw an exception if an error
occurs while loading the shared library. For more information on Derelict
exceptions, see the documentation for
Loading/Unloading Shared Libraries.
In any module that calls SDL_image functions, you will also need
to import derelict.sdl.sdl. This is not required to load the library, as shown
above.
Finally, the method DerelictSDLImage.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 DerelictSDL while the application is running.
Dependencies
DerelictUtil
DerelictSDL