Struct DetectorConfigBuilder 

pub struct DetectorConfigBuilder {

    pub quad_min_edge_score: Option<f64>,
    pub subpixel_refinement_sigma: Option<f64>,
    pub segmentation_margin: Option<i16>,
    pub segmentation_connectivity: Option<SegmentationConnectivity>,
    pub upscale_factor: Option<usize>,
    pub decoder_min_contrast: Option<f64>,
    pub refinement_mode: Option<CornerRefinementMode>,
    pub decode_mode: Option<DecodeMode>,
    pub max_hamming_error: Option<u32>,
    pub gwlf_transversal_alpha: Option<f64>,
    pub quad_max_elongation: Option<f64>,
    pub quad_min_density: Option<f64>,
    pub quad_extraction_mode: Option<QuadExtractionMode>,
    pub huber_delta_px: Option<f64>,
    pub tikhonov_alpha_max: Option<f64>,
    pub sigma_n_sq: Option<f64>,
    pub structure_tensor_radius: Option<u8>,
    /* private fields */
}

Builder for DetectorConfig.

Fields

quad_min_edge_score: Option<f64>

Minimum gradient magnitude along edges (rejects weak candidates).

subpixel_refinement_sigma: Option<f64>

Sigma for Gaussian in subpixel refinement.

segmentation_margin: Option<i16>

Margin for threshold-model segmentation.

segmentation_connectivity: Option<SegmentationConnectivity>

Connectivity mode for segmentation (4 or 8).

upscale_factor: Option<usize>

Upscale factor for low-res images (1 = no upscale).

decoder_min_contrast: Option<f64>

Minimum contrast for decoder to accept a tag.

refinement_mode: Option<CornerRefinementMode>

Refinement mode.

decode_mode: Option<DecodeMode>

Decoding mode.

max_hamming_error: Option<u32>

Maximum Hamming errors.

gwlf_transversal_alpha: Option<f64>

GWLF transversal alpha.

quad_max_elongation: Option<f64>

Maximum elongation for the moments culling gate.

quad_min_density: Option<f64>

Minimum density for the moments culling gate.

quad_extraction_mode: Option<QuadExtractionMode>

Quad extraction mode.

huber_delta_px: Option<f64>

Huber delta for LM reprojection (pixels).

tikhonov_alpha_max: Option<f64>

Maximum Tikhonov regularisation alpha for Accurate mode.

sigma_n_sq: Option<f64>

Pixel noise variance for Structure Tensor covariance model.

structure_tensor_radius: Option<u8>

Radius of the Structure Tensor window in Accurate mode.

Implementations

impl DetectorConfigBuilder

pub fn threshold_tile_size(self, size: usize) -> Self

Set the tile size for adaptive thresholding.

pub fn threshold_min_range(self, range: u8) -> Self

Set the minimum intensity range for valid tiles.

pub fn quad_min_area(self, area: u32) -> Self

Set the minimum quad area.

pub fn quad_max_aspect_ratio(self, ratio: f32) -> Self

Set the maximum aspect ratio.

pub fn quad_min_fill_ratio(self, ratio: f32) -> Self

Set the minimum fill ratio.

pub fn quad_max_fill_ratio(self, ratio: f32) -> Self

Set the maximum fill ratio.

pub fn quad_min_edge_length(self, length: f64) -> Self

Set the minimum edge length.

pub fn quad_min_edge_score(self, score: f64) -> Self

Set the minimum edge gradient score.

pub fn enable_bilateral(self, enable: bool) -> Self

Enable or disable bilateral pre-filtering.

pub fn bilateral_sigma_space(self, sigma: f32) -> Self

Set bilateral spatial sigma.

pub fn bilateral_sigma_color(self, sigma: f32) -> Self

Set bilateral color sigma.

pub fn enable_sharpening(self, enable: bool) -> Self

Enable or disable Laplacian sharpening.

pub fn enable_adaptive_window(self, enable: bool) -> Self

Enable or disable adaptive threshold window sizing.

pub fn threshold_min_radius(self, radius: usize) -> Self

Set minimum threshold window radius.

pub fn threshold_max_radius(self, radius: usize) -> Self

Set maximum threshold window radius.

pub fn adaptive_threshold_constant(self, c: i16) -> Self

Set the constant subtracted from local mean in adaptive thresholding.

pub fn adaptive_threshold_gradient_threshold(self, threshold: u8) -> Self

Set the gradient threshold for adaptive window sizing.

pub fn build(self) -> DetectorConfig

Build the configuration, using defaults for unset fields.

pub fn validated_build(self) -> Result<DetectorConfig, ConfigError>

Build the configuration and validate all parameter ranges.

Errors

Returns [ConfigError] if any parameter is out of its valid range.

pub fn segmentation_connectivity( self, connectivity: SegmentationConnectivity, ) -> Self

Set the segmentation connectivity.

pub fn segmentation_margin(self, margin: i16) -> Self

Set the segmentation margin for threshold-model CCL.

pub fn upscale_factor(self, factor: usize) -> Self

Set the upscale factor (1 = no upscaling, 2 = 2x, etc.).

pub fn decoder_min_contrast(self, contrast: f64) -> Self

Set the minimum contrast for decoder bit classification. Lower values (e.g., 10.0) improve recall on small/blurry checkerboard tags.

pub fn refinement_mode(self, mode: CornerRefinementMode) -> Self

Set the corner refinement mode.

pub fn decode_mode(self, mode: DecodeMode) -> Self

Set the decoding mode (Hard or Soft).

pub fn max_hamming_error(self, errors: u32) -> Self

Set the maximum number of Hamming errors allowed.

pub fn gwlf_transversal_alpha(self, alpha: f64) -> Self

Set the GWLF transversal alpha.

pub fn quad_max_elongation(self, max_elongation: f64) -> Self

Set the maximum elongation for the moments-based culling gate. Set to 0.0 to disable (default). Recommended: 15.0.

pub fn quad_min_density(self, min_density: f64) -> Self

Set the minimum density for the moments-based culling gate. Set to 0.0 to disable (default). Recommended: 0.2.

pub fn quad_extraction_mode(self, mode: QuadExtractionMode) -> Self

Set the quad extraction mode (ContourRdp or EdLines).

pub fn huber_delta_px(self, delta: f64) -> Self

Set the Huber delta for LM reprojection (pixels).

pub fn tikhonov_alpha_max(self, alpha: f64) -> Self

Set the maximum Tikhonov regularisation alpha for Accurate pose mode.

pub fn sigma_n_sq(self, sigma_n_sq: f64) -> Self

Set the pixel noise variance for the Structure Tensor covariance model.

pub fn structure_tensor_radius(self, radius: u8) -> Self

Set the Structure Tensor window radius for Accurate pose mode.

Trait Implementations

impl Default for DetectorConfigBuilder

fn default() -> DetectorConfigBuilder

Returns the “default value” for a type.