本页内容

transform2d QML Value Type

提供 transform2d 类型,即一个 3x3 的 2D 变换矩阵,对应于QTransform 。更多内容...

Import Statement: import QtCanvas2D
Since: Qt 6.12
Status: Technology preview

该类型处于技术预览阶段,内容可能会有变动。

方法

详细说明

transform2d 类型有九个值,在 QML 中可通过属性m11 至m33 访问(按行/列顺序)。

transform2d 类型的属性默认值为单位矩阵,其对角线元素m11 、m22 和m33 均为1 ,其余所有分量均为0 。

该值类型由QtCanvas2D 导入提供。

另请参阅 QTransform 。

方法文档

real m11()

返回水平缩放因子。

real m12()

返回垂直剪切系数。

real m13()

返回水平投影因子。

real m21()

返回水平剪切系数。

real m22()

返回垂直缩放因子。

real m23()

返回垂直投影因子。

real m31()

返回水平平移因子。

real m32()

返回垂直平移系数。

real m33()

返回除数。

real determinant()

返回此 transform2d 的行列式。

transform2d inverted()

如果该 transform2d 的逆矩阵存在,则返回该逆矩阵;否则返回单位矩阵。

void reset()

将矩阵重置为单位矩阵,即所有元素均设为零,但 m11、m22(用于指定缩放比例)和 m33 除外,这三个元素设为 1。

void rotate(real angle)

将坐标系按给定的angle (单位为度)逆时针旋转。

void rotateRadians(real angle)

将坐标系按给定的angle (以弧度为单位)逆时针旋转。

void scale(real scale)

将坐标系按scale 的比例同时在水平和垂直方向上缩放。

void scale(real sx, real sy)

将坐标系按水平方向sx 和垂直方向sy 进行缩放。

void setMatrix(real m11, real m12, real m21, real m22, real m31, real m32)

将矩阵元素设置为指定值:m11 、m12 、m21 、m22 、m31 和m32 。请注意,此函数会覆盖原有的值。

void setMatrix(real m11, real m12, real m13, real m21, real m22, real m23, real m31, real m32, real m33)

将矩阵元素设置为指定值:m11 、m12 、m13 、m21 、m22 、m23 、m31 、m32 和m33 。请注意,此函数会覆盖原有的值。

void shear(real sh, real sv)

将坐标系沿水平方向按sh 进行剪切,沿垂直方向按sv 进行剪切。

transform2d times(real factor)

返回将此 transform2d 与标量factor 相乘后得到的 transform2d 结果。

transform2d times(transform2d other)

返回将此 transform2d 与 transform2dother 相乘所得的 transform2d 结果。

void translate(real dx, qreal dy)

将坐标系沿x轴移动dx ,沿y轴移动dy 。

transform2d transposed()

返回此 transform2d 的转置。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.