Operator Reference
get_calib_data_observ_contours (Operator)
get_calib_data_observ_contours
— Get contour-based observation data from a calibration data model.
Signature
get_calib_data_observ_contours( : Contours : CalibDataID, ContourName, CameraIdx, CalibObjIdx, CalibObjPoseIdx : )
Description
The operator get_calib_data_observ_contours
reads contour-based
observation data from a calibration data model CalibDataID
and returns it in Contours
.
These contours result from a preceding call of find_calib_object
.
The parameters CameraIdx
, CalibObjIdx
, and
CalibObjPoseIdx
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 CalibDataID
by
set_calib_data_observ_points
, no contour-based results can be
returned.
By setting ContourName
to one of the following values, you can
select the specific type of the contour results:
- 'marks' :
The contours of the calibration plate marks.
- 'marks_with_hole' :
The calibration plate marks which contain a hole. In this case, the output returned in
Contours
are regions instead of contours.- 'caltab' :
The contour of the calibration plate finder pattern.
- 'last_caltab' :
The contour of the calibration plate finder pattern, which has been extracted by the last successful preceding call to
find_calib_object
. Note that the observation of the successful call tofind_calib_object
is used and consequently the values inCameraIdx
,CalibObjIdx
, andCalibObjPoseIdx
are ignored.
The mentioned finder pattern depends on the calibration plate:
-
Calibration plates with hexagonally arranged marks: Special mark hexagon (i.e., a mark and its six neighbors) where either four or six marks contain a hole, see
create_caltab
. -
Calibration plates with rectangularly arranged marks: The border of the calibration plate with a triangle in one corner.
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
Contours
(output_object) xld_cont(-array) →
object
Contour-based result(s).
CalibDataID
(input_control) calib_data →
(handle)
Handle of a calibration data model.
ContourName
(input_control) string →
(string)
Name of contour objects to be returned.
Default: 'marks'
List of values: 'caltab' , 'last_caltab' , 'marks' , 'marks_with_hole'
CameraIdx
(input_control) number →
(integer)
Index of the observing camera.
Default: 0
CalibObjIdx
(input_control) number →
(integer)
Index of the observed calibration plate.
Default: 0
CalibObjPoseIdx
(input_control) number →
(integer)
Index of the observed calibration object pose.
Default: 0
Module
Calibration