EWorldShape::AutoCalibrateDotGrid

Performs an automatic calibration based on a dot grid image.

Namespace: Euresys::Open_eVision

[C++]

OEV_UINT32 AutoCalibrateDotGrid(
   const EROIBW8* sourceImage,
   float columnPitch,
   float rowPitch,
   bool testEmpiricalModes,
   bool testAdvancedMode
)

OEV_UINT32 AutoCalibrateDotGrid(
   const EROIBW8* sourceImage,
   float columnPitch,
   float rowPitch,
   bool testEmpiricalModes
)

OEV_UINT32 AutoCalibrateDotGrid(
   const EROIBW8* sourceImage,
   float columnPitch,
   float rowPitch
)

OEV_UINT32 AutoCalibrateDotGrid(
   const EROIBW8* sourceImage,
   float columnPitch,
   float rowPitch,
   OEV_UINT32 enabledCalibrationModes
)

Parameters

sourceImage

Pointer to the source image/ROI.

columnPitch

Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.

rowPitch

Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.

testEmpiricalModes

Boolean indicating whether the empirical quadratic calibration mode (ECalibrationMode.Quadratic) should be considered when determining the best calibration modes. Default value is false.

testAdvancedMode

Boolean indicating whether the advanced calibration mode (ECalibrationMode.Advanced) should be considered when determining the best calibration modes. Default value is false.

enabledCalibrationModes

Calibration modes that should be considered when determining the best calibration model

Remarks

Returns the best calibration mode for the current dot grid. This method will first do an automatic blob Synonym of object. analysis in order to extract all dots (all blobs whose area is smaller than 5 pixels or 1/50000th of the whole image area will be considered as noise and rejected). The dot gravity centers are used as the grid reference points. Then, this method will select and compute the best calibration mode by reducing the fitting error. To ensure a successful calibration, the perspective angle of the dot grid should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode.Scaled, ECalibrationMode.Skewed, ECalibrationMode.Radial, ECalibrationMode.Tilted, and ECalibrationMode.Anisotropic are considered. The ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

EWorldShape.AutoCalibrateDotGrid

Performs an automatic calibration based on a dot grid image.

Namespace: Euresys.Open_eVision

[C#]

uint AutoCalibrateDotGrid(
   EROIBW8 sourceImage,
   float columnPitch,
   float rowPitch,
   bool testEmpiricalModes,
   bool testAdvancedMode
)

uint AutoCalibrateDotGrid(
   EROIBW8 sourceImage,
   float columnPitch,
   float rowPitch,
   bool testEmpiricalModes
)

uint AutoCalibrateDotGrid(
   EROIBW8 sourceImage,
   float columnPitch,
   float rowPitch
)

uint AutoCalibrateDotGrid(
   EROIBW8 sourceImage,
   float columnPitch,
   float rowPitch,
   uint enabledCalibrationModes
)

Parameters

sourceImage

Pointer to the source image/ROI.

columnPitch

Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.

rowPitch

Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.

testEmpiricalModes

Boolean indicating whether the empirical quadratic calibration mode (ECalibrationMode.Quadratic) should be considered when determining the best calibration modes. Default value is false.

testAdvancedMode

Boolean indicating whether the advanced calibration mode (ECalibrationMode.Advanced) should be considered when determining the best calibration modes. Default value is false.

enabledCalibrationModes

Calibration modes that should be considered when determining the best calibration model

Remarks

Returns the best calibration mode for the current dot grid. This method will first do an automatic blob analysis in order to extract all dots (all blobs whose area is smaller than 5 pixels or 1/50000th of the whole image area will be considered as noise and rejected). The dot gravity centers are used as the grid reference points. Then, this method will select and compute the best calibration mode by reducing the fitting error. To ensure a successful calibration, the perspective angle of the dot grid should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode.Scaled, ECalibrationMode.Skewed, ECalibrationMode.Radial, ECalibrationMode.Tilted, and ECalibrationMode.Anisotropic are considered. The ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

EWorldShape.AutoCalibrateDotGrid

Performs an automatic calibration based on a dot grid image.

Module: open_evision

[Python]

AutoCalibrateDotGrid(
    sourceImage: EROIBW8
    columnPitch: float
    rowPitch: float
    testEmpiricalModes: bool
    testAdvancedMode: bool
) -> int

AutoCalibrateDotGrid(
    sourceImage: EROIBW8
    columnPitch: float
    rowPitch: float
    testEmpiricalModes: bool
) -> int

AutoCalibrateDotGrid(
    sourceImage: EROIBW8
    columnPitch: float
    rowPitch: float
) -> int

AutoCalibrateDotGrid(
    sourceImage: EROIBW8
    columnPitch: float
    rowPitch: float
    enabledCalibrationModes: int
) -> int

Parameters

sourceImage

Pointer to the source image/ROI.

columnPitch

Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.

rowPitch

Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.

testEmpiricalModes

Boolean indicating whether the empirical quadratic calibration mode (ECalibrationMode.Quadratic) should be considered when determining the best calibration modes. Default value is false.

testAdvancedMode

Boolean indicating whether the advanced calibration mode (ECalibrationMode.Advanced) should be considered when determining the best calibration modes. Default value is false.

enabledCalibrationModes

Calibration modes that should be considered when determining the best calibration model

Remarks

Returns the best calibration mode for the current dot grid. This method will first do an automatic blob analysis in order to extract all dots (all blobs whose area is smaller than 5 pixels or 1/50000th of the whole image area will be considered as noise and rejected). The dot gravity centers are used as the grid reference points. Then, this method will select and compute the best calibration mode by reducing the fitting error. To ensure a successful calibration, the perspective angle of the dot grid should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode.Scaled, ECalibrationMode.Skewed, ECalibrationMode.Radial, ECalibrationMode.Tilted, and ECalibrationMode.Anisotropic are considered. The ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.