IDS peak ICV v1.1.0
Loading...
Searching...
No Matches
DistortionCoefficients Class Reference

#include <peak_icv/algorithms/calibration/peak_icv_distortion_coefficients.hpp>

Public Member Functions

 DistortionCoefficients (const RadialDistortion &radialDistortion, const TangentialDistortion &tangentialDistortion)
 Creates distortion coefficients from radial and tangential distortion coefficients.
 
 DistortionCoefficients (const RadialDistortion &radialDistortion, const TangentialDistortion &tangentialDistortion, const PrismDistortion &prismDistortion)
 Creates distortion coefficients from radial, tangential and prism distortion coefficients.
 
 DistortionCoefficients (const RadialDistortion &radialDistortion, const TangentialDistortion &tangentialDistortion, const PrismDistortion &prismDistortion, const TiltDistortion &tiltDistortion)
 Creates distortion coefficients from radial, tangential, prism and tilt distortion coefficients.
 
RadialDistortion GetRadialDistortion () const
 
TangentialDistortion GetTangentialDistortion () const
 
PrismDistortion GetPrismDistortion () const
 
TiltDistortion GetTiltDistortion () const
 
bool operator== (const DistortionCoefficients &rhs) const
 

Detailed Description

Holds lens distortion coefficients.

Contains coefficients used to model and correct optical distortions introduced by real-world lenses. These coefficients are typically estimated during camera calibration and are used for image undistortion or improving projection accuracy.

The distortion model includes:

  • RadialDistortion: Radial distortion causes straight lines to appear curved, especially near the image edges. The effect increases with distance from the optical center.
  • TangentialDistortion: Tangential distortion results from lens decentering, where the lens is not perfectly aligned with the optical axis. This causes image points to be displaced perpendicular to the radial direction.
  • PrismDistortion: Prism distortion introduces asymmetrical warping due to optical elements such as prisms or tilted glass plates. This distortion leads to non-uniform displacement that cannot be captured by purely radial models.
  • TiltDistortion: Tilt distortion occurs when the lens is tilted relative to the image plane, introducing a global projective distortion that skews the overall image geometry.
Since
ids_peak_icv 1.1

Definition at line 115 of file peak_icv_distortion_coefficients.hpp.

Constructor & Destructor Documentation

◆ DistortionCoefficients() [1/3]

DistortionCoefficients ( const RadialDistortion & radialDistortion,
const TangentialDistortion & tangentialDistortion )
inline

Creates distortion coefficients from radial and tangential distortion coefficients.

Since
ids_peak_icv 1.1

Definition at line 182 of file peak_icv_distortion_coefficients.hpp.

◆ DistortionCoefficients() [2/3]

DistortionCoefficients ( const RadialDistortion & radialDistortion,
const TangentialDistortion & tangentialDistortion,
const PrismDistortion & prismDistortion )
inline

Creates distortion coefficients from radial, tangential and prism distortion coefficients.

Since
ids_peak_icv 1.1

Definition at line 187 of file peak_icv_distortion_coefficients.hpp.

◆ DistortionCoefficients() [3/3]

DistortionCoefficients ( const RadialDistortion & radialDistortion,
const TangentialDistortion & tangentialDistortion,
const PrismDistortion & prismDistortion,
const TiltDistortion & tiltDistortion )
inline

Creates distortion coefficients from radial, tangential, prism and tilt distortion coefficients.

Since
ids_peak_icv 1.1

Definition at line 192 of file peak_icv_distortion_coefficients.hpp.

Member Function Documentation

◆ GetPrismDistortion()

PrismDistortion GetPrismDistortion ( ) const
inline
Returns
The prism distortion.
Since
ids_peak_icv 1.1

Definition at line 218 of file peak_icv_distortion_coefficients.hpp.

◆ GetRadialDistortion()

RadialDistortion GetRadialDistortion ( ) const
inline
Returns
The radial distortion.
Since
ids_peak_icv 1.1

Definition at line 208 of file peak_icv_distortion_coefficients.hpp.

◆ GetTangentialDistortion()

TangentialDistortion GetTangentialDistortion ( ) const
inline
Returns
The tangential distortion.
Since
ids_peak_icv 1.1

Definition at line 213 of file peak_icv_distortion_coefficients.hpp.

◆ GetTiltDistortion()

TiltDistortion GetTiltDistortion ( ) const
inline
Returns
The tilt distortion.
Since
ids_peak_icv 1.1

Definition at line 223 of file peak_icv_distortion_coefficients.hpp.

◆ operator==()

bool operator== ( const DistortionCoefficients & rhs) const
inline

Definition at line 228 of file peak_icv_distortion_coefficients.hpp.