QTransform Class

成员函数文档

QTransform::QTransform()

构造一个身份矩阵。

除了m11 和m22 （指定刻度）以及m33 设置为 1 外，所有元素都设置为 0。

另请参见 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() 。

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)

创建一个矩阵，对应于dx 沿 x 轴平移和dy 沿 y 轴平移。这与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 外，所有元素均设置为 0。

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

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

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

请注意，如果将QTransform 应用于以 widget 坐标定义的点，旋转方向将是顺时针，因为 Y 轴指向下方。

角度以度为单位指定。

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

此函数在 Qt 6.5 中引入。

另请参阅 setMatrix().

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

这是一个重载函数。

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

请注意，如果将QTransform 应用于以 widget 坐标定义的点，旋转方向将是顺时针，因为 Y 轴指向下方。

角度以度为单位指定。

另请参阅 setMatrix 。

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

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

请注意，如果将QTransform 应用于以 widget 坐标定义的点，旋转方向将是顺时针，因为 Y 轴指向下方。

角度的单位是弧度。

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

此函数在 Qt 6.5 中引入。

另请参见 setMatrix()。

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

这是一个重载函数。

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

请注意，如果将QTransform 应用于以 widget 坐标定义的点，旋转方向将是顺时针，因为 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 。

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

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 。