set_calib_data_cam_paramT_set_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_param (Operator)
Name
set_calib_data_cam_paramT_set_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_param
— Set type and initial parameters of a camera in a calibration data
model.
Signature
void SetCalibDataCamParam(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)
static void HOperatorSet.SetCalibDataCamParam(HTuple calibDataID, HTuple cameraIdx, HTuple cameraType, HTuple cameraParam)
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_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_param
sets the initial
camera parameters CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param
for the camera with the index
CameraIdxCameraIdxCameraIdxCameraIdxcameraIdxcamera_idx
in the calibration data model
CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id
. The parameter CameraIdxCameraIdxCameraIdxCameraIdxcameraIdxcamera_idx
must be
between 0 and NumCamerasNumCamerasNumCamerasNumCamerasnumCamerasnum_cameras
-1 (NumCamerasNumCamerasNumCamerasNumCamerasnumCamerasnum_cameras
is
specified during model creation with create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data
and
can be queried with get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data
). If a camera with
CameraIdxCameraIdxCameraIdxCameraIdxcameraIdxcamera_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
NumCamerasNumCamerasNumCamerasNumCamerasnumCamerasnum_cameras
cameras must be set to perform
calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras
. The calibration procedure refines these
initial parameters. You can find further information about the calibration
process of different camera setups in Calibration.
The parameter CameraTypeCameraTypeCameraTypeCameraTypecameraTypecamera_type
is only provided for backwards
compatibility.
The information about the camera type is contained in the first element
of CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param
.
Therefore, CameraTypeCameraTypeCameraTypeCameraTypecameraTypecamera_type
should be set either to its default value
[] (the recommended option) or to the same value as the
first element of CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param
. In any other case an error is raised.
An overview of all available camera types and their
respective parameters is given in CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param
.
The camera type can be queried later by calling
get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data
with the arguments
ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type
='camera'"camera""camera""camera""camera""camera" and
DataNameDataNameDataNameDataNamedataNamedata_name
='type'"type""type""type""type""type". The initial camera parameters
can be queried by calling get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data
with arguments
ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type
='camera'"camera""camera""camera""camera""camera" and
DataNameDataNameDataNameDataNamedataNamedata_name
='init_params'"init_params""init_params""init_params""init_params""init_params".
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
CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id
(input_control, state is modified) calib_data →
HCalibData, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of a calibration data model.
CameraIdxCameraIdxCameraIdxCameraIdxcameraIdxcamera_idx
(input_control) number-array →
HTupleSequence[Union[int, str]]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Camera index.
Default:
0
Suggested values:
'all'"all""all""all""all""all", 0, 1, 2
CameraTypeCameraTypeCameraTypeCameraTypecameraTypecamera_type
(input_control) string(-array) →
HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Type of the camera.
Default:
[]
List of values:
[]
CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param
(input_control) campar →
HCamPar, HTupleSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Initial camera internal parameters.
Possible Predecessors
create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data
,
set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObjectSetCalibDataCalibObjectset_calib_data_calib_object
Possible Successors
set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObjectSetCalibDataCalibObjectset_calib_data_calib_object
,
set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPointsSetCalibDataObservPointsset_calib_data_observ_points
,
find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObjectfind_calib_object
Module
Calibration