Struct VolumeItem 

#[non_exhaustive]
pub struct VolumeItem {

    pub volume_id: VolumeId,
    pub color_lut: Option<ColormapId>,
    pub opacity_lut: Option<ColormapId>,
    pub scalar_range: (f32, f32),
    pub bbox_min: [f32; 3],
    pub bbox_max: [f32; 3],
    pub step_scale: f32,
    pub model: [[f32; 4]; 4],
    pub enable_shading: bool,
    pub opacity_scale: f32,
    pub threshold_min: f32,
    pub threshold_max: f32,
    pub nan_color: Option<[f32; 4]>,
}

A volume item to render via GPU ray-marching.

The caller uploads a 3D scalar field via ViewportGpuResources::upload_volume and receives a VolumeId. Each frame, submit a VolumeItem referencing that id plus transfer function and display parameters.

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 texture.

color_lut: Option<ColormapId>

Color transfer function LUT. None = use default builtin (viridis).

opacity_lut: Option<ColormapId>

Opacity transfer function LUT. None = linear ramp (0 at min, 1 at max).

scalar_range: (f32, f32)

Scalar range for normalization [min, max].

bbox_min: [f32; 3]

World-space bounding box minimum corner.

bbox_max: [f32; 3]

World-space bounding box maximum corner.

step_scale: f32

Ray step multiplier. Lower = higher quality, slower. Default: 1.0.

model: [[f32; 4]; 4]

World-space transform. Default: identity.

enable_shading: bool

Whether to apply gradient-based Phong shading. Default: false.

opacity_scale: f32

Global opacity multiplier. Default: 1.0.

threshold_min: f32

Scalar threshold range [min, max]. Samples outside this range are discarded (opacity = 0). Default: same as scalar_range (no clipping).

threshold_max: f32

Upper scalar threshold. Samples above this value are discarded. Default: same as scalar_range.1 (no clipping).

nan_color: Option<[f32; 4]>

Color and opacity to use for NaN scalar samples. None = skip NaN samples entirely (same as current behaviour: discard). Some([r, g, b, a]) = render NaN voxels with this fixed RGBA color instead of sampling the transfer function.

Trait Implementations

impl Default for VolumeItem

fn default() -> Self

Returns the “default value” for a type.