set_camera_setup_cam_paramSetCameraSetupCamParamSetCameraSetupCamParamset_camera_setup_cam_paramT_set_camera_setup_cam_param🔗

Short description🔗

set_camera_setup_cam_paramSetCameraSetupCamParamSetCameraSetupCamParamset_camera_setup_cam_paramT_set_camera_setup_cam_param — Define type, parameters, and relative pose of a camera in a camera setup model.

Signature🔗

set_camera_setup_cam_param( camera_setup_model CameraSetupModelID, number CameraIdx, string CameraType, campar CameraParam, number CameraPose )

Description🔗

The operator set_camera_setup_cam_paramSetCameraSetupCamParam defines the internal parameters and the pose of the camera with CameraIdxcameraIdxcamera_idx in the camera setup model CameraSetupModelIDcameraSetupModelIDcamera_setup_model_id. The parameter CameraIdxcameraIdxcamera_idx must be between 0 and NumCamerasnumCamerasnum_cameras-1 (see get_camera_setup_paramGetCameraSetupParam with argument 'num_cameras'"num_cameras"). If a camera with CameraIdxcameraIdxcamera_idx was already defined, its parameters are overwritten by the current ones (the camera is ‘substituted’).

The number of values in CameraParamcameraParamcamera_param depends on the camera type. See the description of set_calib_data_cam_paramSetCalibDataCamParam for a list of values and Calibration for details on camera types and camera parameters.

The parameter CameraTypecameraTypecamera_type is only provided for backwards compatibility. The information about the camera type is contained in the first element of CameraParamcameraParamcamera_param. Therefore, CameraTypecameraTypecamera_type should be set either to its default value [][] (the recommended option) or to the same value as the first element of CameraParamcameraParamcamera_param. In any other case an error is raised.

The parameter CameraPosecameraPosecamera_pose specifies the pose of the camera relative to the setup’s coordinate system (see set_camera_setup_paramSetCameraSetupParam for further explanations on the setup’s coordinate system).

All of the parameters set by set_camera_setup_cam_paramSetCameraSetupCamParam can be read back by get_camera_setup_paramGetCameraSetupParam. While the camera type can be changed only with a new call to set_camera_setup_cam_paramSetCameraSetupCamParam, all other camera parameters can be modified by set_camera_setup_paramSetCameraSetupParam. Furthermore, set_camera_setup_paramSetCameraSetupParam can set additional data to a camera: standard deviations or covariances of the internal camera parameters.

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) number-array → (integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Index of the camera in the setup.

Suggested values: 0, 1, 20, 1, 2

CameraTypecameraTypecamera_type (input_control) string(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Type of the camera.

Default: [][]
List of values: [][]

CameraParamcameraParamcamera_param (input_control) campar → (real / integer / string)HTuple (double / Hlong / HString)Sequence[Union[float, int, str]]Htuple (double / Hlong / char*)

Internal camera parameters.

CameraPosecameraPosecamera_pose (input_control) number-array → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Pose of the camera relative to the setup’s coordinate system.

Number of elements: 7

Module🔗

Calibration