Skip to content

JonSnowbd/ZT

Repository files navigation

A zig-contained library for Windows and Ubuntu that automatically compiles and links ImGui, OpenGL, stb_image, and GLFW into typed packages.

ZT will always target the latest dev version of Zig, and will create a branch for stable releases when convenient.

Check out the wiki for documentation and help.

For Applications

Get your applications done quick with industry standard ImGui library, used by a bunch of applications for its convenience and power.

Using ImGui is as simple as calling the functions! ZT will render everything for you without ever needing to touch gamedev code.


For Games

With ImGui at the forefront for free, debugging and creating editors for your game is as smooth as it can be without deciding anything for you


Overview

To work with ZT You will need:

  • Zig 0.11.* Main branch build. Nightly might work as well (last tested 0.12.0-dev.1856+94c63f31f).
  • Ubuntu: sudo apt install build-essential xorg-dev

Current Status

  • ZT when used for the purpose of GL/ImGui libraries is very stable
  • ZT.App is still receiving breaking changes as I find where I can make the library more flexible for casual use, but overall I find it convenient for applications and games

See the example for what ZT.App has to offer.

Why

ZT is intended for an extremely broad group of developers in zig realtime graphics and applications, as it does not railroad you into using its app+windowing interface to function, and is better viewed as the following goals being accomplished without any resistance:

  • Linear Algebra and Math types
  • Cross platform windowing (GLFW) within Zig
  • OpenGL binding within Zig
  • Completely up to date (c)ImGui Docking branch bindings within Zig
  • STB_Image bindings within Zig
  • (Optional) barebones wrappers around basic opengl constructs like shaders/textures/buffers

and additionally a ready to go combination of all 3 that lets you just immediately use close to the metal OpenGL constructs to just work on your application with convenience for use as desktop application code such as Energy Saving mode.

Getting Started

First you'll want to clone this into your zig project's folder, and const ztBuild = @import("path/to/ZT/build.zig") in your own build.zig to import this framework's build.zig, and that will expose some important functions to link ZT into your project.

  • ztBuild.link(exe) will add ZT's packages to your exe and link the source files for GLFW/GL/ImGui
  • (optional) ztBuild.addBinaryContent("path/to/binContent") adds binary content to your zig-out folder output, basically the folder structure ends up being as if path/to/binContent was the root folder containing your executable. This is smart and will skip older assets.

So with ztBuild imported you just ztBuild.link(exe) and you can start importing and using ZT, or if you so choose, completely ignore ZT and use raw opengl/glfw/imgui.

Then getting started is as easy as this:

const std = @import("std");
const zt = @import("zt");

/// SampleData will be available through the context anywhere.
const SampleData = struct {
    yourData: i32 = 0,
};

const SampleApplication = zt.App(SampleData);

pub fn main() !void {
    var context = try SampleApplication.begin(std.heap.c_allocator);
    // Config here,
    while(context.open) {
        context.beginFrame();
        // Application code here!
        context.data.yourData += 1;
        context.endFrame();
    }
    // Unload here
    context.deinit();
}

For a more indepth example see the example file that shows opengl rendering mixed with imgui and more

Gotcha:

  • ZT.App.begin sets its own GLFW user pointer! Its important too, so use something else for your storage, or if you really want the functionality, let me know and I'll see how I can enable your usecase within ZT.
  • By linking ZT the following packages are available to your app on both windows and ubuntu: zt, gl, glfw, imgui, stb_image
  • ImVec2 and ImVec4 are both substituted with zlm's Vec2 and Vec4 structs respectively, you can use both interchangeably.
  • Disabling power saving mode will let GLFW handle buffer flip timing, so likely will be at vsync fps rather than on every event, unless you disable vsync.
  • Need direct access to the input queue? Your context contains an ArrayList of tagged unions that summarizes every input event. Try to use this instead of overriding GLFW event callbacks.

Credits

About

A zig based Imgui Application framework

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages