Class Vector3<T>

constructor

• new Vector3<
      T extends
          | "i8"
          | "u8"
          | "i16"
          | "u16"
          | "i32"
          | "u32"
          | "i64"
          | "u64"
          | "f32"
          | "f64",
  >(
      scalarType: T,
      ...args: Vector3Arguments<T>,
  ): Vector3<T>

  创建指定标量类型的三维向量。

  Type Parameters

  • T extends "i8" | "u8" | "i16" | "u16" | "i32" | "u32" | "i64" | "u64" | "f32" | "f64"

  Parameters

  • scalarType: T

    存储类型；i64/u64 的分量为 bigint，其余为 number。
  • ...args: Vector3Arguments<T>

    x、y、z 分量或待转换复制的源向量；省略时创建零向量。

  Returns Vector3<T>
• new Vector3<
      T extends
          | "i8"
          | "u8"
          | "i16"
          | "u16"
          | "i32"
          | "u32"
          | "i64"
          | "u64"
          | "f32"
          | "f64",
  >(
      source: ReadonlyValue<Vector3<T>>,
  ): Vector3<T>

  复制向量及其标量类型，副本拥有独立存储。

  Type Parameters

  • T extends "i8" | "u8" | "i16" | "u16" | "i32" | "u32" | "i64" | "u64" | "f32" | "f64"

  Parameters

  • source: ReadonlyValue<Vector3<T>>

  Returns Vector3<T>

Readonly[mutableValue]

[vector3Native]

• get "[vector3Native]"(): NativeValueHandle<"vector3">

  Returns NativeValueHandle<"vector3">

[vector3Storage]

• get "[vector3Storage]"(): ScalarArray<T>

  Returns ScalarArray<T>

scalarType

• get scalarType(): T

  分量使用的标量存储类型。

  Returns T

x

• get x(): Scalar<T>

  X 分量；写入按 scalarType 对应的 TypedArray 规则转换。

  Returns Scalar<T>
• set x(value: Scalar<T>): void

  设置 X 分量。

  Parameters

  • value: Scalar<T>

  Returns void

y

• get y(): Scalar<T>

  Y 分量；写入按 scalarType 对应的 TypedArray 规则转换。

  Returns Scalar<T>
• set y(value: Scalar<T>): void

  设置 Y 分量。

  Parameters

  • value: Scalar<T>

  Returns void

z

• get z(): Scalar<T>

  Z 分量；写入按 scalarType 对应的 TypedArray 规则转换。

  Returns Scalar<T>
• set z(value: Scalar<T>): void

  设置 Z 分量。

  Parameters

  • value: Scalar<T>

  Returns void

componentWiseDiv

• componentWiseDiv(rhs: ReadonlyValue<Vector3<T>>): Vector3<T>

  返回与同类型 rhs 逐分量相除的新向量；任一除数为零时抛出 RangeError。

  Parameters

  • rhs: ReadonlyValue<Vector3<T>>

  Returns Vector3<T>

componentWiseMul

• componentWiseMul(rhs: ReadonlyValue<Vector3<T>>): Vector3<T>

  返回与同类型 rhs 逐分量相乘的新向量。

  Parameters

  • rhs: ReadonlyValue<Vector3<T>>

  Returns Vector3<T>

cross

• cross(rhs: ReadonlyValue<Vector3<T>>): Vector3<T>

  按右手定则返回与同类型向量 rhs 的叉积，结果为新向量。

  Parameters

  • rhs: ReadonlyValue<Vector3<T>>

  Returns Vector3<T>

dot

• dot(rhs: ReadonlyValue<Vector3<T>>): Scalar<T>

  返回与同类型向量 rhs 的点积。

  Parameters

  • rhs: ReadonlyValue<Vector3<T>>

  Returns Scalar<T>

length

• length(this: ReadonlyValue<Vector3<FloatScalar>>): number

  返回欧几里得长度；仅适用于浮点向量。

  Parameters

  • this: ReadonlyValue<Vector3<FloatScalar>>

  Returns number

lengthSquared

• lengthSquared(): Scalar<T>

  返回 x²+y²+z²，按当前标量类型的精度和范围计算。

  Returns Scalar<T>

normalized

• normalized(this: ReadonlyValue<Vector3<T & FloatScalar>>): Vector3<T>

  返回同方向的单位向量；仅适用于浮点向量，零向量抛出 RangeError。

  Parameters

  • this: ReadonlyValue<Vector3<T & FloatScalar>>

  Returns Vector3<T>