Operator Reference

HALCON Operator Reference / Calibration / Camera Parameters
ClassesClasses | | Operators

cam_par_to_cam_matT_cam_par_to_cam_matCamParToCamMatCamParToCamMatcam_par_to_cam_mat (Operator)

cam_par_to_cam_matT_cam_par_to_cam_matCamParToCamMatCamParToCamMatcam_par_to_cam_mat — Compute a camera matrix from internal camera parameters.

Signature

cam_par_to_cam_mat( : : CameraParam : CameraMatrix, ImageWidth, ImageHeight)

Herror T_cam_par_to_cam_mat(const Htuple CameraParam, Htuple* CameraMatrix, Htuple* ImageWidth, Htuple* ImageHeight)

void CamParToCamMat(const HTuple& CameraParam, HTuple* CameraMatrix, HTuple* ImageWidth, HTuple* ImageHeight)

HHomMat2D HCamPar::CamParToCamMat(Hlong* ImageWidth, Hlong* ImageHeight) const

void HHomMat2D::CamParToCamMat(const HCamPar& CameraParam, Hlong* ImageWidth, Hlong* ImageHeight)

static void HOperatorSet.CamParToCamMat(HTuple cameraParam, out HTuple cameraMatrix, out HTuple imageWidth, out HTuple imageHeight)

HHomMat2D HCamPar.CamParToCamMat(out int imageWidth, out int imageHeight)

void HHomMat2D.CamParToCamMat(HCamPar cameraParam, out int imageWidth, out int imageHeight)

def cam_par_to_cam_mat(camera_param: Sequence[Union[int, float, str]]) -> Tuple[Sequence[float], int, int]

Description

cam_par_to_cam_matcam_par_to_cam_matCamParToCamMatCamParToCamMatcam_par_to_cam_mat computes the camera matrix CameraMatrixCameraMatrixCameraMatrixcameraMatrixcamera_matrix as well as the image width ImageWidthImageWidthImageWidthimageWidthimage_width, and the image height ImageHeightImageHeightImageHeightimageHeightimage_height from the internal camera parameters CameraParamCameraParamCameraParamcameraParamcamera_param. The internal camera parameters CameraParamCameraParamCameraParamcameraParamcamera_param can be determined with camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationcamera_calibration. cam_par_to_cam_matcam_par_to_cam_matCamParToCamMatCamParToCamMatcam_par_to_cam_mat converts this representation of the internal camera parameters into the representation used by stationary_camera_self_calibrationstationary_camera_self_calibrationStationaryCameraSelfCalibrationStationaryCameraSelfCalibrationstationary_camera_self_calibration. The conversion can only be performed if the camera is an area scan pinhole camera and the distortion coefficients in CameraParamCameraParamCameraParamcameraParamcamera_param are 0. If necessary, change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParchange_radial_distortion_cam_par must be used to set the distortion coefficients to 0.

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

CameraParamCameraParamCameraParamcameraParamcamera_param (input_control)  campar → HCamPar, HTupleSequence[Union[int, float, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Internal camera parameters.

CameraMatrixCameraMatrixCameraMatrixcameraMatrixcamera_matrix (output_control)  hom_mat2d → HHomMat2D, HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

3x3 projective camera matrix that corresponds to CameraParamCameraParamCameraParamcameraParamcamera_param.

ImageWidthImageWidthImageWidthimageWidthimage_width (output_control)  extent.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of the images that correspond to CameraMatrixCameraMatrixCameraMatrixcameraMatrixcamera_matrix.

Assertion: ImageWidth > 0

ImageHeightImageHeightImageHeightimageHeightimage_height (output_control)  extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of the images that correspond to CameraMatrixCameraMatrixCameraMatrixcameraMatrixcamera_matrix.

Assertion: ImageHeight > 0

Example (HDevelop)

* For the input data to calibrate_cameras, please refer to the
* example for calibrate_cameras.
calibrate_cameras (CalibDataID, Error)
get_calib_data (CalibDataID, 'camera', 0, 'params', CameraParam)
cam_par_to_cam_mat (CameraParam, CameraMatrix, ImageWidth, ImageHeight)

* Alternatively, the following calls can be used.
change_radial_distortion_cam_par ('adaptive', CameraParam, 0, CamParamOut)
cam_par_to_cam_mat (CamParamOut, CameraMatrix, ImageWidth, ImageHeight)

Result

If the parameters are valid, the operator cam_par_to_cam_matcam_par_to_cam_matCamParToCamMatCamParToCamMatcam_par_to_cam_mat returns the value 2 ( H_MSG_TRUE) . If necessary an exception is raised.

Possible Predecessors

camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationcamera_calibration

See also

stationary_camera_self_calibrationstationary_camera_self_calibrationStationaryCameraSelfCalibrationStationaryCameraSelfCalibrationstationary_camera_self_calibration, cam_mat_to_cam_parcam_mat_to_cam_parCamMatToCamParCamMatToCamParcam_mat_to_cam_par

Module

Calibration

ClassesClasses | | Operators