ClassesClasses | | Operators

set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObject (Operator)

Name

set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObject — Define a calibration object in a calibration model.

Signature

set_calib_data_calib_object( : : CalibDataID, CalibObjIdx, CalibObjDescr : )

Herror set_calib_data_calib_object(const Hlong CalibDataID, const Hlong CalibObjIdx, double CalibObjDescr)

Herror T_set_calib_data_calib_object(const Htuple CalibDataID, const Htuple CalibObjIdx, const Htuple CalibObjDescr)

void SetCalibDataCalibObject(const HTuple& CalibDataID, const HTuple& CalibObjIdx, const HTuple& CalibObjDescr)

void HCalibData::SetCalibDataCalibObject(Hlong CalibObjIdx, const HTuple& CalibObjDescr) const

void HCalibData::SetCalibDataCalibObject(Hlong CalibObjIdx, double CalibObjDescr) const

static void HOperatorSet.SetCalibDataCalibObject(HTuple calibDataID, HTuple calibObjIdx, HTuple calibObjDescr)

void HCalibData.SetCalibDataCalibObject(int calibObjIdx, HTuple calibObjDescr)

void HCalibData.SetCalibDataCalibObject(int calibObjIdx, double calibObjDescr)

Description

The operator set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObjectSetCalibDataCalibObject defines the calibration object with the index CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx in the camera calibration data model CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID. The index must be between 0 and NumCalibObjects-1 (NumCalibObjects is specified during model creation with create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibData and can be queried with get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibData).

If a calibration object description with index CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx is already defined, then the current object description overwrites it (the description is 'substituted'). Note that all NumCalibObjects calibration objects must be set to perform calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCameras.

The parameter CalibObjDescrCalibObjDescrCalibObjDescrCalibObjDescrcalibObjDescr can be used in two ways:

as a file name:

it specifies a calibration plate description file as created with create_caltabcreate_caltabCreateCaltabCreateCaltabCreateCaltab or gen_caltabgen_caltabGenCaltabGenCaltabGenCaltab.

as a numerical tuple:

it specifies the 3D coordinates of all points of the calibration object. All X, Y, and Z coordinates, respectively, of all points must be packed sequentially in the tuple in form: [X, Y, Z], i.e., [X1, ..., Xn, Y1, ..., Yn, Z1, ..., Zn], where |X| = |Y| = |Z| and all coordinates are in meters.

To query the calibration objects parameters stored earlier in a calibration data model, use get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibData.

Execution Information

This operator modifies the state of the following input parameter:

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID (input_control, state is modified)  calib_data HCalibData, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Handle of a calibration data model.

CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx (input_control)  number HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Calibration object index.

Default value: 0

Suggested values: 0, 1, 2

CalibObjDescrCalibObjDescrCalibObjDescrCalibObjDescrcalibObjDescr (input_control)  number(-array) HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

3D point coordinates or a description file name.

List of values: 'calplate.cpd'"calplate.cpd""calplate.cpd""calplate.cpd""calplate.cpd", 'calplate_20mm.cpd'"calplate_20mm.cpd""calplate_20mm.cpd""calplate_20mm.cpd""calplate_20mm.cpd", 'calplate_40mm.cpd'"calplate_40mm.cpd""calplate_40mm.cpd""calplate_40mm.cpd""calplate_40mm.cpd", 'calplate_80mm.cpd'"calplate_80mm.cpd""calplate_80mm.cpd""calplate_80mm.cpd""calplate_80mm.cpd", 'caltab.descr'"caltab.descr""caltab.descr""caltab.descr""caltab.descr", 'caltab_160mm.cpd'"caltab_160mm.cpd""caltab_160mm.cpd""caltab_160mm.cpd""caltab_160mm.cpd"

Possible Predecessors

create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibData, set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParam

Possible Successors

set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParam, set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPointsSetCalibDataObservPoints, find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObject

Module

Calibration


ClassesClasses | | Operators