Struct Assets 

pub struct Assets { /* private fields */ }

Implementations

impl Assets

pub fn for_thread(&self) -> Assets

A copy for a worker thread (wasi-threads): the same names and versions, its own file handles and cache (files are reopened or duplicated, memory copied). Changes made later (set_asset, --watch-asset) reach threads started after them.

impl Assets

pub fn new() -> Assets

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn insert_memory(&mut self, name: &str, bytes: Vec<u8>)

Asset from memory (overrides any entry with the same name).

pub fn insert_file(&mut self, name: &str, path: &Path) -> Result<(), String>

Asset backed by a file, opened now and read on demand (overrides any entry with the same name).

pub fn add_dir( &mut self, prefix: Option<&str>, dir: &Path, ) -> Result<usize, String>

Expose every regular file under dir (recursively), named [prefix/]relative/path. Existing names are kept (explicit assets win). Returns the number of files added. Call Assets::finish afterwards.

pub fn add_mods( &mut self, dir: &Path, ) -> Result<(Vec<String>, Vec<(String, String)>), String>

--mods <dir>: the folder’s resource packs (*.pck, *.zip, top level, not hidden), each read on demand as mods/<file name>, sorted by name (the load order). Files that can’t be read are refused, not fatal: the game gets them as asset mods.refused (name<TAB>reason lines) and they’re logged. Returns (mounted, refused).

pub fn refuse_mod(&mut self, file: &str, why: &str)

Refuse a mounted mod (before the game starts): unmounted, and its line added to mods.refused.

pub fn set(&mut self, name: &str, bytes: Vec<u8>) -> u32

Add or replace an asset from memory while the game runs (between frames): it gets a new version. Returns that version.

pub fn set_file(&mut self, name: &str, path: &Path) -> Result<u32, String>

Assets::set with a file read on demand (opened now).

pub fn remove(&mut self, name: &str) -> bool

Remove an asset while the game runs (between frames). False if there was none.

pub fn finish(&mut self)

Build the case-insensitive index and the sorted name list; logs collisions.

pub fn get(&self, name: &str) -> Option<Asset<'_>>

Look an asset up (exact name, then case-insensitively among folder entries).

pub fn size(&self, name: &str) -> Option<u64>

Current size in bytes, or None if there is no such asset.

pub fn read_at(&self, name: &str, offset: u64, dst: &mut [u8]) -> Option<usize>

Copy bytes starting at offset into dst (see Asset::read_at), or None if there is no such asset.

pub fn version(&self, name: &str) -> Option<u32>

The asset’s version (see Asset::version), or None if there is no such asset.

pub fn names(&self) -> &[String]

All asset names, sorted (by UTF-8 bytes).

Trait Implementations

impl Default for Assets

fn default() -> Self

Returns the “default value” for a type.

impl From<HashMap<String, Vec<u8>>> for Assets

fn from(map: HashMap<String, Vec<u8>>) -> Assets

Converts to this type from the input type.