PySide6.QtGui.QVector2D¶

class QVector2D¶

QVector2D 类表示二维空间中的向量或顶点。更多…

在版本4.6中添加。

概要¶

方法¶

def __init__()
def __reduce__()
def __repr__()
def distanceToLine()
def distanceToPoint()
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 setX()
def setY()
def toPoint()
def toPointF()
def toTuple()
def toVector3D()
def toVector4D()
def x()
def y()

静态函数¶

def dotProduct()

注意

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

详细描述¶

向量是2D表示和绘图的主要构建块之一。它们由两个有限的浮点坐标组成，传统上称为x和y。

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

另请参阅

QVector3D QVector4D QQuaternion

__init__()¶

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

__init__(point)

Parameters:: 点 – QPoint

从2D point 构造一个具有x和y坐标的向量。

__init__(point)

Parameters:: 点 – QPointF

从2D point 构造一个具有x和y坐标的向量。

__init__(vector)

Parameters:: 向量 – QVector3D

从3D vector 构造一个具有x和y坐标的向量。vector 的z坐标被丢弃。

另请参阅

toVector3D()

__init__(vector)

Parameters:: 向量 – QVector4D

从3D vector 构造一个具有x和y坐标的向量。vector 的z和w坐标被丢弃。

另请参阅

toVector4D()

__init__(xpos, ypos)

Parameters:

xpos – 浮点数
ypos – 浮点数

构造一个坐标为 (xpos, ypos) 的向量。两个坐标必须是有限的。

__reduce__()¶

Return type:: 字符串

__repr__()¶

Return type:: 字符串

distanceToLine(point, direction)¶

Parameters:

点 – QVector2D
direction – QVector2D

Return type:

浮点数

返回此顶点与由point和单位向量direction定义的直线之间的距离。

如果 direction 是一个零向量，那么它不定义一条线。在这种情况下，返回从 point 到这个顶点的距离。

另请参阅

distanceToPoint()

distanceToPoint(point)¶

Parameters:: 点 – QVector2D
Return type:: 浮点数

返回从该顶点到由顶点point定义的点的距离。

另请参阅

distanceToLine()

static dotProduct(v1, v2)¶

Parameters:

v1 – QVector2D
v2 – QVector2D

Return type:

浮点数

返回v1和v2的点积。

isNull()¶

Return type:: 布尔

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

length()¶

Return type:: 浮点数

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

另请参阅

lengthSquared() normalized()

lengthSquared()¶

Return type:: 浮点数

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

另请参阅

length() dotProduct()

normalize()¶

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

另请参阅

length() normalized()

normalized()¶

Return type:: QVector2D

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

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

另请参阅

length() normalize()

__ne__(v2)¶

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

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

__mul__(v2)¶

Parameters:: v2 – QVector2D
Return type:: QVector2D

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

注意

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

另请参阅

operator*=()

__mul__(factor)

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

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

另请参阅

operator*=()

__mul__(factor)

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

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

另请参阅

operator*=()

__imul__(vector)¶

Parameters:: 向量 – QVector2D
Return type:: QVector2D

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

注意

这不是这个向量与vector的叉积。（它的分量加起来等于这个向量与vector的点积。）

另请参阅

operator/=() operator*()

__imul__(factor)

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

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

另请参阅

operator/=() operator*()

__add__(v2)¶

Parameters:: v2 – QVector2D
Return type:: QVector2D

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

另请参阅

operator+=()

__iadd__(vector)¶

Parameters:: 向量 – QVector2D
Return type:: QVector2D

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

另请参阅

operator-=()

__sub__()¶

Return type:: QVector2D

这是一个重载函数。

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

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

__sub__(v2)

Parameters:: v2 – QVector2D
Return type:: QVector2D

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

另请参阅

operator-=()

__isub__(vector)¶

Parameters:: 向量 – QVector2D
Return type:: QVector2D

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

另请参阅

operator+=()

__div__(divisor)¶

Parameters:: 除数 – QVector2D
Return type:: QVector2D

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

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

另请参阅

operator/=()

__div__(divisor)

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

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

divisor 不能为零或 NaN。

另请参阅

operator/=()

operator/=(vector)

Parameters:: 向量 – QVector2D
Return type:: QVector2D

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

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

另请参阅

operator*=() operator/()

operator/=(divisor)

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

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

另请参阅

operator*=()

__eq__(v2)¶

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

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

operator(i)¶

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

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

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

setX(x)¶

Parameters:: x – 浮点数

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

另请参阅

x() setY()

setY(y)¶

Parameters:: y – 浮点数

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

另请参阅

y() setX()

toPoint()¶

Return type:: QPoint

返回此二维向量的QPoint形式。每个坐标都四舍五入到最接近的整数。

另请参阅

toPointF() toVector3D()

toPointF()¶

Return type:: QPointF

返回此二维向量的QPointF形式。

另请参阅

toPoint() toVector3D()

toTuple()¶

Return type:: 对象

toVector3D()¶

Return type:: QVector3D

返回此2D向量的3D形式，z坐标设置为零。

另请参阅

toVector4D() toPoint()

toVector4D()¶

Return type:: QVector4D

返回此2D向量的4D形式，z和w坐标设置为零。

另请参阅

toVector3D() toPoint()

x()¶

Return type:: 浮点数

返回此点的x坐标。

另请参阅

setX() y()

y()¶

Return type:: 浮点数

返回此点的 y 坐标。

另请参阅

setY() x()