Struct ShaderRegistry 

pub struct ShaderRegistry {
    pub cache_hits: u64,
    pub compilations: u64,
    /* private fields */
}

Central registry for shader sources and compiled variants.

Call ShaderRegistry::register to add a ShaderSource, then ShaderRegistry::get_or_compile to obtain a compiled variant, which is transparently cached in the internal VariantCache.

Fields

cache_hits: u64

Number of cache hits since creation.

compilations: u64

Number of compilations triggered since creation.

Implementations

impl ShaderRegistry

pub fn new(cache_capacity: usize) -> Self

Create a new empty registry with the given cache capacity.

pub fn register(&mut self, source: ShaderSource)

Register a shader source. Overwrites any existing source with the same name and clears cached variants for that name.

pub fn get_or_compile( &mut self, name: &str, defines: &HashMap<String, String>, ) -> Result<&CompiledVariant, RegistryError>

Get or compile a variant.

Returns Err when the source name is unknown or when a required placeholder is not supplied in defines.

pub fn shader_names(&self) -> Vec<&str>

Return all registered shader names.

pub fn cached_count(&self) -> usize

Return the number of entries currently in the variant cache.

pub fn invalidate(&mut self, name: &str)

Invalidate a single shader by name (clears its cached variants).

pub fn invalidate_all(&mut self)

Invalidate all cached variants.

impl ShaderRegistry

pub fn compile_variant( &mut self, name: &str, defines: &HashMap<String, String>, opts: &ShaderCompileOptions, ) -> Result<CompiledVariant, RegistryError>

Compile a specific shader variant with the given options.

Unlike get_or_compile this method always forces a fresh compilation (not served from the cache) and respects the max_source_bytes limit in opts.

impl ShaderRegistry

pub fn apply_hot_reload(&mut self, tracker: &HotReloadTracker) -> Vec<String>

Check a HotReloadTracker and invalidate any stale shader variants.

Returns the list of shader names that were invalidated.

pub fn registered_count(&self) -> usize

Return all shader names registered in this registry.

pub fn source_bytes(&self, name: &str) -> usize

Return the size (in WGSL source bytes) of the named shader, or 0.