procedural_modelling 0.4.2

A framework-agnostic Procedural Modelling crate.
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

//mod geometry;
mod basics;
mod face3d;
mod payload;

pub use basics::*;
pub use face3d::*;
pub use payload::*;

use super::{EuclideanMeshType, MeshType, VertexBasics};
use crate::math::VectorIteratorExt;

// TODO: Remove methods in trait Face

/// A face in a mesh.
///
/// Isn't necessarily planar or triangular.
pub trait Face: FaceBasics<Self::T> {
    /// Associated mesh type
    type T: MeshType<Face = Self>;

    /// Naive method to get the center of the face by averaging the vertices.
    fn centroid<const D: usize>(
        &self,
        mesh: &<Self::T as MeshType>::Mesh,
    ) -> <Self::T as EuclideanMeshType<D>>::Vec
    where
        Self::T: EuclideanMeshType<D>,
    {
        self.vertices(mesh).map(|v| v.pos()).stable_mean()
    }

    /// Whether a triangle shares a halfedge with the face.
    ///
    /// If there is no evidence that the triangle is touching the face, return None.
    /// Given that all vertices are part of this face, this implies that the triangle is part of the face.
    fn triangle_touches_boundary(
        &self,
        mesh: &<Self::T as MeshType>::Mesh,
        v0: <Self::T as MeshType>::V,
        v1: <Self::T as MeshType>::V,
        v2: <Self::T as MeshType>::V,
    ) -> Option<bool>;
}