Struct VolumeGrid 

pub struct VolumeGrid { /* private fields */ }

A regular 3D grid structure.

VolumeGrid represents a regular axis-aligned 3D grid defined by:

• Grid dimensions (number of nodes in X, Y, Z)
• Bounding box (min and max corners in world space)

Node values are at grid vertices, cell values are at grid cell centers.

Implementations

impl VolumeGrid

pub fn new( name: impl Into<String>, node_dim: UVec3, bound_min: Vec3, bound_max: Vec3, ) -> Self

Creates a new volume grid.

Arguments

• name - The name of the grid
• node_dim - Number of nodes in each dimension (X, Y, Z)
• bound_min - Minimum corner of the grid bounding box
• bound_max - Maximum corner of the grid bounding box

pub fn new_uniform( name: impl Into<String>, dim: u32, bound_min: Vec3, bound_max: Vec3, ) -> Self

Creates a volume grid with uniform dimensions.

pub fn node_dim(&self) -> UVec3

Returns the number of nodes in each dimension.

pub fn cell_dim(&self) -> UVec3

Returns the number of cells in each dimension.

pub fn num_nodes(&self) -> u64

Returns the total number of nodes.

pub fn num_cells(&self) -> u64

Returns the total number of cells.

pub fn bound_min(&self) -> Vec3

Returns the minimum bound.

pub fn bound_max(&self) -> Vec3

Returns the maximum bound.

pub fn grid_spacing(&self) -> Vec3

Returns the grid spacing (distance between adjacent nodes).

pub fn flatten_node_index(&self, i: u32, j: u32, k: u32) -> u64

Flattens a 3D node index to a linear index.

pub fn unflatten_node_index(&self, idx: u64) -> UVec3

Unflattens a linear node index to a 3D index.

pub fn position_of_node(&self, i: u32, j: u32, k: u32) -> Vec3

Returns the world position of a node at the given 3D index.

pub fn color(&self) -> Vec4

Gets the grid color.

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

Sets the grid 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 cube_size_factor(&self) -> f32

Gets the cube size factor.

pub fn set_cube_size_factor(&mut self, factor: f32) -> &mut Self

Sets the cube size factor (0 = no cubes, 1 = full size).

pub fn quantities_mut(&mut self) -> &mut [Box<dyn Quantity>]

Returns a mutable reference to the quantities list.

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

Initializes GPU render data.

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

Returns the render data if available.

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

Updates GPU buffers per-frame (wireframe uniforms: edge color, edge width).

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

Adds a node scalar quantity to the grid.

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

Adds a cell scalar quantity to the grid.

pub fn build_egui_ui(&mut self, ui: &mut Ui, colormap_names: &[&str])

Builds the egui UI for this volume grid.

Arguments

• colormap_names - Available colormap names for quantity visualization. If empty, defaults to built-in names.

Trait Implementations

impl HasQuantities for VolumeGrid

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 VolumeGrid

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.