Skip to content

set_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_paramT_set_calib_data_cam_param🔗

Short description🔗

set_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_paramT_set_calib_data_cam_param — Set type and initial parameters of a camera in a calibration data model.

Signature🔗

set_calib_data_cam_param( calib_data CalibDataID, number CameraIdx, string CameraType, campar CameraParam )void SetCalibDataCamParam( const HTuple& CalibDataID, const HTuple& CameraIdx, const HTuple& CameraType, const HTuple& CameraParam )static void HOperatorSet.SetCalibDataCamParam( HTuple calibDataID, HTuple cameraIdx, HTuple cameraType, HTuple cameraParam )def set_calib_data_cam_param( calib_data_id: HHandle, camera_idx: Sequence[Union[int, str]], camera_type: MaybeSequence[str], camera_param: Sequence[Union[float, int, str]] ) -> None

Herror T_set_calib_data_cam_param( const Htuple CalibDataID, const Htuple CameraIdx, const Htuple CameraType, const Htuple CameraParam )

void HCalibData::SetCalibDataCamParam( const HTuple& CameraIdx, const HTuple& CameraType, const HCamPar& CameraParam ) const

void HCalibData::SetCalibDataCamParam( const HTuple& CameraIdx, const HString& CameraType, const HCamPar& CameraParam ) const

void HCalibData::SetCalibDataCamParam( const HTuple& CameraIdx, const char* CameraType, const HCamPar& CameraParam ) const

void HCalibData::SetCalibDataCamParam( const HTuple& CameraIdx, const wchar_t* CameraType, const HCamPar& CameraParam ) const (Windows only)

void HCamPar::SetCalibDataCamParam( const HCalibData& CalibDataID, const HTuple& CameraIdx, const HTuple& CameraType ) const

void HCamPar::SetCalibDataCamParam( const HCalibData& CalibDataID, const HTuple& CameraIdx, const HString& CameraType ) const

void HCamPar::SetCalibDataCamParam( const HCalibData& CalibDataID, const HTuple& CameraIdx, const char* CameraType ) const

void HCamPar::SetCalibDataCamParam( const HCalibData& CalibDataID, const HTuple& CameraIdx, const wchar_t* CameraType ) const (Windows only)

void HCalibData.SetCalibDataCamParam( HTuple cameraIdx, HTuple cameraType, HCamPar cameraParam )

void HCalibData.SetCalibDataCamParam( HTuple cameraIdx, string cameraType, HCamPar cameraParam )

void HCamPar.SetCalibDataCamParam( HCalibData calibDataID, HTuple cameraIdx, HTuple cameraType )

void HCamPar.SetCalibDataCamParam( HCalibData calibDataID, HTuple cameraIdx, string cameraType )

Description🔗

The operator set_calib_data_cam_paramSetCalibDataCamParam sets the initial camera parameters CameraParamcameraParamcamera_param for the camera with the index CameraIdxcameraIdxcamera_idx in the calibration data model CalibDataIDcalibDataIDcalib_data_id. The parameter CameraIdxcameraIdxcamera_idx must be between 0 and NumCamerasnumCamerasnum_cameras-1 (NumCamerasnumCamerasnum_cameras is specified during model creation with create_calib_dataCreateCalibData and can be queried with get_calib_dataGetCalibData). If a camera with CameraIdxcameraIdxcamera_idx was already defined, its parameters are overwritten by the current ones (the camera is substituted). In this case, the selection which camera parameters are marked for optimization is reset and maybe has to be set again. Note that all NumCamerasnumCamerasnum_cameras cameras must be set to perform calibrate_camerasCalibrateCameras. The calibration procedure refines these initial parameters. You can find further information about the calibration process of different camera setups in Calibration.

The parameter CameraTypecameraTypecamera_type is only provided for backwards compatibility. The information about the camera type is contained in the first element of CameraParamcameraParamcamera_param. Therefore, CameraTypecameraTypecamera_type should be set either to its default value [][] (the recommended option) or to the same value as the first element of CameraParamcameraParamcamera_param. In any other case an error is raised.

An overview of all available camera types and their respective parameters is given in CameraParamcameraParamcamera_param.

The camera type can be queried later by calling get_calib_dataGetCalibData with the arguments ItemTypeitemTypeitem_type='camera'"camera" and DataNamedataNamedata_name='type'"type". The initial camera parameters can be queried by calling get_calib_dataGetCalibData with arguments ItemTypeitemTypeitem_type='camera'"camera" and DataNamedataNamedata_name='init_params'"init_params".

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

This operator modifies the state of the following input parameter:

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters🔗

CalibDataIDcalibDataIDcalib_data_id (input_control, state is modified) calib_data → (handle)HTuple (HHandle)HCalibData, HTuple (IntPtr)HHandleHtuple (handle)

Handle of a calibration data model.

CameraIdxcameraIdxcamera_idx (input_control) number-array → (integer / string)HTuple (Hlong / HString)HTuple (int / long / string)Sequence[Union[int, str]]Htuple (Hlong / char*)

Camera index.

Default: 00
Suggested values: 'all', 0, 1, 2"all", 0, 1, 2

CameraTypecameraTypecamera_type (input_control) string(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Type of the camera.

Default: [][]
List of values: [][]

CameraParamcameraParamcamera_param (input_control) campar → (real / integer / string)HTuple (double / Hlong / HString)HCamPar, HTuple (double / int / long / string)Sequence[Union[float, int, str]]Htuple (double / Hlong / char*)

Initial camera internal parameters.

Combinations with other operators🔗

Combinations

Possible predecessors

create_calib_dataCreateCalibData, set_calib_data_calib_objectSetCalibDataCalibObject

Possible successors

set_calib_data_calib_objectSetCalibDataCalibObject, set_calib_data_observ_pointsSetCalibDataObservPoints, find_calib_objectFindCalibObject

Module🔗

Calibration