Struct RibbonItem 

#[non_exhaustive]
pub struct RibbonItem {
    pub positions: Vec<[f32; 3]>,
    pub strip_lengths: Vec<u32>,
    pub width: f32,
    pub width_attribute: Option<Vec<f32>>,
    pub twist_attribute: Option<Vec<[f32; 3]>>,
    pub scalars: Vec<f32>,
    pub scalar_range: Option<(f32, f32)>,
    pub colourmap_id: Option<ColourmapId>,
    pub colour: [f32; 4],
    pub id: u64,
    pub appearance: AppearanceSettings,
    pub selected: bool,
}

A ribbon strip rendered as a flat quad surface swept along a path.

Each strip in strip_lengths is swept from positions. The ribbon lies in the plane defined by the parallel-transport frame or the optional twist_attribute vectors. Width can be uniform or per-point.

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]>

World-space positions for all strips, concatenated.

strip_lengths: Vec<u32>

Number of vertices per individual strip.

width: f32

Uniform ribbon half-width in world-space units. Default: 0.1.

width_attribute: Option<Vec<f32>>

Optional per-point widths. When set, overrides width at each point.

twist_attribute: Option<Vec<[f32; 3]>>

Optional per-point direction vectors that orient the ribbon face normal. When set, the ribbon is aligned with the projection of this vector onto the plane perpendicular to the local tangent.

scalars: Vec<f32>

Optional per-point scalar values for LUT colouring. Empty = use colour.

scalar_range: Option<(f32, f32)>

Scalar range for LUT mapping. None = auto from data min/max.

colourmap_id: Option<ColourmapId>

Colourmap for scalar colouring. None = default builtin (viridis).

colour: [f32; 4]

Flat RGBA colour used when scalars is empty. Default: opaque white.

id: u64

Unique ID (reserved for picking). Default: 0.

appearance: AppearanceSettings

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

selected: bool

Whether this ribbon set is selected at object level. Default: false.

Trait Implementations

impl Clone for RibbonItem

fn clone(&self) -> RibbonItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RibbonItem

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

Formats the value using the given formatter.

impl Default for RibbonItem

fn default() -> Self

Returns the “default value” for a type.