Back to Adaptive Vision Studio website

# cvUndistortPoints

Undistorts points.

Name Type Description
inPoints Point2DArray Input points array.
inCameraMatrix Matrix Input camera matrix.
inDistCoeffs Matrix Input array of distortion coefficients.
inR Matrix* The rectification transformation in object space, use identity if not specified.
inP Matrix* The new camera matrix or the new projection matrix, use inCameraMatrix if not specified.
outPoints Point2DArray Output array of undistorted points.

### Description

The operation computes ideal point coordinates from observed point coordinates. It is similar to cvUndistort and cvInitUndistortRectifyMap but it operates on a set of points instead of raster image.

The inP Matrix can be either a camera matrix $$A$$ (3x3), or the projection matrix $$A * [R|t]$$. Leaving it with a default value means using the original camera matrix - the resulting points will correspond to the same camera setup (projection matrix), but without lens distortions.

### Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Input camera matrix must be 3x3 in cvUndistortPoints.
DomainError Supported matrix sizes for inDistCoeffs are: 1x4, 4x1, 1x5, 5x1, 1x8, 8x1, 1x12, 12x1 in cvUndistortPoints.

### Complexity Level

This filter is available on Basic Complexity Level.