undistort

Image processingfunctionOpenCV 5.0.0

import { undistort } from '@banou/opencv-wasm'

Use after await initOpenCV(). See the initialization and named imports guide.

Explore visually: Lens undistortion →

Invert a calibrated lens model to map distorted observations onto an idealized camera image.

VISUAL WALKTHROUGH3D vision

REFERENCE INPUTLens-distorted grid

Straight scene lines appear curved under radial lens distortion.

→

RESULTRemap to a straight grid

Sampling through the inverse map straightens the grid. Border coverage depends on the chosen output camera.

Illustrative example. The stages explain the method; they are not a live OpenCV execution.

Transforms an image to compensate for lens distortion.

The function transforms an image to compensate radial and tangential lens distortion.

The function is simply a combination of #initUndistortRectifyMap (with unity R ) and #remap (with bilinear interpolation). See the former function for details of the transformation being performed.

Those pixels in the destination image, for which there is no correspondent pixels in the source image, are filled with zeros (black color).

A particular subset of the source image that will be visible in the corrected image can be regulated by newCameraMatrix. You can use #getOptimalNewCameraMatrix to compute the appropriate newCameraMatrix depending on your requirements.

The camera matrix and the distortion parameters can be determined using #calibrateCamera. If the resolution of images is different from the resolution used at the calibration stage, f_x, f_y, c_x and c_y need to be scaled accordingly, while the distortion coefficients remain the same.

undistort(src: Mat, dst: Mat, cameraMatrix: Mat, distCoeffs: Mat, newCameraMatrix: Mat): void;

2 available overloads

undistort(src: Mat, dst: Mat, cameraMatrix: Mat, distCoeffs: Mat): void;

undistort(src: Mat, dst: Mat, cameraMatrix: Mat, distCoeffs: Mat, newCameraMatrix: Mat): void;

src

Input (distorted) image.

dst

Output destination, filled by the native operation. Output (corrected) image that has the same size and type as src .

cameraMatrix

Input camera matrix A = \vecthreethree{f_x}{0}{c_x}{0}{f_y}{c_y}{0}{0}{1} .

distCoeffs

Input vector of distortion coefficients (k_1, k_2, p_1, p_2[, k_3[, k_4, k_5, k_6[, s_1, s_2, s_3, s_4[, \tau_x, \tau_y]]]]) of 4, 5, 8, 12 or 14 elements. If the vector is NULL/empty, the zero distortion coefficients are assumed.

newCameraMatrix

Camera matrix of the distorted image. By default, it is the same as cameraMatrix but you may additionally scale and shift the result by using a different matrix.

Upstream declaration ↗

These signatures describe this package. Upstream documentation can mention optional backends that are absent from this build. Check runtime compatibility before choosing a backend or file format.