https://github.com/zig-gamedev/zsdl
Zig bindings for SDL libs.
https://github.com/zig-gamedev/zsdl
bindings gamedev sdl sdl2 sdl2-image sdl2-ttf sdl3 zig
Last synced: 2 months ago
JSON representation
Zig bindings for SDL libs.
- Host: GitHub
- URL: https://github.com/zig-gamedev/zsdl
- Owner: zig-gamedev
- License: mit
- Created: 2024-11-04T21:35:24.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-25T22:48:33.000Z (3 months ago)
- Last Synced: 2025-03-25T23:30:48.994Z (3 months ago)
- Topics: bindings, gamedev, sdl, sdl2, sdl2-image, sdl2-ttf, sdl3, zig
- Language: C
- Homepage:
- Size: 1.07 MB
- Stars: 15
- Watchers: 2
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [zsdl](https://github.com/zig-gamedev/zsdl)
Zigified bindings for SDL libs. Work in progress.
## Getting started (SDL2)
Example `build.zig`:
```zig
pub fn build(b: *std.Build) !void {
const exe = b.addExecutable(.{ ... });
exe.linkLibC();
const zsdl = b.dependency("zsdl", .{});
exe.root_module.addImport("zsdl2", zsdl.module("zsdl2"));
@import("zsdl").link_SDL2(exe);
exe.root_module.addImport("zsdl2_ttf", zsdl.module("zsdl2_ttf"));
@import("zsdl").link_SDL2_ttf(exe);
exe.root_module.addImport("zsdl2_image", zsdl.module("zsdl2_image"));
@import("zsdl").link_SDL2_image(exe);
// Optionally use prebuilt libs instead of relying on system installed SDL...
@import("zsdl").prebuilt_sdl2.addLibraryPathsTo(exe);
if (@import("zsdl").prebuilt_sdl2.install(b, target.result, .bin), .{
.ttf = true,
.image = true,
}) |install_sdl2_step| {
b.getInstallStep().dependOn(install_sdl2_step);
}
}
```
NOTE: If you want to use our prebuilt libraries also add the following to your `build.zig.zon`:
```zig
.@"sdl2-prebuilt-macos" = .{
.url = "https://github.com/zig-gamedev/sdl2-prebuilt-macos/archive/f14773fa3de719b3a399b854c31eb4139d63842f.tar.gz",
.hash = "12205cb2da6fb4a7fcf28b9cd27b60aaf12f4d4a55be0260b1ae36eaf93ca5a99f03",
.lazy = true,
},
.@"sdl2-prebuilt-x86_64-windows-gnu" = .{
.url = "https://github.com/zig-gamedev/sdl2-prebuilt-x86_64-windows-gnu/archive/8143e2a5c28dbace399cbff14c3e8749a1afd418.tar.gz",
.hash = "1220ade6b84d06d73bf83cef22c73ec4abc21a6d50b9f48875f348b7942c80dde11b",
.lazy = true,
},
.@"sdl2-prebuilt-x86_64-linux-gnu" = .{
.url = "https://github.com/zig-gamedev/sdl2-prebuilt-x86_64-linux-gnu/archive/2eccc574ad909b0d00b694b10c217a95145c47af.tar.gz",
.hash = "12200ecb91c0596d0356ff39d573af83abcd44fecb27943589f11c2cd172763fea39",
.lazy = true,
},
```
Now in your code you may import and use `zsdl2`:
```zig
const std = @import("std");
const sdl = @import("zsdl2");
pub fn main() !void {
...
try sdl.init(.{ .audio = true, .video = true });
defer sdl.quit();
const window = try sdl.Window.create(
"zig-gamedev-window",
sdl.Window.pos_undefined,
sdl.Window.pos_undefined,
600,
600,
.{ .opengl = true, .allow_highdpi = true },
);
defer window.destroy();
...
}
```
## Getting started (SDL3)
TODO