ruviz 0.6.0

High-performance 2D plotting library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

use crate::render::{Color, ColorMap};

/// Surface lighting mode.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
pub enum SurfaceShading {
    /// Preserve colormap colors without lighting.
    Unlit,
    /// One normal per triangle.
    Flat,
    /// Area-weighted vertex normals.
    #[default]
    Smooth,
}

/// Surface sampling policy.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
pub enum SurfaceSampling {
    /// Full topology for static output and diagnosed LOD for interaction.
    #[default]
    Auto,
    /// Always use the complete source grid.
    Full,
    /// Use at most the requested regular-grid dimensions.
    MaxGrid { rows: usize, columns: usize },
}

/// Styling and sampling for a regular-grid surface.
#[derive(Clone, Debug)]
pub struct Surface3DConfig {
    /// Optional fixed color. When absent, z is mapped through `colormap`.
    pub color: Option<Color>,
    /// Scalar colormap used when no fixed color is present.
    pub colormap: ColorMap,
    /// Lighting mode.
    pub shading: SurfaceShading,
    /// Static/interactive sampling policy.
    pub sampling: SurfaceSampling,
    /// Whether to add a colorbar.
    pub colorbar: bool,
}

impl Default for Surface3DConfig {
    fn default() -> Self {
        Self {
            color: None,
            colormap: ColorMap::viridis(),
            shading: SurfaceShading::Smooth,
            sampling: SurfaceSampling::Auto,
            colorbar: false,
        }
    }
}