axiolid-primitive 0.3.2

Exact parametric primitive solids used as CSG leaves
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
85
86

//! Bounded analytic solid primitives.

use axiolid_core::Scalar;

/// Exact primitive solid; tessellation is a separate operation.
#[non_exhaustive]
#[derive(Debug, Clone, Copy, PartialEq)]
pub enum Primitive {
    /// Axis-aligned box in local coordinates.
    Block {
        /// Extent along x.
        x: Scalar,
        /// Extent along y.
        y: Scalar,
        /// Extent along z.
        z: Scalar,
    },
    /// Sphere centered at the local origin.
    Sphere {
        /// Radius.
        radius: Scalar,
    },
    /// Cylinder along local +z.
    Cylinder {
        /// Radius.
        radius: Scalar,
        /// Height.
        height: Scalar,
    },
    /// Cone along local +z.
    Cone {
        /// Base radius.
        radius: Scalar,
        /// Height.
        height: Scalar,
    },
    /// Rectangular pyramid along local +z.
    Pyramid {
        /// Base extent along x.
        x: Scalar,
        /// Base extent along y.
        y: Scalar,
        /// Height.
        height: Scalar,
    },
    /// Ring torus centred on the local origin, about local +z.
    ///
    /// The tube's centre circle has radius `major_radius` in the plane
    /// z = 0. Only a ring torus, `0 < minor_radius < major_radius`, is a
    /// valid solid: at `minor == major` (a horn torus) the tube pinches the
    /// axis to a point, and past it (a spindle torus) the tube overlaps
    /// itself, so neither bounds a two-manifold solid.
    Torus {
        /// Radius of the tube's centre circle.
        major_radius: Scalar,
        /// Radius of the tube.
        minor_radius: Scalar,
    },
    /// Wedge: a box whose top face is narrowed or shifted, as OCCT's
    /// `BRepPrimAPI_MakeWedge(dx, dy, dz, xmin, zmin, xmax, zmax)` with
    /// OCCT's y (the height) read as local +z here.
    ///
    /// The base is the rectangle `[0, x] x [0, y]` at z = 0 and the top is
    /// `[top_x_min, top_x_max] x [top_y_min, top_y_max]` at z = `height`.
    /// Every face is planar and the solid is the convex hull of the two
    /// rectangles. The top may collapse to a segment (`top_x_min ==
    /// top_x_max` or `top_y_min == top_y_max`, a wedge proper) or to a point
    /// (a pyramid with its apex anywhere); OCCT's `ltx` form is `top_x_min =
    /// 0`, `top_x_max = ltx`, `top_y_min = 0`, `top_y_max = y`.
    Wedge {
        /// Base extent along x.
        x: Scalar,
        /// Base extent along y.
        y: Scalar,
        /// Height along z.
        height: Scalar,
        /// Top face's least x.
        top_x_min: Scalar,
        /// Top face's greatest x.
        top_x_max: Scalar,
        /// Top face's least y.
        top_y_min: Scalar,
        /// Top face's greatest y.
        top_y_max: Scalar,
    },
}