Struct hotglsl::Watch

pub struct Watch { /* fields omitted */ }

Watches one or more paths for changes to GLSL shader files.

See the watch or watch_paths constructor functions.

Methods

impl Watch

pub fn await_event(&self) -> Result<(), AwaitEventError>

Block the current thread until some filesystem event has been received from notify.

This is useful when running the hotloading process on a separate thread.

pub fn try_next_path(&self) -> Result<Option<PathBuf>, NextPathError>

Checks for a new filesystem event.

If the event relates to a shader file, the path to that event is returned.

If the event relates to multiple shader files, the remaining files are buffered until the next call to next or try_next.

Returns an Err if the channel was closed or if one of the notify Watchers sent us an error.

pub fn paths_touched(&self) -> Result<HashSet<PathBuf>, NextPathError>

Returns all unique paths that have been changed at least once since the last call to paths_touched or compile_touched.

This uses try_next_path internally to collect all pending paths into a set containing each unique path only once.

pub fn compile_touched(
    &self
) -> Result<impl Iterator<Item = (PathBuf, Result<Vec<u8>, CompileError>)>, NextPathError>

Produce an iterator that compiles each touched shader file to SPIR-V.

Compilation of each file only begins on the produced iterator's next call.