Struct PlanarQuadMesh 

pub struct PlanarQuadMesh {
    pub nu: usize,
    pub nv: usize,
    pub vertices: Vec<V3>,
    pub faces: Vec<[usize; 4]>,
    pub planarity_errors: Vec<f64>,
}

A planar quad mesh (PQ mesh) approximating a free-form surface.

In a PQ mesh every face is (approximately) planar, enabling single-layer glass fabrication. Generated via conjugate curve nets on the surface.

Fields

nu: usize

Grid resolution in the u direction.

nv: usize

Grid resolution in the v direction.

vertices: Vec<V3>

Vertex positions (row-major, nu×nv).

faces: Vec<[usize; 4]>

Quad faces as vertex index tuples (i, i+1, i+cols+1, i+cols).

planarity_errors: Vec<f64>

Planarity error per face (m).

Implementations

impl PlanarQuadMesh

pub fn from_surface<F>(nu: usize, nv: usize, surface_fn: F) -> Self

where F: Fn(f64, f64) -> V3,

Build a PQ mesh from a height-field surface z(u,v) using a uniform parameter grid.

surface_fn maps (u, v) ∈ [0,1]² → (x, y, z).

pub fn mean_planarity_error(&self) -> f64

Mean planarity error across all faces (m).

pub fn max_planarity_error(&self) -> f64

Maximum planarity error (m).

pub fn planarity_compliance_ratio(&self, tol: f64) -> f64

Fraction of faces within tolerance tol (m).

pub fn gaussian_curvature_at(&self, i: usize, j: usize) -> f64

Gaussian curvature approximation at interior vertex (i, j).

Uses the angle-deficit method: K ≈ (2π − Σθ) / A, where θ are the face angles at the vertex and A is the mixed area.

pub fn face_count(&self) -> usize

Total number of faces.

Trait Implementations

impl Clone for PlanarQuadMesh

fn clone(&self) -> PlanarQuadMesh

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PlanarQuadMesh

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.