Struct Assets 

pub struct Assets { /* private fields */ }

Implementations

impl Assets

pub fn new(root: impl AsRef<Path>) -> Result<Assets, Error>

Create with root as the asset directory. Path is canonicalized eagerly to make matching against notify events deterministic. On the web, root is a URL path relative to the page and is used as-is.

pub fn set_web_preload<I, S>(&mut self, paths: I)

where I: IntoIterator<Item = S>, S: AsRef<str>,

Natively, in debug builds: check reads against paths instead of manifest.txt, for a game that sets AppConfig::web_preload. No-op in release builds and on the web.

pub fn check_web_listed(&self, rel: impl AsRef<Path>)

Natively, in debug builds: warn (once per file) if rel isn’t in the web preload list, i.e. loading it would fail in the browser. Assets::read does this itself; call it when reading an asset some other way, e.g. by path. Does nothing when there is no list (no manifest.txt), for in-memory files, in release builds and on the web.

pub fn root(&self) -> &Path

pub fn resolve(&self, rel: impl AsRef<Path>) -> PathBuf

pub fn read(&self, rel: impl AsRef<Path>) -> Result<Vec<u8>, Error>

Read an asset’s bytes: from memory if it was inserted or preloaded, otherwise from disk (native only).

pub fn insert(&mut self, rel: impl AsRef<Path>, bytes: impl Into<Vec<u8>>)

Store bytes under rel, shadowing any file at that path.

pub fn is_loaded(&self, rel: impl AsRef<Path>) -> bool

Whether rel is available in memory (inserted or preloaded).

pub fn watch(&mut self) -> Result<(), Error>

Start watching the asset root recursively. Idempotent. On the web this logs that hot-reload is unavailable and returns Ok.

pub fn drain_changes(&mut self) -> Vec<PathBuf>

Drain all queued filesystem changes since last call. Paths are canonicalized when possible. Idempotent across re-saves within one frame (HashSet-deduped). Always empty on the web.