Struct Assets 

pub struct Assets<T: AssetSource> { /* private fields */ }

Unified storage for source and processed assets of type T.

Each entry holds both the raw source data (T) and the uploaded result (T::Processed), keyed by the same Handle<T>. AssetPlugin fills in processed after a successful Asset::upload.

Use get to retrieve the processed result (e.g. for rendering), and get_source to access the raw data.

Implementations

impl<T: AssetSource> Assets<T>

pub fn new() -> Self

pub fn insert(&mut self, name: &str, source: T) -> Handle<T>

Insert source under name, returning its handle.

If an asset with the same name already exists, its source data is replaced in-place (the same handle is reused and re-queued for re-upload), and any previously processed result is cleared.

pub fn get(&self, handle: Handle<T>) -> Option<&T::Processed>

Look up the processed (uploaded) asset for handle.

Returns None if the handle is null, stale, or the asset has not finished uploading yet.

pub fn get_source(&self, handle: Handle<T>) -> Option<&T>

Look up the raw source data for handle.

pub fn get_source_mut(&mut self, handle: Handle<T>) -> Option<&mut T>

Mutably look up the raw source data for handle.

pub fn is_ready(&self, handle: Handle<T>) -> bool

Returns true if handle exists and its processed asset is ready. Never logs — safe to poll speculatively.

pub fn contains(&self, handle: Handle<T>) -> bool

Returns true if handle currently refers to a present entry. Never logs — safe to poll speculatively.

pub fn get_by_name(&self, name: &str) -> Option<&T::Processed>

Look up the processed asset by the name it was inserted under. None if the name is unknown or the asset hasn’t uploaded yet — not logged, since “still uploading” is a normal transient state.

pub fn get_source_by_name(&self, name: &str) -> Option<&T>

Look up the raw source data by the name it was inserted under.

pub fn get_handle_by_name(&self, name: &str) -> Option<Handle<T>>

Look up a handle by name.

pub fn replace(&mut self, handle: Handle<T>, source: T) -> bool

Replace the source data for handle, invalidating the processed result and re-queuing for upload. Returns false if the handle is null or not present.

pub fn mark_dirty(&mut self, handle: Handle<T>)

Mark a single asset as dirty so the sync system re-uploads it next tick, even though its source data has not changed (e.g. a dependency was recreated). Does nothing if the handle is null or not present.

pub fn remove(&mut self, handle: Handle<T>) -> Option<T>

Remove an asset by handle, returning the source value if it existed. The processed asset is also discarded.

pub fn remove_by_name(&mut self, name: &str) -> Option<T>

Remove an asset by name, returning the source value if it existed.

pub fn iter(&self) -> impl Iterator<Item = (RawAssetHandle, &T::Processed)>

Iterate over all entries that have a processed result ready.

pub fn iter_source(&self) -> impl Iterator<Item = (RawAssetHandle, &T)>

Iterate over all source entries regardless of upload state.

pub fn names(&self) -> impl Iterator<Item = (&str, RawAssetHandle)>

Iterate over (name, handle) pairs for every named asset.