Struct VolumeMesh 

pub struct VolumeMesh { /* private fields */ }

A volume mesh structure (tetrahedral or hexahedral).

Cells are stored as arrays of 8 vertex indices. For tetrahedra, only the first 4 indices are used (indices 4-7 are set to u32::MAX).

Implementations

impl VolumeMesh

pub fn new( name: impl Into<String>, vertices: Vec<Vec3>, cells: Vec<[u32; 8]>, ) -> Self

Creates a new volume mesh from vertices and cell indices.

Arguments

• name - The name of the mesh
• vertices - Vertex positions
• cells - Cell indices, 8 per cell (unused indices should be u32::MAX)

pub fn new_tet_mesh( name: impl Into<String>, vertices: Vec<Vec3>, tets: Vec<[u32; 4]>, ) -> Self

Creates a tetrahedral mesh.

pub fn new_hex_mesh( name: impl Into<String>, vertices: Vec<Vec3>, hexes: Vec<[u32; 8]>, ) -> Self

Creates a hexahedral mesh.

pub fn num_vertices(&self) -> usize

Returns the number of vertices.

pub fn num_cells(&self) -> usize

Returns the number of cells.

pub fn cell_type(&self, cell_idx: usize) -> VolumeCellType

Returns the cell type of the given cell.

pub fn vertices(&self) -> &[Vec3]

Returns the vertices.

pub fn cells(&self) -> &[[u32; 8]]

Returns the cells.

pub fn color(&self) -> Vec4

Gets the base color.

pub fn set_color(&mut self, color: Vec3) -> &mut Self

Sets the base color.

pub fn interior_color(&self) -> Vec4

Gets the interior color.

pub fn set_interior_color(&mut self, color: Vec3) -> &mut Self

Sets the interior color.

pub fn edge_color(&self) -> Vec4

Gets the edge color.

pub fn set_edge_color(&mut self, color: Vec3) -> &mut Self

Sets the edge color.

pub fn edge_width(&self) -> f32

Gets the edge width.

pub fn set_edge_width(&mut self, width: f32) -> &mut Self

Sets the edge width.

pub fn decompose_to_tets(&self) -> Vec<[u32; 4]>

Decomposes all cells into tetrahedra. Tets pass through unchanged, hexes are decomposed into 5 tets.

pub fn num_tets(&self) -> usize

Returns the number of tetrahedra (including decomposed hexes).

pub fn generate_render_geometry_with_quantities( &self, ) -> VolumeMeshRenderGeometry

Generates render geometry including any enabled quantity data.

pub fn init_render_data( &mut self, device: &Device, bind_group_layout: &BindGroupLayout, camera_buffer: &Buffer, )

Initializes GPU render data.

pub fn update_render_data_with_culling( &mut self, device: &Device, bind_group_layout: &BindGroupLayout, camera_buffer: &Buffer, planes: &[(Vec3, Vec3)], )

Reinitializes render data with cell culling based on slice planes. Cells whose centroid is on the negative side of any plane are hidden. Uses caching to avoid regenerating geometry every frame.

pub fn reset_render_data( &mut self, device: &Device, bind_group_layout: &BindGroupLayout, camera_buffer: &Buffer, )

Resets render data to show all cells (no culling).

pub fn is_culled(&self) -> bool

Returns true if the mesh is currently showing culled geometry.

pub fn render_data(&self) -> Option<&SurfaceMeshRenderData>

Returns the render data if available.

pub fn pick_triangles( &self, planes: &[(Vec3, Vec3)], ) -> (Vec<Vec3>, Vec<[u32; 3]>)

Generates triangulated exterior faces for picking. Uses current slice plane culling if provided.

pub fn init_pick_resources( &mut self, device: &Device, mesh_pick_bind_group_layout: &BindGroupLayout, camera_buffer: &Buffer, global_start: u32, )

Initializes GPU resources for pick rendering.

Creates the pick uniform buffer, cell index mapping buffer, and bind group. The cell index buffer maps each GPU triangle to its parent cell index.

pub fn pick_bind_group(&self) -> Option<&BindGroup>

Returns the pick bind group if initialized.

pub fn update_pick_uniforms(&self, queue: &Queue)

Updates pick uniforms (model transform) when the structure is moved.

pub fn num_render_vertices(&self) -> u32

Returns the total number of vertices in the rendered triangulation (for draw calls).

pub fn update_gpu_buffers(&self, queue: &Queue)

Updates GPU buffers.

pub fn update_slice_render_data( &mut self, device: &Device, queue: &Queue, bind_group_layout: &BindGroupLayout, camera_buffer: &Buffer, plane_origin: Vec3, plane_normal: Vec3, ) -> bool

Updates or creates slice mesh render data for a given slice plane.

Returns true if the slice intersects this volume mesh.

pub fn slice_render_data(&self) -> Option<&SliceMeshRenderData>

Returns the slice render data if available.

pub fn clear_slice_render_data(&mut self)

Clears the slice render data cache.

pub fn build_egui_ui(&mut self, ui: &mut Ui)

Builds the egui UI for this volume mesh.

pub fn add_vertex_scalar_quantity( &mut self, name: impl Into<String>, values: Vec<f32>, ) -> &mut Self

Adds a vertex scalar quantity.

pub fn add_cell_scalar_quantity( &mut self, name: impl Into<String>, values: Vec<f32>, ) -> &mut Self

Adds a cell scalar quantity.

pub fn add_vertex_color_quantity( &mut self, name: impl Into<String>, colors: Vec<Vec3>, ) -> &mut Self

Adds a vertex color quantity.

pub fn add_cell_color_quantity( &mut self, name: impl Into<String>, colors: Vec<Vec3>, ) -> &mut Self

Adds a cell color quantity.

pub fn add_vertex_vector_quantity( &mut self, name: impl Into<String>, vectors: Vec<Vec3>, ) -> &mut Self

Adds a vertex vector quantity.

pub fn add_cell_vector_quantity( &mut self, name: impl Into<String>, vectors: Vec<Vec3>, ) -> &mut Self

Adds a cell vector quantity.

pub fn generate_slice_geometry( &self, plane_origin: Vec3, plane_normal: Vec3, ) -> Option<SliceMeshData>

Generates mesh geometry for the cross-section created by a slice plane.

This computes the intersection of all cells with the plane and triangulates the resulting polygons for rendering. If a vertex color quantity is enabled, colors are interpolated at slice points.

Arguments

• plane_origin - A point on the slice plane
• plane_normal - The plane normal (points toward kept geometry)

Returns

Some(SliceMeshData) if the plane intersects the mesh, None otherwise.

Trait Implementations

impl HasQuantities for VolumeMesh

fn add_quantity(&mut self, quantity: Box<dyn Quantity>)

Adds a quantity to this structure.

fn get_quantity(&self, name: &str) -> Option<&dyn Quantity>

Gets a quantity by name.

fn get_quantity_mut(&mut self, name: &str) -> Option<&mut Box<dyn Quantity>>

Gets a mutable quantity by name.

fn remove_quantity(&mut self, name: &str) -> Option<Box<dyn Quantity>>

Removes a quantity by name.

fn quantities(&self) -> &[Box<dyn Quantity>]

Returns all quantities attached to this structure.

fn num_quantities(&self) -> usize

Returns the number of quantities attached.

impl Structure for VolumeMesh

fn as_any(&self) -> &dyn Any

Returns a reference to self as Any for downcasting.

fn as_any_mut(&mut self) -> &mut dyn Any

Returns a mutable reference to self as Any for downcasting.

fn name(&self) -> &str

Returns the unique name of this structure.

fn type_name(&self) -> &'static str

Returns the type name of this structure (e.g., “PointCloud”, “SurfaceMesh”).

fn bounding_box(&self) -> Option<(Vec3, Vec3)>

Returns the axis-aligned bounding box in world coordinates.

fn length_scale(&self) -> f32

Returns a characteristic length scale for this structure.

fn transform(&self) -> Mat4

Returns the current model transform matrix.

fn set_transform(&mut self, transform: Mat4)

Sets the model transform matrix.

fn is_enabled(&self) -> bool

Returns whether this structure is currently visible.

fn set_enabled(&mut self, enabled: bool)

Sets the visibility of this structure.

fn draw(&self, _ctx: &mut dyn RenderContext)

Draws this structure to the scene.

fn draw_pick(&self, _ctx: &mut dyn RenderContext)

Draws this structure for picking/selection.

fn build_ui(&mut self, _ui: &dyn Any)

Builds the ImGui UI for this structure.

fn build_pick_ui(&self, _ui: &dyn Any, _pick: &PickResult)

Builds the ImGui UI for a picked element.

fn clear_gpu_resources(&mut self)

Clears all GPU resources (render data, pick buffers, etc.).

fn refresh(&mut self)

Refreshes GPU resources after data changes.

fn center_bounding_box(&mut self)

Centers the camera on this structure’s bounding box.

fn reset_transform(&mut self)

Resets the transform to identity.

fn material(&self) -> &str

Returns the material name for this structure (e.g., “clay”, “wax”).

fn set_material(&mut self, _material: &str)

Sets the material for this structure by name.