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>

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

  类型参数

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

  参数

  scalarType

  T

  分量存储类型；i64/u64 使用 bigint，其余使用 number。

  ...args

  Vector2Arguments<T> | (T extends FloatScalar ? PolarArguments : never)

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

  返回值

  Vector2<T>

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

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

  类型参数

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

  参数

  source

  ReadonlyValue<Vector2<T>>

  返回值

  Vector2<T>

  源码与继承

scalarType

• get scalarType(): T

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

  返回值

  T

  源码与继承

x

• get x(): Scalar<T>

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

  返回值

  Scalar<T>

  源码与继承
• set x(value: Scalar<T>): void

  设置 X 分量。

  参数

  value

  Scalar<T>

  返回值

  void

  源码与继承

y

• get y(): Scalar<T>

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

  返回值

  Scalar<T>

  源码与继承
• set y(value: Scalar<T>): void

  设置 Y 分量。

  参数

  value

  Scalar<T>

  返回值

  void

  源码与继承

angle

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

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

  参数

  this

  ReadonlyValue<Vector2<FloatScalar>>

  返回值

  Angle

  源码与继承

angleTo

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

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

  参数

  this

  ReadonlyValue<Vector2<T & FloatScalar>>

  rhs

  ReadonlyValue<Vector2<T>>

  返回值

  Angle

  源码与继承

componentWiseDiv

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

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

  参数

  rhs

  ReadonlyValue<Vector2<T>>

  返回值

  Vector2<T>

  源码与继承

componentWiseMul

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

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

  参数

  rhs

  ReadonlyValue<Vector2<T>>

  返回值

  Vector2<T>

  源码与继承

cross

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

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

  参数

  rhs

  ReadonlyValue<Vector2<T>>

  返回值

  Scalar<T>

  源码与继承

dot

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

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

  参数

  rhs

  ReadonlyValue<Vector2<T>>

  返回值

  Scalar<T>

  源码与继承

length

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

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

  参数

  this

  ReadonlyValue<Vector2<FloatScalar>>

  返回值

  number

  源码与继承

lengthSquared

• lengthSquared(): Scalar<T>

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

  返回值

  Scalar<T>

  源码与继承

normalized

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

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

  参数

  this

  ReadonlyValue<Vector2<T & FloatScalar>>

  返回值

  Vector2<T>

  源码与继承

perpendicular

• perpendicular(): Vector2<T>

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

  返回值

  Vector2<T>

  源码与继承

projectedOnto

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

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

  参数

  this

  ReadonlyValue<Vector2<T & FloatScalar>>

  axis

  ReadonlyValue<Vector2<T>>

  返回值

  Vector2<T>

  源码与继承

rotatedBy

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

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

  参数

  this

  ReadonlyValue<Vector2<T & FloatScalar>>

  phi

  ReadonlyValue<Angle>

  返回值

  Vector2<T>

  源码与继承

只读[mutableValue]

[vector2Native]

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

  返回值

  NativeValueHandle<"vector2">

  源码与继承

[vector2Storage]

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

  返回值

  ScalarArray<T>

  源码与继承