cam_mat_to_cam_par (Operator)

Name

cam_mat_to_cam_par — Compute the interior camera parameters from a camera matrix.

Synopsis

cam_mat_to_cam_par( : : CameraMatrix, Kappa, ImageWidth, ImageHeight : CamParam)

Description

cam_mat_to_cam_par computes interior camera parameters from the camera matrix CameraMatrix, the radial distortion coefficient Kappa, the image width ImageWidth, and the image height ImageHeight. The camera parameters are returned in CamParam. The parameters CameraMatrix and Kappa can be determined with stationary_camera_self_calibration. cam_mat_to_cam_par converts this representation of the internal camera parameters into the representation used by camera_calibration. The conversion can only be performed if the skew of the image axes is set to 0 in stationary_camera_self_calibration, i.e., if the parameter 'skew' is not being determined.

Parameters

CameraMatrix (input_control)	hom_mat2d-array → (real)
3x3 projective camera matrix that determines the interior camera parameters.

Kappa (input_control)	number → (real)
Kappa.

ImageWidth (input_control)	integer → (integer)
Width of the images that correspond to CameraMatrix.
Restriction: ImageWidth > 0

ImageHeight (input_control)	integer → (integer)
Height of the images that correspond to CameraMatrix.
Restriction: ImageHeight > 0

CamParam (output_control)	number-array → (real / integer)
Interior camera parameters.
Number of elements: CamParam == 8

Example

* For the input data to stationary_camera_self_calibration, please
* refer to the example for stationary_camera_self_calibration.
stationary_camera_self_calibration (4, 640, 480, 1, From, To, \
                                    HomMatrices2D, Rows1, Cols1, \
                                    Rows2, Cols2, NumMatches, \
                                    'gold_standard', \
                                    ['focus','principal_point','kappa'], \
                                    'true', CameraMatrix, Kappa, \
                                    RotationMatrices, X, Y, Z, Error)
cam_mat_to_cam_par (CameraMatrix, Kappa, 640, 480, CamParam)

Result

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

Parallelization Information

cam_mat_to_cam_par is reentrant and processed without parallelization.

Possible Predecessors

stationary_camera_self_calibration

See also

camera_calibration, cam_par_to_cam_mat

Module

Calibration