Appearance
三维向量
三维向量是数学和物理学中非常重要的一个概念，它用于描述三维空间中的一个点相对于另一个点的位置变化，或者表示一个物体在三维空间中的速度、加速度、力等物理量的方向和大小。简单来说，三维向量是一个有三个分量的量，这些分量分别对应三维空间中的X轴、Y轴和Z轴。
更多有关的数学知识，可以观看3Blue1Brown相关视频。
构造函数
GameVector3()
实例化一个三维向量对象
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| x | 是 | number | x轴坐标 | |
| y | 是 | number | y轴坐标 | |
| z | 是 | number | z轴坐标 |
返回值
| 类型 | 说明 |
|---|---|
| GameVector3 | 三维向量 |
定义于 #L13296
属性
x
x轴坐标
y
y轴坐标
z
z轴坐标
静态方法
fromPolar()
根据极坐标或球面坐标来创建三维向量。
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| mag | 是 | number | 向量的模长或半径，即从原点到点的直线距离。 | |
| phi | 是 | number | 表示从正y轴到点在xy平面上的投影的逆时针角度（即经度）。 | |
| theta | 是 | number | 表示从xz平面向上或向下到点的角度（即纬度）。 |
方法
set()
设置向量值，返回当前向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| x | 是 | number | x轴坐标 | |
| y | 是 | number | y轴坐标 | |
| z | 是 | number | z轴坐标 |
copy()
将三维向量复制到当前三维向量中，返回当前向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
clone()
克隆当前三维向量，返回新的向量
add()
向量加法，返回新的向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
sub()
向量减法，返回新的向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
mul()
向量逐元素乘法，返回新的向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
div()
向量相除，返回新的向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
addEq()
向量加法，并覆盖当前向量，返回当前向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
subEq()
向量减法，并覆盖当前向量，返回当前向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
mulEq()
向量逐元素乘法，并覆盖当前向量，返回当前向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
divEq()
向量相除，并覆盖当前向量，返回当前向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
dot()
向量点积
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
cross()
向量叉积，返回新的向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
scale()
向量数乘，返回新的向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| n | 是 | number | 乘数 |
lerp()
向量插值，返回新的向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 目标三维向量 | |
| n | 是 | number(0-1) | 插值百分比 |
towards()
计算两向量的点之间的位置
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
mag()
返回该向量的长度
sqrMag()
返回向量的平方长度
angle()
返回两个向量之间的角度
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
distance()
返回两个向量之间的距离
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
equals()
检测两向量的值在容差内是否近似相等
容差值：0.000001
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
exactEquals()
检测两向量的值是否完全相等
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
max()
返回两向量的最大向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
min()
返回两向量的最小向量
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| v | 是 | GameVector3 | 三维向量 |
normalize()
向量归一化，返回新的向量
toString()
返回向量格式化的字符串