Class: Vector4
四维向量，四维向量表示的是一个有顺序的、四个为一组的数字组合，可以用来描述：
- 一个位于四维空间中的点。
- 一个在四维空间中的方向与长度的定义。
const a = new Vector4(0, 1, 0);
const b = new Vector4(0, 0, 0);
const d = a.distanceTo(b);
Hierarchy
-
default↳
Vector4
Table of contents
Constructors
Properties
Accessors
Methods
- fromArray
- toArray
- fromObject
- toObject
- set
- setScalar
- add
- addScalar
- subtract
- subtractScalar
- subVectors
- multiply
- multiplyScalar
- divide
- divideScalar
- scale
- scaleAndAdd
- distanceTo
- distanceToSquared
- length
- dot
- equals
- cross
- negate
- inverse
- lerp
- normalize
- applyMatrix4
- applyQuaternion
- copy
- clone
- toString
Constructors
constructor
• new Vector4(x?, y?, z?, w?): Vector4
Parameters
| Name | Type | Default value | Description |
|---|---|---|---|
x | number | 0 | 向量的x值，默认为0 |
y | number | 0 | 向量的y值，默认为0 |
z | number | 0 | 向量的z值，默认为0 |
w | number | 0 | 向量的w值，默认为0 |
Returns
Overrides
Vector.constructor
Defined in
Properties
elements
• elements: Float32Array | Float64Array
Overrides
Vector.elements
Defined in
Accessors
x
• get x(): number
获取向量 x 值
Returns
number
number;
Defined in
• set x(x): void
设置向量 x 值
Parameters
| Name | Type |
|---|---|
x | number |
Returns
void
Defined in
y
• get y(): number
获取向量 y 值
Returns
number
number;
Defined in
• set y(y): void
设置向量 y 值
Parameters
| Name | Type |
|---|---|
y | number |
Returns
void
Defined in
z
• get z(): number
获取向量 z 值
Returns
number
number;
Defined in
• set z(z): void
设置向量 z 值
Parameters
| Name | Type |
|---|---|
z | number |
Returns
void
Defined in
w
• get w(): number
获取向量 w 值
Returns
number
number;
Defined in
• set w(w): void
设置向量 w 值
Parameters
| Name | Type |
|---|---|
w | number |
Returns
void
Defined in
Methods
fromArray
▸ fromArray(array, offset?): Vector4
从数组构建向量数据
Parameters
| Name | Type | Default value | Description |
|---|---|---|---|
array | any | undefined | 原始数组 |
offset | number | 0 | 数组偏移量 |
Returns
Inherited from
Vector.fromArray
Defined in
toArray
▸ toArray(out?, offset?): Float32Array | Float64Array | number[]
从向量转换到数组
Parameters
| Name | Type | Default value | Description |
|---|---|---|---|
out | Float32Array | Float64Array | number[] | [] | 输出数据 |
offset | number | 0 | 偏移量 |
Returns
Float32Array | Float64Array | number[]
Inherited from
Vector.toArray
Defined in
fromObject
▸ fromObject(object): Vector4
从对象赋值 Vector3 的 x、y、z、w 值
Parameters
| Name | Type |
|---|---|
object | any |
Returns
Defined in
toObject
▸ toObject(): Object
转换到对象
Returns
Object
| Name | Type |
|---|---|
x | number |
y | number |
z | number |
w | number |
Defined in
set
▸ set(x, y, z, w): Vector4
设置向量的 x、y、z、w
Parameters
| Name | Type |
|---|---|
x | any |
y | any |
z | any |
w | any |
Returns
Defined in
setScalar
▸ setScalar(s): Vector4
将向量的每个值设置为标量 s
Parameters
| Name | Type |
|---|---|
s | any |
Returns
Defined in
add
▸ add(vec): Vector4
将传入的向量vec和这个向量相加，会改变当前向量
Parameters
| Name | Type | Description |
|---|---|---|
vec | Vector4 | 传入的 Vector4 |
Returns
Defined in
addScalar
▸ addScalar(v): Vector4
将传入的标量量 v 和这个向量相加，会改变当前向量
Parameters
| Name | Type | Description |
|---|---|---|
v | any | 传入的 标量值 |
Returns
Defined in
subtract
▸ subtract(vec): Vector4
从此向量减去 vec 四维向量
Parameters
| Name | Type | Description |
|---|---|---|
vec | Vector4 | 传入的 Vector4 |
Returns
Defined in
subtractScalar
▸ subtractScalar(v): Vector4
从此向量各分量减去标量 v，默认构建一个四维向量 [v, v, v, v]
Parameters
| Name | Type | Description |
|---|---|---|
v | any | 标量值 |
Returns
Defined in
subVectors
▸ subVectors(a, b): Vector4
将向量 a 与向量 b 相减后的向量赋值给此向量
Parameters
| Name | Type |
|---|---|
a | Vector4 |
b | Vector4 |
Returns
Defined in
multiply
▸ multiply(vec): Vector4
将此向量与 vec 向量相乘
Parameters
| Name | Type |
|---|---|
vec | Vector4 |
Returns
Defined in
multiplyScalar
▸ multiplyScalar(v): Vector4
从此向量各分量与标量 v 相乘，默认构建一个四维向量 [v, v, v, v]
Parameters
| Name | Type | Description |
|---|---|---|
v | number | 标量值 |
Returns
Defined in
divide
▸ divide(vec): Vector4
将此向量与 vec 向量相除
Parameters
| Name | Type |
|---|---|
vec | Vector4 |
Returns
Defined in
divideScalar
▸ divideScalar(v): Vector4
从此向量各分量与标量 v 相除，默认构建一个四维向量 [v, v, v, v]
Parameters
| Name | Type | Description |
|---|---|---|
v | any | 标量值 |
Returns
Defined in
scale
▸ scale(s): Vector4
缩放此向量
Parameters
| Name | Type |
|---|---|
s | number |
Returns
Defined in
scaleAndAdd
▸ scaleAndAdd(v, s): Vector4
按标量缩放 v 向量后与此向量相加
Parameters
| Name | Type |
|---|---|
v | Vector4 |
s | number |
Returns
Defined in
distanceTo
▸ distanceTo(vec): any
计算该向量到所传入的 v 间的距离
Parameters
| Name | Type |
|---|---|
vec | Vector4 |
Returns
any
Defined in
distanceToSquared
▸ distanceToSquared(vec): any
计算两个 Vector4 之间的平方距离
Parameters
| Name | Type |
|---|---|
vec | Vector4 |
Returns
any
Defined in
length
▸ length(): any
计算从 [0, 0, 0, 0] 到此向量的直线距离
Returns
any
Defined in
dot
▸ dot(vec): any
计算此向量与 vec 向量的点积
Parameters
| Name | Type |
|---|---|
vec | Vector4 |
Returns
any
Defined in
equals
▸ equals(vec): any
判断传入的向量 vec 与此向量是否相等
Parameters
| Name | Type |
|---|---|
vec | Vector4 |
Returns
any
Defined in
cross
▸ cross(vec): Vector4
将该向量设置为它本身与传入的vec的叉积
Parameters
| Name | Type |
|---|---|
vec | Vector4 |
Returns
Defined in
negate
▸ negate(): Vector4
针对此向量取反
Returns
Defined in
inverse
▸ inverse(): Vector4
针对此向量取倒数
Returns
Defined in
lerp
▸ lerp(vec, t): Vector4
从此向量到 vec 向量进行插值
Parameters
| Name | Type | Description |
|---|---|---|
vec | Vector4 | 目标向量 |
t | number | 插值因数，范围一般在[0-1]，通常在这两个值之间 |
Returns
Defined in
normalize
▸ normalize(): Vector4
将此向量转换为单位向量 (将其设置为与此向量具有相同方向但长度为 1 的向量)
Returns
Defined in
applyMatrix4
▸ applyMatrix4(matrix): Vector4
将此向量乘以 Matrix4
Parameters
| Name | Type |
|---|---|
matrix | Matrix4 |
Returns
Defined in
applyQuaternion
▸ applyQuaternion(quaternion): Vector4
将 Quaternion 变换应用到该向量
Parameters
| Name | Type |
|---|---|
quaternion | Quaternion |
Returns
Defined in
copy
▸ copy(vec4): Vector4
将传递的 Vector4 的 x 、y、 z、w 属性的值复制到此 Vector4
Parameters
| Name | Type |
|---|---|
vec4 | Vector4 |
Returns
Defined in
clone
▸ clone(): Vector4
克隆此向量
Returns
Defined in
toString
▸ toString(): string
转换为字符串
Returns
string