Struct HandleComponent 

pub struct HandleComponent<T: Asset> {
    pub handle: AssetHandle<T>,
    pub uuid: AssetUUID,
}

A generic ECS component that associates an entity with a shared asset resource. It holds both a handle to the loaded data and the asset’s unique identifier.

Fields

handle: AssetHandle<T>

A shared, reference-counted pointer to the asset’s data.

uuid: AssetUUID

The unique, persistent identifier of the asset.

Trait Implementations

impl<T: Asset> Clone for HandleComponent<T>

Manual implementation of Clone. This is cheap as it only clones the reference-counted pointer and the UUID. It correctly does NOT require T to be Clone.

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Asset> Component for HandleComponent<T>

Implement the Component trait to make HandleComponent usable by the ECS.

fn make_column() -> Box<dyn AnyVec>

where Self: Sized,

Creates this component’s empty storage column. Default: an AoS Vec<Self>.

fn push_into_column(self, column: &mut dyn AnyVec)

where Self: Sized,

Appends self as a new row into its column.

fn copy_row_between(src: &dyn AnyVec, src_row: usize, dst: &mut dyn AnyVec)

where Self: Sized,

Clones row src_row from src into dst (used when an entity migrates between pages on a structural change). Both columns are this component’s column type.

fn clone_from_column(column: &dyn AnyVec, row: usize) -> Self

where Self: Sized,

Reads row row of column as an owned value — the uniform by-value access path that works for both AoS (clone the &T) and field-SoA (gather the fields) layouts. Used by World::clone_component, the Soa<T> query, and the serialization recipe.

fn set_in_column(self, column: &mut dyn AnyVec, row: usize)

where Self: Sized,

Overwrites row row of column with self — the uniform by-value write path for both layouts (AoS assigns the slot; field-SoA scatters into the lanes). Used by World::set_component.

impl<T: Asset> Deref for HandleComponent<T>

Implement Deref to the inner AssetHandle for ergonomic access to the asset data. This allows calling methods of T directly on the component (e.g., my_mesh_component.vertex_size()).

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.