affine3d

（不推荐）使用后乘约定的三维仿射几何变换

全页展开

不建议使用 affine3d。请改用 affinetform3d 对象。有关详细信息，请参阅版本历史记录。

说明

affine3d 对象存储有关三维仿射几何变换的信息，并支持正向变换和逆变换。

创建对象

语法

tform = affine3d

tform = affine3d(t)

描述

tform = affine3d 创建一个 affine3d 对象，其默认属性设置对应于恒等变换。

tform = affine3d(t) 将属性 T 设置为指定的三维仿射变换矩阵 t。

示例

属性

全部展开

`T` — 正向三维仿射变换
4×4 单位矩阵 (默认) | 非奇异 4×4 数值矩阵

正向三维仿射变换，指定为非奇异矩阵 4×4 数值矩阵。

矩阵 T 使用如下约定：

[x y z 1] = [u v w 1] * T

其中，T 采用以下形式：

 [a b c 0;
  d e f 0;
  g h i 0;
  j k l 1];

T 的默认值为恒等变换。

数据类型: double | single

`Dimensionality` — 几何变换的维度
`3` (默认)

描述输入点和输出点的几何变换维度，指定为值 3。

对象函数

`invert`	Invert geometric transformation
`isRigid`	Determine if geometric transformation is rigid transformation
`isSimilarity`	Determine if geometric transformation is similarity 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

示例

全部折叠

为各向异性缩放创建三维仿射变换对象

打开实时脚本

创建一个 affine3d 对象，该对象在每个维度上按不同因子缩放三维图像。

Sx = 1.2;
Sy = 1.6;
Sz = 2.4;
T = [Sx 0 0 0; 0 Sy 0 0; 0 0 Sz 0; 0 0 0 1];
tform = affine3d(T)

tform = 
  affine3d with properties:

                 T: [4×4 double]
    Dimensionality: 3

检查 T 属性的值。

tform.T

ans = 4×4

    1.2000         0         0         0
         0    1.6000         0         0
         0         0    2.4000         0
         0         0         0    1.0000

扩展功能

全部展开

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

用法说明和限制：

affine3d 支持 C 和 C++ 代码生成（需要 MATLAB^® Coder™）。有关详细信息，请参阅图像处理的代码生成。
生成代码时，您只能指定单个对象 - 不支持对象数组。
生成代码不能返回 affine3d 对象。但您可以返回数值数组，例如 T 属性的值。

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

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

版本历史记录

在 R2013a 中推出

全部展开

R2022b: 不推荐

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

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

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

不推荐使用推荐的替代项

不推荐使用	推荐的替代项
此示例基于后乘约定中的变换矩阵 `T` 创建一个 `affine3d` 对象。 T = [2 0 0 0; 0 2 0 0; 0 0 4 0; 5 10 -5 1]; tformPost = affine3d(T);	此示例基于变换矩阵 `T` 的转置创建一个 `affinetform3d` 对象。 T = [2 0 0 0; 0 2 0 0; 0 0 4 0; 5 10 -5 1]; A = T'; tform = affinetform3d(A); 此示例从名为 `tformPost` 的 `affine3d` 对象开始，并基于 `tformPost` 的 `T` 属性的转置创建一个 `affinetform3d` 对象。 T = tformPost.T; tform = affinetform3d(T');

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

T = [2 0 0 0; 0 2 0 0; 0 0 4 0; 5 10 -5 1];
tformPost = affine3d(T);

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

T = [2 0 0 0; 0 2 0 0; 0 0 4 0; 5 10 -5 1];
A = T';
tform = affinetform3d(A);

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

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

R2022b: 用于创建 `affine3d` 对象的函数减少了

您无法再使用 imregtform 或 randomAffine3d 函数创建 affine3d 对象。这些函数以 affinetform3d、rigidtform3d、simtform3d 或 transltform3d 对象形式返回三维仿射变换。

R2021b: 支持基于线程的环境

affine3d 现在支持基于线程的环境。

另请参阅

affinetform3d

affine3d

说明

创建对象

语法

描述

属性

T — 正向三维仿射变换 4×4 单位矩阵 (默认) | 非奇异 4×4 数值矩阵

Dimensionality — 几何变换的维度 3 (默认)

对象函数

示例

为各向异性缩放创建三维仿射变换对象

扩展功能

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

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

版本历史记录

R2022b: 不推荐

R2022b: 用于创建 affine3d 对象的函数减少了

R2021b: 支持基于线程的环境

另请参阅

主题

`T` — 正向三维仿射变换
4×4 单位矩阵 (默认) | 非奇异 4×4 数值矩阵

`Dimensionality` — 几何变换的维度
`3` (默认)

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

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

R2022b: 用于创建 `affine3d` 对象的函数减少了