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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

use nalgebra::Point3;

use crate::{misc::Plane, prelude::FloatingPoint};

/// A segment in 3D space.
pub struct Segment<T: FloatingPoint> {
    pub a: Point3<T>,
    pub b: Point3<T>,
}

#[derive(Debug, Clone, Copy)]
pub enum SplitResult<T> {
    /// The split operation yield two results: one lying on the negative half-space of the plane
    /// and the second lying on the positive half-space of the plane.
    Pair(T, T),
    /// The shape being split is fully contained in the negative half-space of the plane.
    Negative,
    /// The shape being split is fully contained in the positive half-space of the plane.
    Positive,
    /// The segment is parallel to the plane.
    Parallel,
}

impl<T: FloatingPoint> Segment<T> {
    pub fn new(a: Point3<T>, b: Point3<T>) -> Self {
        Self { a, b }
    }

    /// Split a segment with a plane.
    pub fn split(
        &self,
        plane: &Plane<T>,
        epsilon: T,
    ) -> (SplitResult<Self>, Option<(Point3<T>, T)>) {
        let dir = self.b - self.a;
        let dir_norm = dir.norm();

        let d_a = plane.signed_distance(&self.a);
        let d_b = plane.signed_distance(&self.b);
        if d_a > T::zero() && d_b > T::zero() {
            return (SplitResult::Positive, None);
        } else if d_a < T::zero() && d_b < T::zero() {
            return (SplitResult::Negative, None);
        }

        let denom = d_a - d_b;
        if denom.relative_eq(&T::zero(), T::default_epsilon(), T::default_max_relative()) {
            return (SplitResult::Parallel, None);
        }

        let t = d_a / denom;
        if (dir_norm * t).abs() <= epsilon {
            return (SplitResult::Parallel, None);
        }

        let intersection = self.a + dir * t;
        let s1 = Segment::new(self.a, intersection);
        let s2 = Segment::new(intersection, self.b);
        if d_a >= T::zero() {
            (SplitResult::Pair(s1, s2), Some((intersection, t)))
        } else {
            (SplitResult::Pair(s2, s1), Some((intersection, t)))
        }
    }
}