Struct ShaderBuild 

pub struct ShaderBuild { /* private fields */ }

Builder for the shader build pipeline.

Configure source/output directories and optional custom file-type handlers, then call .build() to compile all shaders.

Implementations

impl ShaderBuild

pub fn new() -> Self

Creates a new ShaderBuild with default directories.

Defaults:

• source_dir: "shaders/"
• output_dir: "assets/build/shaders/"
• spirv_dir: "build/shaders/spirv/"
• hash_file: "build/shaders/hashes.json"

pub fn source_dir(self, dir: &str) -> Self

Sets the source directory containing shader files.

pub fn output_dir(self, dir: &str) -> Self

Sets the output directory for compiled GLSL ES shaders.

pub fn slangc_path(self, path: &str) -> Self

Sets a custom path to the slangc compiler.

By default, slangc is located via PATH. Use this if slangc is not on PATH or you want to pin a specific version.

Example

ShaderBuild::new()
    .slangc_path("/opt/slang/bin/slangc")
    .build();

pub fn override_file_type_handler( self, extension: &str, handler: impl Fn(&Path, &Path) -> Vec<String> + 'static, ) -> Self

Registers a custom file-type handler for a given extension.

The handler receives (file_path, output_dir) and should:

1. Compile the file and write output to output_dir
2. Add the "//! DO NOT EDIT" header to generated files
3. Return glob patterns for additional dependency files

Example

ShaderBuild::new()
    .override_file_type_handler(".wgsl", |file_path, output_dir| {
        // Custom compilation logic here
        vec!["shaders/includes/**/*.wgsl".to_string()]
    })
    .build();

pub fn build(self)

Runs the shader build pipeline.

This will:

1. Scan the source directory for shader files
2. Check content hashes for incremental builds
3. Compile changed shaders using the appropriate pipeline
4. Write compiled GLSL ES output to the output directory
5. Update the hash file

Trait Implementations

impl Default for ShaderBuild

fn default() -> Self

Returns the “default value” for a type.