QTransform类

成员函数文档

QTransform::QTransform()

构造单位矩阵。

所有元素均设置为0，除了 m11 和 m22（指定比例），它们的值被设为1，以及 m33，它的值也设置为1。

另请参阅reset。

QTransform::QTransform(qreal m11, qreal m12, qreal m13, qreal m21, qreal m22, qreal m23, qreal m31, qreal m32, qreal m33)

构造一个具有元素 m11, m12, m13, m21, m22, m23, m31, m32, m33 的矩阵。

另请参阅setMatrix。

QTransform::QTransform(qreal m11, qreal m12, qreal m21, qreal m22, qreal dx, qreal dy)

构造一个具有元素 m11, m12, m21, m22, dx 和 dy 的矩阵。

另请参阅setMatrix。

qreal QTransform::m11() const

返回水平缩放因子。

另请参阅scale 和 基本矩阵操作。

qreal QTransform::m12() const

返回垂直剪切因子。

另请参阅shear 和 基本矩阵操作。

qreal QTransform::m13() const

返回水平投影因子。

另请参阅translate 和 基本矩阵操作。

qreal QTransform::m21() const

返回水平剪切因子。

另请参阅shear 和 基本矩阵操作。

qreal QTransform::m22() const

返回垂直缩放因子。

另请参阅scale 和 基本矩阵操作。

qreal QTransform::m23() const

返回垂直投影因子。

另请参阅translate 和 基本矩阵操作。

qreal QTransform::m31() const

返回水平平移因子。

另请参阅 dx()、translate() 和 基本矩阵运算。

qreal QTransform::m32() const

返回垂直平移因子。

另请参阅 dy()、translate() 和 基本矩阵运算。

qreal QTransform::m33() const

返回除数因子。

另请参阅translate 和 基本矩阵操作。

QTransform QTransform::adjoint() const

返回此矩阵的伴随矩阵。

qreal QTransform::determinant() const

返回矩阵的行列式。

qreal QTransform::dx() const

返回水平平移因子。

另请参阅 m31()、translate() 和 基本矩阵运算。

qreal QTransform::dy() const

返回垂直平移因子。

另请参阅translate 和 基本矩阵操作。

[静态] QTransform QTransform::fromScale(qreal sx, qreal sy)

创建一个矩阵，该矩阵对应于水平方向上的 sx 和垂直方向上的 sy 的缩放。这相当于 QTransform().scale(sx, sy)，但更快一些。

[静态] QTransform QTransform::fromTranslate(qreal dx, qreal dy)

创建一个矩阵，该矩阵对应于沿着 x 轴的 dx 和沿着 y 轴的 dy 的平移。这相当于 QTransform().translate(dx, dy)，但更快一些。

QTransform QTransform::inverted(bool *invertible = nullptr) const

返回此矩阵的逆矩阵副本。

如果矩阵是奇异的（不可逆），则返回的单位矩阵。如果 invertible 有效（即非 0），矩阵可逆则将其值设置为 true，否则设置为 false。

另请参阅 isInvertible。

bool QTransform::isAffine() const

如果矩阵代表一个仿射变换，则返回 true，否则返回 false。

bool QTransform::isIdentity() const

如果矩阵是单位矩阵，则返回 true，否则返回 false。

另请参阅reset。

bool QTransform::isInvertible() const

如果矩阵可逆，则返回 true，否则返回 false。

另请参阅 inverted。

bool QTransform::isRotating() const

如果矩阵表示某种旋转变换，则返回 true，否则返回 false。

另请参阅reset。

bool QTransform::isScaling() const

如果矩阵表示缩放变换，则返回 true，否则返回 false。

另请参阅reset。

bool QTransform::isTranslating() const

如果矩阵表示平移变换，则返回 true，否则返回 false。

另请参阅reset。

void QTransform::map(qreal x, qreal y, qreal *tx, qreal *ty) const

将给定的坐标 x 和 y 映射到由该矩阵定义的坐标系中。结果值分别放入 *tx 和 *ty 中。

坐标使用以下公式进行变换

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

点 (x, y) 是原始点，(x', y') 是变换后的点。

另请参阅：基本矩阵操作。

QPoint QTransform::map(const QPoint &point) const

这是一个重载函数。

创建并返回一个 QPoint 对象，它是给定 point 的副本，映射到由该矩阵定义的坐标系中。请注意，变换后的坐标四舍五入到最近的整数。

QPointF QTransform::map(const QPointF &p) const

这是一个重载函数。

创建并返回一个 QPointF 对象，它是给定点 p 的副本，映射到由该矩阵定义的坐标系中。

QLine QTransform::map(const QLine &l) const

这是一个重载函数。

创建并返回一个 QLineF 对象，它是给定线 l 的副本，映射到由该矩阵定义的坐标系中。

QLineF QTransform::map(const QLineF &line) const

这是一个重载函数。

创建并返回一个 QLine 对象，它是给定 line 的副本，映射到由该矩阵定义的坐标系中。请注意，变换后的坐标四舍五入到最近的整数。

QPolygonF QTransform::map(const QPolygonF &polygon) const

这是一个重载函数。

创建并返回一个 QPolygonF 对象，它是给定 polygon 的副本，映射到由该矩阵定义的坐标系中。

QPolygon QTransform::map(const QPolygon &polygon) const

这是一个重载函数。

创建并返回一个复制的QPolygon对象，该对象是给定polygon，映射到由此矩阵定义的坐标系中。注意，变换后的坐标被四舍五入到最接近的整数。

QRegion QTransform::map(const QRegion &region) const

这是一个重载函数。

创建并返回一个复制的QRegion对象，该对象是给定region，映射到由此矩阵定义的坐标系。

如果使用了旋转或剪切，调用此方法可能相当昂贵。

QPainterPath QTransform::map(const QPainterPath &path) const

这是一个重载函数。

创建并返回一个复制的QPainterPath对象，该对象是给定path，映射到由此矩阵定义的坐标系。

void QTransform::map(int x, int y, int *tx, int *ty) const

这是一个重载函数。

将给定的坐标x和y映射到此矩阵定义的坐标系中。结果值分别放在*tx和*ty中。注意，变换后的坐标被四舍五入到最接近的整数。

QRectF QTransform::mapRect(const QRectF &rectangle) const

创建并返回一个复制的QRectF对象，该对象是给定rectangle，映射到由此矩阵定义的坐标系。

矩形的坐标使用以下公式变换

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

如果指定了旋转或剪切，则此函数返回边界矩形。要检索给定rectangle映射的精确区域，请使用mapToPolygon()函数。

另请参阅mapToPolygon()和基本矩阵运算。

QRect QTransform::mapRect(const QRect &rectangle) const

这是一个重载函数。

创建并返回一个复制的QRect对象，该对象是给定rectangle，映射到由此矩阵定义的坐标系。注意，变换后的坐标被四舍五入到最接近的整数。

QPolygon QTransform::mapToPolygon(const QRect &rectangle) const

创建并返回给定rectangle的映射到由此矩阵定义的坐标系的QPolygon表示。

矩形的坐标使用以下公式变换

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

多边形和矩形在变换时行为略有不同（由于整数舍入），因此matrix.map(QPolygon(rectangle))不一定与matrix.mapToPolygon(rectangle)相同。

另请参阅mapRect()和基本矩阵运算。

[静态] bool QTransform::quadToQuad(const QPolygonF &one, const QPolygonF &two, QTransform &trans)

创建一个变换矩阵 trans，将该四边形 one 映射到另一个四边形 two。如果变换是可能的，则返回 true；否则返回 false。

这是一个组合了 quadToSquare() 和 squareToQuad() 方法的便利方法。它允许输入的四边形变换成任何其他四边形。

另请参阅squareToQuad() 和 quadToSquare。

[静态] bool QTransform::quadToSquare(const QPolygonF &quad, QTransform &trans)

创建一个变换矩阵 trans，将四边形 quad 映射到单位方阵。如果构造变换，则返回 true，如果不存在这样的变换，则返回 false。

另请参阅squareToQuad() 和 quadToQuad。

void QTransform::reset()

将矩阵重置为单位矩阵，即所有元素都设置为 0，除了 m11 和 m22（指定缩放）以及 m33 被设置为 1。

另请参阅QTransform，isIdentity 和 基本矩阵操作。

[自 6.5 起] QTransform &QTransform::rotate(qreal a, Qt::Axis axis, qreal distanceToPlane)

将坐标系统逆时针旋转给定的角度 a，绕指定 axis 和距离 distanceToPlane 进行旋转，并返回矩阵的引用。

注意，如果您将 QTransform 应用到在窗口坐标中定义的点，则旋转方向将是顺时针，因为 y 轴指向下方。

角度以度为单位指定。

如果 distanceToPlane 为零，则忽略它。这对于实现正交投影是合适的，其中应丢弃 z 坐标而不是进行投影。

此函数是在 Qt 6.5 中引入的。

另请参阅setMatrix。

QTransform &QTransform::rotate(qreal a, Qt::Axis axis = Qt::ZAxis)

这是一个重载函数。

将坐标系统逆时针旋转给定的角度 a，绕指定 axis 和距离 1024.0 进行旋转，并返回矩阵的引用。

注意，如果您将 QTransform 应用到在窗口坐标中定义的点，则旋转方向将是顺时针，因为 y 轴指向下方。

角度以度为单位指定。

另请参阅setMatrix。

[自 6.5 起] QTransform &QTransform::rotateRadians(qreal a, Qt::Axis axis, qreal distanceToPlane)

将坐标系统逆时针旋转给定的角度 a，绕指定 axis 和距离 distanceToPlane 进行旋转，并返回矩阵的引用。

注意，如果您将 QTransform 应用到在窗口坐标中定义的点，则旋转方向将是顺时针，因为 y 轴指向下方。

角度以弧度为单位指定。

如果 distanceToPlane 为零，则忽略它。这对于实现正交投影是合适的，其中应丢弃 z 坐标而不是进行投影。

此函数是在 Qt 6.5 中引入的。

另请参阅setMatrix。

QTransform &QTransform::rotateRadians(double a, Qt::Axis axis = Qt::ZAxis)

这是一个重载函数。

将坐标系统逆时针旋转给定的角度 a，绕指定 axis 和距离 1024.0 进行旋转，并返回矩阵的引用。

注意，如果您将 QTransform 应用到在窗口坐标中定义的点，则旋转方向将是顺时针，因为 y 轴指向下方。

角度以弧度为单位指定。

另请参阅setMatrix。

QTransform &QTransform::scale(double sx, double sy)

按水平方向和垂直方向分别以 sx 和 sy 缩放坐标系，并返回矩阵的引用。

另请参阅setMatrix。

void QTransform::setMatrix(double m11, double m12, double m13, double m21, double m22, double m23, double m31, double m32, double m33)

将矩阵元素设置为指定的值，即 m11、m12、m13、m21、m22、m23、m31、m32 和 m33。注意，此函数将替换之前的值。《QTransform》提供了一个方便的函数集，包括translate()、rotate()、scale() 和 shear()，用于根据当前定义的坐标系操作矩阵的不同元素。

请参见 QTransform。

QTransform &QTransform::shear(double sh, double sv)

按水平方向 sh 和垂直方向 sv 对坐标系进行倾斜，并返回矩阵的引用。

另请参阅setMatrix。

[静态] bool QTransform::squareToQuad(const QPolygonF &quad, QTransform &trans)

创建一个变换矩阵 trans，将单位正方形映射到四边形 quad。如果变换可以构造，则返回 true；如果不存在此类变换，则返回 false。

请参见 quadToSquare() 和 quadToQuad。

QTransform &QTransform::translate(double dx, double dy)

将坐标系沿 x 轴移动 dx 并沿 y 轴移动 dy，并返回矩阵的引用。

另请参阅setMatrix。

QTransform QTransform::transposed() const

返回此矩阵的转置。

QTransform::TransformationType QTransform::type() const

返回此矩阵的变换类型。

变换类型是捕获矩阵所有变换的最高枚举值。例如，如果矩阵既进行缩放又进行剪切，则类型将是 TxShear，因为 TxShear 的枚举值高于 TxScale。

了解矩阵的变换类型对优化很有用：您通常可以比处理通用情况更优化地处理特定类型。

QVariant QTransform::operator QVariant() const

返回作为 QVariant 的变换。

bool QTransform::operator!=(const QTransform &matrix) const

如果此矩阵不等于给定的 matrix，则返回 true，否则返回 false。

QTransform QTransform::operator*(const QTransform &matrix) const

返回此矩阵乘以给定 matrix 的结果。

请注意，矩阵乘法不是交换的，即 a*b != b*a。

QTransform &QTransform::operator*=(const QTransform &matrix)

这是一个重载函数。

返回此矩阵乘以给定 matrix 的结果。

QTransform &QTransform::operator*=(qreal scalar)

这是一个重载函数。

返回对给定的 scalar 执行逐元素乘法的结果。

QTransform &QTransform::operator+=(qreal scalar)

这是一个重载函数。

返回将给定的 scalar 添加到此矩阵每个元素后的矩阵。

QTransform &QTransform::operator-=(qreal scalar)

这是一个重载函数。

返回从给定 scalar 中减去此矩阵每个元素后的矩阵。

QTransform &QTransform::operator/=(qreal scalar)

这是一个重载函数。

返回对给定 scalar 执行逐元素除法的结果。

[noexcept] QTransform &QTransform::operator=(const QTransform &matrix)

将给定 matrix 的值赋给此矩阵。

bool QTransform::operator==(const QTransform &matrix) const

如果此矩阵等于给定的 matrix，则返回 true，否则返回 false。