curvo 0.1.88

NURBS modeling library
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

use nalgebra::Vector2;

use crate::misc::FloatingPoint;

/// First fundamental form (metric tensor) of a parametric surface at a point.
/// Encodes how UV distances map to 3D distances.
///
/// ds² = E·du² + 2F·du·dv + G·dv²
#[derive(Debug, Clone, Copy)]
pub struct SurfaceMetric<T: FloatingPoint> {
    /// E = Su · Su
    pub e: T,
    /// G = Sv · Sv
    pub g: T,
}

impl<T: FloatingPoint> SurfaceMetric<T> {
    pub fn new(e: T, g: T) -> Self {
        Self { e, g }
    }

    /// Compute the maximum allowable UV step size given a target 3D edge length.
    /// Returns (max_du, max_dv) — the maximum steps in each UV direction
    /// that produce edges of approximately `target_length` in 3D.
    pub fn max_uv_step(&self, target_length: T) -> Vector2<T> {
        let du = if self.e > T::default_epsilon() {
            target_length / self.e.sqrt()
        } else {
            target_length
        };
        let dv = if self.g > T::default_epsilon() {
            target_length / self.g.sqrt()
        } else {
            target_length
        };
        Vector2::new(du, dv)
    }
}

/// Compute the target 3D edge length from curvature and deflection tolerance.
/// Based on chord-height criterion: for a circle of radius R = 1/|k|,
/// the chord length that produces deflection `d` is L = 2·sqrt(2·R·d - d²) ≈ 2·sqrt(2·d/|k|).
pub fn curvature_to_edge_length<T: FloatingPoint>(curvature: T, deflection: T) -> T {
    let eps = T::from_f64(1e-12).unwrap();
    if curvature.abs() < eps {
        return T::from_f64(1e6).unwrap(); // flat → no curvature constraint
    }
    let two = T::from_f64(2.0).unwrap();
    (two * deflection / curvature.abs()).sqrt() * two
}