Struct SceneRenderItem 

#[non_exhaustive]
pub struct SceneRenderItem {

    pub mesh_id: MeshId,
    pub model: [[f32; 4]; 4],
    pub settings: ItemSettings,
    pub show_normals: bool,
    pub material: Material,
    pub active_attribute: Option<AttributeRef>,
    pub scalar_range: Option<(f32, f32)>,
    pub colourmap_id: Option<ColourmapId>,
    pub nan_colour: Option<[f32; 4]>,
    pub warp_attribute: Option<String>,
    pub warp_scale: f32,
    pub deform_instance: Option<u32>,
    pub receives_decals: bool,
    pub lic: Option<LicOverlay>,
    pub lod_group: Option<LodGroupId>,
}

Per-object render data for one frame.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

mesh_id: MeshId

MeshId of the uploaded GPU mesh for this object.

model: [[f32; 4]; 4]

World-space model matrix (Translation * Rotation * Scale).

settings: ItemSettings

Per-item render settings (visibility, appearance, pick identity, selection state).

show_normals: bool

Whether to render per-vertex normal visualization lines for this object.

material: Material

Per-object material (colour, shading coefficients, texture).

active_attribute: Option<AttributeRef>

Named scalar attribute to colour by. None = use material base colour.

scalar_range: Option<(f32, f32)>

Explicit scalar range (min, max). None = use auto-range computed at upload time.

colourmap_id: Option<ColourmapId>

Colourmap to use for scalar colouring. Ignored when active_attribute is None.

nan_colour: Option<[f32; 4]>

RGBA colour for NaN scalar values. None = discard (fully transparent).

warp_attribute: Option<String>

Named vector attribute (from AttributeData::VertexVector) used to displace vertex positions in the vertex shader. None = no warp. See also warp_scale.

The attribute must be uploaded as part of the mesh’s MeshData::attributes with kind AttributeData::VertexVector. The vertex shader applies: local_pos += warp_scale * warp_buffer[vertex_index] before the model transform.

warp_scale: f32

Scale factor applied to the warp vector. Default: 1.0.

deform_instance: Option<u32>

Which per-instance deformer data to bind for this item.

• None: the item uses only per-mesh deformer data.
• Some(instance_id): the renderer binds the per-(mesh, instance) deformer slot data attached via crate::resources::DeviceResources::attach_deform_slot_instance (or a plugin handle like SkinningPlugin::attach_palette).

Allows multiple SceneRenderItems that share a bind-pose mesh to each pose independently (crowd / instanced characters with GPU skinning).

receives_decals: bool

Whether this surface receives projected decals. Default: true.

lic: Option<LicOverlay>

LIC flow overlay for this surface. None disables LIC for this item.

The mesh must have a VertexVector attribute matching LicOverlay::vector_attribute.

lod_group: Option<LodGroupId>

LOD group to draw this object from. None means draw mesh_id directly.

When set, the renderer measures how large the object appears each frame and overwrites mesh_id with the matching level before drawing. Set pick_id for the switch to use hysteresis across frames; without one the level is picked fresh each frame. Build a group with DeviceResources::register_lod_group.

Trait Implementations

impl Clone for SceneRenderItem

fn clone(&self) -> SceneRenderItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for SceneRenderItem

fn default() -> Self

Returns the “default value” for a type.