Struct CompletionParams 

pub struct CompletionParams {
    pub enable: bool,
    pub roi_radius_px: f32,
    pub reproj_gate_px: f32,
    pub min_fit_confidence: f32,
    pub min_arc_coverage: f32,
    pub max_attempts: Option<usize>,
    pub image_margin_px: f32,
    pub require_perfect_decode: bool,
    pub max_radii_std_ratio: f32,
}

Configuration for homography-guided completion: attempt local fits for missing IDs at H-projected board locations.

Fields

enable: bool

Enable completion (runs only when a valid homography is available).

roi_radius_px: f32

Radial sampling extent (pixels) used for edge sampling around the prior center.

reproj_gate_px: f32

Maximum allowed reprojection error (pixels) between the fitted center and the H-projected board center.

min_fit_confidence: f32

Minimum fit confidence in [0, 1].

min_arc_coverage: f32

Minimum arc coverage (fraction of rays with both edges found).

max_attempts: Option<usize>

Optional cap on how many completion fits to attempt (in ID order).

image_margin_px: f32

Skip attempts whose projected center is too close to the image boundary.

require_perfect_decode: bool

Require a perfect decode (dist=0 and margin ≥ the active profile’s minimum cyclic Hamming distance) for a completion marker to be accepted.

When homography prediction accuracy is low (e.g. significant lens distortion without a calibrated mapper), the H-projected seed can be several pixels off. Under those conditions, the geometry gates alone are insufficient; requiring a perfect decode provides an independent quality signal that does not depend on H.

Default: false (backward-compatible). Set to true for Scheimpflug / high- distortion setups where no calibrated camera model is available.

max_radii_std_ratio: f32

Maximum allowed coefficient of variation (std_dev / mean) of per-ray outer radii. High scatter indicates inner/outer edge contamination — rays landing on the inner ring inflate the apparent outer radius for some angles. Values above this threshold cause the completion candidate to be rejected.

The gate is skipped when fewer than 2 rays have valid outer radii or when the mean outer radius is below 1 px (degenerate fit).

Default: 0.35 (35% coefficient of variation).

Trait Implementations

impl Clone for CompletionParams

fn clone(&self) -> CompletionParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompletionParams

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

Formats the value using the given formatter.

impl Default for CompletionParams

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CompletionParams

where CompletionParams: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CompletionParams

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.