Struct ReconstructionEvidence

#[non_exhaustive]
pub struct ReconstructionEvidence {
    pub input_points: usize,
    pub used_points: usize,
    pub output_triangles: usize,
    pub output_components: usize,
    pub closed: bool,
    pub achieved_edge_length: f64,
    pub sample_spacing: f64,
    pub used_normals: bool,
    pub interpolated_triangles: usize,
}

Counters describing one reconstruction.

Every field is a fact about the computation, never a quality verdict: whether 12% unsupported area is acceptable is the caller’s decision, not the kernel’s.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

input_points: usize

Points supplied.

used_points: usize

Points the provider actually used.

Lower than input_points when the provider discarded outliers or duplicates. A large gap is worth a caller’s attention.

output_triangles: usize

Triangles in the result.

output_components: usize

Connected components in the result.

A capture with gaps often reconstructs into several shells. Reporting it lets a caller detect the split here rather than downstream.

closed: bool

Whether the result is a closed two-manifold solid.

achieved_edge_length: f64

Edge length the provider achieved, in model units.

Reported whether or not the caller stated one, so a FromSampleSpacing request still learns what it got.

sample_spacing: f64

Median distance between neighbouring input samples.

The scale the capture actually resolves. A result finer than this is interpolation, not measurement.

used_normals: bool

Whether per-point normals were used.

False when the cloud carried none, or the request declined them, or the provider could not use them. Distinguishes a normal-driven result from a positions-only one.

interpolated_triangles: usize

Triangles whose vertices came from interpolation across a gap in the data rather than from measured samples.

This is the honest measure of how much of the surface is invented. Zero means every triangle rests on real points.

Implementations

impl ReconstructionEvidence

pub fn measured() -> ReconstructionEvidence

Start from a cleared record and fill in what the provider measured.

#[non_exhaustive] keeps the struct additive, so a provider outside this crate cannot build one with a literal. This constructor is the supported route: take the default and set the fields you measured. A field left at its default is honestly “not measured” rather than a value invented to satisfy the type.

Trait Implementations

impl Clone for ReconstructionEvidence

fn clone(&self) -> ReconstructionEvidence

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ReconstructionEvidence

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

Formats the value using the given formatter.

impl Default for ReconstructionEvidence

fn default() -> ReconstructionEvidence

Returns the “default value” for a type.

impl PartialEq for ReconstructionEvidence

fn eq(&self, other: &ReconstructionEvidence) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ReconstructionEvidence