arcade-physics/lib/geom/point/GetCentroid.js

Use Arcade Physics without Phaser.

"use strict";
/**
 * @author       Richard Davey <rich@photonstorm.com>
 * @copyright    2020 Photon Storm Ltd.
 * @license      {@link https://opensource.org/licenses/MIT|MIT License}
 */
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const Point_1 = __importDefault(require("./Point"));
/**
 * Get the centroid or geometric center of a plane figure (the arithmetic mean position of all the points in the figure).
 * Informally, it is the point at which a cutout of the shape could be perfectly balanced on the tip of a pin.
 *
 * @function Phaser.Geom.Point.GetCentroid
 * @since 3.0.0
 *
 * @generic {Phaser.Geom.Point} O - [out,$return]
 *
 * @param {Phaser.Types.Math.Vector2Like[]} points - An array of Vector2Like objects to get the geometric center of.
 * @param {Phaser.Geom.Point} [out] - A Point object to store the output coordinates in. If not given, a new Point instance is created.
 *
 * @return {Phaser.Geom.Point} A Point object representing the geometric center of the given points.
 */
const GetCentroid = (points, out) => {
    if (out === undefined) {
        out = new Point_1.default();
    }
    if (!Array.isArray(points)) {
        throw new Error('GetCentroid points argument must be an array');
    }
    const len = points.length;
    if (len < 1) {
        throw new Error('GetCentroid points array must not be empty');
    }
    else if (len === 1) {
        out.x = points[0].x;
        out.y = points[0].y;
    }
    else {
        for (let i = 0; i < len; i++) {
            out.x += points[i].x;
            out.y += points[i].y;
        }
        out.x /= len;
        out.y /= len;
    }
    return out;
};
exports.default = GetCentroid;
//# sourceMappingURL=GetCentroid.js.map