Options
All
  • Public
  • Public/Protected
  • All
Menu

Class Vec3

三维向量。

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

  • newVec3(v: Vec3): Vec3
  • newVec3(x?: undefined | number, y?: undefined | number, z?: undefined | number): Vec3

Properties

x

x: number

x 分量。

y

y: number

y 分量。

z

z: number

z 分量。

Static FORWARD

FORWARD: Readonly<Vec3> = Object.freeze(new Vec3(0, 0, -1))

Static NEG_ONE

NEG_ONE: Readonly<Vec3> = Object.freeze(new Vec3(-1, -1, -1))

Static ONE

ONE: Readonly<Vec3> = Object.freeze(new Vec3(1, 1, 1))

Static RIGHT

RIGHT: Readonly<Vec3> = Object.freeze(new Vec3(1, 0, 0))

Static UNIT_X

UNIT_X: Readonly<Vec3> = Object.freeze(new Vec3(1, 0, 0))

Static UNIT_Y

UNIT_Y: Readonly<Vec3> = Object.freeze(new Vec3(0, 1, 0))

Static UNIT_Z

UNIT_Z: Readonly<Vec3> = Object.freeze(new Vec3(0, 0, 1))

Static UP

UP: Readonly<Vec3> = Object.freeze(new Vec3(0, 1, 0))

Static ZERO

ZERO: Readonly<Vec3> = Object.freeze(new Vec3(0, 0, 0))

Methods

add

  • add(other: Vec3): this

add3f

  • add3f(x: number, y: number, z: number): this
  • zh

    向量加法。将当前向量与指定分量的向量相加

    Parameters

    • x: number

      指定的向量的 x 分量。

    • y: number

      指定的向量的 y 分量。

    • z: number

      指定的向量的 z 分量。

    Returns this

clampf

  • clampf(minInclusive: Vec3, maxInclusive: Vec3): this
  • zh

    设置当前向量的值，使其各个分量都处于指定的范围内。

    Parameters

    • minInclusive: Vec3

      每个分量都代表了对应分量允许的最小值。

    • maxInclusive: Vec3

      每个分量都代表了对应分量允许的最大值。

    Returns this

    this

clone

cross

  • cross(other: Vec3): this

divide

  • divide(other: Vec3): this
  • zh

    向量逐元素相除。将当前向量与指定分量的向量相除的结果赋值给当前向量。

    Parameters

    • other: Vec3

      指定的向量

    Returns this

divide3f

  • divide3f(x: number, y: number, z: number): this
  • zh

    向量逐元素相除。将当前向量与指定分量的向量相除的结果赋值给当前向量。

    Parameters

    • x: number

      指定的向量的 x 分量。

    • y: number

      指定的向量的 y 分量。

    • z: number

      指定的向量的 z 分量。

    Returns this

dot

  • dot(other: Vec3): number
  • zh

    向量点乘。

    Parameters

    • other: Vec3

      指定的向量。

    Returns number

    当前向量与指定向量点乘的结果。

equals

  • equals(other: Vec3, epsilon?: number): boolean
  • zh

    判断当前向量是否在误差范围内与指定向量相等。

    Parameters

    • other: Vec3

      相比较的向量。

    • Default value epsilon: number = EPSILON

      允许的误差，应为非负数。

    Returns boolean

    当两向量的各分量都在指定的误差范围内分别相等时，返回 true；否则返回 false。

equals3f

  • equals3f(x: number, y: number, z: number, epsilon?: number): boolean
  • zh

    判断当前向量是否在误差范围内与指定分量的向量相等。

    Parameters

    • x: number

      相比较的向量的 x 分量。

    • y: number

      相比较的向量的 y 分量。

    • z: number

      相比较的向量的 z 分量。

    • Default value epsilon: number = EPSILON

      允许的误差，应为非负数。

    Returns boolean

    当两向量的各分量都在指定的误差范围内分别相等时，返回 true；否则返回 false。

length

  • length(): number

lengthSqr

  • lengthSqr(): number

lerp

  • lerp(to: Vec3, ratio: number): this
  • zh

    根据指定的插值比率，从当前向量到目标向量之间做插值。

    Parameters

    • to: Vec3

      目标向量。

    • ratio: number

      插值比率，范围为 [0,1]。

    Returns this

multiply

  • multiply(other: Vec3): this
  • zh

    向量乘法。将当前向量乘以与指定向量的结果赋值给当前向量。

    Parameters

    • other: Vec3

      指定的向量。

    Returns this

multiply3f

  • multiply3f(x: number, y: number, z: number): this
  • zh

    向量乘法。将当前向量与指定分量的向量相乘的结果赋值给当前向量。

    Parameters

    • x: number

      指定的向量的 x 分量。

    • y: number

      指定的向量的 y 分量。

    • z: number

      指定的向量的 z 分量。

    Returns this

multiplyScalar

  • multiplyScalar(scalar: number): this
  • zh

    向量数乘。将当前向量数乘指定标量

    Parameters

    • scalar: number

      标量乘数。

    Returns this

negative

  • negative(): this

normalize

  • normalize(): this

set

  • set(other: Vec3): any
  • set(x?: undefined | number, y?: undefined | number, z?: undefined | number): any
  • zh

    设置当前向量的具体分量值。

    Parameters

    • other: Vec3

      相比较的向量。

    Returns any

    this

  • zh

    设置当前向量的具体分量值。

    Parameters

    • Optional x: undefined | number

      要设置的 x 分量的值

    • Optional y: undefined | number

      要设置的 y 分量的值

    • Optional z: undefined | number

      要设置的 z 分量的值

    Returns any

    this

strictEquals

  • strictEquals(other: Vec3): boolean
  • zh

    判断当前向量是否与指定向量相等。

    Parameters

    • other: Vec3

      相比较的向量。

    Returns boolean

    两向量的各分量都分别相等时返回 true；否则返回 false。

strictEquals3f

  • strictEquals3f(x: number, y: number, z: number): boolean
  • zh

    判断当前向量是否与指定分量的向量相等。

    Parameters

    • x: number

      指定向量的 x 分量。

    • y: number

      指定向量的 y 分量。

    • z: number

      指定向量的 z 分量。

    Returns boolean

    两向量的各分量都分别相等时返回 true；否则返回 false。

subtract

  • subtract(other: Vec3): this
  • zh

    向量减法。将当前向量减去指定向量的结果。

    Parameters

    • other: Vec3

      减数向量。

    Returns this

subtract3f

  • subtract3f(x: number, y: number, z: number): this
  • zh

    向量减法。将当前向量减去指定分量的向量

    Parameters

    • x: number

      指定的向量的 x 分量。

    • y: number

      指定的向量的 y 分量。

    • z: number

      指定的向量的 z 分量。

    Returns this

toString

  • toString(): string

transformMat4

  • transformMat4(matrix: Mat4): this
  • zh

    将当前向量视为 w 分量为 1 的四维向量，应用四维矩阵变换到当前矩阵

    Parameters

    • matrix: Mat4

      变换矩阵。

    Returns this

Static add

Static angle

Static ceil

Static clone

  • clone<Out>(a: Out): Vec3

Static copy

  • copy<Out, Vec3Like>(out: Out, a: Vec3Like): Out

Static cross

Static distance

Static divide

Static dot

Static equals

Static floor

Static fromArray

  • fromArray<Out>(out: Out, arr: IWritableArrayLike<number>, ofs?: number): Out
  • zh

    数组转向量

    Type parameters

    Parameters

    • out: Out
    • arr: IWritableArrayLike<number>
    • Default value ofs: number = 0

      数组起始偏移量

    Returns Out

Static invert

Static invertSafe

  • invertSafe<Out>(out: Out, a: IVec3Like): Out

Static len

Static lengthSqr

Static lerp

Static max

Static min

Static multiply

Static multiplyScalar

  • multiplyScalar<Out, Vec3Like>(out: Out, a: Vec3Like, b: number): Out

Static negate

Static normalize

  • normalize<Out>(out: Out, a: IVec3Like): Out

Static project

Static projectOnPlane

Static random

  • random<Out>(out: Out, scale?: undefined | number): Out
  • zh

    生成一个在单位球体上均匀分布的随机向量

    Type parameters

    Parameters

    • out: Out
    • Optional scale: undefined | number

      生成的向量长度

    Returns Out

Static rotateX

Static rotateY

Static rotateZ

Static round

Static scaleAndAdd

Static set

  • set<Out>(out: Out, x: number, y: number, z: number): Out
  • zh

    设置当前向量的具体分量值。

    Type parameters

    Parameters

    • out: Out
    • x: number
    • y: number
    • z: number

    Returns Out

Static squaredDistance

Static strictEquals

Static subtract

Static toArray

  • toArray<Out>(out: Out, v: IVec3Like, ofs?: number): Out
  • zh

    向量转数组

    Type parameters

    • Out: IWritableArrayLike<number>

    Parameters

    • out: Out
    • v: IVec3Like
    • Default value ofs: number = 0

      数组起始偏移量

    Returns Out

Static transformAffine

Static transformInverseRTS

Static transformMat3

Static transformMat4

Static transformMat4Normal

Static transformQuat

Static transformRTS

Static zero

  • zero<Out>(out: Out): Out

Generated using TypeDoc