// raylib-zig (c) Nikolas Wipper 2020-2024 const std = @import("std"); const this = @This(); const rl = @import("raylib"); pub const emcc = @import("emcc.zig"); pub const Options = struct { raudio: bool = true, rmodels: bool = true, rshapes: bool = true, rtext: bool = true, rtextures: bool = true, platform: PlatformBackend = .glfw, shared: bool = false, linux_display_backend: LinuxDisplayBackend = .X11, opengl_version: OpenglVersion = .auto, }; pub const OpenglVersion = enum { auto, gl_1_1, gl_2_1, gl_3_3, gl_4_3, gles_2, gles_3, }; pub const LinuxDisplayBackend = enum { X11, Wayland, }; pub const PlatformBackend = enum { glfw, rgfw, sdl, drm, }; const Program = struct { name: []const u8, path: []const u8, desc: []const u8, }; fn link( b: *std.Build, exe: *std.Build.Step.Compile, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode, options: Options, ) void { const lib = getRaylib(b, target, optimize, options); const target_os = exe.rootModuleTarget().os.tag; switch (target_os) { .windows => { exe.linkSystemLibrary("winmm"); exe.linkSystemLibrary("gdi32"); exe.linkSystemLibrary("opengl32"); }, .macos => { exe.linkFramework("OpenGL"); exe.linkFramework("Cocoa"); exe.linkFramework("IOKit"); exe.linkFramework("CoreAudio"); exe.linkFramework("CoreVideo"); }, .freebsd, .openbsd, .netbsd, .dragonfly => { exe.linkSystemLibrary("GL"); exe.linkSystemLibrary("rt"); exe.linkSystemLibrary("dl"); exe.linkSystemLibrary("m"); exe.linkSystemLibrary("X11"); exe.linkSystemLibrary("Xrandr"); exe.linkSystemLibrary("Xinerama"); exe.linkSystemLibrary("Xi"); exe.linkSystemLibrary("Xxf86vm"); exe.linkSystemLibrary("Xcursor"); }, .emscripten, .wasi => { // When using emscripten, the libries don't need to be linked // because emscripten is going to do that later. }, else => { // Linux and possibly others. exe.linkSystemLibrary("GL"); exe.linkSystemLibrary("rt"); exe.linkSystemLibrary("dl"); exe.linkSystemLibrary("m"); exe.linkSystemLibrary("X11"); }, } exe.linkLibrary(lib); } var _raylib_lib_cache: ?*std.Build.Step.Compile = null; fn getRaylib(b: *std.Build, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode, options: Options) *std.Build.Step.Compile { if (_raylib_lib_cache) |lib| return lib else { const raylib = b.dependency("raylib", .{ .target = target, .optimize = optimize, .raudio = options.raudio, .rmodels = options.rmodels, .rshapes = options.rshapes, .rtext = options.rtext, .rtextures = options.rtextures, .platform = options.platform, .shared = options.shared, .linux_display_backend = options.linux_display_backend, .opengl_version = options.opengl_version, }); const lib = raylib.artifact("raylib"); const raygui_dep = b.dependency("raygui", .{ .target = target, .optimize = optimize, }); var gen_step = b.addWriteFiles(); lib.step.dependOn(&gen_step.step); const raygui_c_path = gen_step.add("raygui.c", "#define RAYGUI_IMPLEMENTATION\n#include \"raygui.h\"\n"); lib.addCSourceFile(.{ .file = raygui_c_path, .flags = &[_][]const u8{ "-std=gnu99", "-D_GNU_SOURCE", "-DGL_SILENCE_DEPRECATION=199309L", "-fno-sanitize=undefined", // https://github.com/raysan5/raylib/issues/3674 }, }); lib.addIncludePath(raylib.path("src")); lib.addIncludePath(raygui_dep.path("src")); lib.installHeader(raygui_dep.path("src/raygui.h"), "raygui.h"); b.installArtifact(lib); _raylib_lib_cache = lib; return lib; } } fn getModule(b: *std.Build, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode) *std.Build.Module { if (b.modules.contains("raylib")) { return b.modules.get("raylib").?; } return b.addModule("raylib", .{ .root_source_file = b.path("lib/raylib.zig"), .target = target, .optimize = optimize, }); } const gui = struct { fn getModule(b: *std.Build, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode) *std.Build.Module { const raylib = this.getModule(b, target, optimize); return b.addModule("raygui", .{ .root_source_file = b.path("lib/raygui.zig"), .imports = &.{.{ .name = "raylib-zig", .module = raylib }}, .target = target, .optimize = optimize, }); } }; pub fn build(b: *std.Build) !void { const target = b.standardTargetOptions(.{}); const optimize = b.standardOptimizeOption(.{}); const defaults = Options{}; const options = Options{ .platform = b.option(PlatformBackend, "platform", "Compile raylib in native mode (no X11)") orelse defaults.platform, .raudio = b.option(bool, "raudio", "Compile with audio support") orelse defaults.raudio, .rmodels = b.option(bool, "rmodels", "Compile with models support") orelse defaults.rmodels, .rtext = b.option(bool, "rtext", "Compile with text support") orelse defaults.rtext, .rtextures = b.option(bool, "rtextures", "Compile with textures support") orelse defaults.rtextures, .rshapes = b.option(bool, "rshapes", "Compile with shapes support") orelse defaults.rshapes, .shared = b.option(bool, "shared", "Compile as shared library") orelse defaults.shared, .linux_display_backend = b.option(LinuxDisplayBackend, "linux_display_backend", "Linux display backend to use") orelse defaults.linux_display_backend, .opengl_version = b.option(OpenglVersion, "opengl_version", "OpenGL version to use") orelse defaults.opengl_version, }; const examples = [_]Program{ .{ .name = "raw_stream", .path = "examples/audio/raw_stream.zig", .desc = "Plays a sine wave", }, .{ .name = "basic_screen_manager", .path = "examples/core/basic_screen_manager.zig", .desc = "Illustrates simple screen manager based on a state machine", }, .{ .name = "basic_window", .path = "examples/core/basic_window.zig", .desc = "Creates a basic window with text", }, .{ .name = "input_keys", .path = "examples/core/input_keys.zig", .desc = "Simple keyboard input", }, .{ .name = "input_mouse", .path = "examples/core/input_mouse.zig", .desc = "Simple mouse input", }, .{ .name = "input_mouse_wheel", .path = "examples/core/input_mouse_wheel.zig", .desc = "Mouse wheel input", }, .{ .name = "input_multitouch", .path = "examples/core/input_multitouch.zig", .desc = "Multitouch input", }, .{ .name = "2d_camera", .path = "examples/core/2d_camera.zig", .desc = "Shows the functionality of a 2D camera", }, .{ .name = "3d_camera_first_person", .path = "examples/core/3d_camera_first_person.zig", .desc = "Simple first person demo", }, .{ .name = "3d_camera_free", .path = "examples/core/3d_camera_free.zig", .desc = "Shows basic 3d camera initialization", }, .{ .name = "2d_camera_mouse_zoom", .path = "examples/core/2d_camera_mouse_zoom.zig", .desc = "Shows mouse zoom demo", }, .{ .name = "3d_picking", .path = "examples/core/3d_picking.zig", .desc = "Shows picking in 3d mode", }, .{ .name = "window_flags", .path = "examples/core/window_flags.zig", .desc = "Demonstrates various flags used during and after window creation", }, .{ .name = "texture_outline", .path = "examples/shaders/texture_outline.zig", .desc = "Uses a shader to create an outline around a sprite", }, .{ .name = "logo_raylib", .path = "examples/shapes/logo_raylib.zig", .desc = "Renders the raylib-zig logo", }, .{ .name = "sprite_anim", .path = "examples/textures/sprite_anim.zig", .desc = "Animate a sprite", }, .{ .name = "textures_background_scrolling", .path = "examples/textures/textures_background_scrolling.zig", .desc = "Background scrolling & parallax demo", }, .{ .name = "text_format_text", .path = "examples/text/text_format_text.zig", .desc = "Renders variables as text", }, .{ .name = "textures_image_loading", .path = "examples/textures/textures_image_loading.zig", .desc = "Image loading and texture creation", }, // .{ // .name = "models_loading", // .path = "examples/models/models_loading.zig", // .desc = "Loads a model and renders it", // }, // .{ // .name = "shaders_basic_lighting", // .path = "examples/shaders/shaders_basic_lighting.zig", // .desc = "Loads a model and renders it", // }, }; const raylib = this.getModule(b, target, optimize); const raygui = this.gui.getModule(b, target, optimize); const raylib_test = b.addTest(.{ .root_source_file = b.path("lib/raylib.zig"), .target = target, .optimize = optimize, }); const raygui_test = b.addTest(.{ .root_source_file = b.path("lib/raygui.zig"), .target = target, .optimize = optimize, }); raygui_test.root_module.addImport("raylib-zig", raylib); const test_step = b.step("test", "Check for library compilation errors"); test_step.dependOn(&raylib_test.step); test_step.dependOn(&raygui_test.step); const examples_step = b.step("examples", "Builds all the examples"); for (examples) |ex| { if (target.query.os_tag == .emscripten) { const exe_lib = try emcc.compileForEmscripten(b, ex.name, ex.path, target, optimize); exe_lib.root_module.addImport("raylib", raylib); exe_lib.root_module.addImport("raygui", raygui); const raylib_lib = getRaylib(b, target, optimize, options); // Note that raylib itself isn't actually added to the exe_lib // output file, so it also needs to be linked with emscripten. exe_lib.linkLibrary(raylib_lib); const link_step = try emcc.linkWithEmscripten(b, &[_]*std.Build.Step.Compile{ exe_lib, raylib_lib }); link_step.addArg("--embed-file"); link_step.addArg("resources/"); const run_step = try emcc.emscriptenRunStep(b); run_step.step.dependOn(&link_step.step); const run_option = b.step(ex.name, ex.desc); run_option.dependOn(&run_step.step); examples_step.dependOn(&exe_lib.step); } else { const exe = b.addExecutable(.{ .name = ex.name, .root_source_file = b.path(ex.path), .optimize = optimize, .target = target, }); this.link(b, exe, target, optimize, options); exe.root_module.addImport("raylib", raylib); exe.root_module.addImport("raygui", raygui); const run_cmd = b.addRunArtifact(exe); const run_step = b.step(ex.name, ex.desc); run_step.dependOn(&run_cmd.step); examples_step.dependOn(&exe.step); } } }