get_calib_data_observ_contoursT_get_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContours (Operator)
Name
get_calib_data_observ_contoursT_get_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContours
— 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_contoursGetCalibDataObservContoursGetCalibDataObservContoursGetCalibDataObservContours
reads contour-based
observation data from a calibration data model CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID
. The
observation data was obtained by a preceding call to
find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObject
. The parameters CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx
,
CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx
, and CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdx
should specify a valid
observation from the calibration model. Note that if an observation
exists, but it was stored by set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPointsSetCalibDataObservPoints
, no
contour-based results can be returned.
By setting ContourNameContourNameContourNameContourNamecontourName
to one of the following values, you can
select the specific type of the contour results:
- 'marks'"marks""marks""marks""marks":
The contours of the calibration plate marks
- 'caltab'"caltab""caltab""caltab""caltab":
The contour of the calibration plate.
- 'last_caltab'"last_caltab""last_caltab""last_caltab""last_caltab":
The calibration plate contour extracted by the last preceding call to
find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObject
. The 'last_caltab'"last_caltab""last_caltab""last_caltab""last_caltab" result is
stored even if find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObject
fails and thus it can be
inspected, whether erroneous calibration plate region was the reason for
the failure. Unlike it, the 'caltab'"caltab""caltab""caltab""caltab" result is not available
before find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObject
succeeds and therefore it cannot be
used for this purpose. Note that the values in CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx
,
CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx
, and CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdx
are ignored for this
result.
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
ContoursContoursContoursContourscontours
(output_object) xld_cont(-array) →
objectHXLDContHXLDContHobject *
Contour-based result(s).
CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID
(input_control) calib_data →
HCalibData, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of a calibration data model.
ContourNameContourNameContourNameContourNamecontourName
(input_control) string →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Name of contour objects to be returned.
Default value:
'marks'
"marks"
"marks"
"marks"
"marks"
List of values: 'caltab'"caltab""caltab""caltab""caltab", 'last_caltab'"last_caltab""last_caltab""last_caltab""last_caltab", 'marks'"marks""marks""marks""marks"
CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx
(input_control) number →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the observing camera.
Default value: 0
CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx
(input_control) number →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the observed calibration object.
Default value: 0
CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdx
(input_control) number →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the observed calibration object pose.
Default value: 0
Module
Calibration