Foundation (CVMetric.dll) 14.0
3) Configuration of Calibration

Functions to configure calibration configuration object. More...

Functions

cvbres_t CVMAQS12CalConfigGetCalculateCorrectionOfLaserPlaneInclination (CVMAQS12CALCONFIG CalibrationConfiguration, cvbbool_t &CalculateCorrectionOfLaserPlaneInclination)
 Gets the flag to calculate the correction of the laser plane inlincation from a calibration configurator. More...
 
cvbres_t CVMAQS12CalConfigGetCalculateHomography (CVMAQS12CALCONFIG CalibrationConfiguration, cvbbool_t &CalculateHomography)
 Gets the flag to calculate homography from a calibration configurator. More...
 
cvbres_t CVMAQS12CalConfigGetPointsAndTopBasePlaneDistance (CVMAQS12CALCONFIG CalibrationConfiguration, CVC3DPointD Points[12], double &TopBasePlaneDistance)
 Returns AQS12 points and distance between top and base plane set in the calibration configuration CalibrationConfiguration. More...
 
cvbres_t CVMAQS12CalConfigSetCalculateCorrectionOfLaserPlaneInclination (CVMAQS12CALCONFIG CalibrationConfiguration, cvbbool_t CalculateCorrectionOfLaserPlaneInclination)
 Sets or resets the flag to calculate the correction of the laser plane inclination of a calibration configurator. More...
 
cvbres_t CVMAQS12CalConfigSetCalculateHomography (CVMAQS12CALCONFIG CalibrationConfiguration, cvbbool_t CalculateHomography)
 Sets or resets the flag to calculate homography of a calibration configurator. More...
 
cvbres_t CVMAQS12CreateInstrinsicCalConfig (const CVC3DPointD Points[12], double TopBasePlaneDistance, CVMAQS12CALCONFIG &InstrinsicCalibrationConfiguration)
 Creates a default intrinsic calibration configurator. Calculation of homography and correction of laser plane inclination is set to true. More...
 

Detailed Description

Functions to configure calibration configuration object.

Function Documentation

◆ CVMAQS12CalConfigGetCalculateCorrectionOfLaserPlaneInclination()

cvbres_t CVMAQS12CalConfigGetCalculateCorrectionOfLaserPlaneInclination ( CVMAQS12CALCONFIG  CalibrationConfiguration,
cvbbool_t &  CalculateCorrectionOfLaserPlaneInclination 
)

Gets the flag to calculate the correction of the laser plane inlincation from a calibration configurator.

Since
Common Vision Blox 13.4
Parameters
[in]CalibrationConfigurationCalibration configurator.
[out]CalculateCorrectionOfLaserPlaneInclinationReceived flag to calculate the correction of the laser plane inclination.
Returns
  • CVC_ERROR(CVC_E_OK) on success
  • CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr or invalid
See also
CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CalConfigSetCalculateCorrectionOfLaserPlaneInclination

◆ CVMAQS12CalConfigGetCalculateHomography()

cvbres_t CVMAQS12CalConfigGetCalculateHomography ( CVMAQS12CALCONFIG  CalibrationConfiguration,
cvbbool_t &  CalculateHomography 
)

Gets the flag to calculate homography from a calibration configurator.

Since
Common Vision Blox 13.4
Parameters
[in]CalibrationConfigurationCalibration configurator.
[out]CalculateHomographyReceived flag to calculate homography.
Returns
  • CVC_ERROR(CVC_E_OK) on success
  • CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr or invalid
See also
CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CalConfigSetCalculateHomography

◆ CVMAQS12CalConfigGetPointsAndTopBasePlaneDistance()

cvbres_t CVMAQS12CalConfigGetPointsAndTopBasePlaneDistance ( CVMAQS12CALCONFIG  CalibrationConfiguration,
CVC3DPointD  Points[12],
double &  TopBasePlaneDistance 
)

Returns AQS12 points and distance between top and base plane set in the calibration configuration CalibrationConfiguration.

Since
Common Vision Blox 13.4
Parameters
[in]CalibrationConfigurationCalibration configuration object.
[out]PointsVariable to receive the 12 reference points.
[out]TopBasePlaneDistanceVariable to receive the distance between the top plane and the base plane.
Returns
  • CVC_ERROR(CVC_E_OK) on success
  • CVC_ERROR(CVC_E_WRONGOBJECT) if InstrinsicCalibrationConfiguration is a nullptr or invalid
  • CVC_ERROR(CVC_E_PARAMETER) if Points is a nullptr
See also
CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CalConfigSetCalculateCorrectionOfLaserPlaneInclination()

cvbres_t CVMAQS12CalConfigSetCalculateCorrectionOfLaserPlaneInclination ( CVMAQS12CALCONFIG  CalibrationConfiguration,
cvbbool_t  CalculateCorrectionOfLaserPlaneInclination 
)

Sets or resets the flag to calculate the correction of the laser plane inclination of a calibration configurator.

Since
Common Vision Blox 13.4
Parameters
[in]CalibrationConfigurationCalibration configurator to be modified.
[in]CalculateCorrectionOfLaserPlaneInclinationFlag to calculate the correction of the laser plane inclination.
Returns
  • CVC_ERROR(CVC_E_OK) on success
  • CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr or invalid
See also
CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CalConfigSetCalculateHomography, CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CalConfigSetCalculateHomography()

cvbres_t CVMAQS12CalConfigSetCalculateHomography ( CVMAQS12CALCONFIG  CalibrationConfiguration,
cvbbool_t  CalculateHomography 
)

Sets or resets the flag to calculate homography of a calibration configurator.

Since
Common Vision Blox 13.4
Parameters
[in]CalibrationConfigurationCalibration configurator to be modified.
[in]CalculateHomographyFlag to calculate homography.
Returns
  • CVC_ERROR(CVC_E_OK) on success
  • CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr
See also
CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CalConfigSetCalculateCorrectionOfLaserPlaneInclination, CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CreateInstrinsicCalConfig()

cvbres_t CVMAQS12CreateInstrinsicCalConfig ( const CVC3DPointD  Points[12],
double  TopBasePlaneDistance,
CVMAQS12CALCONFIG &  InstrinsicCalibrationConfiguration 
)

Creates a default intrinsic calibration configurator. Calculation of homography and correction of laser plane inclination is set to true.

Note
If this function returns successfully you need to release the returned InstrinsicCalibrationConfiguration via ReleaseObject if not needed anymore.
Since
Common Vision Blox 13.4
Parameters
[in]PointsThe 12 reference points in world coordinates.
[in]TopBasePlaneDistanceOptional distance between the top plane and the base plane in world coordinate units (same as Points); can be 0 if base plane is at z = 0.
[out]InstrinsicCalibrationConfigurationVariable to receive the resulting calibration configuration object.
Returns
  • CVC_ERROR(CVC_E_OK) on success
  • CVC_ERROR(CVC_E_PARAMETER) if Points is a nullptr
  • CVC_ERROR(CVC_E_MEMORY) if not enough memory was available to create the Calibrator.
See also
CVMAQS12CalConfigSetCalculateHomography, CVMAQS12CalConfigSetCalculateCorrectionOfLaserPlaneInclination, CVMAQS12CreateIntrinsicCalibratorFromPiece