Class Rectangle

constructor

• new Rectangle(
      x?: number,
      y?: number,
      width?: number,
      height?: number,
  ): Rectangle

  创建矩形实例

  Parameters

  • x: number = 0

    左上角的 x 坐标，默认为0
  • y: number = 0

    左上角的 y 坐标，默认为0
  • width: number = 0

    矩形的宽度，默认为0
  • height: number = 0

    矩形的高度，默认为0

  Returns Rectangle

height

width

x

y

Static ReadonlyTEMP

bottom

• get bottom(): number

  获取矩形的下边界坐标

  Returns number

  矩形下边界的y坐标 (y + height)

left

• get left(): number

  获取矩形的左边界坐标，等同于 x

  Returns number

  矩形左边界的x坐标

right

• get right(): number

  获取矩形的右边界坐标

  Returns number

  矩形右边界的x坐标 (x + width)

top

• get top(): number

  获取矩形的上边界坐标，等同于 y

  Returns number

  矩形上边界的y坐标

clone

• clone(): Rectangle

  创建当前矩形的一个副本

  Returns Rectangle

  一个新的矩形实例，包含与当前矩形相同的属性值

  Remarks

  返回的是深拷贝，修改副本不会影响原矩形

contains

• contains(x: number, y: number): boolean

  判断指定坐标点是否在矩形区域内

  Parameters

  • x: number

    待检测点的 x 坐标
  • y: number

    待检测点的 y 坐标

  Returns boolean

  如果点在矩形内（包含边界）返回 true，否则返回 false

copyFrom

• copyFrom(rect: IRectangle): this

  从指定的矩形对象复制属性值到当前矩形

  Parameters

  • rect: IRectangle

    源矩形对象，必须包含x、y、width、height属性

  Returns this

  当前矩形实例，支持链式调用

copyFromBounds

• copyFromBounds(bounds: Bounds): this

  从指定的边界对象复制属性值到当前矩形

  Parameters

  • bounds: Bounds

    源边界对象，必须包含边界信息

  Returns this

  当前矩形实例，支持链式调用

  Remarks

  边界对象的坐标系统可能与矩形不同，会自动转换

equals

• equals(rect: IRectangle): boolean

  判断当前矩形与指定矩形的所有属性值是否完全相等

  Parameters

  • rect: IRectangle

    待比较的矩形对象

  Returns boolean

  如果所有属性值都相等则返回 true，否则返回 false

  Remarks

  使用严格相等比较，浮点数精度问题可能导致意外结果

fit

• fit(rect: Rectangle): this

  扩展当前矩形以完全包含指定的矩形

  Parameters

  • rect: Rectangle

    需要包含的目标矩形

  Returns this

  当前矩形实例，支持链式调用

  Remarks

  结果矩形是包含两个矩形的最小矩形（外接矩形）

intersects

• intersects(other: Rectangle, otherMatrix?: Matrix): boolean

  判断当前矩形是否与另一个矩形相交

  Parameters

  • other: Rectangle

    待检测的矩形对象
  • OptionalotherMatrix: Matrix

    可选的变换矩阵，用于在检测前对待检测矩形进行变换

  Returns boolean

  如果两个矩形相交返回 true，否则返回 false

  Remarks

  • 不提供变换矩阵时使用轴对齐矩形相交检测，性能更好
  • 提供变换矩阵时使用分离轴定理进行相交检测，支持旋转矩形
  • 变换矩阵的行列式为0时总是返回false（矩阵不可逆）
  • 边界重叠被认为是相交

pad

• pad(paddingX?: number, paddingY?: number): this

  按指定的内边距扩展矩形的四个边

  Parameters

  • paddingX: number = 0

    水平方向的内边距值，会同时应用到左右两边
  • paddingY: number = paddingX

    垂直方向的内边距值，默认等于 paddingX，会同时应用到上下两边

  Returns this

  当前矩形实例，支持链式调用

  Remarks

  • 负值会收缩矩形
  • 过大的负值可能导致宽度或高度变为负数

reset

• reset(): this

  重置矩形的所有属性为默认值（0）

  Returns this

  当前矩形实例，支持链式调用

set

• set(x: number, y: number, width: number, height: number): this

  设置矩形的位置和大小

  Parameters

  • x: number

    左上角的 x 坐标
  • y: number

    左上角的 y 坐标
  • width: number

    矩形的宽度，应为非负数
  • height: number

    矩形的高度，应为非负数

  Returns this

  当前矩形实例，支持链式调用