cl-sdl2 is a Common Lisp wrapper for the SDL 2.0 C Library, with many contributors, maintained primarily by the following:
- Chip Collier photex@lofidelitygames.com
- Ryan Pavlik rpavlik@gmail.com
- Peter Keller psilord@cs.wisc.edu
It is licensed under the MIT license.
sdl2 is in Quicklisp, see below for instructions.
On Linux, you can probably find SDL2 in your distribution's package set. For other platforms, or for building manually, download the source.
If you need to compile from source for your Linux platform:
- Download the source tar-ball.
- tar zxf SDL2-0.0.0.tar.gz
- ./configure
- make
- sudo make install
This will install the SDL-2.0.3 C Library into your /usr/local location.
It's generally a good idea to install at a minimum the version of SDL2 that was wrapped; however, sub revisions should not introduce binary incompatibility and should be fine. If you install a different version, certain features may not be available or may not work correctly.
sdl2 is best installed via QuickLisp, though for cutting-edge changes, you may want to install from github as below.
If you don't have Quicklisp, then follow the directions to install it. We assume you placed the Quicklisp repository in the default place as indicated by the directions and have added it to your lisp init file.
- cd $HOME/quicklisp/local-projects
- git clone https://github.com/rpav/cl-autowrap.git
- git clone https://github.com/lispgames/cl-sdl2.git
Then, use quicklisp to install the libraries required by cl-sdl2:
Start your lisp. Then, just:
(ql:quickload "sdl2")Start your lisp:
(asdf:load-system :sdl2-examples)
(sdl2-examples:basic-test)This example will open a window with an opengl primitive in it. Any mouse movements or keystrokes are recorded in the terminal (or emacs SLIME output buffer). Hitting the ESCAPE key will terminate the example.
Thank you for using sdl2!