Struct SparseVolumeGridData 

#[non_exhaustive]
pub struct SparseVolumeGridData {
    pub origin: [f32; 3],
    pub cell_size: f32,
    pub active_cells: Vec<[u32; 3]>,
    pub cell_scalars: HashMap<String, Vec<f32>>,
    pub node_scalars: HashMap<String, Vec<f32>>,
    pub cell_colours: HashMap<String, Vec<[f32; 4]>>,
}

Input data for a sparse regular voxel grid.

Only the cells listed in active_cells are considered occupied. Boundary faces (faces not shared between two active cells) are extracted and uploaded as a standard surface mesh.

Attribute conventions

• cell_scalars / cell_colours: one entry per element of active_cells (parallel arrays).
• node_scalars: dense array indexed by nk * (W * H) + nj * W + ni where W = max_i + 2, H = max_j + 2 and max_i, max_j, max_k are derived from active_cells (see module docs). Set via [AttributeRef { kind: AttributeKind::Face, .. }] after upload — node scalars are averaged to face scalars during extraction.

Upload

use viewport_lib::{SparseVolumeGridData, AttributeKind, AttributeRef};
use std::collections::HashMap;

let mut data = SparseVolumeGridData::default();
data.origin    = [-1.0, -1.0, -1.0];
data.cell_size = 1.0;
data.active_cells = vec![[0, 0, 0], [1, 0, 0]];
data.cell_scalars.insert("pressure".to_string(), vec![0.3, 0.8]);
// upload via resources.upload_sparse_volume_grid_data(device, &data)

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.

origin: [f32; 3]

World-space position of the [0, 0, 0] corner of cell [0, 0, 0].

cell_size: f32

Side length of one cubic cell in world units. Must be positive.

active_cells: Vec<[u32; 3]>

Grid indices [i, j, k] of occupied cells.

cell_scalars: HashMap<String, Vec<f32>>

Named per-cell scalar attributes (one f32 per active cell, parallel to active_cells). Remapped to AttributeKind::Face during extraction.

node_scalars: HashMap<String, Vec<f32>>

Named per-node scalar attributes. Dense array; see module-level indexing convention. Averaged over 4 quad corners to produce AttributeKind::Face values.

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

Named per-cell RGBA colour attributes (one [f32; 4] per active cell, parallel to active_cells). Remapped to AttributeKind::FaceColour during extraction.

Trait Implementations

impl Default for SparseVolumeGridData

fn default() -> SparseVolumeGridData

Returns the “default value” for a type.