PySide6.QtGui.QVector4D¶

class QVector4D¶

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

在版本4.6中添加。

概要¶

方法¶

def __init__()
def __reduce__()
def __repr__()
def isNull()
def length()
def lengthSquared()
def normalize()
def normalized()
def __ne__()
def __mul__()
def __imul__()
def __add__()
def __iadd__()
def __sub__()
def __isub__()
def __div__()
def operator/=()
def __eq__()
def operator[]()
def setW()
def setX()
def setY()
def setZ()
def toPoint()
def toPointF()
def toTuple()
def toVector2D()
def toVector2DAffine()
def toVector3D()
def toVector3DAffine()
def w()
def x()
def y()
def z()

静态函数¶

def dotProduct()

注意

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

详细描述¶

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

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

另请参阅

QQuaternion QVector2D QVector3D

__init__()¶

构造一个零向量，即坐标为 (0, 0, 0, 0)。

__init__(point)

Parameters:: 点 – QPoint

从2D point构造一个具有x和y坐标的向量，z和w坐标为0。

__init__(point)

Parameters:: 点 – QPointF

从2D point 构造一个具有x和y坐标的向量，z和w坐标为0。

__init__(vector)

Parameters:: 向量 – QVector2D

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

另请参阅

toVector2D()

__init__(vector)

Parameters:: 向量 – QVector3D

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

另请参阅

toVector3D()

__init__(vector, wpos)

Parameters:

向量 – QVector3D
wpos – 浮点数

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

另请参阅

toVector3D()

__init__(vector, zpos, wpos)

Parameters:

vector – QVector2D
zpos – 浮点数
wpos – 浮点数

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

另请参阅

toVector2D()

__init__(xpos, ypos, zpos, wpos)

Parameters:

xpos – 浮点数
ypos – 浮点数
zpos – 浮点数
wpos – 浮点数

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

__reduce__()¶

Return type:: 字符串

__repr__()¶

Return type:: 字符串

static dotProduct(v1, v2)¶

Parameters:

v1 – QVector4D
v2 – QVector4D

Return type:

浮点数

返回v1和v2的点积。

isNull()¶

Return type:: 布尔

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

length()¶

Return type:: 浮点数

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

另请参阅

lengthSquared() normalized()

lengthSquared()¶

Return type:: 浮点数

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

另请参阅

length() dotProduct()

normalize()¶

将当前向量就地归一化。如果该向量是零向量或向量的长度非常接近1，则不会发生任何变化。

另请参阅

length() normalized()

normalized()¶

Return type:: QVector4D

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

如果这个向量为空，则返回一个空向量。如果向量的长度非常接近1，则向量将按原样返回。否则，将返回长度为1的向量的归一化形式。

另请参阅

length() normalize()

__ne__(v2)¶

Parameters:: v2 – QVector4D
Return type:: 布尔

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

__mul__(v2)¶

Parameters:: v2 – QVector4D
Return type:: QVector4D

返回通过将v1的每个分量与v2的相应分量相乘形成的QVector4D对象。

注意

这不是v1和v2的叉积。（它的分量加起来等于v1和v2的点积。）

另请参阅

operator*=()

__mul__(matrix)

Parameters:: 矩阵 – QMatrix4x4
Return type:: QVector4D

__mul__(matrix)

Parameters:: 矩阵 – QMatrix4x4
Return type:: QVector4D

__mul__(factor)

Parameters:: factor – 浮点数
Return type:: QVector4D

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

另请参阅

operator*=()

__mul__(factor)

Parameters:: factor – 浮点数
Return type:: QVector4D

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

另请参阅

operator*=()

__imul__(vector)¶

Parameters:: 向量 – QVector4D
Return type:: QVector4D

将此向量的每个分量与vector的相应分量相乘，并返回对此向量的引用。

另请参阅

operator/=() operator*()

__imul__(factor)

Parameters:: factor – 浮点数
Return type:: QVector4D

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

另请参阅

operator/=() operator*()

__add__(v2)¶

Parameters:: v2 – QVector4D
Return type:: QVector4D

返回一个QVector4D对象，该对象是给定向量v1和v2的和；每个分量分别相加。

另请参阅

operator+=()

__iadd__(vector)¶

Parameters:: 向量 – QVector4D
Return type:: QVector4D

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

另请参阅

operator-=()

__sub__()¶

Return type:: QVector4D

这是一个重载函数。

返回一个QVector4D对象，该对象是通过改变给定vector的所有三个分量的符号形成的。

等同于 QVector4D(0,0,0,0) - vector。

__sub__(v2)

Parameters:: v2 – QVector4D
Return type:: QVector4D

返回一个QVector4D对象，该对象是通过从v1中减去v2形成的；每个分量分别相减。

另请参阅

operator-=()

__isub__(vector)¶

Parameters:: 向量 – QVector4D
Return type:: QVector4D

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

另请参阅

operator+=()

__div__(divisor)¶

Parameters:: 除数 – QVector4D
Return type:: QVector4D

返回通过将给定vector的每个分量除以给定divisor的相应分量形成的QVector4D对象。

divisor 不能包含任何为零或 NaN 的组件。

另请参阅

operator/=()

__div__(divisor)

Parameters:: 除数 – float
Return type:: QVector4D

返回通过将给定vector的每个分量除以给定divisor形成的QVector4D对象。

divisor 不能为零或 NaN。

另请参阅

operator/=()

operator/=(vector)

Parameters:: 向量 – QVector4D
Return type:: QVector4D

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

vector 必须没有任何一个分量为零或NaN。

另请参阅

operator*=() operator/()

operator/=(divisor)

Parameters:: 除数 – float
Return type:: QVector4D

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

另请参阅

operator*=()

__eq__(v2)¶

Parameters:: v2 – QVector4D
Return type:: 布尔

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

operator(i)¶

Parameters:: i – 整数
Return type:: 浮点数

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

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

setW(w)¶

Parameters:: w – 浮点数

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

另请参阅

w() setX() setY() setZ()

setX(x)¶

Parameters:: x – 浮点数

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

另请参阅

x() setY() setZ() setW()

setY(y)¶

Parameters:: y – 浮点数

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

另请参阅

y() setX() setZ() setW()

setZ(z)¶

Parameters:: z – 浮点数

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

另请参阅

z() setX() setY() setW()

toPoint()¶

Return type:: QPoint

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

另请参阅

toPointF() toVector2D()

toPointF()¶

Return type:: QPointF

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

另请参阅

toPoint() toVector2D()

toTuple()¶

Return type:: 对象

toVector2D()¶

Return type:: QVector2D

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

另请参阅

toVector2DAffine() toVector3D() toPoint()

toVector2DAffine()¶

Return type:: QVector2D

返回此4D向量的2D向量形式，将x和y坐标除以w坐标并丢弃z坐标。如果w为零，则返回一个空向量。

另请参阅

toVector2D() toVector3DAffine() toPoint()

toVector3D()¶

Return type:: QVector3D

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

另请参阅

toVector3DAffine() toVector2D() toPoint()

toVector3DAffine()¶

Return type:: QVector3D

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

另请参阅

toVector3D() toVector2DAffine() toPoint()

w()¶

Return type:: 浮点数

返回此点的w坐标。

另请参阅

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

x()¶

Return type:: 浮点数

返回此点的x坐标。

另请参阅

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

y()¶

Return type:: 浮点数

返回此点的 y 坐标。

另请参阅

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

z()¶

Return type:: 浮点数

返回此点的z坐标。

另请参阅

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