Struct AssetSource 

pub struct AssetSource { /* private fields */ }

Where a world’s assets live, and where fetched ones are cached.

Implementations

impl AssetSource

pub fn local(base_dir: impl Into<PathBuf>) -> Self

A local world: relative URIs resolve against base_dir; absolute URLs still fetch to a shared cache.

pub fn hosted( base_dir: impl Into<PathBuf>, base_url: Option<String>, cache_dir: impl Into<PathBuf>, ) -> Self

A hosted world: base_url is the world’s directory URL (relative URIs resolve against it); remote assets cache under cache_dir.

pub fn resolve(&self, uri: &str) -> Option<PathBuf>

Resolve an asset URI to a readable local path, fetching + caching if remote. Returns None if a remote fetch failed (the caller degrades gracefully — e.g. falls back to a built-in mesh or a flat colour).

pub fn prefetch(&self, manifest: &WorldManifest)

Download every remote asset in manifest into the cache (idempotent). Run on a background thread before the main-thread GPU load so it only reads locally.