cv::Affine3< T > 类模板参考

仿射变换。更多…

#include <opencv2/core/affine.hpp>

cv::Affine3< T > 的协作图

公共类型
typedef T	float_type
typedef Matx< float_type, 3, 3 >	Mat3
typedef Matx< float_type, 4, 4 >	Mat4
typedef Vec< float_type, 3 >	Vec3

公共成员函数
	Affine3 ()
	默认构造函数。它表示一个 4x4 单位矩阵。
	Affine3 (const float_type *vals)
	从 16 元素数组。
	Affine3 (const Mat &data, const Vec3 &t=Vec3::all(0))
	Affine3 (const Mat3 &R, const Vec3 &t=Vec3::all(0))
	Affine3 (const Mat4 &affine)
	增广仿射矩阵。
	Affine3 (const Vec3 &rvec, const Vec3 &t=Vec3::all(0))
template<typename Y >
Affine3< Y >	cast () const
Affine3	concatenate (const Affine3 &affine) const
	a.concatenate(affine) 等价于 affine * a;
Affine3	inv (int method=cv::DECOMP_SVD) const
Mat3	linear () const
void	linear (const Mat3 &L)
template<typename Y >
	operator Affine3< Y > () const
Affine3	rotate (const Mat3 &R) const
	a.rotate(R) 等价于 Affine(R, 0) * a;
Affine3	rotate (const Vec3 &rvec) const
	a.rotate(rvec) 等价于 Affine(rvec, 0) * a;
Mat3	rotation () const
void	rotation (const Mat &data)
void	rotation (const Mat3 &R)
void	rotation (const Vec3 &rvec)
Vec3	rvec () const
Affine3	translate (const Vec3 &t) const
	a.translate(t) 等价于 Affine(E, t) * a，其中 E 是单位矩阵
Vec3	translation () const
void	translation (const Vec3 &t)

静态公共成员函数
static Affine3	Identity ()
	创建一个 4x4 单位变换。

公共属性
Mat4	matrix

详细描述

template<typename T>
class cv::Affine3< T >

仿射变换。

它表示一个 4x4 齐次变换矩阵 \(T\)

\[T = \begin{bmatrix} R & t\\ 0 & 1\\ \end{bmatrix} \]

其中 \(R\) 是一个 3x3 旋转矩阵，\(t\) 是一个 3x1 平移向量。

您可以使用 3x3 旋转矩阵或 3x1 旋转向量来指定 \(R\)，后者通过 Rodrigues 公式转换为 3x3 旋转矩阵。

要构造一个矩阵 \(T\)，它首先表示绕轴 \(r\) 旋转，旋转角为 \(|r|\) 弧度（右手规则），然后平移向量 \(t\)，您可以使用

cv::Vec3f r, t;
cv::Affine3f T(r, t);

如果您已经拥有旋转矩阵 \(R\)，则可以使用

cv::Matx33f R;
cv::Affine3f T(R, t);

要从 \(T\) 中提取旋转矩阵 \(R\)，请使用

cv::Matx33f R = T.rotation();

要从 \(T\) 中提取平移向量 \(t\)，请使用

cv::Vec3f t = T.translation();

要从 \(T\) 中提取旋转向量 \(r\)，请使用

cv::Vec3f r = T.rvec();

请注意，由于从旋转向量到旋转矩阵的映射是多对一的。返回的旋转向量不一定与您之前用于设置矩阵的旋转向量相同。

如果您有两个变换 \(T = T_1 * T_2\)，请使用

cv::Affine3f T, T1, T2;
T = T2.concatenate(T1);

要获取 \(T\) 的逆变换，请使用

cv::Affine3f T, T_inv;
T_inv = T.inv();

成员类型定义文档

float_type

模板<typename T >

T cv::Affine3< T >::float_type

Mat3

模板<typename T >

Matx<float_type, 3, 3> cv::Affine3< T >::Mat3

Mat4

模板<typename T >

Matx<float_type, 4, 4> cv::Affine3< T >::Mat4

Vec3

模板<typename T >

Vec<float_type, 3> cv::Affine3< T >::Vec3

构造函数和析构函数文档

Affine3() [1/6]

模板<typename T >

cv::Affine3< T >::Affine3

(

)

默认构造函数。它表示一个 4x4 单位矩阵。

Affine3() [2/6]

模板<typename T >

cv::Affine3< T >::Affine3

(

const Mat4 &

affine

)

增广仿射矩阵。

Affine3() [3/6]

模板<typename T >

cv::Affine3< T >::Affine3	(	const Mat3 &	R,
		const Vec3 &	t = Vec3::all(0) )

最终的4x4矩阵为

\[ \begin{bmatrix} R & t\\ 0 & 1\\ \end{bmatrix} \]

参数

R	3x3旋转矩阵。
t	3x1平移向量。

Affine3() [4/6]

模板<typename T >

cv::Affine3< T >::Affine3	(	const Vec3 &	rvec,
		const Vec3 &	t = Vec3::all(0) )

罗德里格斯向量。

当前矩阵的最后一行设置为[0,0,0,1]。

参数

rvec	3x1旋转向量。其方向指示旋转轴，其长度指示以弧度表示的旋转角度（使用右手规则）。
t	3x1平移向量。

Affine3() [5/6]

模板<typename T >

cv::Affine3< T >::Affine3 ( const Mat & data, const Vec3 & t = Vec3::all(0) )

显式

结合上述所有构造函数。支持4x4、3x4、3x3、1x3、3x1大小的数据矩阵。

当data不是4x4时，当前矩阵的最后一行设置为[0,0,0,1]。

参数

data	1通道矩阵。当它是4x4时，它被复制到当前矩阵，并且不使用t。当它是3x4时，它被复制到当前矩阵的左上角3x4部分，并且不使用t。当它是3x3时，它被复制到当前矩阵的左上角3x3部分。当它是3x1或1x3时，它被视为旋转向量，并使用罗德里格斯公式计算3x3旋转矩阵。
t	3x1平移向量。仅当data既不是4x4也不是3x4时才使用它。

Affine3() [6/6]

模板<typename T >

cv::Affine3< T >::Affine3 ( const float_type * vals )

显式

从 16 元素数组。

成员函数文档

cast()

模板<typename T >

template<typename Y >

Affine3< Y > cv::Affine3< T >::cast

(

)

const

concatenate()

模板<typename T >

Affine3 cv::Affine3< T >::concatenate

(

const Affine3< T > &

affine

)

const

a.concatenate(affine) 等价于 affine * a;

Identity()

模板<typename T >

static Affine3 cv::Affine3< T >::Identity ( )

static

创建一个 4x4 单位变换。

inv()

模板<typename T >

Affine3 cv::Affine3< T >::inv

(

int

method = cv::DECOMP_SVD

)

const

返回值

当前矩阵的逆矩阵。

linear() [1/2]

模板<typename T >

Mat3 cv::Affine3< T >::linear

(

)

const

返回值

左上角3x3部分

linear() [2/2]

模板<typename T >

void cv::Affine3< T >::linear

(

const Mat3 &

L

)

将3x3矩阵L复制到当前矩阵的左上角部分

它设置矩阵的左上角3x3部分。其余部分不受影响。

参数

L

3x3矩阵。

operator Affine3< Y >()

模板<typename T >

template<typename Y >

cv::Affine3< T >::operator Affine3< Y >

(

)

const

rotate() [1/2]

模板<typename T >

Affine3 cv::Affine3< T >::rotate

(

const Mat3 &

R

)

const

a.rotate(R) 等价于 Affine(R, 0) * a;

rotate() [2/2]

模板<typename T >

Affine3 cv::Affine3< T >::rotate

(

const Vec3 &

rvec

)

const

a.rotate(rvec) 等价于 Affine(rvec, 0) * a;

rotation() [1/4]

模板<typename T >

Mat3 cv::Affine3< T >::rotation

(

)

const

返回值

左上角3x3部分

rotation() [2/4]

模板<typename T >

void cv::Affine3< T >::rotation

(

const Mat &

data

)

结合上述旋转方法。支持3x3、1x3、3x1大小的数据矩阵。

它设置矩阵的左上角3x3部分。其余部分不受影响。

参数

data	1通道矩阵。当它是3x3矩阵时，它设置当前矩阵的左上角3x3部分。当它是1x3或3x1矩阵时，它被用作旋转向量。罗德里格斯公式用于计算旋转矩阵并设置当前矩阵的左上角3x3部分。

rotation() [3/4]

模板<typename T >

void cv::Affine3< T >::rotation

(

const Mat3 &

R

)

旋转矩阵。

将旋转矩阵复制到当前矩阵的左上角3x3部分。当前矩阵的其余元素不变。

参数

R

3x3旋转矩阵。

rotation() [4/4]

模板<typename T >

void cv::Affine3< T >::rotation

(

const Vec3 &

rvec

)

罗德里格斯向量。

它设置矩阵的左上角3x3部分。其余部分不受影响。

参数

rvec	3x1旋转向量。方向指示旋转轴，长度指示以弧度表示的旋转角度（使用右手拇指规则）。

rvec()

模板<typename T >

Vec3 cv::Affine3< T >::rvec

(

)

const

罗德里格斯向量。

返回值

表示当前矩阵左上角3x3旋转矩阵的向量。

警告

由于旋转向量和旋转矩阵之间的映射是多对一的，因此此函数仅返回一个表示当前旋转矩阵的旋转向量，它不一定与`rotation(const Vec3& rvec)`设置的相同。

translate()

模板<typename T >

Affine3 cv::Affine3< T >::translate

(

const Vec3 &

t

)

const

a.translate(t) 等价于 Affine(E, t) * a，其中 E 是单位矩阵

translation() [1/2]

模板<typename T >

Vec3 cv::Affine3< T >::translation

(

)

const

返回值

矩阵右上角的 3x1 部分

translation() [2/2]

模板<typename T >

void cv::Affine3< T >::translation

(

const Vec3 &

t

)

将 t 复制到当前矩阵最后一列的前三个元素

它设置矩阵的右上角 3x1 部分。其余部分不受影响。

参数

t

3x1平移向量。

成员数据文档

matrix

模板<typename T >

Mat4 cv::Affine3< T >::matrix

---

此类的文档是从以下文件生成的：

• opencv2/core/affine.hpp