cameraIntrinsics

Object for storing intrinsic camera parameters

expand all in page

Description

Store information about a camera’s intrinsic calibration parameters, including the lens distortion parameters.

Creation

Syntax

intrinsics = cameraIntrinsics(focalLength,principalPoint,imageSize)

intrinsics = cameraIntrinsics(focalLength,principalPoint,imageSize,Name,Value)

Description

intrinsics = cameraIntrinsics(focalLength,principalPoint,imageSize) returns a camera intrinsics object that contains the focal length and the camera's principal point. The three input arguments set the FocalLength, PrincipalPoint, and ImageSize properties, respectively.

example

intrinsics = cameraIntrinsics(focalLength,principalPoint,imageSize,Name,Value) sets additional properties using one or name-value pairs. Enclose each property name in quotes.

For example, intrinsics = cameraIntrinsics(focalLength,principalPoint,imageSize,"RadialDistortion",[0 10]) sets the radial lens distortion property, RadialDistortion, as the vector [0 10].

Properties

expand all

`FocalLength` — Focal length
2-element vector

Focal length in x and y, stored as a 2-element vector [f_x f_y] in pixels.

f_x = F * s_x

f_y = F * s_y

F is the focal length in world units, typically in millimeters. s_x and s_y are the number of pixels per world unit in the x and y direction respectively. Thus, f_x and f_y are in pixels.

The focal length F influences the angle of view and thus affects the area of the scene that appears focused in an image. For a fixed subject distance:

A short focal length offers a wide angle of view allowing to capture large area of the scene under focus. It emphasizes both the subject and the scene background.
A long focal length offers a narrow angle of view, thus reducing the area of the scene under focus. It emphasizes more on the subject and restricts the amount of background from being captured.

You cannot set the value of FocalLength after you create the cameraIntrinsics object.

`PrincipalPoint` — Optical center of camera
two-element vector

Optical center of camera, stored as a two-element vector [cx cy] in pixels. The vector contains the coordinates of the optical center of the camera.

You cannot set the value of PrincipalPoint after you create the cameraIntrinsics object.

`ImageSize` — Image size produced by the camera
two-element vector

Image size produced by the camera, stored as a two-element vector, [mrows ncols].

You cannot set the value of ImageSize after you create the cameraIntrinsics object.

`RadialDistortion` — Radial lens distortion coefficients
`[0 0]` (default) | 2-element vector | 3-element vector | 6-element vector

Radial lens distortion coefficients, specified as a 2-, 3-, or 6-element vector.

2-element vector — [k1 k2].
3-element vector — [k1 k2 k3].
6-element vector — [k1 k2 k3 k4 k5 k6].

Radial distortion is the displacement of image points along radial lines extending from the principal point.

As image points move away from the principal point (positive radial displacement), image magnification decreases and a pincushion-shaped distortion occurs on the image.
As image points move toward the principal point (negative radial displacement), image magnification increases and a barrel-shaped distortion occurs on the image.

Three grids: one with pincushion distortion (positive radial displacement), one with no distortion, and one with barrel distortion (negative radial displacement)

The camera parameters object calculates the radial-distorted location of a point, denoted as (x_distorted, y_distorted):

$x_{d i s t o r t e d} = x (\frac{1 + k_{1} * r^{2} + k_{2} * r^{4} + k_{3} * r^{6}}{1 + k_{4} * r^{2} + k_{5} * r^{4} + k_{6} * r^{6}})$

$y_{d i s t o r t e d} = y (\frac{1 + k_{1} * r^{2} + k_{2} * r^{4} + k_{3} * r^{6}}{1 + k_{4} * r^{2} + k_{5} * r^{4} + k_{6} * r^{6}})$

x, y is a undistorted image point in normalized image coordinates in world units, with the origin at the optical center.

r² = x² + y²

k₁, k₂, …, k₆ are radial distortion coefficients of the lens. Typically, two coefficients are sufficient and k₃, …, k₆ are only needed for wide-angle lenses.

`TangentialDistortion` — Tangential distortion coefficients
`[0 0]` (default) | two-element vector

Tangential distortion coefficients, specified as a 2-element vector, [p₁ p₂]. Tangential distortion occurs when the lens and the image plane are not parallel.

Comparison of zero tangential distortion and tangential distortion

The camera parameters object calculates the tangential distorted location of a point. You can denote the distorted points as (x_distorted, y_distorted), as follows:

x_distorted = x + [2 * p₁ * x * y + p₂ * (r² + 2 * x²)]

y_distorted = y + [p₁ * (r² + 2*y²) + 2 * p₂ * x * y]

x, y are undistorted pixel locations

p₁ and p₂ are tangential distortion coefficients of the lens

r² = x² + y²

The undistorted pixel locations appear in normalized image coordinates, with the origin at the optical center. The coordinates are expressed in world units.

`Skew` — Camera axes skew
`0` (default) | numeric scalar

Camera axes skew, specified as a numeric scalar. If the x and the y axes are exactly perpendicular, then the skew must be 0.

`K` — Camera intrinsic matrix
3-by-3 identity matrix (default) | 3-by-3 matrix

This property is read-only.

Camera intrinsic matrix, specified as a 3-by-3 matrix. The matrix has the format

$[\begin{matrix} f_{x} & s & c_{x} \\ 0 & f_{y} & c_{y} \\ 0 & 0 & 1 \end{matrix}]$

The coordinates [c_x c_y] represent the optical center (the principal point), in pixels. When the x and y axis are exactly perpendicular, the skew parameter, s, equals 0.

f_x = F*s_x

f_y = F*s_y

F is the focal length in world units, typically expressed in millimeters.

s_x and s_y are the number of pixels per world unit in the x and y direction respectively.

f_x and f_y are expressed in pixels.

Examples

collapse all

Create an Object Containing Fundamental Camera Parameters

Open Live Script

Define camera parameters without lens distortion or skew.

Specify the focal length and principal point in pixels.

focalLength    = [800 800]; 
principalPoint = [320 240];
imageSize      = [480 640];

Create a camera intrinsics object.

intrinsics = cameraIntrinsics(focalLength,principalPoint,imageSize)

intrinsics = 
  cameraIntrinsics with properties:

             FocalLength: [800 800]
          PrincipalPoint: [320 240]
               ImageSize: [480 640]
        RadialDistortion: [0 0]
    TangentialDistortion: [0 0]
                    Skew: 0
                       K: [3x3 double]

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2017a

expand all

R2024b: Import OpenCV pinhole camera model with six radial distortion coefficients

The cameraIntrinsics has been updated to support OpenCV pinhole camera model with 6 radial distortion coefficients.

R2022b: Supports premultiply matrix convention

Starting in R2022b, many Computer Vision Toolbox™ functions create and perform geometric transformations using the premultiply convention. Accordingly, a property of the cameraIntrinsics object has changed to support the premultiply convention.

The new K property replaces the old IntrinsicMatrix property. The value of K is the transpose of IntrinsicMatrix.

For more information, see Migrate Geometric Transformations to Premultiply Convention.

cameraIntrinsics

Description

Creation

Syntax

Description

Properties

`FocalLength` — Focal length
2-element vector

`PrincipalPoint` — Optical center of camera
two-element vector

`ImageSize` — Image size produced by the camera
two-element vector

`RadialDistortion` — Radial lens distortion coefficients
`[0 0]` (default) | 2-element vector | 3-element vector | 6-element vector

`TangentialDistortion` — Tangential distortion coefficients
`[0 0]` (default) | two-element vector

`Skew` — Camera axes skew
`0` (default) | numeric scalar

`K` — Camera intrinsic matrix
3-by-3 identity matrix (default) | 3-by-3 matrix

Examples

Create an Object Containing Fundamental Camera Parameters

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

R2024b: Import OpenCV pinhole camera model with six radial distortion coefficients

R2022b: Supports premultiply matrix convention

See Also

Apps

Objects

Functions

Topics

cameraIntrinsics

Description

Creation

Syntax

Description

Properties

FocalLength — Focal length 2-element vector

PrincipalPoint — Optical center of camera two-element vector

ImageSize — Image size produced by the camera two-element vector

RadialDistortion — Radial lens distortion coefficients [0 0] (default) | 2-element vector | 3-element vector | 6-element vector

TangentialDistortion — Tangential distortion coefficients [0 0] (default) | two-element vector

Skew — Camera axes skew 0 (default) | numeric scalar

K — Camera intrinsic matrix 3-by-3 identity matrix (default) | 3-by-3 matrix

Examples

Create an Object Containing Fundamental Camera Parameters

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™.

Version History

R2024b: Import OpenCV pinhole camera model with six radial distortion coefficients

R2022b: Supports premultiply matrix convention

See Also

Apps

Objects

Functions

Topics

`FocalLength` — Focal length
2-element vector

`PrincipalPoint` — Optical center of camera
two-element vector

`ImageSize` — Image size produced by the camera
two-element vector

`RadialDistortion` — Radial lens distortion coefficients
`[0 0]` (default) | 2-element vector | 3-element vector | 6-element vector

`TangentialDistortion` — Tangential distortion coefficients
`[0 0]` (default) | two-element vector

`Skew` — Camera axes skew
`0` (default) | numeric scalar

`K` — Camera intrinsic matrix
3-by-3 identity matrix (default) | 3-by-3 matrix

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.