Guile-SDL2

Guile-SDL2 provides Guile Scheme bindings for the SDL2 C shared library. The bindings are written in pure Scheme using Guile's foreign function interface.

Usage

Guile-SDL2 provides modules in the (sdl2 ...) namespace, roughly organized how the SDL2 C header files are organized. Low-level bindings are available in the(sdl2 bindings ...) namespace, but these are not recommended for normal usage.

Additionally, SDL2 extension library bindings are available in the following modules:

• SDL2_image: (sdl2 image)
• SDL2_mixer: (sdl2 mixer)
• SDL2_ttf: (sdl2 ttf)

Here is a short “hello, world” example program:

(use-modules (sdl2)
             (sdl2 render)
             (sdl2 surface)
             (sdl2 video))

(define (draw ren)
  (let* ((surface (load-bmp "hello.bmp"))
         (texture (surface->texture ren surface)))
    (clear-renderer ren)
    (render-copy ren texture)
    (present-renderer ren)
    (sleep 2)))

(sdl-init)

(call-with-window (make-window)
  (lambda (window)
    (call-with-renderer (make-renderer window) draw)))

(sdl-quit)

Documentation

View the reference manual

Releases

• 2022-10-23 — 0.8.0 — guile-sdl2-0.8.0.tar.gz — GPG signature
• 2021-10-07 — 0.7.0 — guile-sdl2-0.7.0.tar.gz — GPG signature
• 2021-04-13 — 0.6.0 — guile-sdl2-0.6.0.tar.gz — GPG signature
• 2020-04-07 — 0.5.0 — guile-sdl2-0.5.0.tar.gz — GPG signature
• 2019-06-02 — 0.4.0 — guile-sdl2-0.4.0.tar.gz — GPG signature
• 2018-10-16 — 0.3.1 — guile-sdl2-0.3.1.tar.gz — GPG signature
• 2018-07-10 — 0.3.0 — guile-sdl2-0.3.0.tar.gz — GPG signature
• 2017-01-20 — 0.2.0 — guile-sdl2-0.2.0.tar.gz — GPG signature
• 2016-08-10 — 0.1.2 — guile-sdl2-0.1.2.tar.gz — GPG signature
• 2016-01-01 — 0.1.1 — guile-sdl2-0.1.1.tar.gz — GPG signature
• 2015-12-22 — 0.1.0 — guile-sdl2-0.1.0.tar.gz — GPG signature

Requirements

• GNU Guile >= 2.0.9
• SDL2 >= 2.0.0
• SDL2_image >= 2.0.0
• SDL2_mixer >= 2.0.0
• SDL2_ttf >= 2.0.0

Installation

To install Guile-SDL2 with the GNU Guix package manager, run:

guix install guile-sdl2

To build and install Guile-SDL2 from source, run:

wget https://files.dthompson.us/releases/guile-sdl2/guile-sdl2-0.8.0.tar.gz
tar xf guile-sdl2-0.8.0.tar.gz
cd guile-sdl2-0.8.0
./configure
make
make install

License

GNU LGPLv3+

Git Repository

Guile-SDL2 is developed using the Git version control system. The official repository is hosted at https://git.dthompson.us/guile-sdl2.git.

To clone the repository, run:

git clone https://git.dthompson.us/guile-sdl2.git

Community

Real-time discussion for Guile-SDL2 can be found on the #guile channel on the Libera.chat IRC network

Contributing

Send patches and bug reports to davet@gnu.org.