Line.midPoint will return a Point object where the x and y values correspond to the center (or midpoint) of the Line segment.

Author: photonstorm

README.md

@@ -256,6 +256,7 @@ If you are an exceptional JavaScript developer and would like to join the Phaser
 * Text.addFontStyle and Text.addFontWeight allow you to apply font weights and styles to specific characters in a Text object. For example you can now include bold or italics within single Text objects (thanks @jdnichollsc #1950)
 * PIXI.CanvasPool is a new static global created to deal with the issue of resource leaks and continuous DOM node build-up when creating lots of Text or BitmapData objects, or when calling `generateTexture` on any display object. The CanvasPool will do its best to re-use out dated canvas elements rather than filling up the DOM with new ones.
 * Sprite.setTexture has a new `destroyBase` parameter - set this to `true` if you know the base used a generated texture that isn't being used by any other sprites. This will free-up the canvas for further re-use by other calls to generateTexture or Text objects.
+* Line.midPoint will return a Point object where the x and y values correspond to the center (or midpoint) of the Line segment.
 
 ### Updates
 

src/geom/Line.js

@@ -157,6 +157,24 @@ Phaser.Line.prototype = {
 
     },
 
+    /**
+    * Returns a Point object where the x and y values correspond to the center (or midpoint) of the Line segment.
+    * 
+    * @method Phaser.Line#midPoint
+    * @param {Phaser.Point} [out] - A Phaser.Point object into which the result will be populated. If not given a new Point object is created.
+    * @return {Phaser.Point} A Phaser.Point object with the x and y values set to the center of the line segment.
+    */
+    midPoint: function (out) {
+
+        if (out === undefined) { out = new Phaser.Point(); }
+
+        out.x = (this.start.x + this.end.x) / 2;
+        out.y = (this.start.y + this.end.y) / 2;
+
+        return out;
+
+    },
+
     /**
     * Tests if the given coordinates fall on this line. See pointOnSegment to test against just the line segment.
     * 

typescript/phaser.d.ts

@@ -2130,6 +2130,7 @@ declare module Phaser {
         fromAngle(x: number, y: number, angle: number, length: number): Phaser.Line;
         fromSprite(startSprite: Phaser.Sprite, endSprite: Phaser.Sprite, useCenter?: boolean): Phaser.Line;
         intersects(line: Phaser.Line, asSegment?: boolean, result?: Phaser.Point): Phaser.Point;
+        midPoint(out?: Phaser.Point): Phaser.Point;
         pointOnLine(x: number, y: number): boolean;
         pointOnSegment(x: number, y: number): boolean;
         random(out?: Phaser.Point): Phaser.Point;