Class Vector2<T>

constructor

• new Vector2<
      T extends
          | "i8"
          | "u8"
          | "i16"
          | "u16"
          | "i32"
          | "u32"
          | "i64"
          | "u64"
          | "f32"
          | "f64",
  >(
      scalarType: T,
      ...args:
          | Vector2Arguments<T>
          | (T extends FloatScalar ? PolarArguments : never),
  ): Vector2<T>

  创建指定标量类型的二维向量；省略分量时为零，也可转换并复制源向量。

  Type Parameters

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

  Parameters

  • scalarType: T

    分量存储类型；i64/u64 使用 bigint，其余使用 number。
  • ...args: Vector2Arguments<T> | (T extends FloatScalar ? PolarArguments : never)

    x、y 分量或源向量；浮点类型还支持半径与 Angle 极坐标。

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

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

  Type Parameters

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

  Parameters

  • source: ReadonlyValue<Vector2<T>>

  Returns Vector2<T>

Readonly[mutableValue]

[vector2Native]

• get "[vector2Native]"(): NativeValueHandle<"vector2">

  Returns NativeValueHandle<"vector2">

[vector2Storage]

• get "[vector2Storage]"(): 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

angle

• angle(this: ReadonlyValue<Vector2<FloatScalar>>): Angle

  返回相对于正 X 轴的角度；仅适用于非零浮点向量。

  Parameters

  • this: ReadonlyValue<Vector2<FloatScalar>>

  Returns Angle

angleTo

• angleTo(
      this: ReadonlyValue<Vector2<T & FloatScalar>>,
      rhs: ReadonlyValue<Vector2<T>>,
  ): Angle

  返回从本向量到 rhs 的有符号夹角；两者必须为同类型的非零浮点向量。

  Parameters

  • this: ReadonlyValue<Vector2<T & FloatScalar>>
  • rhs: ReadonlyValue<Vector2<T>>

  Returns Angle

componentWiseDiv

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

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

  Parameters

  • rhs: ReadonlyValue<Vector2<T>>

  Returns Vector2<T>

componentWiseMul

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

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

  Parameters

  • rhs: ReadonlyValue<Vector2<T>>

  Returns Vector2<T>

cross

• cross(rhs: ReadonlyValue<Vector2<T>>): Scalar<T>

  返回二维叉积标量 x·rhs.y−y·rhs.x；rhs 必须具有相同标量类型。

  Parameters

  • rhs: ReadonlyValue<Vector2<T>>

  Returns Scalar<T>

dot

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

  返回与同类型向量 rhs 的点积 x·rhs.x+y·rhs.y。

  Parameters

  • rhs: ReadonlyValue<Vector2<T>>

  Returns Scalar<T>

length

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

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

  Parameters

  • this: ReadonlyValue<Vector2<FloatScalar>>

  Returns number

lengthSquared

• lengthSquared(): Scalar<T>

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

  Returns Scalar<T>

normalized

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

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

  Parameters

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

  Returns Vector2<T>

perpendicular

• perpendicular(): Vector2<T>

  返回垂直向量 (-y, x)，使用相同标量类型。

  Returns Vector2<T>

projectedOnto

• projectedOnto(
      this: ReadonlyValue<Vector2<T & FloatScalar>>,
      axis: ReadonlyValue<Vector2<T>>,
  ): Vector2<T>

  返回在 axis 上的投影；axis 必须为同类型的非零浮点向量。

  Parameters

  • this: ReadonlyValue<Vector2<T & FloatScalar>>
  • axis: ReadonlyValue<Vector2<T>>

  Returns Vector2<T>

rotatedBy

• rotatedBy(
      this: ReadonlyValue<Vector2<T & FloatScalar>>,
      phi: ReadonlyValue<Angle>,
  ): Vector2<T>

  返回旋转 phi 后的新浮点向量；屏幕坐标中正角度为顺时针。

  Parameters

  • this: ReadonlyValue<Vector2<T & FloatScalar>>
  • phi: ReadonlyValue<Angle>

  Returns Vector2<T>