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 skin_instance: Option<u32>,
    pub receives_decals: bool,
    pub lic: Option<LicOverlay>,
}

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.

skin_instance: Option<u32>

Which skinning instance palette to use when mesh_id has been marked skinnable via crate::ViewportGpuResources::set_skin_weights.

• None: this item is treated as static even if the mesh has skinning data attached. The standard (non-skinned) pipeline is used.
• Some(instance_id): the renderer routes this item through the skinned pipeline variant and binds the joint palette uploaded via set_skin_palette(mesh_id, instance_id, ...). If no palette has been uploaded for this (mesh_id, instance_id), the item falls back to the static pipeline for this frame.

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

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.

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.