ZBgfx

When zig meets bgfx.

Features

Zig api.
Compile as standard zig library.
shaderc as build artifact.
Shader compile in build.zig to *.bin.h.
Shader compile in build.zig and embed as zig module. (this is zig equivalent of *.bin.h)
Shader compile from runtime via shaderc as child process.
Binding for DebugDraw API
imgui render backend. Use build option imgui_include to enable. ex. for zgui: .imgui_include = zgui.path("libs").getPath(b),
Zig based allocator.

IMPORTANT
This is only zig binding. For BGFX stuff goto bgfx.

WARNING

• shaderc need some time to compile.

NOTE

• If you build shaders/app and see something like run shaderc (shader.bin.h) stderr. This is not "true" error (build success), but only in debug build shader print some stuff to stderr and zig build catch it.

License

Folders libs, shaders is copy&paste from bgfx for more sell-contained experience and is licensed by LICENSEE

Zig binding is licensed by WTFPL

Zig version

Minimal is 0.15.1. But you know try your version and believe.

Bgfx version

• BX
• BImg
• BGFX

Getting started

Copy zbgfx to a subdirectory of your project and then add the following to your build.zig.zon .dependencies:

    .zbgfx = .{ .path = "path/to/zbgfx" },

or use zig fetch --save ... way.

Then in your build.zig add:

pub fn build(b: *std.Build) void {
    const exe = b.addExecutable(.{ ... });

    const zbgfx = b.dependency("zbgfx", .{});
    exe.root_module.addImport("zbgfx", zbgfx.module("zbgfx"));
    exe.linkLibrary(zbgfx.artifact("bgfx"));

    // This install shaderc to install dir
    // For shader build in build =D check examples
    // b.installArtifact(zbgfx.artifact("shaderc"));
}

Usage

See examples for binding usage and bgfx for bgfx stuff.

Build options

Examples

Run this for build all examples:

cd examples
zig build

00-Minimal

Minimal setup with GLFW for window and input.

examples/zig-out/bin/00-minimal

01-ZGui

Minimal setup for zgui/ImGui.

examples/zig-out/bin/01-zgui

02-Runtime shaderc

Basic usage of shader compile in runtime. Try edit shaders in zig-out/bin/shaders and hit r to recompile.

examples/zig-out/bin/02-runtime-shaderc

03-debugdraw

DebugDraw api usage example.

examples/zig-out/bin/03-debugdraw