projtform2d

2-D projective geometric transformation

Since R2022b. Recommended over projective2d.

Description

A projtform2d object stores information about a 2-D projective geometric transformation and enables forward and inverse transformations.

Creation

You can create a projtform2d object in these ways:

fitgeotform2d — Estimate a geometric transformation that maps pairs of control points between two images.
The projtform2d function described here.

Syntax

tform = projtform2d

tform = projtform2d(projMat)

tform = projtform2d(tformIn)

Description

tform = projtform2d creates a projtform2d object that performs an identity transformation.

tform = projtform2d(projMat) creates a projtform2d object from a valid 2-D projective transformation matrix, projMat.

example

tform = projtform2d(tformIn) creates a projtform2d object from another geometric transformation object, tformIn, that represents a valid 2-D projective geometric transformation.

Input Arguments

expand all

`projMat` — Forward 2-D projective transformation
3-by-3 identity matrix (default) | 3-by-3 numeric matrix

Forward 2-D projective transformation, specified as a 3-by-3 numeric matrix.

This argument sets the A property.

Data Types: double | single

`tformIn` — Projective 2-D geometric transformation
`affinetform2d` object | `rigidtform2d` object | `simtform2d` object | `transltform2d` object | `projtform2d` object

Projective 2-D geometric transformation, specified as an affinetform2d object, rigidtform2d object, simtform2d object, transltform2d object, or projtform2d object.

Output Arguments

expand all

`tform` — Projective 2-D geometric transformation
`projtform2d` object

Projective 2-D geometric transformation, returned as a projtform2d object.

Properties

expand all

`A` — Forward 2-D projective transformation
3-by-3 identity matrix (default) | 3-by-3 numeric matrix

Forward 2-D projective transformation, specified as a 3-by-3 numeric matrix. The default value of A is the identity matrix.

The matrix A transforms the point (u, v) in the input coordinate space to the point (x, y) in the output coordinate space using the convention:

$[\begin{matrix} x^{'} \\ y^{'} \\ k \end{matrix}] = Α \times [\begin{matrix} u \\ v \\ 1 \end{matrix}]$

where x = xʹ / k and y = yʹ / k.

Data Types: double | single

`Dimensionality` — Dimensionality of geometric transformation
Read-only: `2` (default)

This property is read-only.

Dimensionality of the geometric transformation for both input and output points, returned as the value 2.

Data Types: double

Object Functions

`invert`	Invert geometric transformation
`outputLimits`	Find output spatial limits given input spatial limits
`transformPointsForward`	Apply forward geometric transformation
`transformPointsInverse`	Apply inverse geometric transformation

Examples

collapse all

Create 2-D Projective Transformation

Open Live Script

Define a 3-by-3 geometric transformation matrix. This matrix specifies a projective transformation consisting of rotation and tilt.

theta = 30;
A = [cosd(theta) -sind(theta) 0; ...
     sind(theta)  cosd(theta) 0; ...
     0.001        0.001       1];

Create a projtform2d object from the transformation matrix.

tform = projtform2d(A)

tform = 
  projtform2d with properties:

    Dimensionality: 2

                 A: [0.8660   -0.5000         0
                     0.5000    0.8660         0
                     0.0010    0.0010    1.0000]

Examine the value of the A property.

tform.A

ans = 3×3

    0.8660   -0.5000         0
    0.5000    0.8660         0
    0.0010    0.0010    1.0000

Extended Capabilities

expand all

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

Usage notes and limitations:

projtform2d supports the generation of C and C++ code (requires MATLAB^® Coder™). For more information, see Code Generation for Image Processing.
When generating code, you can only specify singular objects. Arrays of objects are not supported.

Thread-Based Environment
Run code in the background using MATLAB® `backgroundPool` or accelerate code with Parallel Computing Toolbox™ `ThreadPool`.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Version History

Introduced in R2022b

expand all

R2022b: Recommended over `projective2d`

Starting in R2022b, most Image Processing Toolbox™ functions create and perform geometric transformations using the premultiply convention. The projtform2d object stores information about 2-D projective geometric transformations in a format consistent with the premultiply convention.

The projective2d object is not recommended because it uses the postmultiply convention. Although there are no plans to remove the projective2d object at this time, you can streamline your geometric transformation workflows by switching to the projtform2d object. For more information, see Migrate Geometric Transformations to Premultiply Convention.

projtform2d

Description

Creation

Syntax

Description

Input Arguments

`projMat` — Forward 2-D projective transformation
3-by-3 identity matrix (default) | 3-by-3 numeric matrix

`tformIn` — Projective 2-D geometric transformation
`affinetform2d` object | `rigidtform2d` object | `simtform2d` object | `transltform2d` object | `projtform2d` object

Output Arguments

`tform` — Projective 2-D geometric transformation
`projtform2d` object

Properties

`A` — Forward 2-D projective transformation
3-by-3 identity matrix (default) | 3-by-3 numeric matrix

`Dimensionality` — Dimensionality of geometric transformation
Read-only: `2` (default)

Object Functions

Examples

Create 2-D Projective Transformation

Extended Capabilities

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

Thread-Based Environment
Run code in the background using MATLAB® `backgroundPool` or accelerate code with Parallel Computing Toolbox™ `ThreadPool`.

Version History

R2022b: Recommended over `projective2d`

See Also

Topics

projtform2d

Description

Creation

Syntax

Description

Input Arguments

projMat — Forward 2-D projective transformation 3-by-3 identity matrix (default) | 3-by-3 numeric matrix

tformIn — Projective 2-D geometric transformation affinetform2d object | rigidtform2d object | simtform2d object | transltform2d object | projtform2d object

Output Arguments

tform — Projective 2-D geometric transformation projtform2d object

Properties

A — Forward 2-D projective transformation 3-by-3 identity matrix (default) | 3-by-3 numeric matrix

Dimensionality — Dimensionality of geometric transformation Read-only: 2 (default)

Object Functions

Examples

Create 2-D Projective Transformation

Extended Capabilities

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

Thread-Based Environment Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

Version History

R2022b: Recommended over projective2d

See Also

Topics

`projMat` — Forward 2-D projective transformation
3-by-3 identity matrix (default) | 3-by-3 numeric matrix

`tformIn` — Projective 2-D geometric transformation
`affinetform2d` object | `rigidtform2d` object | `simtform2d` object | `transltform2d` object | `projtform2d` object

`tform` — Projective 2-D geometric transformation
`projtform2d` object

`A` — Forward 2-D projective transformation
3-by-3 identity matrix (default) | 3-by-3 numeric matrix

`Dimensionality` — Dimensionality of geometric transformation
Read-only: `2` (default)

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

Thread-Based Environment
Run code in the background using MATLAB® `backgroundPool` or accelerate code with Parallel Computing Toolbox™ `ThreadPool`.

R2022b: Recommended over `projective2d`