Struct SceneSpec 

pub struct SceneSpec {
    pub meshes: Vec<MeshDraw>,
    pub points: Vec<PointDraw>,
    pub lines: Vec<LineDraw>,
    pub lights: LightRig,
    pub style: SceneStyle,
    pub camera: Option<CameraState>,
    pub framing: Framing,
    pub focus: Option<Focus>,
    pub controls: CameraControls,
    pub axes: Option<Axes>,
}

Declarative scene description: the marks plus styling. Resolved into a Scene3DData at draw time (the camera is auto-framed against the marks’ combined bounds, or taken from SceneSpec::camera when set).

Fields

meshes: Vec<MeshDraw>

points: Vec<PointDraw>

lines: Vec<LineDraw>

lights: LightRig

style: SceneStyle

camera: Option<CameraState>

App-supplied camera pose. With Framing::Manual it is used verbatim; with Auto/Fit its orbit angles seed the framed view. None uses a default three-quarter pose.

framing: Framing

How the camera relates to the data bounds. Defaults to Framing::Auto (fit, then free).

focus: Option<Focus>

Declarative focus request. Changing it animates the camera to the new viewpoint (under Auto/Fit). None leaves framing/gestures in charge.

controls: CameraControls

Pointer navigation scheme (default CameraControls::Orbit).

axes: Option<Axes>

Axis tick/title labels. None (the default) draws no labels; Some projects labels through the camera at draw time. Independent of SceneStyle::show_axes, which draws the axis lines.

Implementations

impl SceneSpec

pub fn new() -> Self

pub fn points(self, handle: PointsHandle) -> Self

Add a point/scatter mark with the default style.

pub fn points_styled(self, handle: PointsHandle, style: PointStyle) -> Self

Add a point mark with an explicit style.

pub fn points_labeled( self, handle: PointsHandle, style: PointStyle, labels: PointLabels, ) -> Self

Add a point mark with per-point labels / hover tooltips.

pub fn add_points(self, draw: PointDraw) -> Self

Add a fully-specified point mark (transform + style).

pub fn mesh(self, handle: MeshHandle) -> Self

Add a mesh mark with the default material.

pub fn mesh_with(self, handle: MeshHandle, material: Material) -> Self

Add a mesh mark with an explicit material.

pub fn add_mesh(self, draw: MeshDraw) -> Self

Add a fully-specified mesh mark (transform + material).

pub fn lines(self, handle: LinesHandle) -> Self

Add a line mark with the default style.

pub fn lines_styled(self, handle: LinesHandle, style: LineStyle) -> Self

Add a line mark with an explicit style.

pub fn add_lines(self, draw: LineDraw) -> Self

Add a fully-specified line mark (transform + style).

pub fn grid(self, planes: GridPlanes) -> Self

Set which planes carry the reference grid.

pub fn no_grid(self) -> Self

Turn the reference grid off.

pub fn axis_bounds(self, axis: AxisKind, min: f32, max: f32) -> Self

Clip one axis to an explicit world [min, max], overriding the symmetric grid extent for that axis alone. The grid plane lines, the axis line, and the axis’s ticks/title all honour the bound; the other axes stay symmetric. Useful for a naturally one-sided axis — e.g. CIE L* ∈ [0, 100], which should never draw a negative half.

pub fn background(self, color: Color) -> Self

Fill the scene background (default leaves it transparent).

pub fn style(self, style: SceneStyle) -> Self

Replace the whole style block.

pub fn lights(self, rig: LightRig) -> Self

Replace the light rig.

pub fn camera(self, state: CameraState) -> Self

Supply an explicit camera pose. With Framing::Manual it is the authoritative pose; otherwise its orbit angles seed the framed view.

pub fn framing(self, framing: Framing) -> Self

Set how the camera relates to the data bounds (default Framing::Auto).

pub fn focus(self, focus: Focus) -> Self

Request the camera animate to a Focus. Changing the value across rebuilds triggers a smooth move; passing the same value is a no-op.

pub fn controls(self, controls: CameraControls) -> Self

Choose the pointer navigation scheme (default CameraControls::Orbit).

pub fn axes(self, axes: Axes) -> Self

Enable axis labels with the given configuration.

pub fn axis_titles( self, x: impl Into<String>, y: impl Into<String>, z: impl Into<String>, ) -> Self

Enable axis labels with default styling and the three titles set.

Trait Implementations

impl Clone for SceneSpec

fn clone(&self) -> SceneSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SceneSpec

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

Formats the value using the given formatter.

impl Default for SceneSpec

fn default() -> SceneSpec

Returns the “default value” for a type.