C

变换类

Transform 类指定坐标系统的 2D 变换。更多...

头文件	#include <platforminterface/transform.h>
自	Qt Quick Ultralite (平台) 1.5
继承	Qul::PlatformInterface::GenericMatrix (私有)

所有成员表，包括继承成员

公共类型

枚举	Type { Identity, Translate, UniformScale, Scale, Rotation, …, Project }

公共函数

	Transform(float m11, float m12, float m13, float m21, float m22, float m23, float m31, float m32, float m33)
	Transform(Qul::PlatformInterface::Transform::Type type, float m11, float m12, float m21, float m22, float dx, float dy)
	变换()
float	m11() const
float	m12() const
float	m13() const
float	m21() const
float	m22() const
float	m23() const
float	m31() const
float	m32() const
float	m33() const
float	determinant() const
float	dx() const
float	dy() const
Qul::PlatformInterface::Transform	inverted(bool *invertible) const
PlatformInterface::PointF	map(PlatformInterface::PointF point) const
PlatformInterface::RectF	map(const PlatformInterface::RectF &rect) const
Qul::PlatformInterface::Transform::Type	optimize()
Qul::PlatformInterface::Transform &	rotate(float angle)
Qul::PlatformInterface::Transform &	scale(float sx, float sy)
Qul::PlatformInterface::Transform &	translate(float x, float y)
Qul::PlatformInterface::Transform	translated(float x, float y) const
PlatformInterface::PointF	translation() const
Qul::PlatformInterface::Transform::Type	类型() const
Qul::PlatformInterface::Transform	算符operator*(const Qul::PlatformInterface::Transform &位移) const
bool	算符operator==(const Qul::PlatformInterface::Transform &位移) const

静态公众成员

Qul::PlatformInterface::Transform	fromRotation(float 角度)
Qul::PlatformInterface::Transform	fromScale(float 水平缩放, float 垂直缩放)
Qul::PlatformInterface::Transform	fromTranslation(float dx, float dy)

详细描述

变换指定了如何平移、缩放、倾斜、旋转或投影坐标系。通常用于渲染图形。

Transform 类型及其矩阵可以在创建 Transform 对象时设置。默认构造函数创建具有 Identity 类型和大小的 Transform 对象。或者，可以使用 fromTranslation()，fromRotation() 或 fromScale() 静态函数创建 Transform 对象。此外，还可以通过应用基本矩阵运算来创建 Transform 对象。

Transform 类支持使用 map() 函数映射图形原语。例如，可以将给定的点或矩形映射到变换定义的坐标系中。

Transform 提供了 type() 函数以获取当前变换类型的信息，以及 optimize() 函数以强制重新检查类型，函数 inverted() 返回变换的逆值副本（如果可以被逆变换），否则返回恒等变换。此外，Transform 还提供了 determinant() 函数，该函数返回矩阵的行列式。

最后，Transform 类支持乘法和比较运算。

基本矩阵运算

`m11`	`m12`	`m13`
`m21`	`m22`	`m23`
`m31`（dx）	`m32`（dy）	`m33`

Transform 对象包含一个 3x3 矩阵。其中，

m31 (dx) 和 m32 (dy) 指定了水平和垂直平移。
m11 和 m22 指定了水平和垂直缩放。
m12 和 m21 指定了水平和垂直剪切。
m13 和 m23 指定了水平和垂直投影，其中 m33 用作额外的投影因子。

Transform 使用以下公式对平面上的点执行变换

x' = m11*x + m21*y + dx
y' = m22*y + m12*x + dy
if (is not affine) {
    w' = m13*x + m23*y + m33
    x' /= w'
    y' /= w'
}

其中，(x, y) 是原始点，而 (x', y') 是变换点。可以通过在 inverted() 矩阵上执行相同的操作将 (x', y') 变换回 (x, y)。

在构建变换时可以设置各种矩阵元素。也可以使用translate()、rotate()和scale()便捷函数来操作它们。当前值可以使用m11()、m12()、m13()、m21()、m22()、m23()、m31()、m32()、m33()、dx()和dy()函数检索。

以下变换被支持：

可以通过设置dx和dy来实现平移，将坐标系沿X轴移动dx单位，沿Y轴移动dy单位。
可以通过设置m11和m22来实现缩放。例如，将m11设置为2，将m22设置为1.5，可以使高度加倍，宽度增加50%。
通过将m11、m22和m33设置为1（其他都设置为0）实现单位变换，将一个点映射到自身。
剪切由m12和m21控制。将这些元素设置为非零值将扭曲坐标系。
通过设置剪切和缩放因子可以实现旋转。
可以通过设置投影和缩放因子来实现透视变换。

注意事项:

内部变换表示使用转置矩阵，这将改变变换组合的顺序。
将变换(A)应用于向量(V)（x, y, 1）的计算方式为(m11 * x + m21 * y + m31, m12 * x + m22 * y + m32)。这是通过调用A.map(V)实现的。等效的操作是：(V * A)或(A^T * V)。这也可以解释为从右边应用变换。
因此，连续应用两个变换A * B，意味着首先应用A，然后应用B。
剪切或投影可以表示为变换，但绘图引擎尚不支持仿射变换的混合。

注意：该功能可能不受所有参考板上的硬件支持。更多信息，请参阅支持的功能表。另请参阅变换QML类型

成员类型文档

enum Transform::Type

常数	值	描述
`Qul::PlatformInterface::Transform::Identity`	`0`	单位变换
`Qul::PlatformInterface::Transform::Translate`	`1`	纯平移
`Qul::PlatformInterface::Transform::UniformScale`	`2`	先均等地缩放然后平移
`Qul::PlatformInterface::Transform::Scale`	`3`	先缩放然后平移
`Qul::PlatformInterface::Transform::Rotation`	`4`	旋转，均等地缩放（可能），然后平移
`Qul::PlatformInterface::Transform::ScaleRotation`	`5`	缩放，旋转，然后平移
`Qul::PlatformInterface::Transform::Shear`	`6`	旋转，非均匀缩放，然后平移
`Qul::PlatformInterface::Transform::Project`	`7`	任意投影变换