mach-sdl

SDL3 (and SDL3_ttf, SDL3_image and SDL3_mixer) bindings for the mach programming language.

Requirements

• A mach compiler matching the required version range (mach info prints your version).
• Linux: The SDL3 development files, so that libSDL3.so, libSDL3_ttf.so, libSDL3_image.so and libSDL3_mixer.so (not just the .so.0 symlinks) are available in a standard library directory such as /usr/lib or /usr/lib/<arch>-linux-gnu.
• Windows: After building your .exe, you need to manually copy SDL3.dll, SDL3_ttf.dll, SDL3_image.dll and SDL3_mixer.dll into the same directory as the executable.
• macOS: libSDL3.dylib, libSDL3_ttf.dylib, libSDL3_image.dylib and libSDL3_mixer.dylib in /usr/local/lib. Refer to MACOS.md for more information.

Usage

Add this repo to your project by running:

mach dep add . sdl --git https://github.com/Wmakes/mach-sdl

Or add it as a dependency in your mach.toml by hand:

[dep.sdl]
git = "https://github.com/Wmakes/mach-sdl"
ref = "branch/master"

Then import the modules you need, e.g. use sdl.window;.

Documentation is accessible via mach doc.

Status

mach-sdl is still a work in progress and does not yet implement the entirety of SDL3. Some APIs and functionality may be missing or incomplete.

If you need an SDL3 feature that isn't currently available in mach-sdl, you're encouraged to implement it and open a pull request. Contributions that help expand the bindings and improve SDL3 coverage are very welcome.

License

GNU Lesser General Public License v3.0. See COPYING.LESSER and LICENSE.