scurve-gui 0.2.0

Space-filling curves library and visualization tools.
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

use spacecurve::{curve_from_name, registry};

/// Shared cache and selection state for 2D/3D curve panes.
#[derive(Clone)]
pub struct CurveSelection<const D: usize> {
    /// The selected curve name.
    pub name: String,
    /// The side length of the grid per axis.
    pub size: u32,
    /// Current offset for the animated snake overlay, in segments.
    pub snake_offset: f32,
    /// Whether the info pane for this curve is open.
    pub info_open: bool,
    /// Cache key: last curve name used to generate `cached_points`.
    cached_name: String,
    /// Cache key: last grid size used to generate `cached_points`.
    cached_size: u32,
    /// Cached integer points for the currently selected curve and size.
    cached_points: Vec<[u32; D]>,
    /// Cached curve length for the currently selected curve and size.
    cached_length: Option<u32>,
}

impl<const D: usize> Default for CurveSelection<D> {
    fn default() -> Self {
        let default_name = registry::curve_names(false)
            .first()
            .copied()
            .unwrap_or(registry::CURVE_NAMES[0]);

        Self::with_name(default_name)
    }
}

impl<const D: usize> CurveSelection<D> {
    /// Build a selection with a specific initial curve name.
    pub fn with_name(name: &str) -> Self {
        Self {
            name: name.to_string(),
            size: if D == 2 { 64 } else { 8 },
            snake_offset: 0.0,
            info_open: false,
            cached_name: String::new(),
            cached_size: 0,
            cached_points: Vec::new(),
            cached_length: None,
        }
    }

    /// Reset cached data when the selected curve or size changes.
    fn invalidate_if_changed(&mut self) {
        if self.cached_name != self.name || self.cached_size != self.size {
            self.cached_points.clear();
            self.cached_length = None;
        }
    }

    /// Ensure the cached curve length is available for the current selection.
    pub fn ensure_curve_length(&mut self) -> Option<u32> {
        self.invalidate_if_changed();
        if let Some(len) = self.cached_length {
            return Some(len);
        }
        if !self.cached_points.is_empty() {
            let len = self.cached_points.len() as u32;
            self.cached_length = Some(len);
            return Some(len);
        }
        match curve_from_name(&self.name, D as u32, self.size) {
            Ok(pattern) => {
                let len = pattern.length();
                self.cached_length = Some(len);
                self.cached_name = self.name.clone();
                self.cached_size = self.size;
                Some(len)
            }
            Err(_) => None,
        }
    }

    /// Ensure the cached points are computed for the current name and size.
    /// Returns a slice of cached points if successful.
    pub fn ensure_cached_points(&mut self) -> Option<&[[u32; D]]> {
        self.invalidate_if_changed();
        if self.cached_name != self.name
            || self.cached_size != self.size
            || self.cached_points.is_empty()
        {
            if let Ok(pattern) = curve_from_name(&self.name, D as u32, self.size) {
                let mut pts = Vec::with_capacity(pattern.length() as usize);
                for i in 0..pattern.length() {
                    let p = pattern.point(i);
                    let mut arr = [0u32; D];
                    for d in 0..D {
                        arr[d] = p[d];
                    }
                    pts.push(arr);
                }
                self.cached_points = pts;
                self.cached_name = self.name.clone();
                self.cached_size = self.size;
                self.cached_length = Some(pattern.length());
            } else {
                return None;
            }
        }
        Some(&self.cached_points)
    }
}

/// 2D selection state.
pub type SelectedCurve = CurveSelection<2>;
/// 3D selection state.
pub type Selected3DCurve = CurveSelection<3>;