| Operators |
set_calib_data_cam_param — Set type and initial parameters of a camera in a calibration data model.
set_calib_data_cam_param( : : CalibDataID, CameraIdx, CameraType, CameraParam : )
The operator set_calib_data_cam_param sets the camera type CameraType and the initial camera parameters CameraParam for the camera with the index CameraIdx in the calibration data model CalibDataID. The parameter CameraIdx must be between 0 and NumCameras-1 (NumCameras is specified during model creation with create_calib_data and can be queried with get_calib_data). If a camera with CameraIdx was already defined, its parameters are overwritten by the current ones (the camera is 'substituted'). In this case, the selection which camera parameters are marked for optimization is reset and maybe has to be set again. Note that all NumCameras cameras must be set to perform calibrate_cameras. The calibration procedure refines these initial parameters.
The number of values of CameraParam depends on the value of CameraType.
| CameraType | CameraParam | # |
|---|---|---|
| 'area_scan_division' | [Focus, Kappa, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight] | 8 |
| 'area_scan_telecentric_division' | [0, Kappa, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight] | 8 |
| 'area_scan_tilt_division' | [Focus, Kappa, Tilt, Rot, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight] | 10 |
| 'area_scan_telecentric_tilt_division' | [0, Kappa, Tilt, Rot, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight] | 10 |
| 'area_scan_polynomial' | [Focus, K1, K2, K3, P1, P2, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight] | 12 |
| 'area_scan_telecentric_polynomial' | [0, K1, K2, K3, P1, P2, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight] | 12 |
| 'area_scan_tilt_polynomial' | [Focus, K1, K2, K3, P1, P2, Tilt, Rot, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight] | 14 |
| 'area_scan_telecentric_tilt_polynomial' | [0, K1, K2, K3, P1, P2, Tilt, Rot, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight] | 14 |
| 'line_scan' | [Focus, Kappa, Sx, Sy, Cx, Cy, ImageWidth, ImageHeight, Vx, Vy, Vz] | 11 |
For a detailed description of the camera types, camera parameters and suggested initial values, see calibrate_cameras.
If the standard HALCON calibration plate is used, the units of the individual parameters are as specified in read_cam_par.
The camera type can be queried later by calling get_calib_data with the arguments ItemType='camera' and DataName='type'. The initial camera parameters can be queried by calling get_calib_data with arguments ItemType='camera' and DataName='init_params'.
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.Handle of a calibration data model.
Camera index.
Default value: 0
Suggested values: 'all', 0, 1, 2
Type of the camera.
Default value: 'area_scan_division'
List of values: 'area_scan_division', 'area_scan_polynomial', 'area_scan_telecentric_division', 'area_scan_telecentric_polynomial', 'area_scan_telecentric_tilt_division', 'area_scan_telecentric_tilt_polynomial', 'area_scan_tilt_division', 'area_scan_tilt_polynomial', 'line_scan'
Initial camera internal parameters.
Number of elements: CameraParam == 8 || CameraParam == 10 || CameraParam == 11 || CameraParam == 12 || CameraParam == 14
create_calib_data, set_calib_data_calib_object
set_calib_data_calib_object, set_calib_data_observ_points, find_calib_object
Calibration
| Operators |