Struct AssetStorage 

pub struct AssetStorage { /* private fields */ }

Type-erased container for all asset types.

AssetStorage is the main asset storage container that holds typed storages for each registered asset type. It provides both typed and untyped access patterns.

Example

use goud_engine::assets::{Asset, AssetStorage, AssetPath};

struct Texture { width: u32 }
impl Asset for Texture {}

struct Audio { duration: f32 }
impl Asset for Audio {}

let mut storage = AssetStorage::new();

// Insert different asset types
let tex_handle = storage.insert(Texture { width: 256 });
let audio_handle = storage.insert(Audio { duration: 2.5 });

// Type-safe access
assert_eq!(storage.get::<Texture>(&tex_handle).unwrap().width, 256);
assert_eq!(storage.get::<Audio>(&audio_handle).unwrap().duration, 2.5);

// Count by type
assert_eq!(storage.len::<Texture>(), 1);
assert_eq!(storage.len::<Audio>(), 1);

Implementations

impl AssetStorage

pub fn new() -> Self

Creates a new, empty asset storage.

pub fn with_capacity(capacity: usize) -> Self

Creates a new asset storage with pre-allocated capacity for storage map.

pub fn insert<A: Asset>(&mut self, asset: A) -> AssetHandle<A>

Inserts an asset and returns its handle.

Automatically creates the typed storage if it doesn’t exist.

pub fn insert_with_path<A: Asset>( &mut self, asset: A, path: AssetPath<'_>, ) -> AssetHandle<A>

Inserts an asset with an associated path.

If an asset with the same path exists and is alive, returns the existing handle.

pub fn reserve<A: Asset>(&mut self) -> AssetHandle<A>

Reserves a handle for later loading.

pub fn reserve_with_path<A: Asset>( &mut self, path: AssetPath<'_>, ) -> AssetHandle<A>

Reserves a handle with an associated path.

pub fn set_loaded<A: Asset>( &mut self, handle: &AssetHandle<A>, asset: A, ) -> bool

Sets a loaded asset for a reserved handle.

pub fn remove<A: Asset>(&mut self, handle: &AssetHandle<A>) -> Option<A>

Removes an asset and returns it.

pub fn remove_untyped(&mut self, handle: &UntypedAssetHandle) -> bool

Removes an asset by untyped handle.

pub fn get<A: Asset>(&self, handle: &AssetHandle<A>) -> Option<&A>

Gets a reference to an asset.

pub fn get_mut<A: Asset>(&mut self, handle: &AssetHandle<A>) -> Option<&mut A>

Gets a mutable reference to an asset.

pub fn get_entry<A: Asset>( &self, handle: &AssetHandle<A>, ) -> Option<&AssetEntry<A>>

Gets the entry for a handle.

pub fn get_entry_mut<A: Asset>( &mut self, handle: &AssetHandle<A>, ) -> Option<&mut AssetEntry<A>>

Gets the mutable entry for a handle.

pub fn is_alive<A: Asset>(&self, handle: &AssetHandle<A>) -> bool

Checks if a handle is alive.

pub fn is_alive_untyped(&self, handle: &UntypedAssetHandle) -> bool

Checks if an untyped handle is alive.

pub fn get_state<A: Asset>(&self, handle: &AssetHandle<A>) -> Option<AssetState>

Gets the state for a handle.

pub fn get_state_untyped( &self, handle: &UntypedAssetHandle, ) -> Option<AssetState>

Gets the state for an untyped handle.

pub fn get_handle_by_path<A: Asset>(&self, path: &str) -> Option<AssetHandle<A>>

Gets a handle by path.

pub fn get_by_path<A: Asset>(&self, path: &str) -> Option<&A>

Gets an asset by path.

pub fn has_path<A: Asset>(&self, path: &str) -> bool

Checks if a path exists for an asset type.

pub fn set_path<A: Asset>( &mut self, handle: &AssetHandle<A>, path: AssetPath<'_>, ) -> bool

Sets the path for a handle.

pub fn len<A: Asset>(&self) -> usize

Returns the number of assets of a specific type.

pub fn is_empty_type<A: Asset>(&self) -> bool

Returns true if no assets of a specific type are stored.

pub fn total_len(&self) -> usize

Returns the total number of assets across all types.

pub fn is_empty(&self) -> bool

Returns true if no assets are stored.

pub fn type_count(&self) -> usize

Returns the number of registered asset types.

pub fn clear_type<A: Asset>(&mut self)

Clears all assets of a specific type.

pub fn clear(&mut self)

Clears all assets from all storages.

pub fn has_type<A: Asset>(&self) -> bool

Returns true if storage exists for a type.

pub fn registered_types(&self) -> Vec<AssetInfo>

Returns asset info for all registered types.

pub fn get_storage<A: Asset>(&self) -> Option<&TypedAssetStorage<A>>

Gets the typed storage for an asset type.

pub fn get_storage_mut<A: Asset>(&mut self) -> Option<&mut TypedAssetStorage<A>>

Gets mutable typed storage for an asset type.

pub fn set_loaded_raw( &mut self, asset_id: AssetId, index: u32, generation: u32, boxed: Box<dyn Any + Send>, ) -> bool

Sets a loaded asset from a type-erased boxed value using raw handle parts.

Used by async loading to finalize results on the main thread.

pub fn replace_erased(&mut self, path: &str, boxed: Box<dyn Any + Send>) -> bool

Replaces a loaded asset by path with a new type-erased value.

Searches all storage types for an asset with the given path and replaces it with the new value. Used for hot-reload.

pub fn set_failed_raw( &mut self, asset_id: AssetId, index: u32, generation: u32, error: String, ) -> bool

Marks an asset as failed using raw handle parts.

Used by async loading to report errors on the main thread.

pub fn get_or_create_storage<A: Asset>(&mut self) -> &mut TypedAssetStorage<A>

Gets or creates typed storage for an asset type.

pub fn iter<A: Asset>(&self) -> impl Iterator<Item = (AssetHandle<A>, &A)>

Iterates over all assets of a specific type.

pub fn handles<A: Asset>(&self) -> impl Iterator<Item = AssetHandle<A>> + '_

Returns handles for all assets of a specific type.

Trait Implementations

impl Debug for AssetStorage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AssetStorage

fn default() -> Self

Returns the “default value” for a type.