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

pub mod curve_morph;
pub mod point_morph;

#[cfg(test)]
mod tests;

use nalgebra::{allocator::Allocator, DefaultAllocator, DimName, DimNameDiff, DimNameSub, U1};

use crate::{misc::FloatingPoint, surface::nurbs_surface::NurbsSurface};

/// A unified trait for morphing points, curves, and surfaces from a reference surface to a target surface.
///
/// This trait enables the transformation of geometric entities by:
/// 1. Finding the closest UV parameter(s) on the reference surface
/// 2. Evaluating the target surface at the same UV parameter(s)
/// 3. Returning the morphed entity
///
/// # Type Parameters
///
/// * `T` - The floating point type (f32 or f64)
/// * `D` - The dimension of the homogeneous coordinate system
///
/// # Implementations
///
/// This trait is implemented for:
/// - `OPoint<T, Const<3>>` (Point3) - Morphs a single point
/// - `NurbsCurve<T, Const<4>>` - Morphs all control points of a curve
/// - `NurbsSurface<T, Const<4>>` - Morphs all control points of a surface
pub trait Morph<T, D>
where
    T: FloatingPoint,
    D: DimName,
    DefaultAllocator: Allocator<D>,
    D: DimNameSub<U1>,
    DefaultAllocator: Allocator<DimNameDiff<D, U1>>,
{
    /// The option type for the morphing
    type Option;

    /// The output type after morphing
    type Output;

    /// Morphs the geometric entity from the reference surface to the target surface.
    ///
    /// # Arguments
    ///
    /// * `reference_surface` - The reference surface to find UV parameter(s)
    /// * `target_surface` - The target surface to evaluate at the found UV parameter(s)
    ///
    /// # Returns
    ///
    /// The morphed entity, or an error if the morphing fails
    fn morph(
        &self,
        reference_surface: &NurbsSurface<T, D>,
        target_surface: &NurbsSurface<T, D>,
        option: Self::Option,
    ) -> anyhow::Result<Self::Output>;
}