Struct VolumeMeshData 

#[non_exhaustive]
pub struct VolumeMeshData {
    pub positions: Vec<[f32; 3]>,
    pub cells: Vec<[u32; 8]>,
    pub cell_scalars: HashMap<String, Vec<f32>>,
    pub cell_colours: HashMap<String, Vec<[f32; 4]>>,
}

Input data for an unstructured volume mesh (tets, hexes, or mixed).

Each cell is represented as exactly 8 vertex indices. For cells with fewer than 8 vertices, fill unused slots with CELL_SENTINEL (u32::MAX).

use viewport_lib::{VolumeMeshData, CELL_SENTINEL};

// Two tets sharing vertices 0-1-2
let mut data = VolumeMeshData::default();
data.positions = vec![
    [0.0, 0.0, 0.0],
    [1.0, 0.0, 0.0],
    [0.5, 1.0, 0.0],
    [0.5, 0.5, 1.0],
    [0.5, 0.5, -1.0],
];
data.cells = vec![
    [0, 1, 2, 3, CELL_SENTINEL, CELL_SENTINEL, CELL_SENTINEL, CELL_SENTINEL],
    [0, 2, 1, 4, CELL_SENTINEL, CELL_SENTINEL, CELL_SENTINEL, CELL_SENTINEL],
];

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.

positions: Vec<[f32; 3]>

Vertex positions in local space.

cells: Vec<[u32; 8]>

Cell connectivity : exactly 8 indices per cell.

Tets: first 4 indices are the tet vertices; indices [4..8] must be CELL_SENTINEL. Hexes: all 8 indices are valid. Other cell types use CELL_SENTINEL to pad unused slots (see module-level docs).

cell_scalars: HashMap<String, Vec<f32>>

Named per-cell scalar attributes (one f32 per cell).

Automatically remapped to boundary face scalars during upload so they can be visualised via AttributeKind::Face.

cell_colours: HashMap<String, Vec<[f32; 4]>>

Named per-cell RGBA colour attributes (one [f32; 4] per cell).

Automatically remapped to boundary face colours during upload, rendered via AttributeKind::FaceColour.

Implementations

impl VolumeMeshData

pub fn push_tet(&mut self, a: u32, b: u32, c: u32, d: u32)

Append a tetrahedral cell (4 vertices).

Slots [4..8] are filled with CELL_SENTINEL automatically.

pub fn push_pyramid(&mut self, base: [u32; 4], apex: u32)

Append a pyramidal cell (square base + apex, 5 vertices).

base holds the four base vertices in VTK order (counter-clockwise when viewed from outside the cell); apex is the tip vertex. Slots [5..8] are filled with CELL_SENTINEL automatically.

pub fn push_wedge(&mut self, tri0: [u32; 3], tri1: [u32; 3])

Append a wedge (triangular prism) cell (6 vertices).

tri0 and tri1 are the bottom and top triangular faces; vertex tri1[i] is directly above tri0[i], forming the three lateral quad faces. Slots [6..8] are filled with CELL_SENTINEL automatically.

pub fn push_hex(&mut self, verts: [u32; 8])

Append a hexahedral cell (8 vertices, VTK ordering).

Trait Implementations

impl Default for VolumeMeshData

fn default() -> VolumeMeshData

Returns the “default value” for a type.