2 unstable releases

0.2.0 Jan 17, 2024
0.1.0 Mar 21, 2020

#658 in Graphics APIs

37 downloads per month

MIT/Apache

14KB
236 lines

hotglsl Build Status Crates.io Crates.io docs.rs

A simple crate for hotloading GLSL shaders as SPIR-V.

fn main() {
    let shader_dir = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
        .join("examples")
        .join("shaders");
    let watch = hotglsl::watch(&shader_dir).unwrap();
    println!("Edit the shaders in `examples/shaders/`!");
    loop {
        watch.await_event().unwrap();

        // On some OSes, a whole bunch of events will occur at once. Wait for
        // this to happen to avoid compiling our shader(s) twice unnecessarily.
        std::thread::sleep(std::time::Duration::from_millis(10));

        // Compile each shader that has been touched and produce the result.
        for (path, result) in watch.compile_touched().unwrap() {
            println!("Tried compiling {:?}:", path);
            match result {
                Ok(_spirv_bytes) => println!("  Success!"),
                Err(e) => println!("  Woopsie!\n{}", e),
            }
        }
    }
}

Allows for watching one or more file and/or directory paths for GLSL shader file changes.

See the GLSL_EXTENSIONS const for supported GLSL extensions that will be watched. A hotglsl::Watch will ignore all events that don't involve a file with one of these extensions.

Uses the notify crate for file system events and the glsl-to-spirv crate for GLSL->SPIR-V compilation.

Dependencies

~5–15MB
~171K SLoC