Operator Reference

get_calib_data_observ_contoursT_get_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContoursget_calib_data_observ_contours (Operator)

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

get_calib_data_observ_contours( : Contours : CalibDataID, ContourName, CameraIdx, CalibObjIdx, CalibObjPoseIdx : )

Herror T_get_calib_data_observ_contours(Hobject* Contours, const Htuple CalibDataID, const Htuple ContourName, const Htuple CameraIdx, const Htuple CalibObjIdx, const Htuple CalibObjPoseIdx)

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)

static void HOperatorSet.GetCalibDataObservContours(out HObject contours, HTuple calibDataID, HTuple contourName, HTuple cameraIdx, HTuple calibObjIdx, HTuple calibObjPoseIdx)

HXLDCont HCalibData.GetCalibDataObservContours(string contourName, int cameraIdx, int calibObjIdx, int calibObjPoseIdx)

def get_calib_data_observ_contours(calib_data_id: HHandle, contour_name: str, camera_idx: int, calib_obj_idx: int, calib_obj_pose_idx: int) -> HObject

Description

The operator get_calib_data_observ_contoursget_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContoursget_calib_data_observ_contours reads contour-based observation data from a calibration data model CalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id and returns it in ContoursContoursContourscontourscontours. These contours result from a preceding call of find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectfind_calib_object. The parameters CameraIdxCameraIdxCameraIdxcameraIdxcamera_idx, CalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdxcalib_obj_idx, and CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdxcalib_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 CalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id by set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPointsset_calib_data_observ_points, no contour-based results can be returned.

By setting ContourNameContourNameContourNamecontourNamecontour_name 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.

'marks_with_hole'"marks_with_hole""marks_with_hole""marks_with_hole""marks_with_hole":

The calibration plate marks which contain a hole. In this case, the output returned in ContoursContoursContourscontourscontours are regions instead of contours.

'caltab'"caltab""caltab""caltab""caltab":

The contour of the calibration plate finder pattern.

'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_objectFindCalibObjectFindCalibObjectfind_calib_object. Note that the observation of the successful call to find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectfind_calib_object is used and consequently the values in CameraIdxCameraIdxCameraIdxcameraIdxcamera_idx, CalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdxcalib_obj_idx, and CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdxcalib_obj_pose_idx 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_caltabcreate_caltabCreateCaltabCreateCaltabcreate_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

ContoursContoursContourscontourscontours (output_object)  xld_cont(-array) objectHXLDContHObjectHObjectHobject *

Contour-based result(s).

CalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id (input_control)  calib_data HCalibData, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of a calibration data model.

ContourNameContourNameContourNamecontourNamecontour_name (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of contour objects to be returned.

Default: '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", 'marks_with_hole'"marks_with_hole""marks_with_hole""marks_with_hole""marks_with_hole"

CameraIdxCameraIdxCameraIdxcameraIdxcamera_idx (input_control)  number HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Index of the observing camera.

Default: 0

CalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdxcalib_obj_idx (input_control)  number HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Index of the observed calibration plate.

Default: 0

CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdxcalib_obj_pose_idx (input_control)  number HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Index of the observed calibration object pose.

Default: 0

Module

Calibration