rigid2d

R2026b

（不推荐）使用后乘约定的二维刚性几何变换

全页展开

不推荐使用 rigid2d。请改用 rigidtform2d 对象。有关详细信息，请参阅版本历史记录。

描述

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

创建对象

语法

tform = rigid2d

tform = rigid2d(t)

tform = rigid2d(rot,trans)

描述

tform = rigid2d 创建对应于恒等变换的默认 rigid2d 对象。

tform = rigid2d(t) 将 T 属性设置为指定的二维刚性变换矩阵 t。

tform = rigid2d(rot,trans) 将 Rotation 和 Translation 属性分别设置为指定的旋转矩阵 rot 和平移向量 trans。

示例

属性

全部展开

`T` — 正向刚性变换
3×3 单位矩阵 (默认) | 3×3 数值矩阵

正向刚性变换，指定为 3×3 数值矩阵。矩阵 T 满足由下式给出的后乘约定：

[x y 1] = [u v 1] * Rotation + Translation

数据类型: single | double

`Rotation` — 变换的旋转分量
2×2 单位矩阵 (默认) | 2×2 数值矩阵

变换的旋转分量，指定为 2×2 数值矩阵。

数据类型: single | double

`Translation` — 变换的平移分量
`[0 0]` (默认) | 二元素数值行向量

变换的平移分量，指定为一个包含 2 个元素的数值行向量。

数据类型: single | double

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

此属性为只读。

几何变换的维度，指定为数字 2。

对象函数

`invert`	Invert geometric transformation
`isTranslation`	Determine if geometric transformation is pure translation
`outputLimits`	Find output spatial limits given input spatial limits
`transformPointsForward`	Apply forward geometric transformation
`transformPointsInverse`	Apply inverse geometric transformation

示例

全部折叠

创建具有定义的平移和旋转的刚性二维对象

打开实时脚本

以度为单位指定旋转角度，并创建一个 2×2 旋转矩阵。

theta = 30;
rot = [ cosd(theta) sind(theta); ...
       -sind(theta) cosd(theta)];

分别指定水平和垂直平移量。

trans = [2 3];

创建一个执行旋转和平移的 rigid2d 对象。

tform = rigid2d(rot,trans)

tform = 
  rigid2d with properties:

       Rotation: [2×2 double]
    Translation: [2 3]

扩展功能

全部展开

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

用法说明和限制：

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

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

请参阅“C/C++ 代码生成”部分中的用法说明和限制。同样的用法说明和限制也适用于 GPU 代码生成。

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

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

版本历史记录

在 R2020b 中推出

全部折叠

R2022b: 不推荐

从 R2022b 开始，大多数 Image Processing Toolbox™ 函数都使用前乘约定来创建和执行几何变换。因此，不推荐使用 rigid2d 对象，因为它使用后乘约定。虽然当前没有删除 rigid2d 对象的计划，但您可以通过切换到支持前乘约定的 rigidtform2d 对象来简化几何变换工作流。有关详细信息，请参阅Migrate Geometric Transformations to Premultiply Convention。

要更新您的代码，请执行以下操作：

将函数名称 rigid2d 的实例更改为 rigidtform2d。
将变换矩阵指定为 T 或 Rotation 的转置。T 是 rigid2d 对象的 T 属性的值，或用于创建 rigid2d 对象的变换矩阵。Rotation 是 rigid2d 对象的 Rotation 属性的值，或用于创建 rigid2d 对象的旋转矩阵。

不推荐使用推荐的替代项

不推荐使用	推荐的替代项
此示例基于后乘约定中的变换矩阵 `T` 创建一个 `rigid2d` 对象。 T = [1 0 0; 0 1 0; 5 10 1]; tformPost = rigid2d(T);	此示例基于变换矩阵 `T` 的转置创建一个 `rigidtform2d` 对象。 T = [1 0 0; 0 1 0; 5 10 1]; tform = rigidtform2d(T'); 此示例从一个名为 `tformPost` 的 `rigid2d` 对象开始，并基于 `tformPost` 的 `T` 属性的转置创建一个 `rigidtform2d` 对象。 T = tformPost.T; tform = rigidtform2d(T');
此示例基于后乘约定中的旋转矩阵 `rot` 和平移 `trans` 创建一个 `rigid2d` 对象。 theta = 45; rot = [cosd(theta) sind(theta); -sind(theta) cosd(theta)]; trans = [5 10]; tformPost = rigid2d(rot,trans);	此示例基于旋转矩阵 `rot` 的转置和平移 `trans` 创建一个 `rigidtform2d` 对象。 theta = 45; rot = [cosd(theta) sind(theta); -sind(theta) cosd(theta)]; trans = [5 10]; tform = rigidtform2d(rot',trans); 您可以通过直接指定旋转角度来简化代码。 tform = rigidtform2d(theta,trans);

此示例基于后乘约定中的变换矩阵 T 创建一个 rigid2d 对象。

T = [1 0 0; 0 1 0; 5 10 1];
tformPost = rigid2d(T);

此示例基于变换矩阵 T 的转置创建一个 rigidtform2d 对象。

T = [1 0 0; 0 1 0; 5 10 1];
tform = rigidtform2d(T');

此示例从一个名为 tformPost 的 rigid2d 对象开始，并基于 tformPost 的 T 属性的转置创建一个 rigidtform2d 对象。

T = tformPost.T;
tform = rigidtform2d(T');

此示例基于后乘约定中的旋转矩阵 rot 和平移 trans 创建一个 rigid2d 对象。

theta = 45;
rot = [cosd(theta) sind(theta); -sind(theta) cosd(theta)];
trans = [5 10];
tformPost = rigid2d(rot,trans);

此示例基于旋转矩阵 rot 的转置和平移 trans 创建一个 rigidtform2d 对象。

theta = 45;
rot = [cosd(theta) sind(theta); -sind(theta) cosd(theta)];
trans = [5 10];
tform = rigidtform2d(rot',trans);

您可以通过直接指定旋转角度来简化代码。

tform = rigidtform2d(theta,trans);

另请参阅

rigidtform2d

rigid2d

描述

创建对象

语法

描述

属性

T — 正向刚性变换 3×3 单位矩阵 (默认) | 3×3 数值矩阵

Rotation — 变换的旋转分量 2×2 单位矩阵 (默认) | 2×2 数值矩阵

Translation — 变换的平移分量 [0 0] (默认) | 二元素数值行向量

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

对象函数

示例

创建具有定义的平移和旋转的刚性二维对象

扩展功能

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

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

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

版本历史记录

R2022b: 不推荐

另请参阅

主题

`T` — 正向刚性变换
3×3 单位矩阵 (默认) | 3×3 数值矩阵

`Rotation` — 变换的旋转分量
2×2 单位矩阵 (默认) | 2×2 数值矩阵

`Translation` — 变换的平移分量
`[0 0]` (默认) | 二元素数值行向量

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

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

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

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