Struct VolumeMeshItem 

pub struct VolumeMeshItem {
    pub mesh_id: MeshId,
    pub face_to_cell: Vec<u32>,
    pub model: [[f32; 4]; 4],
    pub selected: bool,
    pub appearance: AppearanceSettings,
    pub material: Material,
    pub active_attribute: Option<AttributeRef>,
    pub scalar_range: Option<(f32, f32)>,
    pub colourmap_id: Option<ColourmapId>,
    pub pick_id: PickId,
}

Render item for an opaque volume mesh uploaded via upload_volume_mesh_data.

Wraps the MeshId produced by boundary extraction together with the face-to-cell mapping so consumers can recover cell-level identity from face-level pick hits. Call to_render_item each frame to produce the SceneRenderItem submitted to the renderer.

let (mesh_id, face_to_cell) = resources.upload_volume_mesh_data(&device, &data)?;
let item = VolumeMeshItem::new(mesh_id, face_to_cell);

// Each frame:
scene_frame.surfaces = SurfaceSubmission::Flat(vec![item.to_render_item()].into());

Fields

mesh_id: MeshId

GPU mesh slot for the extracted boundary surface.

face_to_cell: Vec<u32>

Maps each boundary triangle to its originating cell index.

face_to_cell[face_index] is the cell index in the original VolumeMeshData::cells array. Use this to convert a SubObjectRef::Face pick hit into a cell index.

model: [[f32; 4]; 4]

World-space model matrix. Default: identity.

selected: bool

Whether this object is selected. Default: false.

appearance: AppearanceSettings

Per-item appearance overrides (hidden, unlit, opacity, wireframe).

material: Material

Per-object material.

active_attribute: Option<AttributeRef>

Named scalar or colour attribute to colour by.

scalar_range: Option<(f32, f32)>

Explicit scalar range (min, max). None = auto-range from upload.

colourmap_id: Option<ColourmapId>

Colourmap for scalar colouring.

pick_id: PickId

GPU pick identifier. PickId::NONE = not pickable.

Implementations

impl VolumeMeshItem

pub fn new(mesh_id: MeshId, face_to_cell: Vec<u32>) -> Self

Create a new item from the mesh ID and face-to-cell map returned by upload_volume_mesh_data.

pub fn to_render_item(&self) -> SceneRenderItem

Build the SceneRenderItem that the renderer consumes.

The volume mesh renders through the standard surface pipeline; this method copies the per-frame fields into a SceneRenderItem.

pub fn cell_for_face(&self, face_index: u32) -> Option<u32>

Look up the cell index for a boundary face hit.

Returns None if face_index is out of range.

pub fn update_mesh(&mut self, mesh_id: MeshId, face_to_cell: Vec<u32>)

Replace the mesh ID and face-to-cell map, for example after a clipped re-upload via replace_clipped_volume_mesh_data.

Trait Implementations

impl Clone for VolumeMeshItem

fn clone(&self) -> VolumeMeshItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.