Struct Scatter3D 

pub struct Scatter3D { /* private fields */ }

A 3D scatter plot: per-point (x, y, z) positions coloured by a per-point value through a Colormap, drawn as PointMarker sprites of one size.

Port of silx plot3d.items.Scatter3D (DataItem3D + ColormapMixIn + SymbolMixIn). silx colours points on the GPU from a colormap texture; here the mapping is done on the CPU via Colormap::color_at when building the geometry — simpler, and points are few relative to image rasters.

Implementations

impl Scatter3D

pub fn new() -> Self

An empty scatter with silx defaults: the viridis colormap over [0, 1], circle markers at DEFAULT_SCATTER3D_SIZE.

pub fn set_data( &mut self, x: &[f32], y: &[f32], z: &[f32], values: &[f64], ) -> bool

Replace the point data (silx Scatter3D.setData). The four arrays must be the same length; on a length mismatch the data is left unchanged and false is returned (silx asserts equal lengths).

pub fn with_data(self, x: &[f32], y: &[f32], z: &[f32], values: &[f64]) -> Self

Builder form of set_data; a length mismatch leaves the data empty.

pub fn set_colormap(&mut self, colormap: Colormap)

Set the colormap (silx ColormapMixIn.setColormap).

pub fn with_colormap(self, colormap: Colormap) -> Self

Builder form of set_colormap.

pub fn colormap(&self) -> &Colormap

Read-only access to the colormap.

pub fn colormap_mut(&mut self) -> &mut Colormap

Mutable access to the colormap (e.g. to set the value range directly).

pub fn autoscale_colormap(&mut self, mode: AutoscaleMode) -> (f64, f64)

Fit the colormap’s value range to the current data with mode (silx’s colormap autoscale over the value array), returning the new (vmin, vmax). With no data the range falls back to the autoscale default, matching AutoscaleMode::range.

pub fn set_marker(&mut self, marker: PointMarker)

Set the marker shape (silx SymbolMixIn.setSymbol).

pub fn with_marker(self, marker: PointMarker) -> Self

Builder form of set_marker.

pub fn set_size(&mut self, size: f32)

Set the marker size in pixels (silx SymbolMixIn.setSymbolSize), clamped to be non-negative.

pub fn with_size(self, size: f32) -> Self

Builder form of set_size.

pub fn len(&self) -> usize

Number of points.

pub fn is_empty(&self) -> bool

True when there are no points.

pub fn bounds(&self) -> Option<(Vec3, Vec3)>

Axis-aligned data bounds (min, max) over the points (silx DataItem3D.getBounds), or None when empty. Useful to frame a crate::widget::scene_widget::SceneWidget.

pub fn append_to(&self, geometry: &mut Scene3dGeometry)

Append this scatter’s points (coloured through the colormap) to geometry, ready to upload via crate::render::gpu_scene3d::set_scene3d.

Trait Implementations

impl Clone for Scatter3D

fn clone(&self) -> Scatter3D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scatter3D

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

Formats the value using the given formatter.

impl Default for Scatter3D

fn default() -> Self

Returns the “default value” for a type.