Source: tiny/core/math/shapes/Rectangle.js

import { SHAPES } from '../../const';

/**
 * Rectangle object is an area defined by its position, as indicated by its top-left corner
 * point (x, y) and by its width and its height.
 *
 * @class
 * @memberof Tiny
 */
export default class Rectangle {
  /**
   * @param {number} [x=0] - The X coordinate of the upper-left corner of the rectangle
   * @param {number} [y=0] - The Y coordinate of the upper-left corner of the rectangle
   * @param {number} [width=0] - The overall width of this rectangle
   * @param {number} [height=0] - The overall height of this rectangle
   */
  constructor(x = 0, y = 0, width = 0, height = 0) {
    /**
     * @member {number}
     * @default 0
     */
    this.x = x;

    /**
     * @member {number}
     * @default 0
     */
    this.y = y;

    /**
     * @member {number}
     * @default 0
     */
    this.width = width;

    /**
     * @member {number}
     * @default 0
     */
    this.height = height;

    /**
     * The type of the object, mainly used to avoid `instanceof` checks
     *
     * @member {number}
     * @readOnly
     * @default Tiny.SHAPES.RECT
     * @see Tiny.SHAPES
     */
    this.type = SHAPES.RECT;
  }

  /**
   * returns the left edge of the rectangle
   *
   * @member {number}
   */
  get left() {
    return this.x;
  }

  /**
   * returns the right edge of the rectangle
   *
   * @member {number}
   */
  get right() {
    return this.x + this.width;
  }

  /**
   * returns the top edge of the rectangle
   *
   * @member {number}
   */
  get top() {
    return this.y;
  }

  /**
   * returns the bottom edge of the rectangle
   *
   * @member {number}
   */
  get bottom() {
    return this.y + this.height;
  }

  /**
   * A constant empty rectangle.
   *
   * @static
   * @constant
   */
  static get EMPTY() {
    return new Rectangle(0, 0, 0, 0);
  }

  /**
   * Creates a clone of this Rectangle
   *
   * @return {Tiny.Rectangle} a copy of the rectangle
   */
  clone() {
    return new Rectangle(this.x, this.y, this.width, this.height);
  }

  /**
   * Copies another rectangle to this one.
   *
   * @param {Tiny.Rectangle} rectangle - The rectangle to copy.
   * @return {Tiny.Rectangle} Returns itself.
   */
  copy(rectangle) {
    this.x = rectangle.x;
    this.y = rectangle.y;
    this.width = rectangle.width;
    this.height = rectangle.height;

    return this;
  }

  /**
   * Checks whether the x and y coordinates given are contained within this Rectangle
   *
   * @param {number} x - The X coordinate of the point to test
   * @param {number} y - The Y coordinate of the point to test
   * @return {boolean} Whether the x/y coordinates are within this Rectangle
   */
  contains(x, y) {
    if (this.width <= 0 || this.height <= 0) {
      return false;
    }

    if (x >= this.x && x < this.x + this.width) {
      if (y >= this.y && y < this.y + this.height) {
        return true;
      }
    }

    return false;
  }

  /**
   * Pads the rectangle making it grow in all directions.
   *
   * @param {number} paddingX - The horizontal padding amount.
   * @param {number} paddingY - The vertical padding amount.
   */
  pad(paddingX, paddingY) {
    paddingX = paddingX || 0;
    paddingY = paddingY || ((paddingY !== 0) ? paddingX : 0);

    this.x -= paddingX;
    this.y -= paddingY;

    this.width += paddingX * 2;
    this.height += paddingY * 2;
  }

  /**
   * Fits this rectangle around the passed one.
   *
   * @param {Tiny.Rectangle} rectangle - The rectangle to fit.
   */
  fit(rectangle) {
    if (this.x < rectangle.x) {
      this.width += this.x;
      if (this.width < 0) {
        this.width = 0;
      }

      this.x = rectangle.x;
    }

    if (this.y < rectangle.y) {
      this.height += this.y;
      if (this.height < 0) {
        this.height = 0;
      }
      this.y = rectangle.y;
    }

    if (this.x + this.width > rectangle.x + rectangle.width) {
      this.width = rectangle.width - this.x;
      if (this.width < 0) {
        this.width = 0;
      }
    }

    if (this.y + this.height > rectangle.y + rectangle.height) {
      this.height = rectangle.height - this.y;
      if (this.height < 0) {
        this.height = 0;
      }
    }
  }

  /**
   * Enlarges this rectangle to include the passed rectangle.
   *
   * @param {Tiny.Rectangle} rectangle - The rectangle to include.
   */
  enlarge(rectangle) {
    const x1 = Math.min(this.x, rectangle.x);
    const x2 = Math.max(this.x + this.width, rectangle.x + rectangle.width);
    const y1 = Math.min(this.y, rectangle.y);
    const y2 = Math.max(this.y + this.height, rectangle.y + rectangle.height);

    this.x = x1;
    this.width = x2 - x1;
    this.y = y1;
    this.height = y2 - y1;
  }
}
Documentation generated by JSDoc 3.4.3 on Thu May 31 2018 14:40:21 GMT+0800 (CST)