EZXR 开发者中心

Appearance

Vector4（JavaScript） ​

Vector4 ​

Scripting Name：Insight.Vector4

四维向量，或四维点，或颜色值(RGBA)。

javascript
constructor( x?: number, y?: number, z?: number, w?: number);

Parameters

  • x : number （可选）x 分量，默认为 0
  • y : number （可选）y 分量，默认为 0
  • z : number （可选）z 分量，默认为 0
  • w : number （可选）w 分量，默认为 1

Properties ​

x ​

type ：number

x 值。

y ​

type ：number

y 值。

z ​

type ：number

z 值。

w ​

type ：number

w 值。

r ​

type ：number

r 值，等同于 x 值。

g ​

type ：number

g 值，等同于 y 值。

b ​

type ：number

b 值，等同于 z 值。

a ​

type ：number

a 值，等同于 w 值。

width ​

type ：number

等同于 z 值。

height ​

type ：number

等同于 w 值。

Static Properties ​

black ​

type ：Insight.Vector4

（只读）黑色(0,0,0,1)。

blue ​

type ：Insight.Vector4

（只读）蓝色(0,0,1,1)。

clear ​

type ：Insight.Vector4

（只读）清零，等同于(0,0,0,0)。

cyan ​

type ：Insight.Vector4

（只读）青色(0,1,1,1)。

gray ​

type ：Insight.Vector4

（只读）灰色(0.5,0.5,0.5,0.5)，等同于 grey。

grey ​

type ：Insight.Vector4

（只读）灰色(0.5,0.5,0.5,0.5)。

green ​

type ：Insight.Vector4

（只读）绿色(0,1,0,1)。

magenta ​

type ：Insight.Vector4

（只读）品红(1,0,1,1)。

negativeInfinity ​

type ：Insight.Vector4

（只读）(-inf,-inf,-inf,-inf))。

one ​

type ：Insight.Vector4

（只读）(1,1,1,1)。

positiveInfinity ​

type ：Insight.Vector4

（只读）(+inf,+inf,+inf,+inf)。

red ​

type ：Insight.Vector4

（只读）红色(1,0,0,1)。

white ​

type ：Insight.Vector4

（只读）白色(1,1,1,1)。

yellow ​

type ：Insight.Vector4

（只读）黄色(1,1,0,1)。

zero ​

type ：Insight.Vector4

（只读）(0,0,0,0)。

Methods ​

set ​

javascript
set(x: number, y: number, z: number, w: number): this;

设置向量各个分量的值，返回值为本身。

Parameters

  • x : number 分量 x
  • y : number 分量 y
  • z : number 分量 z
  • w : number 分量 w

setScalar ​

javascript
setScalar(scalar: number): this;

用一个浮点数来设置向量各个分量的值，返回值为本身。

Parameters

  • scalar : number 用来设置 x 和 y 两个分量的浮点数

setX ​

javascript
setX(x: number): this;

用一个浮点数来设置 x 分量的值，返回值为本身。

Parameters

  • x : number 用来设置 x 分量的浮点数

setY ​

javascript
setY(y: number): this;

用一个浮点数来设置 y 分量的值，返回值为本身。

Parameters

  • y : number 用来设置 y 分量的浮点数

setZ ​

javascript
setZ(z: number): this;

用一个浮点数来设置 z 分量的值，返回值为本身。

Parameters

  • z : number 用来设置 z 分量的浮点数

setW ​

javascript
setW(z: number): this;

用一个浮点数来设置 w 分量的值，返回值为本身。

Parameters

  • w : number 用来设置 w 分量的浮点数

setComponent ​

javascript
setComponent(index: number, value: number): this;

设置向量中某个分量的值。

Parameters

  • index : number 向量中分量的下标，取值范围为[0,3]
  • value : number 新的值

getComponent ​

javascript
getComponent(index: number): number;

返回向量中某个分量的值。

Parameters

  • index : number 向量中分量的下标，取值范围为[0,3]

clone ​

javascript
clone(): Vector4;

克隆一个新向量等于本向量。

copy ​

javascript
copy(v: Vector4): this;

将另一个向量的值拷贝到本向量中。

Parameters

  • v : Insight.Vector4 另一个向量

setAxisAngleFromQuaternion ​

javascript
setAxisAngleFromQuaternion(q: Quaternion): this;

将本向量的 xyz 设置传入的四元数的旋转轴，w 设为四元数的旋转角度，因此本向量的原值可能会被改变。

Parameters

  • q : Quaternion 旋转四元数

add ​

javascript
add(v: Vector4): this;

将另一个向量 v 的值累加到本向量中，相当于 x = x + v。

Parameters

  • v : Insight.Vector4 另一个向量
javascript
// 提示：可以进行连续计算，如：
var a = Insight.Vector4(1, 1);
var b = Insight.Vector4(2, 3);
a.add(b).add(b); 
// 相当于a=a+b+b

addScalar ​

javascript
addScalar(s: number): this;

将一个浮点数 s 的值累加到本向量的各个分量中，相当于 x = x + s。

Parameters

  • s : number 待累加的浮点数

addVectors ​

javascript
addVectors(a: Vector4, b: Vector4): this;

将两个向量 a 和 b 相加，结果放入本向量中，本向量原来的值将被丢弃，相当于 x = a + b。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b

addScaledVector ​

javascript
addScaledVector(v: Vector4, s: number): this;

将另一个向量 v 与浮点数 s 相乘后，再累加到本向量中，相当于 x = x + v * s。

Parameters

  • v : Insight.Vector4 向量 v
  • s : number 浮点数

sub ​

javascript
sub(v: Vector4): this;

将另一个向量 v 的值从本向量中减去，相当于 x = x - v。

Parameters

  • v : Insight.Vector4 另一个向量
javascript
// 提示：可以进行连续计算，如：
var a = Insight.Vector4(1, 1);
var b = Insight.Vector4(2, 3);
a.sub(b).add(b.setY(10)); 
// 相当于a=a-b+(2, 10)

subScalar ​

javascript
subScalar(s: number): this;

将一个浮点数 s 的值从本向量中减去，相当于 x = x - s。

Parameters

  • s : number 待减去的浮点数

subVectors ​

javascript
subVectors(a: Vector4, b: Vector4): this;

将两个向量 a 和 b 相减，结果放入本向量中，本向量原来的值将被丢弃，相当于 x = a - b。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b

multiply ​

javascript
multiply(v: Vector4): this;

将另一个向量 v 的值与本向量相乘，相当于 x = x * v。

Parameters

  • v : Insight.Vector4 另一个向量
javascript
// 提示：可以进行连续计算，如：
var a = Insight.Vector4(1, 1);
var b = Insight.Vector4(2, 3);
a.add(b).multiply(b); 
// 相当于a=(a+b)*b

multiplyScalar ​

javascript
multiplyScalar(s: number): this;

将一个浮点数 s 的值与本向量相乘，相当于 x = x * s。

Parameters

  • s : number 待相乘的浮点数

multiplyVectors ​

javascript
multiplyVectors(a: Vector4, b: Vector4): this;

将两个向量 a 和 b 相乘，结果放入本向量中，本向量原来的值将被丢弃，相当于 x = a * b。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b

divide ​

javascript
divide(v: Vector4): this;

将另一个向量 v 的值与本向量相除，相当于 x = x / v。

Parameters

  • v : Insight.Vector4 另一个向量
javascript
// 提示：可以进行连续计算，如：
var a = Insight.Vector4(1, 1);
var b = Insight.Vector4(2, 3);
a.add(b).divide(b); 
// 相当于a=(a+b)/b

divideScalar ​

javascript
divideScalar(s: number): this;

将一个浮点数 s 的值与本向量相除，相当于 x = x / s。

Parameters

  • s : number 待相除的浮点数

divideVectors ​

javascript
divideVectors(a: Vector4, b: Vector4): this;

将两个向量 a 和 b 相除，结果放入本向量中，本向量原来的值将被丢弃，相当于 x = a / b。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b

min ​

javascript
min(v: Vector4): this;

将本向量与另一个向量 v 中较小的一个的值保存在本向量中，因此本向量的原值可能会被改变。

Parameters

  • v : Insight.Vector4 另一个向量

max ​

javascript
max(v: Vector4): this;

将本向量与另一个向量 v 中较大的一个的值保存在本向量中，因此本向量的原值可能会被改变。

Parameters

  • v : Insight.Vector4 另一个向量

clamp ​

javascript
clamp(min: Vector4, max: Vector4): this;

将本向量夹持到向量 min 和向量 max 之间，并把夹持结果保存在本向量中，因此本向量的原值可能会被改变。

Parameters

  • min : Insight.Vector4 向量 min
  • max : Insight.Vector4 向量 max

clampScalar ​

javascript
clampScalar(min: number, max: number): this;

将本向量夹持到浮点数 min 和浮点数 max 之间，并把夹持结果保存在本向量中，因此本向量的原值可能会被改变。

Parameters

  • min : number 浮点数 min
  • max : number 浮点数 max

clampLength ​

javascript
clampLength(min: number, max: number): this;

将本向量的长度夹持到浮点数 min 和浮点数 max 之间，并把计算后的新的向量值保存在本向量中，因此本向量的原值可能会被改变。

Parameters

  • min : number 浮点数 min
  • max : number 浮点数 max

floor ​

javascript
floor(): this;

将本向量的各个分量进行向下取整，因此本向量的原值可能会被改变。

ceil ​

javascript
ceil(): this;

将本向量的各个分量进行向上取整，因此本向量的原值可能会被改变。

round ​

javascript
round(): this;

将本向量的各个分量进行四舍五入，因此本向量的原值可能会被改变。

roundToZero ​

javascript
roundToZero(): this;

将本向量的各个分量进行向零取整（正数为向下取整，负数为向上取整），因此本向量的原值可能会被改变。

negate ​

javascript
negate(): this;

将本向量的各个分量取反，因此本向量的原值可能会被改变。

dot ​

javascript
dot(v: Vector4): number;

将本向量与另一个向量 v 进行点乘操作，返回点乘结果。

Parameters

  • v : Insight.Vector4 另一个向量

lengthSq ​

javascript
lengthSq(): number;

计算本向量的长度的平方。

length ​

javascript
length(): number;

计算本向量的长度。

manhattanLength ​

javascript
manhattanLength(): number;

计算本向量的曼哈顿长度。

manhattanDistanceTo ​

javascript
manhattanDistanceTo(v: Vector4): number;

计算本向量与另一个向量 v 之间的曼哈顿距离。

Parameters

  • v : Insight.Vector4 另一个向量

normalize ​

javascript
normalize(): this;

对向量归一化，因此本向量的原值可能会被改变。

setLength ​

javascript
setLength(length: number): this;

将本向量设置为一个与原先向量方向相同的、但长度等于 length 的新向量，因此本向量的原值可能会被改变。

Parameters

  • length : number 新长度

lerp ​

javascript
lerp(v: Vector4, alpha: number): this;

将本向量与向量 v 进行线性插值操作，并把结果保存在本向量中，因此本向量的原值可能会被改变。

Parameters

  • v : Insight.Vector2 另一个向量 v
  • alpha : number 线性插值的取值，范围在[0,1]之间。

lerpVectors ​

javascript
lerpVectors(v1: Vector4, v2: Vector4, alpha: number): this;

将向量 v1 与向量 v2 进行线性插值操作，并把结果保存在本向量中，因此本向量的原值将被丢弃。

Parameters

  • v1 : Insight.Vector2 向量 v1
  • v2 : Insight.Vector2 向量 v2
  • alpha : number 线性插值的取值，范围在[0,1]之间。

equals ​

javascript
equals(v: Vector4): boolean;

判断是否等于另一个向量 v。

Parameters

  • v : Insight.Vector4 另一个向量

toString ​

javascript
toString(): string;

按照(x, y, z)的格式输出。

fromArray ​

javascript
fromArray(array: number[], offset?: number): this;

从一个数组 array 中获取向量的每个分量的值，并填充到本向量中，因此本向量的原值可能会被丢弃。

Parameters

  • array : number[] 带有 16 个分量值的数组
  • offset?: number 可选参数，表示从数组的第 offset 个下标开始获取值，如不填则默认 0

toArray ​

javascript
toArray(array?: number[], offset?: number): number[];

将本向量中的所有分量值填充到 array 数组中。返回值为填充好的 array 数组（与参数中的 array 是同一个）。如 array 数组为空，则返回一个全新的数组。

Parameters

  • array : number[] 可选参数，待填充的数组，如不填则返回一个全新的数组
  • offset?: number 可选参数，表示从数组的第 offset 个下标开始填充值，offset 的值不能超过数组长度，否则会抛出异常。如不填则默认 0

Static Methods ​

Distance ​

javascript
static Distance(a: Vector4, b: Vector4): number;

计算两个二维点之间的距离。此方法会返回一个全新的向量，而不会修改 a、b 的值。

Parameters

  • a : Insight.Vector4 点 a 坐标
  • b : Insight.Vector4 点 b 坐标

Dot ​

javascript
static Dot(a: Vector4, b: Vector4): number;

计算两个向量的点积。此方法会返回一个全新的向量，而不会修改 a、b 的值。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b

Lerp ​

javascript
static Lerp(a: Vector4, b: Vector4, t: number): Vector4;

两个向量做插值，t 在[0, 1]之间。当 t=0 时，返回 a，当 t=1 时，返回 b。此方法会返回一个全新的向量，而不会修改 a、b 的值。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b
  • t : number 在 a 到 b 之间做插值

LerpUnclamped ​

javascript
static LerpUnclamped(a: Vector4, b: Vector4, t: number): Vector4;

两个向量做插值，t 的取值范围不做限制。此方法会返回一个全新的向量，而不会修改 a、b 的值。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b
  • t : number 在 a 到 b 之间做插值

Max ​

javascript
static Max(a: Vector4, b: Vector4): Vector4;

返回两个向量每个分量中较大的值组成的新向量。此方法会返回一个全新的向量，而不会修改 a、b 的值。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b

Min ​

javascript
static Min(a: Vector4, b: Vector4): Vector4;

返回两个向量每个分量中较小的值组成的新向量。此方法会返回一个全新的向量，而不会修改 a、b 的值。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b

MoveTowards ​

javascript
static MoveTowards(current: Vector4, target: Vector4, maxDistanceDelta: number): Vector4;

返回从 current 出发，朝向 target，到达与 current 最大距离为 maxDistanceDelta 的点。此方法会返回一个全新的向量，而不会修改 current、target 的值。

Parameters

  • current : Insight.Vector4 起点
  • target : Insight.Vector4 终点
  • maxDistanceDelta : number 与的 current 最大距离

Project ​

javascript
static Project(vector: Vector4, onNormal: Vector4): Vector4;

计算 vector 在 onNormal 上的投影。此方法会返回一个全新的向量，而不会修改 vector、onNormal 的值。

Parameters

  • vector : Insight.Vector4 待计算向量
  • onNormal : Insight.Vector4 投影向量

Scale ​

javascript
static Scale(a: Vector4, b: Vector4): Vector4;

返回 a 与 b 相乘的结果，a 与 b 对应分量相乘。此方法会返回一个全新的向量，而不会修改 a、b 的值。

Parameters

  • a : Insight.Vector4 向量 a
  • b : Insight.Vector4 向量 b