Struct AssetEntry 

pub struct AssetEntry<A: Asset> { /* private fields */ }

An individual asset entry in storage with metadata.

AssetEntry wraps an asset value together with its loading state, optional path association, and other metadata.

Example

use goud_engine::assets::{Asset, AssetEntry, AssetState, AssetPath};

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

// Create a loaded entry
let entry = AssetEntry::loaded(Texture { width: 256 });
assert!(entry.is_loaded());
assert_eq!(entry.asset().unwrap().width, 256);

// Create entry with path
let entry = AssetEntry::with_path(
    Texture { width: 512 },
    AssetPath::new("textures/player.png"),
);
assert_eq!(entry.path().map(|p| p.as_str()), Some("textures/player.png"));

Implementations

impl<A: Asset> AssetEntry<A>

pub fn empty() -> Self

Creates a new entry in the NotLoaded state.

Use this when you want to reserve a handle before the asset is loaded.

pub fn loading(progress: f32) -> Self

Creates a new entry with a loading state.

Arguments

• progress - Initial loading progress (0.0 to 1.0)

pub fn loaded(asset: A) -> Self

Creates a new entry with a loaded asset.

pub fn with_path(asset: A, path: AssetPath<'static>) -> Self

Creates a new entry with a loaded asset and path.

pub fn failed(error: impl Into<String>) -> Self

Creates a new failed entry with an error message.

pub fn asset(&self) -> Option<&A>

Returns a reference to the asset if loaded.

pub fn asset_mut(&mut self) -> Option<&mut A>

Returns a mutable reference to the asset if loaded.

pub fn take_asset(&mut self) -> Option<A>

Takes the asset out of this entry, leaving None.

pub fn state(&self) -> &AssetState

Returns a reference to the current state.

pub fn path(&self) -> Option<&AssetPath<'static>>

Returns the path this asset was loaded from, if any.

pub fn set_path(&mut self, path: AssetPath<'static>)

Sets the path for this entry.

pub fn clear_path(&mut self)

Clears the path for this entry.

pub fn is_loaded(&self) -> bool

Returns true if the asset is fully loaded.

pub fn is_loading(&self) -> bool

Returns true if the asset is currently loading.

pub fn is_failed(&self) -> bool

Returns true if loading failed.

pub fn set_loaded(&mut self, asset: A)

Sets the asset and marks as loaded.

pub fn set_progress(&mut self, progress: f32)

Updates the loading progress.

pub fn set_failed(&mut self, error: impl Into<String>)

Marks the entry as failed.

pub fn set_unloaded(&mut self)

Marks the entry as unloaded and removes the asset.

Trait Implementations

impl<A: Clone + Asset> Clone for AssetEntry<A>

fn clone(&self) -> AssetEntry<A>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<A: Debug + Asset> Debug for AssetEntry<A>

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

Formats the value using the given formatter.

impl<A: Asset> Default for AssetEntry<A>

fn default() -> Self

Returns the “default value” for a type.