cl-sdl2-image
2024-10-12
Bindings for sdl2_image using autowrap
cl-sdl2-image
This is a (currently) brief but usable wrap for SDL2_image. Currently, this exports the following:
(sdl2-image:init LIST-OF-FORMATS)
: Initialize and loadLIST-OF-FORMATS
, which should be a list of any combination of the keyword:png
,:jpg
, and:tif
. This callsIMG_Init()
.(sdl2-image:quit)
: This callsIMG_Quit()
.(sdl2-image:load-image FILENAME)
: This callsIMG_Load()
on the filename, and returns anSDL-SURFACE
.
These functions act more or less like their wrapped equivalents; see the SDL_image 2.0 documentation for details.
Regenerating CFFI Bindings
This library uses cl-autowrap to generate CFFI bindings. If you need to regenerate the bindings, follow these steps:
- Delete the existing bindings:
$ rm -f src/spec/SDL_image.*.spec
- Reload the system in a REPL. This action will automatically regenerate the bindings:
${LISP-sbcl} \
--load "sdl2-image.asd" \
--eval "(ql:quickload '(:sdl2-image))" \
--eval "(uiop:quit)"
In most cases, this process should work without issues. However, if you encounter problems (usually due to environment-specific factors like missing include headers), you can use the C_INCLUDE_PATH
environment variable to specify additional include paths:
C_INCLUDE_PATH=/data1/include:/data1/lib/include \
${LISP-sbcl} \
--load "sdl2-image.asd" \
--eval "(ql:quickload '(:sdl2-image))" \
--eval "(uiop:quit)"
This approach allows you to provide the necessary include paths without modifying the source code.
Issues
If you require further functions, please file an issue, pull request, or inquire in #lispgames
on freenode.
If you can't load libSDL2_image
, please ensure that you have SDL_image 2.0 installed, and not just 1.2. Earlier versions will not work correctly. In the case of Windows, please ensure this, along with SDL2's DLLs, are installed in the same directory as your Lisp .exe
.
If you are sure all of this is correct, and it still will not load, please file an issue and specify:
- Your platform and architecture
- Your lisp
- The absolute path to your installed
.so
,.dll
, or the appropriate OSX framework