Skip to content

set_camera_setup_paramSetCameraSetupParamSetCameraSetupParamset_camera_setup_paramT_set_camera_setup_param🔗

Short description🔗

set_camera_setup_paramSetCameraSetupParamSetCameraSetupParamset_camera_setup_paramT_set_camera_setup_param — Set generic camera setup model parameters.

Signature🔗

set_camera_setup_param( camera_setup_model CameraSetupModelID, integer CameraIdx, attribute.name GenParamName, attribute.value GenParamValue )void SetCameraSetupParam( const HTuple& CameraSetupModelID, const HTuple& CameraIdx, const HTuple& GenParamName, const HTuple& GenParamValue )static void HOperatorSet.SetCameraSetupParam( HTuple cameraSetupModelID, HTuple cameraIdx, HTuple genParamName, HTuple genParamValue )def set_camera_setup_param( camera_setup_model_id: HHandle, camera_idx: MaybeSequence[Union[int, str]], gen_param_name: str, gen_param_value: MaybeSequence[Union[float, int, str]] ) -> None

Herror T_set_camera_setup_param( const Htuple CameraSetupModelID, const Htuple CameraIdx, const Htuple GenParamName, const Htuple GenParamValue )

void HCameraSetupModel::SetCameraSetupParam( const HTuple& CameraIdx, const HString& GenParamName, const HTuple& GenParamValue ) const

void HCameraSetupModel::SetCameraSetupParam( Hlong CameraIdx, const HString& GenParamName, double GenParamValue ) const

void HCameraSetupModel::SetCameraSetupParam( Hlong CameraIdx, const char* GenParamName, double GenParamValue ) const

void HCameraSetupModel::SetCameraSetupParam( Hlong CameraIdx, const wchar_t* GenParamName, double GenParamValue ) const (Windows only)

void HCameraSetupModel.SetCameraSetupParam( HTuple cameraIdx, string genParamName, HTuple genParamValue )

void HCameraSetupModel.SetCameraSetupParam( int cameraIdx, string genParamName, double genParamValue )

Description🔗

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

Coordinate system of the setup and transformation of camera poses:

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

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

Camera parameters:

By setting CameraIdxcameraIdxcamera_idx to a valid setup camera index (a value between 0 and NumCamerasnumCamerasnum_cameras-1) and GenParamNamegenParamNamegen_param_name to one of the following values, camera specific parameters can be set with GenParamValuegenParamValuegen_param_value:

  • 'params'"params": A tuple with internal camera parameters.

  • 'params_deviations'"params_deviations": A tuple with the standard deviations of the internal camera parameters except for CameraType, Width, and Height, thus |params_deviations|=|params|-3. The internal camera parameters are camera-type dependent. See the description of set_calib_data_cam_paramSetCalibDataCamParam for a list of values and calibrate_camerasCalibrateCameras for details on camera types and camera parameters.

  • 'params_covariances'"params_covariances": A tuple with the covariance matrix of the internal camera parameters. The tuple must represent a square matrix whose both dimensions are identical to the number of standard deviation values, thus texttt{|params_covariances|=|params_deviations|²=(|params|-3)²}, see 'params_deviations'"params_deviations".

  • '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_paramSetCameraSetupParam. If CameraIdxcameraIdxcamera_idx is an index of a undefined camera, the operator returns an error.

All parameters can be read back by get_camera_setup_paramGetCameraSetupParam.

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🔗

CameraSetupModelIDcameraSetupModelIDcamera_setup_model_id (input_control) camera_setup_model → (handle)HTuple (HHandle)HCameraSetupModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle to the camera setup model.

CameraIdxcameraIdxcamera_idx (input_control) integer(-array) → (integer / string)HTuple (Hlong / HString)HTuple (int / long / string)MaybeSequence[Union[int, str]]Htuple (Hlong / char*)

Unique index of the camera in the setup.

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

GenParamNamegenParamNamegen_param_name (input_control) attribute.name → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Names of the generic parameters to be set.

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

GenParamValuegenParamValuegen_param_value (input_control) attribute.value(-array) → (real / integer / string)HTuple (double / Hlong / HString)HTuple (double / int / long / string)MaybeSequence[Union[float, int, str]]Htuple (double / Hlong / char*)

Values of the generic parameters to be set.

Combinations with other operators🔗

Combinations

Possible predecessors

create_camera_setup_modelCreateCameraSetupModel, read_camera_setup_modelReadCameraSetupModel

Module🔗

Calibration