S-三维向量

三维向量是数学和物理学中非常重要的一个概念，它用于描述三维空间中的一个点相对于另一个点的位置变化，或者表示一个物体在三维空间中的速度、加速度、力等物理量的方向和大小。简单来说，三维向量是一个有三个分量的量，这些分量分别对应三维空间中的 X 轴、Y 轴和 Z 轴。

更多有关的数学知识，可以观看3Blue1Brown 相关视频。

构造函数

GameVector3()

实例化一个三维向量对象

输入参数

参数	必填	默认值	类型	说明
x	是		number	x 轴坐标
y	是		number	y 轴坐标
z	是		number	z 轴坐标

返回值

类型	说明
GameVector3	三维向量

属性

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()

返回向量格式化的字符串