get_calib_data_observ_contoursT_get_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContoursget_calib_data_observ_contours (Operator)
Name
get_calib_data_observ_contoursT_get_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContoursget_calib_data_observ_contours
— Get contour-based observation data from a calibration data model.
Signature
void GetCalibDataObservContours(HObject* Contours, const HTuple& CalibDataID, const HTuple& ContourName, const HTuple& CameraIdx, const HTuple& CalibObjIdx, const HTuple& CalibObjPoseIdx)
HXLDCont HCalibData::GetCalibDataObservContours(const HString& ContourName, Hlong CameraIdx, Hlong CalibObjIdx, Hlong CalibObjPoseIdx) const
HXLDCont HCalibData::GetCalibDataObservContours(const char* ContourName, Hlong CameraIdx, Hlong CalibObjIdx, Hlong CalibObjPoseIdx) const
HXLDCont HCalibData::GetCalibDataObservContours(const wchar_t* ContourName, Hlong CameraIdx, Hlong CalibObjIdx, Hlong CalibObjPoseIdx) const
(
Windows only)
Description
The operator get_calib_data_observ_contoursget_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContoursGetCalibDataObservContoursget_calib_data_observ_contours
reads contour-based
observation data from a calibration data model CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id
and returns it in ContoursContoursContoursContourscontourscontours
.
These contours result from a preceding call of find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObjectfind_calib_object
.
The parameters CameraIdxCameraIdxCameraIdxCameraIdxcameraIdxcamera_idx
, CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdxcalib_obj_idx
, and
CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdxcalib_obj_pose_idx
are indices of the observing camera, calibration
plate, and calibration object pose.
Together, they specify an observation from the calibration model.
Note that if an observation exists, but it was stored
in the calibration model CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id
by
set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPointsSetCalibDataObservPointsset_calib_data_observ_points
, no contour-based results can be
returned.
By setting ContourNameContourNameContourNameContourNamecontourNamecontour_name
to one of the following values, you can
select the specific type of the contour results:
- 'marks'"marks""marks""marks""marks""marks":
The contours of the calibration plate marks
- 'marks_with_hole'"marks_with_hole""marks_with_hole""marks_with_hole""marks_with_hole""marks_with_hole":
The contours of the calibration plate marks which contain a hole.
- 'caltab'"caltab""caltab""caltab""caltab""caltab":
The contour of the calibration plate finder pattern.
- 'last_caltab'"last_caltab""last_caltab""last_caltab""last_caltab""last_caltab":
The contour of the calibration plate finder pattern, which has been
extracted by the last successful preceding call to
find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObjectfind_calib_object
.
Note that the observation of the successful call to
find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObjectfind_calib_object
is used and consequently the values in
CameraIdxCameraIdxCameraIdxCameraIdxcameraIdxcamera_idx
, CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdxcalib_obj_idx
, and CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdxcalib_obj_pose_idx
are ignored.
The mentioned finder pattern depends on the calibration plate:
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ContoursContoursContoursContourscontourscontours
(output_object) xld_cont(-array) →
objectHXLDContHObjectHXLDContHobject *
Contour-based result(s).
CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id
(input_control) calib_data →
HCalibData, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of a calibration data model.
ContourNameContourNameContourNameContourNamecontourNamecontour_name
(input_control) string →
HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of contour objects to be returned.
Default:
'marks'
"marks"
"marks"
"marks"
"marks"
"marks"
List of values:
'caltab'"caltab""caltab""caltab""caltab""caltab", 'last_caltab'"last_caltab""last_caltab""last_caltab""last_caltab""last_caltab", 'marks'"marks""marks""marks""marks""marks", 'marks_with_hole'"marks_with_hole""marks_with_hole""marks_with_hole""marks_with_hole""marks_with_hole"
CameraIdxCameraIdxCameraIdxCameraIdxcameraIdxcamera_idx
(input_control) number →
HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the observing camera.
Default:
0
CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdxcalib_obj_idx
(input_control) number →
HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the observed calibration plate.
Default:
0
CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdxcalib_obj_pose_idx
(input_control) number →
HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the observed calibration object pose.
Default:
0
Module
Calibration