Class Vector3

constructor

• new Vector3(x?, y?, z?): Vector3

• 创建 Vector3 对象的实例。如果未指定构造函数的参数，则将使用元素 (0,0,0,0) 创建 Vector3 对象。

  Parameters

  • Optional x: number

    第一个元素，例如 x 坐标。

  • Optional y: number

    第二个元素，例如 y 坐标。

  • Optional z: number

    第三个元素，例如 z 坐标。

  Returns Vector3

__class__

x

y

z

length

• get length(): number

• 当前 Vector3 对象的长度（大小），即从原点 (0,0,0) 到该对象的 x、y 和 z 坐标的距离。w 属性将被忽略。单位矢量具有的长度或大小为一。

  Returns number

lengthSquared

• get lengthSquared(): number

• 当前 Vector3 对象长度的平方，它是使用 x、y 和 z 属性计算出来的。w 属性将被忽略。尽可能使用 lengthSquared() 方法，而不要使用 Vector3.length() 方法的 Math.sqrt() 方法调用，后者速度较慢。

  Returns number

Static ONE

• get ONE(): Readonly<Vector3>

• Vector3(1, 1, 1)

  Returns Readonly<Vector3>

Static X_AXIS

• get X_AXIS(): Readonly<Vector3>

• 定义为 Vector3 对象的 x 轴，坐标为 (1,0,0)。

  Returns Readonly<Vector3>

Static Y_AXIS

• get Y_AXIS(): Readonly<Vector3>

• 定义为 Vector3 对象的 y 轴，坐标为 (0,1,0)

  Returns Readonly<Vector3>

Static ZERO

• get ZERO(): Readonly<Vector3>

• 原点 Vector3(0,0,0)

  Returns Readonly<Vector3>

Static Z_AXIS

• get Z_AXIS(): Readonly<Vector3>

• 定义为 Vector3 对象的 z 轴，坐标为 (0,0,1)

  Returns Readonly<Vector3>

add

• add(v): Vector3

• 加上指定向量

  Parameters

  • v: Vector3

    加向量

  Returns Vector3

addNumber

• addNumber(n): Vector3

• 加上标量

  Parameters

  • n: number

    标量

  Returns Vector3

addNumberTo

• addNumberTo(n, vOut?): Vector3

• 增加标量

  Parameters

  • n: number

    标量

  • Optional vOut: Vector3

  Returns Vector3

addScaledVector

• addScaledVector(scalar, vector): Vector3

• Scale a vector and add it to this vector. Save the result in "this". (this = this + vector * scalar)

  Parameters

  • scalar: number

  • vector: Vector3

  Returns Vector3

addScaledVectorTo

• addScaledVectorTo(scalar, vector, target?): Vector3

• Scale a vector and add it to this vector. Save the result in "target". (target = this + vector * scalar)

  Parameters

  • scalar: number

  • vector: Vector3Like

  • Optional target: Vector3

    The vector to save the result in.

  Returns Vector3

addTo

• addTo(v, vOut?): Vector3

• 加上指定向量得到新向量

  Parameters

  • v: Vector3

    加向量

  • Optional vOut: Vector3

  Returns Vector3

  返回新向量

almostZero

• almostZero(precision?): boolean

• 检查一个向量是否接近零

  Parameters

  • Optional precision: number

  Returns boolean

applyMatrix4x4

• applyMatrix4x4(mat): Vector3

• 应用矩阵

  Parameters

  • mat: Matrix4x4

    矩阵

  Returns Vector3

applyQuaternion

• applyQuaternion(q): Vector3

• 应用四元素

  Parameters

  • q: Quaternion

    四元素

  Returns Vector3

ceil

• ceil(): Vector3

• 向上取整

  Returns Vector3

clamp

• clamp(min, max): Vector3

• 夹紧？

  Parameters

  • min: Vector3

    最小值

  • max: Vector3

    最大值

  Returns Vector3

clampTo

• clampTo(min, max, vOut?): Vector3

• 夹紧？

  Parameters

  • min: Vector3

    最小值

  • max: Vector3

    最大值

  • Optional vOut: Vector3

  Returns Vector3

clone

• clone(): Vector3

• 返回一个新 Vector3 对象，它是与当前 Vector3 对象完全相同的副本。

  Returns Vector3

  一个新 Vector3 对象，它是当前 Vector3 对象的副本。

copy

• copy(v): Vector3

• 将源 Vector3 对象中的所有矢量数据复制到调用方 Vector3 对象中。

  Parameters

  • v: Vector3Like

  Returns Vector3

  要从中复制数据的 Vector3 对象。

cross

• cross(a): Vector3

• 叉乘向量

  Parameters

  • a: Vector3Like

    向量

  Returns Vector3

crossMat

• crossMat(this, outMatrix): Matrix3x3

• 从向量中得到叉乘矩阵a_cross，使得a x b = a_cross * b = c

  Parameters

  • this: Vector3

  • outMatrix: Matrix3x3

  Returns Matrix3x3

  See

  http://www8.cs.umu.se/kurser/TDBD24/VT06/lectures/Lecture6.pdf

crossTo

• crossTo(a, vOut?): Vector3

• 叉乘向量

  Parameters

  • a: Vector3Like

    向量

  • Optional vOut: Vector3

    输出向量

  Returns Vector3

distance

• distance(p): number

• 与目标点之间的距离

  Parameters

  • p: Vector3Like

    目标点

  Returns number

distanceSquared

• distanceSquared(p): number

• 与目标点之间的距离平方

  Parameters

  • p: Vector3Like

    目标点

  Returns number

divide

• divide(a): Vector3

• 除以向量

  Parameters

  • a: Vector3

    向量

  Returns Vector3

divideNumber

• divideNumber(n): Vector3

• 除以标量

  Parameters

  • n: number

    标量

  Returns Vector3

divideNumberTo

• divideNumberTo(n, vOut?): Vector3

• 除以标量

  Parameters

  • n: number

    标量

  • Optional vOut: Vector3

    输出向量

  Returns Vector3

divideTo

• divideTo(a, vOut?): Vector3

• 除以向量

  Parameters

  • a: Vector3Like

    向量

  • Optional vOut: Vector3

    输出向量

  Returns Vector3

dot

• dot(a): number

• 如果当前 Vector3 对象和作为参数指定的 Vector3 对象均为单位顶点，此方法将返回这两个顶点之间所成角的余弦值。

  Parameters

  • a: Vector3Like

  Returns number

equals

• equals(v, precision?): boolean

• 通过将当前 Vector3 对象的 x、y 和 z 元素与指定的 Vector3 对象的 x、y 和 z 元素进行比较，确定这两个对象是否相等。

  Parameters

  • v: Vector3Like

  • Optional precision: number

  Returns boolean

floor

• floor(): Vector3

• 向下取整

  Returns Vector3

fromArray

• fromArray(array, offset?): Vector3

• 从数组中初始化向量

  Parameters

  • array: ArrayLike<number>

    数组

  • Optional offset: number

    偏移

  Returns Vector3

  返回新向量

fromVector2

• fromVector2(vector, z?): Vector3

• 从Vector2初始化

  Parameters

  • vector: Vector2

  • Optional z: number

  Returns Vector3

fromVector4

• fromVector4(vector): Vector3

• 从Vector4初始化

  Parameters

  • vector: Vector4

    4维向量

  Returns Vector3

greater

• greater(p): boolean

• 大于指定点

  Parameters

  • p: Vector3

    点

  Returns boolean

greaterEqual

• greaterEqual(p): boolean

• 大于等于指定点

  Parameters

  • p: Vector3

    点

  Returns boolean

inverse

• inverse(): Vector3

• 倒向量 (a,b,c)->(1/a,1/b,1/c)

  Returns Vector3

inverseTo

• inverseTo(vOut?): Vector3

• 倒向量 (a,b,c)->(1/a,1/b,1/c)

  Parameters

  • Optional vOut: Vector3

  Returns Vector3

isAntiparallelTo

• isAntiparallelTo(v, precision?): boolean

• 检查这个向量是否与另一个向量反平行。

  Parameters

  • v: Vector3

  • Optional precision: number

    设置为零以进行精确比较

  Returns boolean

isParallel

• isParallel(v, precision?): boolean

• 与指定向量是否平行

  Parameters

  • v: Vector3

    向量

  • Optional precision: number

  Returns boolean

isZero

• isZero(): boolean

• 是否为零向量

  Returns boolean

lerp

• lerp(v, alpha): Vector3

• 插值到指定向量

  Parameters

  • v: Vector3

    目标向量

  • alpha: Vector3

    插值系数

  Returns Vector3

  返回自身

lerpNumber

• lerpNumber(v, alpha): Vector3

• 插值到指定向量

  Parameters

  • v: Vector3

    目标向量

  • alpha: number

    插值系数

  Returns Vector3

  返回自身

lerpNumberTo

• lerpNumberTo(v, alpha, vOut?): Vector3

• 插值到指定向量

  Parameters

  • v: Vector3

    目标向量

  • alpha: number

    插值系数

  • Optional vOut: Vector3

  Returns Vector3

  返回自身

lerpTo

• lerpTo(v, alpha, vOut?): Vector3

• 插值到指定向量

  Parameters

  • v: Vector3

    目标向量

  • alpha: Vector3

    插值系数

  • Optional vOut: Vector3

  Returns Vector3

  返回自身

less

• less(p): boolean

• 小于指定点

  Parameters

  • p: Vector3

    点

  Returns boolean

lessEqual

• lessEqual(p): boolean

• 小于等于指定点

  Parameters

  • p: Vector3

    点

  Returns boolean

max

• max(v): Vector3

• 取最大元素

  Parameters

  • v: Vector3

    向量

  Returns Vector3

min

• min(v): Vector3

• 取最小元素

  Parameters

  • v: Vector3

    向量

  Returns Vector3

multiply

• multiply(v): Vector3

• 乘以向量

  Parameters

  • v: Vector3

    向量

  Returns Vector3

multiplyNumber

• multiplyNumber(n): Vector3

• 乘以标量

  Parameters

  • n: number

    标量

  Returns Vector3

multiplyNumberTo

• multiplyNumberTo(n, vOut?): Vector3

• 乘以标量

  Parameters

  • n: number

    标量

  • Optional vOut: Vector3

    输出向量

  Returns Vector3

multiplyTo

• multiplyTo(v, vOut?): Vector3

• 乘以向量

  Parameters

  • v: Vector3

    向量

  • Optional vOut: Vector3

    输出向量

  Returns Vector3

negate

• negate(): Vector3

• 负向量 (a,b,c)->(-a,-b,-c)

  Returns Vector3

negateTo

• negateTo(vOut?): Vector3

• 负向量 (a,b,c)->(-a,-b,-c)

  Parameters

  • Optional vOut: Vector3

  Returns Vector3

normalize

• normalize(thickness?): Vector3

• 通过将最前面的三个元素（x、y、z）除以矢量的长度可将 Vector3 对象转换为单位矢量。

  Parameters

  • Optional thickness: number

  Returns Vector3

random

• random(size?, double?): Vector3

• 随机三维向量

  Parameters

  • Optional size: number

    尺寸

  • Optional double: boolean

    如果值为false，随机范围在[0,size],否则[-size,size]。默认为false。

  Returns Vector3

reflect

• reflect(normal): Vector3

• 反射

  Parameters

  • normal: Vector3

  Returns Vector3

round

• round(): Vector3

• 四舍五入

  Returns Vector3

roundToZero

• roundToZero(): Vector3

• 向0取整

  Returns Vector3

scale

• scale(s): Vector3

• 缩放

  Parameters

  • s: Vector3

    缩放量

  Returns Vector3

scaleNumber

• scaleNumber(s): Vector3

• 按标量（大小）缩放当前的 Vector3 对象。

  Parameters

  • s: number

  Returns Vector3

scaleNumberTo

• scaleNumberTo(s, vOut?): Vector3

• 按标量（大小）缩放当前的 Vector3 对象。

  Parameters

  • s: number

  • Optional vOut: Vector3

  Returns Vector3

scaleTo

• scaleTo(s, vOut?): Vector3

• 缩放

  Parameters

  • s: Vector3

    缩放量

  • Optional vOut: Vector3

  Returns Vector3

set

• set(x, y, z): Vector3

• 将 Vector3 的成员设置为指定值

  Parameters

  • x: number

  • y: number

  • z: number

  Returns Vector3

setZero

• setZero(): void

• 把所有分量都设为零

  Returns void

sub

• sub(a): Vector3

• 减去向量

  Parameters

  • a: Vector3

    减去的向量

  Returns Vector3

  返回新向量

subNumber

• subNumber(n): Vector3

• 减去标量

  Parameters

  • n: number

    标量

  Returns Vector3

subNumberTo

• subNumberTo(n, vOut?): Vector3

• 减去标量

  Parameters

  • n: number

    标量

  • Optional vOut: Vector3

  Returns Vector3

subTo

• subTo(v, vOut?): Vector3

• 减去向量返回新向量

  Parameters

  • v: Vector3

    减去的向量

  • Optional vOut: Vector3

  Returns Vector3

  返回的新向量

tangents

• tangents(t1, t2): void

• Parameters

  • t1: Vector3

  • t2: Vector3

  Returns void

toArray

• toArray(array?, offset?): number[]

• 转换为数组

  Parameters

  • Optional array: number[]

    数组

  • Optional offset: number

    偏移

  Returns number[]

  返回数组

toString

• toString(): string

• 返回当前 Vector3 对象的字符串表示形式。

  Returns string

toVector2

• toVector2(vector?): Vector2

• 转换为Vector2

  Parameters

  • Optional vector: Vector2

  Returns Vector2

unit

• unit(target?): Vector3

• 得到这个向量长度为1

  Parameters

  • Optional target: Vector3

  Returns Vector3