use serde::{Deserialize, Serialize}; use crate::Vec3; /// Axis-aligned bounding box. #[derive(Clone, Copy, Debug, PartialEq, Serialize, Deserialize)] pub struct Aabb3 { pub min: Vec3, pub max: Vec3, } impl Default for Aabb3 { fn default() -> Self { Aabb3::EMPTY } } impl Aabb3 { pub const EMPTY: Aabb3 = Aabb3 { min: Vec3::new(f64::INFINITY, f64::INFINITY, f64::INFINITY), max: Vec3::new(f64::NEG_INFINITY, f64::NEG_INFINITY, f64::NEG_INFINITY), }; pub fn is_empty(&self) -> bool { !(self.min.x <= self.max.x && self.min.y <= self.max.y && self.min.z <= self.max.z) } pub fn add(&mut self, p: Vec3) { if p.is_finite() { self.min = self.min.min(p); self.max = self.max.max(p); } } pub fn union(&self, o: &Aabb3) -> Aabb3 { if self.is_empty() { return *o; } if o.is_empty() { return *self; } Aabb3 { min: self.min.min(o.min), max: self.max.max(o.max) } } pub fn center(&self) -> Vec3 { if self.is_empty() { Vec3::ZERO } else { (self.min + self.max) * 0.5 } } pub fn size(&self) -> Vec3 { if self.is_empty() { Vec3::ZERO } else { self.max - self.min } } pub fn diagonal(&self) -> f64 { self.size().len() } } /// An indexed triangle mesh with per-vertex normals, a face id per triangle (the B-rep face it /// came from) and edge polylines (the B-rep edges, for display and picking). #[derive(Clone, Debug, Default, Serialize, Deserialize)] pub struct Mesh { pub positions: Vec, pub normals: Vec, /// Triangles as vertex index triples (counter-clockwise seen from outside). pub triangles: Vec<[u32; 3]>, /// B-rep face index per triangle. pub tri_face: Vec, /// B-rep edges as polylines. pub edges: Vec>, /// Per edge: a seam between two pieces of the same smooth surface (not drawn). #[serde(default)] pub seams: Vec, /// Per edge: the B-rep faces it bounds (one or two). #[serde(default)] pub edge_faces: Vec>, } /// Mass properties of a closed mesh. #[derive(Clone, Copy, Debug, Default, PartialEq, Serialize, Deserialize)] pub struct MeshMeasure { pub volume: f64, pub area: f64, pub centroid: Vec3, } impl Mesh { /// Edges bounding face `f`. pub fn face_edges(&self, f: u32) -> Vec { self.edge_faces.iter().enumerate().filter(|(_, fs)| fs.contains(&f)).map(|(i, _)| i).collect() } /// The edges reached from `e` through vertices where the next edge continues smoothly /// (angle between the end tangents below `max_angle`), including `e` itself. pub fn tangent_chain(&self, e: usize, max_angle: f64) -> Vec { // (end point, direction leaving the edge there). A polyline's end chord leans inward // on a curve by half the turn to the next chord; extrapolating the two end chords // recovers the curve's end tangent. let end_dir = |p0: Vec3, p1: Vec3, p2: Option| -> Option { let u1 = (p0 - p1).normalized()?; match p2.and_then(|p2| (p1 - p2).normalized()) { Some(u2) => (u1 * 1.5 - u2 * 0.5).normalized(), None => Some(u1), } }; let ends = |i: usize| -> Option<[(Vec3, Vec3); 2]> { let p = self.edges.get(i)?; let n = p.len(); let (a, a1, a2) = (*p.first()?, *p.get(1)?, p.get(2).copied().filter(|_| n > 2)); let (b, b1) = (*p.last()?, *p.get(n.checked_sub(2)?)?); let b2 = n.checked_sub(3).and_then(|k| p.get(k)).copied(); Some([(a, end_dir(a, a1, a2)?), (b, end_dir(b, b1, b2)?)]) }; let size = self.bounds().diagonal().max(1e-9); let tol = size * 1e-7; let cos = max_angle.cos(); let mut chain = vec![e]; let mut todo = vec![e]; while let Some(cur) = todo.pop() { let Some(ce) = ends(cur) else { continue }; for (i, _) in self.edges.iter().enumerate() { if chain.contains(&i) || self.seams.get(i).copied().unwrap_or(false) { continue; } let Some(ne) = ends(i) else { continue }; // Smooth: leaving `cur` at a shared end continues into `i` (opposite directions). let smooth = ce.iter().any(|(p, d)| ne.iter().any(|(q, dn)| p.dist(*q) < tol && d.dot(-*dn) > cos)); if smooth && chain.len() < 10_000 { chain.push(i); todo.push(i); } } } chain } pub fn tri(&self, t: &[u32; 3]) -> Option<[Vec3; 3]> { Some([*self.positions.get(t[0] as usize)?, *self.positions.get(t[1] as usize)?, *self.positions.get(t[2] as usize)?]) } pub fn bounds(&self) -> Aabb3 { let mut b = Aabb3::EMPTY; for p in &self.positions { b.add(*p); } b } /// Signed volume (divergence theorem), surface area and volume centroid. pub fn measure(&self) -> MeshMeasure { let (mut v6, mut area, mut c) = (0.0, 0.0, Vec3::ZERO); for t in &self.triangles { let Some([a, b, cc]) = self.tri(t) else { continue }; let d = a.dot(b.cross(cc)); v6 += d; c += (a + b + cc) * d; area += (b - a).cross(cc - a).len() * 0.5; } let volume = v6 / 6.0; let centroid = if v6.abs() > 1e-12 { c / (4.0 * v6) } else { self.bounds().center() }; MeshMeasure { volume, area, centroid } } /// Append another mesh (face ids offset by `face_offset`). pub fn append(&mut self, o: &Mesh, face_offset: u32) { let base = u32::try_from(self.positions.len()).unwrap_or(u32::MAX); self.positions.extend_from_slice(&o.positions); self.normals.extend_from_slice(&o.normals); self.triangles.extend(o.triangles.iter().map(|t| [t[0].saturating_add(base), t[1].saturating_add(base), t[2].saturating_add(base)])); self.tri_face.extend(o.tri_face.iter().map(|f| f.saturating_add(face_offset))); self.edges.extend(o.edges.iter().cloned()); } /// Number of triangles a ray crosses (for inside/outside tests on closed meshes). pub fn ray_crossings(&self, o: Vec3, dir: Vec3) -> usize { let mut n = 0; for t in &self.triangles { let Some([a, b, c]) = self.tri(t) else { continue }; let (e1, e2) = (b - a, c - a); let p = dir.cross(e2); let det = e1.dot(p); if det.abs() < 1e-14 { continue; } let inv = 1.0 / det; let s = o - a; let u = s.dot(p) * inv; if !(0.0..1.0).contains(&u) { continue; } let q = s.cross(e1); let v = dir.dot(q) * inv; if v < 0.0 || u + v >= 1.0 { continue; } if e2.dot(q) * inv > 0.0 { n += 1; } } n } /// Point inside a closed mesh (majority vote of three skewed rays). pub fn contains(&self, p: Vec3) -> bool { let dirs = [Vec3::new(0.5773, 0.5774, 0.5776), Vec3::new(-0.6123, 0.3141, 0.7254), Vec3::new(0.2718, -0.8414, 0.4673)]; dirs.iter().filter(|d| self.ray_crossings(p, **d) % 2 == 1).count() >= 2 } /// Closest intersection of a ray with the mesh: (distance along `dir`, triangle index). pub fn raycast(&self, o: Vec3, dir: Vec3) -> Option<(f64, usize)> { let mut best: Option<(f64, usize)> = None; for (i, t) in self.triangles.iter().enumerate() { let Some([a, b, c]) = self.tri(t) else { continue }; let (e1, e2) = (b - a, c - a); let p = dir.cross(e2); let det = e1.dot(p); if det.abs() < 1e-14 { continue; } let inv = 1.0 / det; let s = o - a; let u = s.dot(p) * inv; if !(0.0..=1.0).contains(&u) { continue; } let q = s.cross(e1); let v = dir.dot(q) * inv; if v < 0.0 || u + v > 1.0 { continue; } let t = e2.dot(q) * inv; if t > 1e-9 && best.is_none_or(|(bt, _)| t < bt) { best = Some((t, i)); } } best } } /// Point-in-mesh queries in bulk: for each of `Mesh::contains`'s three ray directions, the /// triangles binned on a grid in the plane square to it, so a ray tests only the triangles /// whose shadow covers its cell. Answers exactly as `Mesh::contains` does. pub struct InsideIndex<'a> { mesh: &'a Mesh, rays: Vec, } struct RayGrid { dir: Vec3, u: Vec3, v: Vec3, min: (f64, f64), cell: f64, n: (usize, usize), cells: Vec>, } const RAY_DIRS: [Vec3; 3] = [Vec3::new(0.5773, 0.5774, 0.5776), Vec3::new(-0.6123, 0.3141, 0.7254), Vec3::new(0.2718, -0.8414, 0.4673)]; impl Mesh { /// An index for many `contains` queries on this mesh. pub fn inside_index(&self) -> InsideIndex<'_> { let rays = RAY_DIRS .iter() .map(|d| { let u = d.any_perp(); let v = d.cross(u); let tris: Vec<[(f64, f64); 3]> = self .triangles .iter() .map(|t| match self.tri(t) { Some([a, b, c]) => [(a.dot(u), a.dot(v)), (b.dot(u), b.dot(v)), (c.dot(u), c.dot(v))], None => [(0.0, 0.0); 3], }) .collect(); let (mut lo, mut hi) = ((f64::INFINITY, f64::INFINITY), (f64::NEG_INFINITY, f64::NEG_INFINITY)); for t in &tris { for p in t { lo = (lo.0.min(p.0), lo.1.min(p.1)); hi = (hi.0.max(p.0), hi.1.max(p.1)); } } let span = (hi.0 - lo.0).max(hi.1 - lo.1).max(1e-9); let side = ((tris.len() as f64).sqrt().ceil() as usize).clamp(1, 256); let cell = span / side as f64 * (1.0 + 1e-9); let n = (side + 1, side + 1); let mut cells = vec![Vec::new(); n.0 * n.1]; if lo.0.is_finite() { for (i, t) in tris.iter().enumerate() { let (x0, x1) = (t.iter().map(|p| p.0).fold(f64::INFINITY, f64::min), t.iter().map(|p| p.0).fold(f64::NEG_INFINITY, f64::max)); let (y0, y1) = (t.iter().map(|p| p.1).fold(f64::INFINITY, f64::min), t.iter().map(|p| p.1).fold(f64::NEG_INFINITY, f64::max)); let c = |x: f64, o: f64, m: usize| (((x - o) / cell).floor().max(0.0) as usize).min(m - 1); for gx in c(x0, lo.0, n.0)..=c(x1, lo.0, n.0) { for gy in c(y0, lo.1, n.1)..=c(y1, lo.1, n.1) { if let Some(slot) = cells.get_mut(gx * n.1 + gy) { slot.push(i as u32); } } } } } RayGrid { dir: *d, u, v, min: lo, cell, n, cells } }) .collect(); InsideIndex { mesh: self, rays } } } impl InsideIndex<'_> { fn crossings(&self, g: &RayGrid, o: Vec3) -> usize { let (x, y) = (o.dot(g.u), o.dot(g.v)); if !(g.min.0.is_finite()) { return 0; } let (fx, fy) = ((x - g.min.0) / g.cell, (y - g.min.1) / g.cell); if fx < 0.0 || fy < 0.0 { return 0; } let (gx, gy) = (fx.floor() as usize, fy.floor() as usize); if gx >= g.n.0 || gy >= g.n.1 { return 0; } let Some(list) = g.cells.get(gx * g.n.1 + gy) else { return 0 }; let dir = g.dir; let mut n = 0; for &i in list { let Some(t) = self.mesh.triangles.get(i as usize) else { continue }; let Some([a, b, c]) = self.mesh.tri(t) else { continue }; let (e1, e2) = (b - a, c - a); let p = dir.cross(e2); let det = e1.dot(p); if det.abs() < 1e-14 { continue; } let inv = 1.0 / det; let s = o - a; let u = s.dot(p) * inv; if !(0.0..1.0).contains(&u) { continue; } let q = s.cross(e1); let v = dir.dot(q) * inv; if v < 0.0 || u + v >= 1.0 { continue; } if e2.dot(q) * inv > 0.0 { n += 1; } } n } /// Same answer as `Mesh::contains`. pub fn contains(&self, p: Vec3) -> bool { self.rays.iter().filter(|g| self.crossings(g, p) % 2 == 1).count() >= 2 } }