Struct VolumeSurfaceSliceItem 

#[non_exhaustive]
pub struct VolumeSurfaceSliceItem {
    pub volume_id: VolumeId,
    pub mesh_id: MeshId,
    pub bbox_min: [f32; 3],
    pub bbox_max: [f32; 3],
    pub scalar_range: (f32, f32),
    pub colour_lut: Option<ColourmapId>,
    pub opacity: f32,
    pub model: [[f32; 4]; 4],
    pub id: u64,
    pub appearance: AppearanceSettings,
    pub selected: bool,
}

A volume slice sampled on an arbitrary surface mesh.

Unlike ImageSliceItem which is restricted to axis-aligned flat quads, this item renders any uploaded mesh and colours each fragment by the volume scalar at that world-space position. The slice surface can be a flat plane, a disk, a saddle, a paraboloid – any shape that can be expressed as a mesh.

Upload the surface mesh once with [ViewportGpuResources::upload_mesh_data] to get a MeshId, then submit a VolumeSurfaceSliceItem referencing that mesh each frame.

Fragments whose world position falls outside the volume bounding box are discarded, so the mesh can extend beyond the volume without clipping artifacts.

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.

volume_id: VolumeId

Reference to a previously uploaded 3D volume texture.

mesh_id: MeshId

Mesh defining the slice surface shape. Any mesh works: flat quad, disk, saddle, etc.

bbox_min: [f32; 3]

World-space bounding box minimum corner of the volume.

bbox_max: [f32; 3]

World-space bounding box maximum corner of the volume.

scalar_range: (f32, f32)

Scalar range for colourmap mapping [min, max]. Default: (0.0, 1.0).

colour_lut: Option<ColourmapId>

Colour LUT. None = default builtin (viridis).

opacity: f32

Overall opacity of the slice. Default: 1.0.

model: [[f32; 4]; 4]

World-space model matrix for the slice mesh. Default: identity.

id: u64

Pick ID for unified selection API. 0 = not selectable.

appearance: AppearanceSettings

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

selected: bool

If true, draws an outline ring around the slice mesh.

Trait Implementations

impl Clone for VolumeSurfaceSliceItem

fn clone(&self) -> VolumeSurfaceSliceItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VolumeSurfaceSliceItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for VolumeSurfaceSliceItem

fn default() -> Self

Returns the “default value” for a type.