class QVector2D#

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

新增于版本 4.6。

概述#

方法#

静态函数#

注意

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

详细说明#

向量是二维表示和绘图的主要构建模块之一。它由两个有限的浮点坐标组成，通常称为x和y。

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

__init__(point)#
参数：

point – QPoint

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

__init__()

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

__init__(xpos, ypos)
参数：

  • xpos – float

  • ypos – float

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

__init__(vector)
参数：

vector – QVector4D

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

另请参阅

toVector4D()

__init__(point)
参数：

point – QPointF

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

__init__(vector)
参数：

vector – QVector3D

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

另请参阅

toVector3D()

__reduce__()#
返回类型：

对象

__repr__()#
返回类型：

对象

distanceToLine(point, direction)#
参数：
返回类型：

float

返回这个顶点距离通过 point 点和单位向量 direction 定义的直线的距离。

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

另请参阅

distanceToPoint()

distanceToPoint(point)#
参数：

point – QVector2D

返回类型：

float

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

另请参阅

distanceToLine()

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

float

返回 v1 和 v2 的点积。

isNull()#
返回类型：

bool

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

length()#
返回类型：

float

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

lengthSquared()#
返回类型：

float

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

另请参阅

length() dotProduct()

normalize()#

就地标准化当前向量。如果该向量是零向量或者向量的长度非常接近于 1，则不执行任何操作。

另请参阅

length() normalized()

normalized()#
返回类型：

QVector2D

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

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

另请参阅

length() normalize()

__ne__(v2)#
参数：

v2 – QVector2D

返回类型：

bool

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

__mul__(v2)#
参数：

v2 – QVector2D

返回类型：

QVector2D

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

注意

这在任何意义上都不是 v1 和 v2 的叉积。 (其分量相加等于 v1 和 v2 的点积。)

另请参阅

operator*=()

__mul__(factor)
参数：

factor – float

返回类型：

QVector2D

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

另请参阅

operator*=()

__mul__(factor)
参数：

factor – float

返回类型：

QVector2D

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

另请参阅

operator*=()

__imul__(factor)#
参数：

factor – float

返回类型：

QVector2D

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

另请参阅

operator/=() operator*()

__imul__(vector)
参数：

vector – QVector2D

返回类型：

QVector2D

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

注意

这不是此向量与 vector 的叉积。 (其分量相加等于此向量与 vector 的点积。)

另请参阅

operator/=() operator*()

__add__(v2)#
参数：

v2 – QVector2D

返回类型：

QVector2D

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

另请参阅

operator+=()

__iadd__(vector)#
参数：

vector – QVector2D

返回类型：

QVector2D

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

另请参阅

operator-=()

__sub__()#
返回类型：

QVector2D

这是一个重载函数。

返回一个由给定 vector 的每个分量符号变换组成的 QVector2D 对象。

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

__sub__(v2)
参数：

v2 – QVector2D

返回类型：

QVector2D

返回一个由从 v1 减去 v2 形成的 QVector2D 对象；每个分量分别相减。

另请参阅

operator-=()

__isub__(vector)#
参数：

vector – QVector2D

返回类型：

QVector2D

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

另请参阅

operator+=()

__div__(divisor)#
参数：

divisor – QVector2D

返回类型：

QVector2D

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

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

另请参阅

operator/=()

__div__(divisor)
参数：

divisor – float

返回类型：

QVector2D

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

除数不能为零或 NaN。

另请参阅

operator/=()

operator/=(vector)
参数：

vector – QVector2D

返回类型：

QVector2D

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

向量中不能有任何零或NaN的分量。

另请参阅

operator*=() operator/()

operator/=(除数)
参数：

divisor – float

返回类型：

QVector2D

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

另请参阅

operator*=()

__eq__(v2)
参数：

v2 – QVector2D

返回类型：

bool

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

operator(i)
参数：

i – 整数

返回类型：

float

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

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

setX(x)
参数：

x – float

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

另请参阅

x() setY()

setY(y)
参数：

y – float

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

另请参阅

y() setX()

toPoint()
返回类型：

QPoint

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

另请参阅

toPointF() toVector3D()

toPointF()
返回类型：

QPointF

返回此2D向量的QPointF形式。

另请参阅

toPoint() toVector3D()

toTuple()#
返回类型：

对象

toVector3D()#
返回类型：

QVector3D

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

另请参阅

toVector4D() toPoint()

toVector4D()#
返回类型：

QVector4D

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

另请参阅

toVector3D() toPoint()

x()#
返回类型：

float

返回此点的 x 坐标。

另请参阅

setX() y()

y()#
返回类型：

float

返回此点的 y 坐标。

另请参阅

setY() x()