# 三维向量（[name]）

该类表示的是一个三维向量（3D [link:https://en.wikipedia.org/wiki/Vector_space vector]）。 一个三维向量表示的是一个有顺序的、三个为一组的数字组合（标记为x、y和z）， 可被用来表示很多事物，例如：

- 一个位于三维空间中的点。
- 一个在三维空间中的方向与长度的定义。在three.js中，长度总是从(0, 0, 0)到(x, y, z)的 [link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean distance]（欧几里德距离，即直线距离）， 方向也是从(0, 0, 0)到(x, y, z)的方向。
- 任意的、有顺序的、三个为一组的数字组合。

其他的一些事物也可以使用二维向量进行表示，比如说动量矢量等等； 但以上这些是它在three.js中的常用用途。

对 [name] 实例进行遍历将按相应的顺序生成它的分量 (x, y, z)。

## 代码示例

`const a = new THREE.Vector3( 0, 1, 0 ); //no arguments; will be initialised to (0, 0, 0) const b = new THREE.Vector3( ); const d = a.distanceTo( b );`

## 构造函数

### [name]( [param:Float x], [param:Float y], [param:Float z] )

[page:Float x] - 向量的x值，默认为*0*。
[page:Float y] - 向量的y值，默认为*0*。
[page:Float z] - 向量的z值，默认为*0*。
创建一个新的[name]。

## 属性

### [property:Boolean isVector3]

Read-only flag to check if a given object is of type [name].

### [property:Float x]

### [property:Float y]

### [property:Float z]

## 方法

### [method:this add]( [param:Vector3 v] )

将传入的向量[page:Vector3 v]和这个向量相加。

### [method:this addScalar]( [param:Float s] )

将传入的标量s和这个向量的[page:.x x]值、[page:.y y]值以及[page:.z z]值相加。

### [method:this addScaledVector]( [param:Vector3 v], [param:Float s] )

将所传入的[page:Vector3 v]与[page:Float s]相乘所得的乘积和这个向量相加。

### [method:this addVectors]( [param:Vector3 a], [param:Vector3 b] )

将该向量设置为[page:Vector3 a] + [page:Vector3 b]。

### [method:this applyAxisAngle]( [param:Vector3 axis], [param:Float angle] )

[page:Vector3 axis] - 一个被归一化的[page:Vector3]。
[page:Float angle] - 以弧度表示的角度。
将轴和角度所指定的旋转应用到该向量上。

### [method:this applyEuler]( [param:Euler euler] )

通过将[page:Euler]（欧拉）对象转换为[page:Quaternion]（四元数）并应用， 将欧拉变换应用到这一向量上。

### [method:this applyMatrix3]( [param:Matrix3 m] )

将该向量乘以三阶矩阵[page:Matrix3 m]。

### [method:this applyMatrix4]( [param:Matrix4 m] )

将该向量乘以四阶矩阵m（第四个维度隐式地为1），并按角度进行划分。

### [method:this applyNormalMatrix]( [param:Matrix3 m] )

将该向量乘以正规矩阵 [page:Matrix3 m]，并将结果进行归一化。

### [method:this applyQuaternion]( [param:Quaternion quaternion] )

将[page:Quaternion]变换应用到该向量。

### [method:Float angleTo]( [param:Vector3 v] )

以弧度返回该向量与向量[page:Vector3 v]之间的角度。

### [method:this ceil]()

将该向量[page:.x x]分量、 [page:.y y]分量以及[page:.z z]分量向上取整为最接近的整数。

### [method:this clamp]( [param:Vector3 min], [param:Vector3 max] )

[page:Vector3 min] - 在限制范围内，[page:.x x]值、[page:.y y]值和[page:.z z]的最小值。
[page:Vector3 max] - 在限制范围内，[page:.x x]值、[page:.y y]值和[page:.z z]的最大值。
如果该向量的x值、y值或z值大于限制范围内最大x值、y值或z值，则该值将会被所对应的值取代。
如果该向量的x值、y值或z值小于限制范围内最小x值、y值或z值，则该值将会被所对应的值取代。

### [method:this clampLength]( [param:Float min], [param:Float max] )

[page:Float min] - 长度将被限制为的最小值
[page:Float max] - 长度将被限制为的最大值
如果向量长度大于最大值，则它将会被最大值所取代。
如果向量长度小于最小值，则它将会被最小值所取代。

### [method:this clampScalar]( [param:Float min], [param:Float max] )

[page:Float min] - 分量将被限制为的最小值
[page:Float max] - 分量将被限制为的最大值
如果该向量的x值、y值或z值大于最大值，则它们将被最大值所取代。
如果该向量的x值、y值或z值小于最小值，则它们将被最小值所取代。

### [method:Vector3 clone]()

返回一个新的Vector3，其具有和当前这个向量相同的[page:.x x]、[page:.y y]和[page:.z z]。

### [method:this copy]( [param:Vector3 v] )

将所传入Vector3的[page:.x x]、[page:.y y]和[page:.z z]属性复制给这一Vector3。

### [method:this cross]( [param:Vector3 v] )

将该向量设置为它本身与传入的[page:Vector3 v]的叉积（[link:https://en.wikipedia.org/wiki/Cross_product cross product]）。

### [method:this crossVectors]( [param:Vector3 a], [param:Vector3 b] )

将该向量设置为传入的[page:Vector3 a]与[page:Vector3 b]的叉积（[link:https://en.wikipedia.org/wiki/Cross_product cross product]）。

### [method:Float distanceTo]( [param:Vector3 v] )

计算该向量到所传入的[page:Vector3 v]间的距离。

### [method:Float manhattanDistanceTo]( [param:Vector3 v] )

计算该向量到所传入的[page:Vector3 v]之间的曼哈顿距离（[link:https://en.wikipedia.org/wiki/Taxicab_geometry Manhattan distance]）。

### [method:Float distanceToSquared]( [param:Vector3 v] )

计算该向量到传入的[page:Vector3 v]的平方距离。 如果你只是将该距离和另一个距离进行比较，则应当比较的是距离的平方， 因为它的计算效率会更高一些。

### [method:this divide]( [param:Vector3 v] )

将该向量除以向量[page:Vector3 v]。

### [method:this divideScalar]( [param:Float s] )

将该向量除以标量[page:Float s]。

### [method:Float dot]( [param:Vector3 v] )

计算该vector和所传入[page:Vector3 v]的点积（[link:https://en.wikipedia.org/wiki/Dot_product dot product]）。

### [method:Boolean equals]( [param:Vector3 v] )

检查该向量和[page:Vector3 v]的严格相等性。

### [method:this floor]()

向量的分量向下取整为最接近的整数值。

### [method:this fromArray]( [param:Array array], [param:Integer offset] )

[page:Array array] - 来源矩阵。
[page:Integer offset] - （可选）在数组中的元素偏移量，默认值为0。
设置向量中的[page:.x x]值为array[ offset + 0 ]，[page:.y y]值为array[ offset + 1 ]， [page:.z z]值为array[ offset + 2 ]。

### [method:this fromBufferAttribute]( [param:BufferAttribute attribute], [param:Integer index] )

[page:BufferAttribute attribute] - 来源的attribute。
[page:Integer index] - 在attribute中的索引。
从[page:BufferAttribute attribute]中设置向量的[page:.x x]值、[page:.y y]值和[page:.z z]值。

### [method:Float getComponent]( [param:Integer index] )

[page:Integer index] - 0, 1 or 2.
如果index值为0返回[page:.x x]值。
如果index值为1返回[page:.y y]值。
如果index值为2返回[page:.z z]值。

### [method:Float length]()

计算从(0, 0, 0) 到 (x, y, z)的欧几里得长度 （[link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean length]，即直线长度）

### [method:Float manhattanLength]()

计算该向量的曼哈顿长度（[link:http://en.wikipedia.org/wiki/Taxicab_geometry Manhattan length]）。

### [method:Float lengthSq]()

计算从(0, 0, 0)到(x, y, z)的欧几里得长度 （[link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean length]，即直线长度）的平方。 如果你正在比较向量的长度，应当比较的是长度的平方，因为它的计算效率更高一些。

### [method:this lerp]( [param:Vector3 v], [param:Float alpha] )

[page:Vector3 v] - 朝着进行插值的[page:Vector3]。
[page:Float alpha] - 插值因数，其范围通常在[0, 1]闭区间。
在该向量与传入的向量[page:Vector3 v]之间的线性插值，alpha是沿着线的长度的百分比 —— alpha = 0 时表示的是当前向量，alpha = 1 时表示的是所传入的向量[page:Vector3 v]。

### [method:this lerpVectors]( [param:Vector3 v1], [param:Vector3 v2], [param:Float alpha] )

[page:Vector3 v1] - 起始的[page:Vector3]。
[page:Vector3 v2] - 朝着进行插值的[page:Vector3]。
[page:Float alpha] - 插值因数，其范围通常在[0, 1]闭区间。
将此向量设置为在[page:Vector3 v1]和[page:Vector3 v2]之间进行线性插值的向量， 其中alpha为两个向量之间连线的长度的百分比 —— alpha = 0 时表示的是[page:Vector3 v1]，alpha = 1 时表示的是[page:Vector3 v2]。

### [method:this max]( [param:Vector3 v] )

如果该向量的x值、y值或z值小于所传入[page:Vector3 v]的x值、y值或z值， 则将该值替换为对应的最大值。

### [method:this min]( [param:Vector3 v] )

如果该向量的x值、y值或z值大于所传入[page:Vector3 v]的x值、y值或z值， 则将该值替换为对应的最小值。

### [method:this multiply]( [param:Vector3 v] )

将该向量与所传入的向量[page:Vector3 v]进行相乘。

### [method:this multiplyScalar]( [param:Float s] )

将该向量与所传入的标量[page:Float s]进行相乘。

### [method:this multiplyVectors]( [param:Vector3 a], [param:Vector3 b] )

按照分量顺序，将该向量设置为和[page:Vector3 a] * [page:Vector3 b]相等。

### [method:this negate]()

向量取反，即： x = -x, y = -y , z = -z。

### [method:this normalize]()

将该向量转换为单位向量（[link:https://en.wikipedia.org/wiki/Unit_vector unit vector]）， 也就是说，将该向量的方向设置为和原向量相同，但是其长度（[page:.length length]）为1。

### [method:this project]( [param:Camera camera] )

[page:Camera camera] — 在投影中使用的摄像机。
将此向量(坐标)从世界空间投影到相机的标准化设备坐标 (NDC) 空间。

### [method:this projectOnPlane]( [param:Vector3 planeNormal] )

[page:Vector3 planeNormal] - 表示平面法线的向量
[link:https://en.wikipedia.org/wiki/Vector_projection Projects] 通过从该向量减去投影到平面法线上的向量，将该向量投影到平面上。

### [method:this projectOnVector]( [param:Vector3 v] )

投影（[link:https://en.wikipedia.org/wiki/Vector_projection Projects]）该向量到向量[page:Vector3 v]上。

### [method:this reflect]( [param:Vector3 normal] )

[page:Vector3 normal] - 反射面法线
将该向量设置为对指定 normal 法线的表面的反射向量。假设法线具有单位长度。

### [method:this round]()

向量中的分量四舍五入取整为最接近的整数值。

### [method:this roundToZero]()

向量中的分量朝向0取整数（若分量为负数则向上取整，若为正数则向下取整）。

### [method:this set]( [param:Float x], [param:Float y], [param:Float z] )

设置该向量的[page:.x x]、[page:.y y] 和 [page:.z z] 分量。

### [method:this setComponent]( [param:Integer index], [param:Float value] )

[page:Integer index] - 0、1 或 2。
[page:Float value] - [page:Float]
若index为 0 则设置 [page:.x x] 值为 [page:Float value]。
若index为 1 则设置 [page:.y y] 值为 [page:Float value]。
若index为 2 则设置 [page:.z z] 值为 [page:Float value]。

### [method:this setFromCylindrical]( [param:Cylindrical c] )

从圆柱坐标[page:Cylindrical c]中设置该向量。

### [method:this setFromCylindricalCoords]( [param:Float radius], [param:Float theta], [param:Float y] )

从圆柱坐标中的[page:Cylindrical radius]、[page:Cylindrical theta]和[page:Cylindrical y]设置该向量。

### [method:this setFromEuler]( [param:Euler euler] )

根据指定的[page:Euler Euler Angle]的x、y、z分量来设置该向量的[page:.x x]、[page:.y y]、[page:.z z]分量。

### [method:this setFromMatrixColumn]( [param:Matrix4 matrix], [param:Integer index] )

从传入的四阶矩阵[page:Matrix4 matrix]由[page:Integer index]指定的列中， 设置该向量的[page:.x x]值、[page:.y y]值和[page:.z z]值。

### [method:this setFromMatrix3Column]( [param:Matrix3 matrix], [param:Integer index] )

从传入的三阶矩阵 [page:Matrix3 matrix] 由 [page:Integer index] 指定的列中，设置该向量的 [page:.x x] 值、[page:.y y] 值和 [page:.z z] 值。

### [method:this setFromMatrixPosition]( [param:Matrix4 m] )

从变换矩阵（[link:https://en.wikipedia.org/wiki/Transformation_matrix transformation matrix]）[page:Matrix4 m]中， 设置该向量为其中与位置相关的元素。

### [method:this setFromMatrixScale]( [param:Matrix4 m] )

从变换矩阵（[link:https://en.wikipedia.org/wiki/Transformation_matrix transformation matrix]）[page:Matrix4 m]中， 设置该向量为其中与缩放相关的元素。

### [method:this setFromSpherical]( [param:Spherical s] )

从球坐标[page:Spherical s]中设置该向量。

### [method:this setFromSphericalCoords]( [param:Float radius], [param:Float phi], [param:Float theta] )

从球坐标中的[page:Spherical radius]、[page:Spherical phi]和[page:Spherical theta]设置该向量。

### [method:this setLength]( [param:Float l] )

将该向量的方向设置为和原向量相同，但是长度（[page:.length length]）为[page:Float l]。

### [method:this setScalar]( [param:Float scalar] )

将该向量的[page:.x x]、[page:.y y]和[page:.z z]值同时设置为等于传入的[page:Float scalar]。

### [method:this setX]( [param:Float x] )

将向量中的[page:.x x]值替换为[page:Float x]。

### [method:this setY]( [param:Float y] )

将向量中的[page:.y y]值替换为[page:Float y]。

### [method:this setZ]( [param:Float z] )

将向量中的[page:.z z]值替换为[page:Float z]。

### [method:this sub]( [param:Vector3 v] )

从该向量减去向量[page:Vector3 v]。

### [method:this subScalar]( [param:Float s] )

从该向量的[page:.x x]、[page:.y y]和[page:.z z]中减去标量[page:Float s]。

### [method:this subVectors]( [param:Vector3 a], [param:Vector3 b] )

将该向量设置为[page:Vector3 a] - [page:Vector3 b]。

### [method:Array toArray]( [param:Array array], [param:Integer offset] )

[page:Array array] - （可选）被用于存储向量的数组。如果这个值没有传入，则将创建一个新的数组。
[page:Integer offset] - （可选） 数组中元素的偏移量。
返回一个数组[x, y ,z]，或者将x、y和z复制到所传入的[page:Array array]中。

### [method:this transformDirection]( [param:Matrix4 m] )

通过传入的矩阵（[page:Matrix4 m]的左上角3 x 3子矩阵）变换向量的方向， 并将结果进行[page:.normalize normalizes]（归一化）。

### [method:this unproject]( [param:Camera camera] )

[page:Camera camera] — 在投影中使用的摄像机。
将此向量(坐标)从相机的标准化设备坐标 (NDC) 空间投影到世界空间。

### [method:this random]()

将该向量的每个分量(x、y、z)设置为介于 0 和 1 之间的伪随机数，不包括 1。

## 源代码

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]