Struct DistortionFixMask 

pub struct DistortionFixMask {
    pub k1: bool,
    pub k2: bool,
    pub k3: bool,
    pub p1: bool,
    pub p2: bool,
}

Mask for fixing distortion parameters during optimization.

Supports Brown-Conrady distortion model with:

• Radial coefficients: k1, k2, k3
• Tangential coefficients: p1, p2

Set a field to true to keep that parameter fixed during optimization.

Default

By default, k3 is fixed because it often causes overfitting with typical calibration data. Only enable k3 optimization for wide-angle lenses or with high-quality calibration data.

Example

use vision_calibration_core::DistortionFixMask;

// Default: k3 fixed, others free
let mask = DistortionFixMask::default();
assert!(!mask.k1);
assert!(mask.k3); // k3 fixed by default

// Fix tangential distortion
let mask = DistortionFixMask {
    p1: true,
    p2: true,
    ..Default::default()
};

Fields

k1: bool

Fix first radial distortion coefficient.

k2: bool

Fix second radial distortion coefficient.

k3: bool

Fix third radial distortion coefficient (fixed by default).

p1: bool

Fix first tangential distortion coefficient.

p2: bool

Fix second tangential distortion coefficient.

Implementations

impl DistortionFixMask

pub fn all_fixed() -> Self

Create a mask that fixes all distortion parameters.

pub fn all_free() -> Self

Create a mask that allows all distortion parameters to be optimized.

pub fn radial_only() -> Self

Create a mask that only allows radial distortion (k1, k2) to be optimized.

Fixes k3, p1, p2 - useful for standard lenses with minimal tangential distortion.

pub fn any_fixed(&self) -> bool

Returns true if any parameter is fixed.

pub fn all_are_fixed(&self) -> bool

Returns true if all parameters are fixed.

pub fn to_indices(&self) -> Vec<usize>

Convert to a vector of fixed indices (for IR FixedMask).

Index mapping: k1=0, k2=1, k3=2, p1=3, p2=4

Trait Implementations

impl Clone for DistortionFixMask

fn clone(&self) -> DistortionFixMask

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DistortionFixMask

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

Formats the value using the given formatter.

impl Default for DistortionFixMask

fn default() -> Self

Default mask with k3 fixed to prevent overfitting.

impl<'de> Deserialize<'de> for DistortionFixMask

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DistortionFixMask

fn eq(&self, other: &DistortionFixMask) -> 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 Serialize for DistortionFixMask

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for DistortionFixMask

impl Eq for DistortionFixMask

impl StructuralPartialEq for DistortionFixMask