Detailed Description

Parameters for initializing a camera calibration.

Data Structures
struct	dwCalibrationCameraParams
	Calibration parameters for calibrating a camera sensor. More...

struct	dwCalibrationCameraParams.features
	Options only used when method is DW_CALIBRATION_CAMERA_METHOD_FEATURES. More...

Enumerations
enum	dwCalibrationCameraMethod { DW_CALIBRATION_CAMERA_METHOD_FEATURES = 0 }
	Camera calibration method used for estimation. More...

enum	dwCalibrationCameraSignal { DW_CALIBRATION_CAMERA_SIGNAL_DEFAULT = 0 , DW_CALIBRATION_CAMERA_SIGNAL_PITCHYAW = 1 << 0 , DW_CALIBRATION_CAMERA_SIGNAL_ROLL = 1 << 1 , DW_CALIBRATION_CAMERA_SIGNAL_HEIGHT = 1 << 2 }
	Camera calibration signals to estimate (either `DW_CALIBRATION_CAMERA_SIGNAL_DEFAULT` or combination of explicit signals) More...

Data Structure Documentation

◆ dwCalibrationCameraParams

struct dwCalibrationCameraParams

Data Fields
dwConstCameraModelHandle_t	calibratedCamera	A handle to calibrated camera to use in the camera calibration routine. This handle can be based off the same sensor index as passed into the calibration routine. If this parameter is DW_NULL_HANDLE then a calibrated camera will be created from the rig configuration. If a valid handle is passed, it will be used and the one from rig configuration will be ignored. Note: internally the calibration routine will clone this handle, hence the handle can be reused right after the initialization
dwCameraProperties const *	cameraProperties	Pointer to Camera properties This pointer can't be null and needs to point to the properties of the camera to be calibrated.
uint32_t	extrinsicProfileIndex	index of the extrinsic profile to be calibrated
dwCalibrationFastAcceptanceOption	fastAcceptance	Specification of fast-acceptance behaviour. By default, fast-acceptance is currently not enabled for camera calibrations (this might change in future DW versions). Enabled fast-acceptance additionally requires previously accepted estimates to be active.
struct dwCalibrationCameraParams.features	features	Options only used when method is DW_CALIBRATION_CAMERA_METHOD_FEATURES.
dwCalibrationCameraMethod	method	Calibration method used for estimation.
dwCalibrationStatusChanged	onChanged	An optional pointer to a function that will be called when the calibration status of a routine has changed. The function should be valid to call for as long as the sensor is being calibrated.
dwCalibrationCameraSignal	signals	Signals to be estimated (can be a bitwise "or" of `dwCalibrationCameraSignal` flags)
void *	userData	A pointer to user data that will be passed along when a sensor calibration data has been changed.

◆ dwCalibrationCameraParams.features

struct dwCalibrationCameraParams.features

Data Fields
uint32_t	maxFeatureCount	The maximum number of tracked features per camera.
uint32_t	maxFeatureHistorySize	The maximum number of positions in a feature's location history.

Enumeration Type Documentation

◆ dwCalibrationCameraMethod

enum dwCalibrationCameraMethod

Camera calibration method used for estimation.

Enumerator
DW_CALIBRATION_CAMERA_METHOD_FEATURES	Feature-based calibration, supports estimation of pitch+yaw, roll, and height signals, data is provided with `dwCalibrationEngine_addFeatureDetections()`

Definition at line 61 of file CameraParams.h.

◆ dwCalibrationCameraSignal

enum dwCalibrationCameraSignal

Camera calibration signals to estimate (either DW_CALIBRATION_CAMERA_SIGNAL_DEFAULT or combination of explicit signals)

Enumerator
DW_CALIBRATION_CAMERA_SIGNAL_DEFAULT	Activate supported signals based on properties of the camera sensor.
DW_CALIBRATION_CAMERA_SIGNAL_PITCHYAW	Pitch+yaw estimation, supported by feature-based calibration.
DW_CALIBRATION_CAMERA_SIGNAL_ROLL	Roll estimation, supported by feature-based calibration.
DW_CALIBRATION_CAMERA_SIGNAL_HEIGHT	Height estimation, supported by feature-based calibration.

Definition at line 69 of file CameraParams.h.