projtform2d

二维投影几何变换

自 R2022b 起. 建议替换 projective2d.

全页展开

说明

projtform2d 对象存储有关二维投影几何变换的信息，并支持正向变换和逆变换。

创建对象

您可以通过以下方式创建一个 projtform2d 对象：

fitgeotform2d - 估计在两个图像之间映射成对控制点的几何变换。
此处介绍的 projtform2d 函数。

语法

tform = projtform2d

tform = projtform2d(projMat)

tform = projtform2d(tformIn)

描述

tform = projtform2d 创建一个执行恒等变换的 projtform2d 对象。

tform = projtform2d(projMat) 从有效的二维投影变换矩阵 projMat 创建一个 projtform2d 对象。

示例

tform = projtform2d(tformIn) 基于另一个几何变换对象 tformIn 创建一个 projtform2d 对象，该对象表示有效的二维投影几何变换。

输入参量

全部展开

`projMat` — 正向二维投影变换
3×3 单位矩阵 (默认) | 3×3 数值矩阵

正向二维投影变换，指定为 3×3 数值矩阵。

此参量设置 A 属性。

数据类型: double | single

`tformIn` — 投影二维几何变换
`affinetform2d` 对象 | `rigidtform2d` 对象 | `simtform2d` 对象 | `transltform2d` 对象 | `projtform2d` 对象

投影二维几何变换，指定为 affinetform2d 对象、rigidtform2d 对象、simtform2d 对象、transltform2d 对象或 projtform2d 对象。

输出参量

全部展开

`tform` — 投影二维几何变换
`projtform2d` 对象

投影二维几何变换，以 projtform2d 对象形式返回。

属性

全部展开

`A` — 正向二维投影变换
3×3 单位矩阵 (默认) | 3×3 数值矩阵

正向二维投影变换，指定为 3×3 数值矩阵。A 的默认值为单位矩阵。

矩阵 A 使用以下约定将输入坐标空间中的点 (u, v) 转换为输出坐标空间中的点 (x, y)：

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

其中 x = xʹ / k 并且 y = yʹ / k。

数据类型: double | single

`Dimensionality` — 几何变换的维度
只读: `2` (默认)

此属性为只读。

输入点和输出点的几何变换维度，以值 2 的形式返回。

数据类型: double

对象函数

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

示例

全部折叠

创建二维投影变换

打开实时脚本

定义一个 3×3 几何变换矩阵。此矩阵指定由旋转和倾斜组成的投影变换。

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

从变换矩阵创建一个 projtform2d 对象。

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]

检查 A 属性的值。

tform.A

ans = 3×3

    0.8660   -0.5000         0
    0.5000    0.8660         0
    0.0010    0.0010    1.0000

扩展功能

全部展开

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

projtform2d 支持 C 和 C++ 代码生成（需要 MATLAB^® Coder™）。有关详细信息，请参阅图像处理的代码生成。
生成代码时，您只能指定单个对象。不支持对象数组。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

版本历史记录

在 R2022b 中推出

全部展开

R2022b: 建议替换 `projective2d`

从 R2022b 开始，大多数 Image Processing Toolbox™ 函数都使用前乘约定来创建和执行几何变换。projtform2d 对象以与前乘约定一致的格式存储关于二维投影几何变换的信息。

因此，不推荐使用 projective2d 对象，因为它使用后乘约定。虽然当前没有删除 projective2d 对象的计划，但您可以通过切换到 projtform2d 对象来简化几何变换工作流。有关详细信息，请参阅Migrate Geometric Transformations to Premultiply Convention。

另请参阅

projtform2d

说明

创建对象

语法

描述

输入参量

projMat — 正向二维投影变换 3×3 单位矩阵 (默认) | 3×3 数值矩阵

tformIn — 投影二维几何变换 affinetform2d 对象 | rigidtform2d 对象 | simtform2d 对象 | transltform2d 对象 | projtform2d 对象

输出参量

tform — 投影二维几何变换 projtform2d 对象

属性

A — 正向二维投影变换 3×3 单位矩阵 (默认) | 3×3 数值矩阵

Dimensionality — 几何变换的维度 只读: 2 (默认)

对象函数

示例

创建二维投影变换

扩展功能

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

版本历史记录

R2022b: 建议替换 projective2d

另请参阅

主题

`projMat` — 正向二维投影变换
3×3 单位矩阵 (默认) | 3×3 数值矩阵

`tformIn` — 投影二维几何变换
`affinetform2d` 对象 | `rigidtform2d` 对象 | `simtform2d` 对象 | `transltform2d` 对象 | `projtform2d` 对象

`tform` — 投影二维几何变换
`projtform2d` 对象

`A` — 正向二维投影变换
3×3 单位矩阵 (默认) | 3×3 数值矩阵

`Dimensionality` — 几何变换的维度
只读: `2` (默认)

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

R2022b: 建议替换 `projective2d`