class QVector4D#

类 QVector4D 代表了4D空间中的向量或顶点。 更多…

自版本 4.6 以来。

概要#

方法#

静态函数#

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译存在问题，也可以通过创建https:/bugreports.qt.io/projects/PYSIDE上的工单来通知我们

详细说明#

矢量是3D空间4D仿射表示的主要构建块之一。它们由四个有限的浮点坐标组成，传统上称为x、y、z和w。

QVector4D 类也可以用来表示4D空间的顶点。因此，我们不需要提供单独的顶点类。

__init__(point)#
参数:

point – QPoint

从2D point 构建具有x和y坐标的向量，并将z和w坐标设置为0。

__init__()

构建一个空向量，即坐标为(0, 0, 0, 0)。

__init__(xpos, ypos, zpos, wpos)
参数:

  • xpos – float

  • ypos – float

  • zpos – float

  • wpos – float

构建具有坐标(xpos, ypos, zpos, wpos)的向量。所有参数必须是有限的。

__init__(vector, wpos)
参数:

从指定的3D vector 构建一个4D向量。w坐标设置为wpos，它必须是有限的。

参见

toVector3D()

__init__(vector)
参数:

vector – QVector3D

从指定的3D vector 构建一个4D向量。w坐标设置为零。

参见

toVector3D()

__init__(vector)
参数:

vector – QVector2D

从指定的2D vector 构建一个4D向量。z和w坐标设置为零。

参见

toVector2D()

__init__(point)
参数:

point – QPointF

从2D point 构建具有x和y坐标的向量，并将z和w坐标设置为0。

__init__(vector, zpos, wpos)
参数:

  • vector – QVector2D

  • zpos – float

  • wpos – float

根据指定的 2D vector 构造一个 4D 向量。z 和 w 坐标分别设置为 zpos 和 wpos，各自必须是有限的。

参见

toVector2D()

__reduce__()#
返回类型：:

object

__repr__()#
返回类型：:

object

static dotProduct(v1, v2)#
参数:
返回类型：:

float

返回 v1 和 v2 的点积。

isNull()#
返回类型：:

bool

如果 x、y、z 和 w 坐标均设置为 0.0，则返回 true，否则返回 false。

length()#
返回类型：:

float

返回从原点到向量的长度。

lengthSquared()#
返回类型：:

float

返回从原点到向量的长度的平方。这相当于向量与其自身的点积。

normalize()#

就地规范化当前向量。如果这个向量是零向量或者向量的长度非常接近 1，则不执行任何操作。

normalized()#
返回类型：:

QVector4D

返回此向量的归一化单位向量形式。

如果此向量为零，则返回零向量。如果向量的长度非常接近1，则将返回该向量本身。否则，将返回长度为1的向量的归一化形式。

__ne__(v2)#
参数:

v2 – QVector4D

返回类型：:

bool

如果 v1 不等于 v2，则返回 true；否则返回 false。此运算符使用精确的浮点比较。

__mul__(v2)#
参数:

v2 – QVector4D

返回类型：:

QVector4D

返回由将 v1 的每个组件乘以 v2 的相应组件组成的 QVector4D 对象。

注意

这不是在任何意义上 v1 和 v2 的叉积。（它的组件相加等于 v1 和 v2 的点积。）

参见

operator*=()

__mul__(matrix)
参数:

matrix – QMatrix4x4

返回类型：:

QVector4D

__mul__(matrix)
参数:

matrix – QMatrix4x4

返回类型：:

QVector4D

__mul__(factor)
参数:

factor – float

返回类型：:

QVector4D

返回给定 vector 的副本，并将其乘以给定的 factor。

参见

operator*=()

__mul__(factor)
参数:

factor – float

返回类型：:

QVector4D

返回给定 vector 的副本，并将其乘以给定的 factor。

参见

operator*=()

__imul__(vector)#
参数:

vector – QVector4D

返回类型：:

QVector4D

通过将此向量的每个组件乘以 vector 的相应组件来乘以此向量，并返回对此向量的引用。

参见

operator/=() operator*()

__imul__(factor)
参数:

factor – float

返回类型：:

QVector4D

将此向量的坐标乘以给定的有限 factor，并返回对此向量的引用。

参见

operator/=() operator*()

__add__(v2)#
参数:

v2 – QVector4D

返回类型：:

QVector4D

返回一个QVector4D对象，它是给定向量v1和v2的和；每个分量都单独相加。

参见

运算符+=()

__iadd__(vector)#
参数:

vector – QVector4D

返回类型：:

QVector4D

将给定的向量加到此向量并返回对该向量的引用。

参见

运算符-=()

__sub__(v2)#
参数:

v2 – QVector4D

返回类型：:

QVector4D

返回一个QVector4D对象，该对象由从v1减去v2组成；每个分量都单独相减。

参见

运算符-=()

__sub__()
返回类型：:

QVector4D

这是一个重载函数。

返回一个由给定向量的所有三个分量取反形成的QVector4D对象。

相当于QVector4D(0,0,0,0) - vector。

__isub__(vector)#
参数:

vector – QVector4D

返回类型：:

QVector4D

从这个向量减去给定的向量并返回对该向量的引用。

参见

运算符+=()

__div__(divisor)#
参数:

除数 – QVector4D

返回类型：:

QVector4D

返回由给定向量的每个分量除以给定除数的相应分量形成的QVector4D对象。

除数必须没有任何分量为零或NaN。

参见

运算符/=()

__div__(divisor)
参数:

除数 – float

返回类型：:

QVector4D

返回由给定向量的每个分量除以给定的除数形成的QVector4D对象。

除数不能为零或NaN。

参见

运算符/=()

运算符/=(vector)
参数:

vector – QVector4D

返回类型：:

QVector4D

将此向量的每个分量除以对应的vector分量，并返回对此向量的引用。

vector不得有任何分量为零或NaN。

参见

operator*=() operator/()

operator/=(除数)
参数:

除数 – float

返回类型：:

QVector4D

将此向量的坐标除以给定的divisor，并返回对此向量的引用。divisor不得为零或NaN。

参见

operator*=()

__eq__(v2)#
参数:

v2 – QVector4D

返回类型：:

bool

如果v1等于v2，则返回true；否则返回false。此运算符使用精确的浮点数比较。

operator(i)#
参数:

i – int

返回类型：:

float

返回向量在索引位置i的分量。

i必须是向量中的有效索引位置（即，0 <= i < 4）。

setW(w)#
参数:

w – float

将此点的w坐标设置为给定的有限w坐标。

setX(x)#
参数:

x – float

将此点的x坐标设置为给定的有限x坐标。

setY(y)#
参数:

y – float

将此点的y坐标设置为给定的有限y坐标。

setZ(z)#
参数:

z – float

将此点的z坐标设置为给定的有限z坐标。

toPoint()#
返回类型：:

QPoint

返回此4D向量的QPoint形式。z和w坐标被丢弃。x和y坐标四舍五入到最接近的整数。

toPointF()#
返回类型：:

QPointF

返回此4D向量的QPointF形式。z和w坐标被丢弃。

toTuple()#
返回类型：:

object

toVector2D()#
返回类型：:

QVector2D

返回此4D向量的2D向量形式，丢弃z和w坐标。

toVector2DAffine()#
返回类型：:

QVector2D

返回此4D向量的二维向量形式，通过将x和y坐标除以w坐标，删除z坐标。如果w为零，则返回零向量。

toVector3D()#
返回类型：:

QVector3D

返回此4D向量的三维向量形式，删除w坐标。

toVector3DAffine()#
返回类型：:

QVector3D

返回此4D向量的三维向量形式，将x、y和z坐标除以w坐标。如果w为零，则返回零向量。

w()#
返回类型：:

float

返回此点的w坐标。

参见

setW() x() y() z()

x()#
返回类型：:

float

返回此点的x坐标。

参见

setX() y() z() w()

y()#
返回类型：:

float

返回此点的y坐标。

参见

setY() x() z() w()

z()#
返回类型：:

float

返回此点的z坐标。

参见

setZ() x() y() w()