set_camera_setup_paramset_camera_setup_paramSetCameraSetupParamSetCameraSetupParam (Operator)

Name

set_camera_setup_paramset_camera_setup_paramSetCameraSetupParamSetCameraSetupParam — Set generic camera setup model parameters.

Signature

set_camera_setup_param( : : CameraSetupModelID, CameraIdx, GenParamName, GenParamValue : )

The operator set_camera_setup_paramset_camera_setup_paramSetCameraSetupParamSetCameraSetupParamSetCameraSetupParam can be used to set diverse generic parameters or transformations for the camera setup model CameraSetupModelIDCameraSetupModelIDCameraSetupModelIDCameraSetupModelIDcameraSetupModelID. Two types of parameters can be set with this operator:

Coordinate system of the setup and transformation of camera poses:

By setting CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx to 'general'"general""general""general""general" and GenParamNameGenParamNameGenParamNameGenParamNamegenParamName to one of the following values, you can perform the following general pose transformation for all cameras:

'reference_camera'"reference_camera""reference_camera""reference_camera""reference_camera":: When setting GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue to a valid camera index, all camera poses are recomputed relative to the coordinate system of this camera.
'coord_transf_pose'"coord_transf_pose""coord_transf_pose""coord_transf_pose""coord_transf_pose":: When passing a tuple in HALCON pose format in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue, the current coordinate system is moved into this pose. The pose in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue represents the location and orientation of the desired coordinate system relative to the current one. All camera poses are recomputed relative to the new coordinate system.

The recomputed camera poses can be inspected with the operator get_camera_setup_paramget_camera_setup_paramGetCameraSetupParamGetCameraSetupParamGetCameraSetupParam.

Camera parameters:

By setting CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx to a valid setup camera index (a value between 0 and NumCameras-1) and GenParamNameGenParamNameGenParamNameGenParamNamegenParamName to one of the following values, camera specific parameters can be set with GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue:

'params'"params""params""params""params":: A tuple with internal camera parameters.
'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations":: A tuple with the standard deviations of the internal camera parameters. The length of the tuple must be equal to the length of the internal parameters, which is camera-type dependent. See set_camera_setup_cam_paramset_camera_setup_cam_paramSetCameraSetupCamParamSetCameraSetupCamParamSetCameraSetupCamParam for further details.
'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances":: A tuple with the covariance matrix of the internal camera parameters. The length of the tuple must be the square of the tuple length of the internal camera parameters, which depend on the camera type. See set_camera_setup_cam_paramset_camera_setup_cam_paramSetCameraSetupCamParamSetCameraSetupCamParamSetCameraSetupCamParam for further details.
'pose'"pose""pose""pose""pose":: A tuple representing the pose of the camera in HALCON pose format, relative to camera setup's coordinate system. See the above section for further details.

Note that the camera must already be defined in the model, before any of its parameters can be changed by set_camera_setup_paramset_camera_setup_paramSetCameraSetupParamSetCameraSetupParamSetCameraSetupParam. If CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx is an index of a undefined camera, the operator returns an error.

All parameters can be read back by get_camera_setup_paramget_camera_setup_paramGetCameraSetupParamGetCameraSetupParamGetCameraSetupParam.

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

CameraSetupModelIDCameraSetupModelIDCameraSetupModelIDCameraSetupModelIDcameraSetupModelID (input_control) camera_setup_model → (integer)

Handle to the camera setup model.

CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx (input_control) integer(-array) → (integer / string)

Unique index of the camera in the setup.

Default value: 0

Suggested values: 0, 1, 2, 'general'"general""general""general""general"

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) attribute.name → (string)

Names of the generic parameters to be set.

List of values: 'coord_transf_pose'"coord_transf_pose""coord_transf_pose""coord_transf_pose""coord_transf_pose", 'params'"params""params""params""params", 'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances", 'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations", 'pose'"pose""pose""pose""pose", 'reference_camera'"reference_camera""reference_camera""reference_camera""reference_camera"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) attribute.value(-array) → (real / integer / string)

Values of the generic parameters to be set.

Possible Predecessors

create_camera_setup_modelcreate_camera_setup_modelCreateCameraSetupModelCreateCameraSetupModelCreateCameraSetupModel, read_camera_setup_modelread_camera_setup_modelReadCameraSetupModelReadCameraSetupModelReadCameraSetupModel

Module

Calibration

Operators