zsdl - SDL3 wrapper for Zig

SDL3 wrapper for Zig 0.14.0 built on top of castholm/SDL's Zig build system implementation for SDL.

Check out the documentation for more info.

Usage

zig fetch --save git+https://github.com/mdmrk/zsdl.git

const zsdl = b.dependency("zsdl", .{
    .target = target,
    .optimize = optimize,
});
exe.root_module.addImport("zsdl", zsdl.module("zsdl"));

Example

const std = @import("std");

const zsdl = @import("zsdl");

pub fn main() !void {
    try zsdl.init(.{ .video = true });
    defer zsdl.quit();

    const window = try zsdl.video.Window.create(
        "redbed",
        1280,
        720,
        .{ .resizable = true },
    );
    defer window.destroy();

    main_loop: while (true) {
        while (zsdl.events.pollEvent()) |event| {
            switch (event) {
                .quit => {
                    break :main_loop;
                },
                .window => |w| {
                    switch (w.data) {
                        .resized => |size| {
                            std.debug.print(
                                "window resized: (w: {any}, h: {any})\n",
                                .{ size.width, size.height },
                            );
                        },
                        else => {},
                    }
                },
                else => {},
            }
        }
    }
}

Support

Category	Status
Init	🧪
Hints	❌
Error	🧪
Properties	❌
Log	❌
Video	🧪
Events	🧪
Keyboard	🧪
Mouse	🧪
Touch	✅
Gamepad	🧪
Joystick	🧪
Haptic	🧪
Audio	❌
Gpu	🧪
Clipboard	✅
Dialog	✅
Filesystem	❌
Iostream	❌
Atomic	❌
Time	❌
Timer	🧪
Render	🧪
Pixels	✅
Surface	🧪
Platform	❌
Misc	❌
Main	❌
Strings	❌
CPU	❌
Intrinsics	❌
Locale	❌
System	❌
Metal	❌
Vulkan	❌

Legend:

• ✅ Fully implemented
• 🧪 Partially implemented/experimental
• ❌ Not implemented

Supported targets

Refer to supported targets.