Back to Qt.io
Contact Us Blog Download Qt
本页内容

vector3d QML Value Type

一个具有 x、y 和 z 属性的值。更多...

Import Statement: import QtQuick

详细说明

vector3d 类型指具有x 、y 和z 属性的值。

vector3d 类型的属性默认具有零向量。此时，x 、y 和z 均设置为0 。

要创建一个 `vector3d ` 值，请将其指定为“x,y,z”字符串：

Rotation { angle: 60; axis: "0,1,0" }

或使用Qt.vector3d() 函数：

Rotation { angle: 60; axis: Qt.vector3d(0, 1, 0) }

或者作为独立的x 、y 和z 分量：

Rotation { angle: 60; axis.x: 0; axis.y: 1; axis.z: 0 }

vector3d 值的每个属性在内部都以单精度浮点数（float ）的形式存储。

在与 C++ 集成时，请注意：从 C++ 传递到 QML的任何QVector3D 值都会自动转换为vector3d 值，反之亦然。

vector3d 类型具有以下可在 QML 中调用的幂等函数：

函数签名描述示例
vector3d crossProduct(vector3d other)返回向量 `this ` 与向量 `other ` 进行叉积运算后得到的 `vector3d` 结果
var a = Qt.vector3d(1,2,3);
var b = Qt.vector3d(4,5,6);
var c = a.crossProduct(b);
console.log(c.toString()); // QVector3D(-3, 6, -3)
real dotProduct(vector3d other)返回this vector3d与other vector3d的点积结果，该结果为标量real类型
var a = Qt.vector3d(1,2,3);
var b = Qt.vector3d(4,5,6);
var c = a.dotProduct(b);
console.log(c); // 32
vector3d times(matrix4x4 matrix)返回将this 向量3D与4x4矩阵matrix 进行变换后得到的向量3D结果，该矩阵在向量后应用
var a = Qt.vector3d(1,2,3);
var b = Qt.matrix4x4(4,5,6,7,8,9,10,11,
                     12,13,14,15,16,17,18,19);
var c = a.times(b);
console.log(c.toString());
// QVector3D(0.774194, 0.849462, 0.924731)
vector3d times(vector3d other)返回将this 向量3d与other 向量3d相乘后得到的向量3d结果
var a = Qt.vector3d(1,2,3);
var b = Qt.vector3d(4,5,6);
var c = a.times(b);
console.log(c.toString()); // QVector3D(4, 10, 18)
vector3d times(real factor)返回将this 向量与标量相乘后的vector3d结果factor
var a = Qt.vector3d(1,2,3);
var b = 4.48;
var c = a.times(b);
console.log(c.toString()); // QVector3D(4.48, 8.96, 13.44)
vector3d plus(vector3d other)返回将this 向量3d与other 向量3d相加得到的向量3d结果
var a = Qt.vector3d(1,2,3);
var b = Qt.vector3d(4,5,6);
var c = a.plus(b);
console.log(c.toString()); // QVector3D(5, 7, 9)
vector3d minus(vector3d other)返回从 `other vector3d` 中减去 `this vector3d` 后的 `vector3d` 结果
var a = Qt.vector3d(1,2,3);
var b = Qt.vector3d(4,5,6);
var c = a.minus(b);
console.log(c.toString()); // QVector3D(-3, -3, -3)
vector3d normalized()返回this 向量的归一化形式
var a = Qt.vector3d(1,2,3);
var b = a.normalized();
console.log(b.toString());
// QVector3D(0.267261, 0.534522, 0.801784)
real length()返回this 向量3D长度的标量实数值
var a = Qt.vector3d(1,2,3);
var b = a.length();
console.log(b.toString()); // 3.7416573867739413
vector2d toVector2d()返回将this 向量3d转换为向量2d后的结果
var a = Qt.vector3d(1,2,3);
var b = a.toVector2d();
console.log(b.toString()); // QVector2D(1, 2)
vector4d toVector4d()返回将this vector3d 转换为 vector4d 后的结果
var a = Qt.vector3d(1,2,3);
var b = a.toVector4d();
console.log(b.toString()); // QVector4D(1, 2, 3, 0)
bool fuzzyEquals(vector3d other, real epsilon)other如果this 的vector3d与other 的vector3d近似相等，则返回true。当this 的每个属性都处于epsilon 范围内时，该近似关系成立。请注意，epsilon 是可选参数，默认值epsilon 为0.00001。
var a = Qt.vector3d(1,2,3);
var b = Qt.vector3d(1.0001, 1.9998, 2.0001);
var c = a.fuzzyEquals(b);        // default epsilon
var d = a.fuzzyEquals(b, 0.005); // supplied epsilon
console.log(c + " " + d); // false true

该值类型由QtQuick 导入提供。

另请参阅 QML 值类型。

© 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.