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.

cvbres_t	CVMAQS12CalConfigGetCalculateEncoderStep (CVMAQS12CALCONFIG CalibrationConfiguration, cvbbool_t &CalculateEncoderStep)
	Gets the flag for calculating the encoder step (scale in Y).

cvbres_t	CVMAQS12CalConfigGetCalculateHomography (CVMAQS12CALCONFIG CalibrationConfiguration, cvbbool_t &CalculateHomography)
	Gets the flag to calculate homography from a calibration configurator.

cvbres_t	CVMAQS12CalConfigGetExtrinsicTransformationModel (CVMAQS12CALCONFIG CalibrationConfiguration, CVMExtrinsicTransformationModel &Model)
	Gets the extrinsic transformation model set in a calibration configuration object.

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.

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.

cvbres_t	CVMAQS12CalConfigSetCalculateEncoderStep (CVMAQS12CALCONFIG CalibrationConfiguration, cvbbool_t CalculateEncoderStep)
	Sets the flag for calculating the encoder step (scale in Y).

cvbres_t	CVMAQS12CalConfigSetCalculateHomography (CVMAQS12CALCONFIG CalibrationConfiguration, cvbbool_t CalculateHomography)
	Sets or resets the flag to calculate homography of a calibration configurator.

cvbres_t	CVMAQS12CalConfigSetExtrinsicTransformationModel (CVMAQS12CALCONFIG CalibrationConfiguration, CVMExtrinsicTransformationModel Model)
	Sets the extrinsic transformation model in a calibration configuration object.

cvbres_t	CVMAQS12CreateExtrinsicCalConfig (const CVC3DPointD Points[12], double TopBasePlaneDistance, CVMAQS12CALCONFIG &CalibrationConfiguration)
	Creates a default extrinsic calibration configurator. Calculation of homography is set to false and extrinsic transformation model is set to CVMETM_AffineTransformation.

cvbres_t	CVMAQS12CreateInstrinsicCalConfig (const CVC3DPointD Points[12], double TopBasePlaneDistance, CVMAQS12CALCONFIG &InstrinsicCalibrationConfiguration)
	Creates a default intrinsic calibration configurator. Calculation of homography and extrinsic transformation model is set to CVMETM_AffineTransformation.

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.

Parameters

[in]	CalibrationConfiguration	Calibration configurator.
[out]	CalculateCorrectionOfLaserPlaneInclination	Received 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

◆ CVMAQS12CalConfigGetCalculateEncoderStep()

cvbres_t CVMAQS12CalConfigGetCalculateEncoderStep	(	CVMAQS12CALCONFIG	CalibrationConfiguration,
		cvbbool_t &	CalculateEncoderStep )

Gets the flag for calculating the encoder step (scale in Y).

Parameters

[in]	CalibrationConfiguration	Calibration configurator to be modified.
[in]	CalculateEncoderStep	If true, the encoder step will be estimated.

Returns

CVC_ERROR(CVC_E_OK) on success
CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr or invalid

See also: CVMAQS12CalConfigSetCalculateEncoderStep, CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CreateExtrinsicCalConfig, CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CalConfigGetCalculateHomography()

cvbres_t CVMAQS12CalConfigGetCalculateHomography	(	CVMAQS12CALCONFIG	CalibrationConfiguration,
		cvbbool_t &	CalculateHomography )

Gets the flag to calculate homography from a calibration configurator.

Parameters

[in]	CalibrationConfiguration	Calibration configurator.
[out]	CalculateHomography	Received 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

◆ CVMAQS12CalConfigGetExtrinsicTransformationModel()

cvbres_t CVMAQS12CalConfigGetExtrinsicTransformationModel	(	CVMAQS12CALCONFIG	CalibrationConfiguration,
		CVMExtrinsicTransformationModel &	Model )

Gets the extrinsic transformation model set in a calibration configuration object.

Parameters

[in]	CalibrationConfiguration	Calibration configurator.
[in]	Model	Received xtrinsic transformation model.

Returns

CVC_ERROR(CVC_E_OK) on success
CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr or invalid

See also: CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CreateExtrinsicCalConfig, CVMAQS12CalConfigSetExtrinsicTransformationModel

◆ 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.

Parameters

[in]	CalibrationConfiguration	Calibration configuration object.
[out]	Points	Variable to receive the 12 reference points.
[out]	TopBasePlaneDistance	Variable 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.

Parameters

[in]	CalibrationConfiguration	Calibration configurator to be modified.
[in]	CalculateCorrectionOfLaserPlaneInclination	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, CVMAQS12CalConfigSetCalculateHomography, CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CalConfigSetCalculateEncoderStep()

cvbres_t CVMAQS12CalConfigSetCalculateEncoderStep	(	CVMAQS12CALCONFIG	CalibrationConfiguration,
		cvbbool_t	CalculateEncoderStep )

Sets the flag for calculating the encoder step (scale in Y).

Parameters

[in]	CalibrationConfiguration	Calibration configurator to be modified.
[in]	CalculateEncoderStep	If true, the encoder step will be estimated.

Returns

CVC_ERROR(CVC_E_OK) on success
CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr or invalid

See also: CVMAQS12CalConfigGetCalculateEncoderStep, CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CreateExtrinsicCalConfig, CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CalConfigSetCalculateHomography()

cvbres_t CVMAQS12CalConfigSetCalculateHomography	(	CVMAQS12CALCONFIG	CalibrationConfiguration,
		cvbbool_t	CalculateHomography )

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

Parameters

[in]	CalibrationConfiguration	Calibration configurator to be modified.
[in]	CalculateHomography	Flag to calculate homography.

Returns

CVC_ERROR(CVC_E_OK) on success
CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr

See also: CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CalConfigSetExtrinsicTransformationModel, CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CalConfigSetExtrinsicTransformationModel()

cvbres_t CVMAQS12CalConfigSetExtrinsicTransformationModel	(	CVMAQS12CALCONFIG	CalibrationConfiguration,
		CVMExtrinsicTransformationModel	Model )

Sets the extrinsic transformation model in a calibration configuration object.

Parameters

[in]	CalibrationConfiguration	Calibration configurator to be modified.
[in]	Model	Extrinsic transformation model.

Returns

CVC_ERROR(CVC_E_OK) on success
CVC_ERROR(CVC_E_WRONGOBJECT) if CalibrationConfiguration is a nullptr or invalid

See also: CVMAQS12CreateInstrinsicCalConfig, CVMAQS12CreateExtrinsicCalConfig, CVMAQS12CalConfigSetCalculateHomography, CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CreateExtrinsicCalConfig()

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

Creates a default extrinsic calibration configurator. Calculation of homography is set to false and extrinsic transformation model is set to CVMETM_AffineTransformation.

Note: If this function returns successfully you need to release the returned CalibrationConfiguration via ReleaseObject if not needed anymore.

Parameters

[in]	Points	The 12 reference points in world coordinates.
[in]	TopBasePlaneDistance	Optional 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]	CalibrationConfiguration	Variable 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, CVMAQS12CalConfigSetExtrinsicTransformationModel, CVMAQS12CalConfigSetCalculateEncoderStep, CVMAQS12CreateIntrinsicCalibratorFromPiece

◆ CVMAQS12CreateInstrinsicCalConfig()

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

Creates a default intrinsic calibration configurator. Calculation of homography and extrinsic transformation model is set to CVMETM_AffineTransformation.

Note: If this function returns successfully you need to release the returned InstrinsicCalibrationConfiguration via ReleaseObject if not needed anymore.

Parameters

[in]	Points	The 12 reference points in world coordinates.
[in]	TopBasePlaneDistance	Optional 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]	InstrinsicCalibrationConfiguration	Variable 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, CVMAQS12CalConfigSetExtrinsicTransformationModel, CVMAQS12CalConfigSetCalculateEncoderStep, CVMAQS12CreateIntrinsicCalibratorFromPiece