raylib-zig

Manually tweaked, auto-generated raylib bindings for zig.

Bindings tested on raylib version 5.0 and Zig 0.11.0/0.12.0-dev.1849+bb0f7d55e

Thanks to all the contributors for their help with this binding.

Example

const rl = @import("raylib");

pub fn main() anyerror!void {
    // Initialization
    //--------------------------------------------------------------------------------------
    const screenWidth = 800;
    const screenHeight = 450;

    rl.initWindow(screenWidth, screenHeight, "raylib-zig [core] example - basic window");
    defer rl.closeWindow(); // Close window and OpenGL context

    rl.setTargetFPS(60); // Set our game to run at 60 frames-per-second
    //--------------------------------------------------------------------------------------

    // Main game loop
    while (!rl.windowShouldClose()) { // Detect window close button or ESC key
        // Update
        //----------------------------------------------------------------------------------
        // TODO: Update your variables here
        //----------------------------------------------------------------------------------

        // Draw
        //----------------------------------------------------------------------------------
        rl.beginDrawing();
        defer rl.endDrawing();

        rl.clearBackground(rl.Color.white);

        rl.drawText("Congrats! You created your first window!", 190, 200, 20, rl.Color.light_gray);
        //----------------------------------------------------------------------------------
    }
}

Building the examples

To build all available examples simply zig build examples. To list available examples run zig build --help. If you want to run an example, say basic_window run zig build basic_window

Building and using

(Optional) Install raylib
Execute project_setup.sh project_name, this will create a folder with the name specified
You can copy that folder anywhere you want and edit the source
Run zig build run at any time to test your project

Exporting for web

To export your project for the web, first install emsdk. Once emsdk is installed, set it up by running

emsdk install latest

Find the folder where it's installed and run

zig build -Dtarget=wasm32-emscripten --sysroot [path to emsdk]/upstream/emscripten

once that is finished, the exported project should be located at zig-out/htmlout

When is the binding updated?

I plan on updating it every mayor release (2.5, 3.0, etc.). Keep in mind these are technically header files, so any implementation stuff should be updatable with some hacks on your side.

What needs to be done?

(Done) Set up a proper package build and a build script for the examples
Port all the examples
Member functions/initialisers

stalengd / raylib-zig