引擎

指南教程参考资源艺术设计

Vector3

显示已弃用

*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按此处。

Datatype.Vector3 数据类型表示 3D 空间中的向量，通常用于在 3D 空间中的点或是长方体的尺寸。Datatype.

一些示例使用 Vector3 的例子是 Position 、 Rotation 和 1> Class.BasePart.Size|Size1> 零件，例如：


local part = workspace.Part
part.Position = part.Position + Vector3.new(5, 2, 10)  -- Move part by (5, 2, 10)

Vector3 还常用于建造更复杂的 3D 数据类型，例如 CFrame 。许多数据类型的方法都会使用 Vector3 在其参数中，例如 0> Datatype.CFrame:PointToObjectSpace()0> 。

概要

构造工具

new(x : number,y : number,z : number)
从给定的 x、y 和 z 组件中返回一个新的 Vector3。
FromNormalId(normal : Enum.NormalId)
在指定方向返回一个新的 Vector3。
FromAxis(axis : Enum.Axis)
为所指轴返回一个新的 Vector3。

属性

zero:Vector3
一个 Vector3 拥有零度。
one:Vector3
一个 Vector3 值 1 在每个轴上。
xAxis:Vector3
一个 Vector3 值 1 在 X 轴上。
yAxis:Vector3
一个 Vector3 值 1 在 Y 轴上。
zAxis:Vector3
一个 Vector3 值 1 在 Z 轴上。
X:number
Vector3 的 x 坐标。
Y:number
Vector3 的 y 坐标。
Z:number
Vector3 的 z 坐标。
Magnitude:number
Vector3 的长度。
Unit:Vector3
一个普通化的副本 Vector3 - 一个具有与原始版相同的方向，但是具有 1 的量级。

方法

Abs():Vector3
从原始部件的绝对值中返回一个新的向量。
Ceil():Vector3
从原件的天花板中返回一个新的向量。
Floor():Vector3
从原始部件的地板上返回一个新的向量。
Sign():Vector3
从原始部件的标志 (-1、0 或 1) 返回一个新的向量。
Cross(other : Vector3):Vector3
返回两个向量的交叉产品。
Angle(other : Vector3,axis : Vector3):number
将角度在 radian 之间返回。如果您提供轴，它将确定角度的方向。
Dot(other : Vector3):number
返回两个向量的缩放点产品。
FuzzyEq(other : Vector3,epsilon : number):bool
如果其他 true 的 X、Y 和 Z 部件在每个相应的组件的 epsilon 单位内，则返回 Vector3 。
Lerp(goal : Vector3,alpha : number):Vector3
在此 Vector3 和指定的目标之间返回一个直线的 Vector3。
Max(vector : Vector3):Vector3
返回一个 Vector3 用于每个组件，其中每个组件的最高值都来自提供的两个 Vector3 对象。
Min(vector : Vector3):Vector3
返回一个 Vector3 用于每个组件，作为提供的 Vector3 对象之间最低的。

数学算式

Vector3 + Vector3
通过将第一个向量的每个组成部分添加到第二个组成部分相应的部分来生成一个 Vector3。
Vector3 - Vector3
通过减去第二向量的每个组成部分来生产一个 Vector3 。
Vector3 * Vector3
通过将第一个向量的每个组成部分乘以相应的第二个组成部分产生一个 Vector3。
Vector3 / Vector3
通过将第一个向量的每个组成部分分割为第二组成部分相应的部分产生一个 Vector3。
Vector3 // Vector3
通过 Vector3 由楼层分隔每个组件的第一个向量的相应部分来生成一个 Datatype.Vector3 。
Vector3 * number
通过将提供的 вектор的每个组成部分乘以数量产生一个 Vector3。
Vector3 / number
通过将提供的 вектор的每个组成部分分数为Vector3生成一个。
Vector3 // number
通过 Vector3 每个组件的提供 vector 生成一个 Datatype.Vector3。

构造工具

new

使用 x, y 和 z 组件返回一个新的 Vector3。

参数

默认值：0

默认值：0

默认值：0

FromNormalId

在指定方向返回一个新的 Vector3。

参数

normal: Enum.NormalId

FromAxis

为所指轴返回一个新的 Vector3。

参数

axis: Enum.Axis

属性

zero

一个 Vector3 拥有零度。

此 API 成员是一个常量，必须通过 Vector3 全球访问，而不是通过单个 Vector3 对象。


print(Vector3.zero) --> 0, 0, 0

one

一个 Vector3 值 1 在每个轴上。

此 API 成员是一个常量，必须通过 Vector3 全球访问，而不是通过单个 Vector3 对象。


print(Vector3.one)  --> 1, 1, 1

xAxis

一个 Vector3 值 1 在 X 轴上。

此 API 成员是一个常量，必须通过 Vector3 全球访问，而不是通过单个 Vector3 对象。


print(Vector3.xAxis)  --> 1, 0, 0

yAxis

一个 Vector3 值 1 在 Y 轴上。

此 API 成员是一个常量，必须通过 Vector3 全球访问，而不是通过单个 Vector3 对象。


print(Vector3.yAxis)  --> 0, 1, 0

zAxis

一个 Vector3 值 1 在 Z 轴上。

此 API 成员是一个常量，必须通过 Vector3 全球访问，而不是通过单个 Vector3 对象。


print(Vector3.zAxis)  --> 0, 0, 1

X

Vector3 的 x 坐标。

Y

Vector3 的 y 坐标。

Z

Vector3 的 z 坐标。

Magnitude

Vector3 的长度。

Unit

一个普通化的副本 Vector3 - 一个具有与原始版相同的方向，但是具有 1 的量级。

方法

Abs

从原始部件的绝对值中返回一个新的向量。例如，一个向量的 (-2, 4, -6) 返回一个向量的 (2, 4, 6)。

返回

Ceil

从原始部件的天花板中返回一个新的向量。例如，一个向量的 (-2.6, 5.1, 8.8) 返回一个向量的 (-2, 6, 9) .

返回

Floor

从原始部件的地板上返回一个新的向量。例如，一个向量的 (-2.6, 5.1, 8.8) 返回一个向量的 (-3, 5, 8) .

返回

Sign

从原始的零件中返回一个新的向量 (-1, 0, 或 1)。例如，一个向量的 (-2.6, 5.1, 0) 返回一个向量的 (-1, 1, 0) .

返回

Cross

返回两个向量的交叉产品。

参数

other: Vector3

返回

Angle

将角度在 radian 之间返回。如果您提供轴，它将确定角度的方向。

参数

other: Vector3

默认值：nil

返回

Dot

返回两个向量的缩放点产品。

参数

other: Vector3

返回

FuzzyEq

如果其他 true 的 X、Y 和 Z 部件在每个相应的组件的 epsilon 单位内，则返回 Vector3 。

参数

other: Vector3

epsilon: number

默认值：0.00001 aka 1e-5

返回

Lerp

返回一个 Vector3 线性间隔在此 Vector3 和给出的 goal 1> Datatype. Vector31> 通过给定的 4> alpha4> 。

注意：alpha 值是不限于范围[0, 1]。

参数

alpha: number

返回

Max

返回一个 Vector3 用于每个组件，其中每个组件的最高值都来自提供的两个 Vector3 对象。


local a = Vector3.new(1, 2, 1)
local b = Vector3.new(2, 1, 2)

print(a:Max(b))  --> Vector3.new(2, 2, 2)

参数

vector: Vector3

返回

Min

返回一个 Vector3 用于每个组件，作为提供的 Vector3 对象之间最低的。


local a = Vector3.new(1, 2, 1)
local b = Vector3.new(2, 1, 2)

print(a:Min(b))  --> Vector3.new(1, 1, 1)

参数

vector: Vector3

返回

数学算式

Vector3 + Vector3 : Vector3

通过将第一个向量的每个组成部分添加到第二个组成部分相应的部分来生成一个 Vector3。

Vector3 - Vector3 : Vector3

通过减去第二向量的每个组成部分来生产一个 Vector3 。

Vector3 * Vector3 : Vector3

通过将第一个向量的每个组成部分乘以相应的第二个组成部分产生一个 Vector3。

Vector3 / Vector3 : Vector3

通过将第一个向量的每个组成部分分割为第二组成部分相应的部分产生一个 Vector3。

Vector3 // Vector3 : Vector3

通过 Vector3 由楼层分隔每个组件的第一个向量的相应部分来生成一个 Datatype.Vector3 。

Vector3 * number : Vector3

通过将提供的 вектор的每个组成部分乘以数量产生一个 Vector3。

Vector3 / number : Vector3

通过将提供的 вектор的每个组成部分分数为Vector3生成一个。

Vector3 // number : Vector3

通过 Vector3 每个组件的提供 vector 生成一个 Datatype.Vector3。