Name
set_calib_data_observ_pointsT_set_calib_data_observ_pointsSetCalibDataObservPointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPoints — Set point-based observation data in a calibration data model.
Herror set_calib_data_observ_points(const HTuple& CalibDataID, const HTuple& CameraIdx, const HTuple& CalibObjIdx, const HTuple& CalibObjPoseIdx, const HTuple& Row, const HTuple& Column, const HTuple& Index, const HTuple& Pose)
void HCalibData::SetCalibDataObservPoints(const HTuple& CameraIdx, const HTuple& CalibObjIdx, const HTuple& CalibObjPoseIdx, const HTuple& Row, const HTuple& Column, const HTuple& Index, const HTuple& Pose) const
void SetCalibDataObservPoints(const HTuple& CalibDataID, const HTuple& CameraIdx, const HTuple& CalibObjIdx, const HTuple& CalibObjPoseIdx, const HTuple& Row, const HTuple& Column, const HTuple& Index, const HTuple& Pose)
void HCalibData::SetCalibDataObservPoints(Hlong CameraIdx, Hlong CalibObjIdx, Hlong CalibObjPoseIdx, const HTuple& Row, const HTuple& Column, const HTuple& Index, const HTuple& Pose) const
void HOperatorSetX.SetCalibDataObservPoints(
[in] VARIANT CalibDataID, [in] VARIANT CameraIdx, [in] VARIANT CalibObjIdx, [in] VARIANT CalibObjPoseIdx, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Index, [in] VARIANT Pose)
void HCalibDataX.SetCalibDataObservPoints(
[in] Hlong CameraIdx, [in] Hlong CalibObjIdx, [in] Hlong CalibObjPoseIdx, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Index, [in] VARIANT Pose)
static void HOperatorSet.SetCalibDataObservPoints(HTuple calibDataID, HTuple cameraIdx, HTuple calibObjIdx, HTuple calibObjPoseIdx, HTuple row, HTuple column, HTuple index, HTuple pose)
void HCalibData.SetCalibDataObservPoints(int cameraIdx, int calibObjIdx, int calibObjPoseIdx, HTuple row, HTuple column, HTuple index, HTuple pose)
For a calibration model of type
CalibSetup='calibration_object'"calibration_object""calibration_object""calibration_object""calibration_object""calibration_object" (see
create_calib_datacreate_calib_dataCreateCalibDatacreate_calib_dataCreateCalibDataCreateCalibData), cameras are calibrated based on so-called
observations of calibration objects. With
set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPoints, you store such an observation in
the calibration data model CalibDataIDCalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID. An observation consists of
the following data:
- CameraIdxCameraIdxCameraIdxCameraIdxCameraIdxcameraIdx:
index of the observing camera
- CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx:
index of the observed calibration object
- CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdx:
index of the observed pose of the
calibration object. You can choose it freely, without following a strict
order. If you specify an index that already exists for the calibration
object CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx, the corresponding observation data is
replaced by the new one. Of course, the same index can be assigned to
poses of different calibration objects.
- RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn, IndexIndexIndexIndexIndexindex:
Extracted image
coordinates and corresponding index of the calibration marks of the calibration
object. RowRowRowRowRowrow and ColumnColumnColumnColumnColumncolumn are tuples containing the same
number of elements. IndexIndexIndexIndexIndexindex can either contain a tuple (of the
same length) or the value 'all'"all""all""all""all""all", indicating that the points
[Row, Column] correspond in a one-to-one relation to the
calibration marks of the calibration object. If the number of row or column
coordinates does not match the number of calibration marks, a
corresponding error message is returned.
- PosePosePosePosePosepose:
A roughly estimated pose of the observed calibration
object relative to observing camera.
If you are using the HALCON calibration plate, it is recommended to use
find_calib_objectfind_calib_objectFindCalibObjectfind_calib_objectFindCalibObjectFindCalibObject instead of set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPoints,
since the contour information, which it stores in the calibration data
model, enables a more precise calibration procedure with
calibrate_camerascalibrate_camerasCalibrateCamerascalibrate_camerasCalibrateCamerasCalibrateCameras.
The observation data can be accessed later by calling
get_calib_data_observ_pointsget_calib_data_observ_pointsGetCalibDataObservPointsget_calib_data_observ_pointsGetCalibDataObservPointsGetCalibDataObservPoints using the same values for the
arguments CameraIdxCameraIdxCameraIdxCameraIdxCameraIdxcameraIdx, CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx, and
CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdx.
A camera calibration data model CalibDataID cannot be shared
between two or more user's threads. Different camera calibration data
models can be used independently and safely in different threads.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Handle of a calibration data model.
Index of the observing camera.
Default value: 0
Suggested values: 0, 1, 2
Index of the calibration object.
Default value: 0
Suggested values: 0, 1, 2
Index of the observed calibration object.
Default value: 0
Suggested values: 0, 1, 2
Restriction: CalibObjPoseIdx >= 0
RowRowRowRowRowrow (input_control) number-array → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Row coordinates of the extracted points.
Column coordinates of the extracted points.
Correspondence of the extracted points to the
calibration marks of the observed calibration object.
Default value:
'all'
"all"
"all"
"all"
"all"
"all"
Suggested values: 'all'"all""all""all""all""all", 0, 1, 2
PosePosePosePosePosepose (input_control) number-array → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Roughly estimated pose of the observed calibration
object relative to the observing camera.
Number of elements: 7
find_marks_and_posefind_marks_and_poseFindMarksAndPosefind_marks_and_poseFindMarksAndPoseFindMarksAndPose,
set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParam,
set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObject
set_calib_dataset_calib_dataSetCalibDataset_calib_dataSetCalibDataSetCalibData,
calibrate_camerascalibrate_camerasCalibrateCamerascalibrate_camerasCalibrateCamerasCalibrateCameras
find_calib_objectfind_calib_objectFindCalibObjectfind_calib_objectFindCalibObjectFindCalibObject
Calibration