Enum MaterialRef 

pub enum MaterialRef {
    Inline {
        material: Box<dyn Material>,
        uuid: AssetUUID,
    },
    Asset(AssetUUID),
}

Authored reference to a material — the only serialized material form.

The enum is the discriminator: Inline embeds the material value, Asset carries the stable UUID of a .kmat in the VFS.

Both arms carry an identity UUID — the content-derived UUID for Inline, the stable asset UUID for Asset. The resolver compares this identity against the resolved handle’s UUID every tick: a mismatch (or a missing handle) means the authored reference changed and must be re-resolved. The Inline UUID is never serialized; it is recomputed from the material content on deserialize via MaterialRef::inline so it stays purely content-derived. Construct Inline through MaterialRef::inline so the UUID and the material value can never disagree.

Variants

Inline

Ad-hoc material data created in code or the editor, embedded inline. The uuid is content-derived; build via MaterialRef::inline.

Fields

material: Box<dyn Material>

The embedded material value.

uuid: AssetUUID

Content-derived identity UUID (the same content hash the GPU projection keys on). Not serialized — recomputed on load.

Asset(AssetUUID)

Reference to a .kmat asset in the VFS, resolved by UUID.

Implementations

impl MaterialRef

pub fn inline(material: Box<dyn Material>) -> MaterialRef

Builds an Inline reference from a material value, deriving its identity UUID from the material content. Two inline references holding equal material content get the same UUID, so they dedup to one resolved handle (and one GpuMaterial). On a serialization failure the UUID falls back to a fresh random value (logged) rather than panicking.

pub fn uuid(&self) -> AssetUUID

Returns the identity UUID: the content-derived UUID for Inline, the stable asset UUID for Asset. The resolver compares this against the resolved handle’s UUID to detect an authored change.

Trait Implementations

impl Clone for MaterialRef

fn clone(&self) -> MaterialRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for MaterialRef

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 + 'static))

where Self: Sized,

Appends self as a new row into its column.

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

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 + 'static), 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 + 'static), 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.