Struct InstancedProp 

pub struct InstancedProp {
    pub asset_id: AssetId,
    pub mesh: Option<MeshHandle>,
    pub material: Option<MaterialHandle>,
    pub texture: Option<TextureHandle>,
    pub instances: Vec<InstanceTransform>,
    pub cull_distance: f32,
}

A single mesh + material drawn at many world-space transforms.

Use for foliage, debris, projectiles, or any content that repeats the same shape with varied placement. Each instance gets its own world transform and culling without the overhead of declaring many separate Props.

Each instances entry has the shape {"position":[x,y,z], "rotation_deg":[p,y,r], "scale":[sx,sy,sz]}. rotation_deg and scale may be omitted (defaults [0,0,0] and [1,1,1]).

Fields

asset_id: AssetId

Asset identity; injected via inject_name. Not part of args.

mesh: Option<MeshHandle>

A Mesh, ProceduralMesh, VoxelChunk, or mesh-kind File asset.

material: Option<MaterialHandle>

A Material; takes precedence over texture when set.

texture: Option<TextureHandle>

Older texture-only reference; ignored when material is set.

instances: Vec<InstanceTransform>

Per-instance transforms. Empty list renders nothing.

cull_distance: f32

View-distance cutoff in world units per instance. 0 = always draw.

Trait Implementations

impl Clone for InstancedProp

fn clone(&self) -> InstancedProp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for InstancedProp

const NAME: &'static str = "InstancedProp"

The registry name a world authors this component under.

fn inject_name(&mut self, id: AssetId)

Called after construction to inject the asset’s identity from the blob def. Only meaningful for components that look themselves up by id at runtime. The default implementation does nothing.

fn from_baked(bytes: &[u8]) -> Result<Self, CnResult>

Reconstruct this component from a blob record, whose bytes are the serialized runtime component (cook already ran the asset -> component translation). The default rejects: runtime-only components are never stored in a blob, so only loadable types provide an implementation.

fn inject_locator(&mut self, _locator: PayloadLocator)

Called after construction to inject the payload locator from the blob def. Only meaningful for components with a compiled payload. The default implementation does nothing (correct for most components).

impl ComponentSlot for InstancedProp

const DISCRIMINANT: u8

The component type’s stable id, used as its ComponentId.

fn slot(s: &ComponentStorage) -> &Column<Self>

Borrow this type’s column out of the storage.

fn slot_mut(s: &mut ComponentStorage) -> &mut Column<Self>

Mutably borrow this type’s column out of the storage.

impl Debug for InstancedProp

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

Formats the value using the given formatter.

impl Default for InstancedProp

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for InstancedProp

where InstancedProp: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<InstancedProp> for ComponentAsset

fn from(c: InstancedProp) -> Self

Converts to this type from the input type.

impl InstancedPropGeometry for InstancedProp

fn instance_model_matrix(&self, idx: usize) -> Option<[[f32; 4]; 4]>

Build a column-major model matrix for the i-th instance. Order matches Prop::model_matrix: scale, then YXZ rotation, then translation.

impl RuntimeComponent for InstancedProp

impl Serialize for InstancedProp

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.