QTransform Class

成员函数文档

QTransform::QTransform()

构建单位矩阵。

除m11 、m22 （指定缩放因子）和m33 外，所有元素均设为零，上述三个元素均设为1。

另请参阅 reset()。

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

构建一个矩阵，其元素分别为：m11 、m12 、m21 、m22 、dx 和dy 。

另请参阅 setMatrix()。

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()。

[constexpr noexcept default] QTransform::QTransform(const QTransform &other)

复制并构造一个QTransform 的实例。

[constexpr noexcept default] QTransform::QTransform(QTransform &&other)

通过“Move”操作构造一个QTransform 的实例。

qreal QTransform::m11() const

返回水平缩放因子。

另请参阅 scale() 和Basic Matrix Operations 。

qreal QTransform::m12() const

返回垂直剪切因子。

另请参阅 shear() 和Basic Matrix Operations 。

qreal QTransform::m13() const

返回水平投影因子。

另请参阅 translate() 和Basic Matrix Operations 。

qreal QTransform::m21() const

返回水平剪切系数。

另请参阅 shear() 和Basic Matrix Operations 。

qreal QTransform::m22() const

返回垂直缩放因子。

另请参阅 scale() 和Basic Matrix Operations 。

qreal QTransform::m23() const

返回垂直投影因子。

另请参阅 translate() 和Basic Matrix Operations 。

qreal QTransform::m31() const

返回水平平移因子。

另请参阅 dx()、translate() 以及Basic Matrix Operations 。

qreal QTransform::m32() const

返回垂直平移因子。

另请参阅 dy()、translate() 以及Basic Matrix Operations 。

qreal QTransform::m33() const

返回除数。

另请参阅 translate() 和Basic Matrix Operations 。

QTransform QTransform::adjoint() const

返回该矩阵的伴随矩阵。

qreal QTransform::determinant() const

返回矩阵的行列式。

qreal QTransform::dx() const

返回水平平移因子。

另请参阅 m31()、translate() 以及Basic Matrix Operations 。

qreal QTransform::dy() const

返回垂直平移因子。

另请参阅 translate() 和Basic Matrix Operations 。

[static] QTransform QTransform::fromScale(qreal sx, qreal sy)

创建一个矩阵，其缩放比例为水平方向sx ，垂直方向sy 。这与QTransform().scale(sx, sy)的效果相同，但速度略快一些。

[static] 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') 为变换后的点。

另请参阅 Basic Matrix Operations 。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

如果使用了旋转或剪切操作，调用此方法的开销可能会相当大。

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()和Basic Matrix Operations 。

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() 和Basic Matrix Operations 。

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

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

这是一个将quadToSquare() 和squareToQuad() 方法结合在一起的便捷方法。它允许将输入的四边形转换为任何其他四边形。

另请参阅 squareToQuad() 和quadToSquare()。

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

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

另请参阅 squareToQuad() 和quadToQuad()。

void QTransform::reset()

将矩阵重置为单位矩阵，即所有元素均设为零，但m11 和m22 （用于指定缩放因子）以及m33 除外，这些元素均设为 1。

另请参阅 QTransform()、isIdentity() 和Basic Matrix Operations 。

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

将坐标系围绕指定点axis （距离屏幕distanceToPlane 处）以给定角度a 逆时针旋转，并返回矩阵的引用。

请注意，如果将QTransform 应用于以控件坐标定义的点，由于y轴指向下方，因此旋转方向将为顺时针。

角度以度为单位指定。

如果distanceToPlane 为零，则会被忽略。这适用于实现正交投影，在这种情况下，z 坐标应被舍弃而非投影。

该函数在 Qt 6.5 中引入。

另请参阅 setMatrix()。

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

将坐标系围绕距离屏幕 1024.0 处的指定点axis ，以给定角度a 逆时针旋转，并返回矩阵的引用。

请注意，如果将QTransform 应用于以控件坐标定义的点，由于y轴指向下方，因此旋转方向将为顺时针。

角度以度为单位。

另请参阅 setMatrix 。

[since 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(qreal a, Qt::Axis axis = Qt::ZAxis)

将坐标系围绕距离屏幕1024.0处的指定axis 点，以给定角度a 逆时针旋转，并返回该矩阵的引用。

请注意，如果将QTransform 应用于以控件坐标定义的点，由于y轴指向下方，因此旋转方向将是顺时针的。

角度以弧度为单位。

另请参阅 setMatrix()。

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

将坐标系按水平方向sx 和垂直方向sy 进行缩放，并返回该矩阵的引用。

另请参阅 setMatrix()。

void QTransform::setMatrix(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 。请注意，此函数会覆盖原有的值。QTransform 提供了translate()、rotate()、scale() 和shear() 这些便捷函数，用于根据当前定义的坐标系操作各种矩阵元素。

另请参阅 QTransform()。

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

将坐标系按sh 水平剪切，按sv 垂直剪切，并返回该矩阵的引用。

另请参阅 setMatrix()。

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

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

另请参阅 quadToSquare() 和quadToQuad()。

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

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

另请参见 setMatrix()。

QTransform QTransform::transposed() const

返回该矩阵的转置。

QTransform::TransformationType QTransform::type() const

返回该矩阵的变换类型。

变换类型是涵盖该矩阵所有变换操作的最高枚举值。例如，如果该矩阵同时进行缩放和剪切操作，则其类型为TxShear ，因为TxShear 的枚举值高于TxScale 。

了解矩阵的变换类型对于优化非常有用：通常处理特定类型比处理通用情况更有效。

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 default] QTransform &QTransform::operator=(QTransform &&other)

将other 通过“move-assign”操作赋值给此QTransform 实例。

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

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

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

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