DriveWorks SDK Reference
3.5.78 Release
For Test and Development only

Camera Calibration

Detailed Description

Parameters for initializing a camera calibration.

Note
SW Release Applicability: These APIs are available in both NVIDIA DriveWorks and NVIDIA DRIVE Software releases.

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

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

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

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.