Skip to content

get_calib_data_observ_contoursget_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContoursget_calib_data_observ_contoursT_get_calib_data_observ_contours🔗

Short description🔗

get_calib_data_observ_contoursget_calib_data_observ_contoursGetCalibDataObservContoursGetCalibDataObservContoursget_calib_data_observ_contoursT_get_calib_data_observ_contours — Get contour-based observation data from a calibration data model.

Signature🔗

get_calib_data_observ_contours( out xld_cont Contours, calib_data CalibDataID, string ContourName, number CameraIdx, number CalibObjIdx, number CalibObjPoseIdx )get_calib_data_observ_contours( : Contours : CalibDataID, ContourName, CameraIdx, CalibObjIdx, CalibObjPoseIdx : )void GetCalibDataObservContours( HObject* Contours, const HTuple& CalibDataID, const HTuple& ContourName, const HTuple& CameraIdx, const HTuple& CalibObjIdx, const HTuple& CalibObjPoseIdx )static void HOperatorSet.GetCalibDataObservContours( out HObject contours, HTuple calibDataID, HTuple contourName, HTuple cameraIdx, HTuple calibObjIdx, HTuple 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

Herror T_get_calib_data_observ_contours( 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)

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

Description🔗

The operator get_calib_data_observ_contoursGetCalibDataObservContours reads contour-based observation data from a calibration data model CalibDataIDcalibDataIDcalib_data_id and returns it in Contourscontourscontours. These contours result from a preceding call of find_calib_objectFindCalibObject. The parameters CameraIdxcameraIdxcamera_idx, CalibObjIdxcalibObjIdxcalib_obj_idx, and CalibObjPoseIdxcalibObjPoseIdxcalib_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 CalibDataIDcalibDataIDcalib_data_id by set_calib_data_observ_pointsSetCalibDataObservPoints, no contour-based results can be returned.

By setting ContourNamecontourNamecontour_name to one of the following values, you can select the specific type of the contour results:

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_caltabCreateCaltab.

  • Calibration plates with rectangularly arranged marks: The border of the calibration plate with a triangle in one corner.

Execution information🔗

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🔗

Contourscontourscontours (output_object) xld_cont(-array) → objectobjectHObjectHXLDContHObjectHobject *

Contour-based result(s).

CalibDataIDcalibDataIDcalib_data_id (input_control) calib_data → (handle)(handle)HTuple (HHandle)HCalibData, HTuple (IntPtr)HHandleHtuple (handle)

Handle of a calibration data model.

ContourNamecontourNamecontour_name (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Name of contour objects to be returned.

Default: 'marks'"marks"
List of values: 'caltab', 'last_caltab', 'marks', 'marks_with_hole'"caltab", "last_caltab", "marks", "marks_with_hole"

CameraIdxcameraIdxcamera_idx (input_control) number → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Index of the observing camera.

Default: 00

CalibObjIdxcalibObjIdxcalib_obj_idx (input_control) number → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Index of the observed calibration plate.

Default: 00

CalibObjPoseIdxcalibObjPoseIdxcalib_obj_pose_idx (input_control) number → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Index of the observed calibration object pose.

Default: 00

Module🔗

Calibration