i_triangle 0.45.0

Polygon Triangulation Library: Efficient Delaunay Triangulation for Complex Shapes.
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

use crate::int::solver::ShapesSolver;
use crate::int::solver::{ContourSolver, ShapeSolver};
use crate::int::triangulation::RawIntTriangulation;
use crate::int::validation::Validation;
use i_key_sort::sort::key::SortKey;
use i_overlay::i_float::int::number::int::IntNumber;
use i_overlay::i_float::int::point::IntPoint;
use i_overlay::i_shape::int::shape::{IntContour, IntShape, IntShapes};
use i_tree::{Expiration, LayoutNumber};

/// A trait for performing triangulation with custom validation settings.
///
/// Useful when precise control over fill rule, minimum area, or orientation is needed.
/// Accepts a custom [`Validation`] struct to configure triangulation behavior.
///
/// # Implemented For
/// - [`IntContour`]
/// - [`IntShape`]
/// - [`IntShapes`]
pub trait IntCustomTriangulatable<I: IntNumber> {
    /// Triangulates the shape(s) using the given [`Validation`] settings.
    fn custom_triangulate(&self, validation: Validation<I>) -> RawIntTriangulation<I>;

    /// Triangulates the shape(s), injecting Steiner points and using the specified [`Validation`] settings.
    fn custom_triangulate_with_steiner_points(
        &self,
        points: &[IntPoint<I>],
        validation: Validation<I>,
    ) -> RawIntTriangulation<I>;
}

impl<I: IntNumber + Expiration + LayoutNumber + SortKey> IntCustomTriangulatable<I>
    for IntContour<I>
{
    #[inline]
    fn custom_triangulate(&self, validation: Validation<I>) -> RawIntTriangulation<I> {
        ContourSolver::triangulate(validation, self)
    }

    #[inline]
    fn custom_triangulate_with_steiner_points(
        &self,
        points: &[IntPoint<I>],
        validation: Validation<I>,
    ) -> RawIntTriangulation<I> {
        ContourSolver::triangulate_with_steiner_points(validation, self, points)
    }
}

impl<I: IntNumber + Expiration + LayoutNumber + SortKey> IntCustomTriangulatable<I>
    for IntShape<I>
{
    #[inline]
    fn custom_triangulate(&self, validation: Validation<I>) -> RawIntTriangulation<I> {
        ShapeSolver::triangulate(validation, self)
    }

    #[inline]
    fn custom_triangulate_with_steiner_points(
        &self,
        points: &[IntPoint<I>],
        validation: Validation<I>,
    ) -> RawIntTriangulation<I> {
        ShapeSolver::triangulate_with_steiner_points(validation, self, points)
    }
}

impl<I: IntNumber + Expiration + LayoutNumber + SortKey> IntCustomTriangulatable<I>
    for IntShapes<I>
{
    #[inline]
    fn custom_triangulate(&self, validation: Validation<I>) -> RawIntTriangulation<I> {
        ShapesSolver::triangulate(validation, self)
    }

    #[inline]
    fn custom_triangulate_with_steiner_points(
        &self,
        points: &[IntPoint<I>],
        validation: Validation<I>,
    ) -> RawIntTriangulation<I> {
        ShapesSolver::triangulate_with_steiner_points(validation, self, points)
    }
}