跳至正文
版本:最新版 - a1.156.0 ⚖️

📏 Vector2D

由浮点精度组件 (X, Y) 组成的 2D 向量。主要用于 HUD 和屏幕绘制。


🎒 示例​

local new_vector = Vector2D(1452.5, 512)

🛠 构造函数​

Default Constructor​

No description provided

local my_vector2d = Vector2D(X?, Y?)

Parameters

TypeNameDefaultDescription
floatX0X 坐标
floatYXY 坐标

🧽 属性​

TypeNameDescription
floatXX 坐标
floatYY 坐标

🦠 函数​

信息

This structure supports +, -, *, /, ==, unary - (negation) and tostring operations.

ReturnsNameDescription
floatDistance两点之间的距离
floatDistanceSquared两点之间的平方距离
booleanIsNear高效检查向量是否在指定半径内接近另一个向量
floatSize获取该向量的长度(模长)
floatSizeSquared获取该向量的平方长度
floatDot两个向量的点积
floatCross两个向量的叉积
Vector2DLerp在此向量与另一个向量之间进行线性插值

Optimal

Distance​

返回 2 个向量之间的距离
local ret = my_vector2d:Distance(other)

Parameters

TypeParameterDefaultDescription
Vector2Dother Required parameter 要获取距离的另一个向量

Returns

TypeDescription
float向量之间的距离

Optimal

DistanceSquared​

返回 2 个向量之间的平方距离
local ret = my_vector2d:DistanceSquared(other)

Parameters

TypeParameterDefaultDescription
Vector2Dother Required parameter 要获取平方距离的另一个向量

Returns

TypeDescription
float向量之间的平方距离

Optimal

IsNear​

高效检查向量是否在指定半径内接近另一个向量
local ret = my_vector2d:IsNear(other, radius)

Parameters

TypeParameterDefaultDescription
Vector2Dother Required parameter 要对比的向量
floatradius Required parameter 要检查的半径范围

Returns

TypeDescription
boolean该向量是否接近另一个向量

Optimal

Size​

获取该向量的长度(模长)
local ret = my_vector2d:Size()

Returns

TypeDescription
float向量的长度

Optimal

SizeSquared​

获取该向量的平方长度
local ret = my_vector2d:SizeSquared()

Returns

TypeDescription
float向量的平方长度

Optimal

Dot​

返回该向量与另一个向量之间的点积
local ret = my_vector2d:Dot(other)

Parameters

TypeParameterDefaultDescription
Vector2Dother Required parameter 要进行点积的点

Returns

TypeDescription
float点积结果

Optimal

Cross​

返回此向量与另一个向量之间的叉积,对于 2D 向量,该值为标量
local ret = my_vector2d:Cross(other)

Parameters

TypeParameterDefaultDescription
Vector2Dother Required parameter 要进行叉积的向量

Returns

TypeDescription
float叉积结果

Optimal

Lerp​

根据给定的 Alpha 值返回此向量与另一个向量之间的线性插值结果
local ret = my_vector2d:Lerp(other, alpha)

Parameters

TypeParameterDefaultDescription
Vector2Dother Required parameter 要插值到的目标向量
floatalpha Required parameter 插值 Alpha 值,设为 0 返回当前向量,设为 1 返回目标向量

Returns

TypeDescription
Vector2D插值后的向量