From 263086fd6a380bc2762cef76428103b1cab6d6bf Mon Sep 17 00:00:00 2001
From: Richard Davey <rdavey@gmail.com>
Date: Sat, 17 Mar 2018 17:31:38 +0000
Subject: [PATCH] Actions.PropertyValueInc is a new action that will increment
 any property of an array of objects by the given amount, using an optional
 step value, index and iteration direction. Most Actions have been updated to
 use this internally.

---
 src/actions/PropertyValueInc.js | 59 +++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 src/actions/PropertyValueInc.js

diff --git a/src/actions/PropertyValueInc.js b/src/actions/PropertyValueInc.js
new file mode 100644
index 000000000..fc5ead23c
--- /dev/null
+++ b/src/actions/PropertyValueInc.js
@@ -0,0 +1,59 @@
+/**
+ * @author       Richard Davey <rich@photonstorm.com>
+ * @copyright    2018 Photon Storm Ltd.
+ * @license      {@link https://github.com/photonstorm/phaser/blob/master/license.txt|MIT License}
+ */
+
+/**
+ * Takes an array of Game Objects, or any objects that have a public property as defined in `key`,
+ * and then adds the given value to it.
+ * 
+ * The optional `step` property is applied incrementally, multiplied by each item in the array.
+ * 
+ * To use this with a Group: `PropertyValueInc(group.getChildren(), key, value, step)`
+ *
+ * @function Phaser.Actions.PropertyValueInc
+ * @since 3.3.0
+ * 
+ * @param {array|Phaser.GameObjects.GameObject[]} items - The array of items to be updated by this action.
+ * @param {string} key - The property to be updated.
+ * @param {number} value - The amount to be added to the property.
+ * @param {number} [step=0] - This is added to the `value` amount, multiplied by the iteration counter.
+ * @param {integer} [index=0] - An optional offset to start searching from within the items array.
+ * @param {integer} [direction=1] - The direction to iterate through the array. 1 is from beginning to end, -1 from end to beginning.
+ *
+ * @return {array} The array of objects that were passed to this Action.
+ */
+var PropertyValueInc = function (items, key, value, step, index, direction)
+{
+    if (step === undefined) { step = 0; }
+    if (index === undefined) { index = 0; }
+    if (direction === undefined) { direction = 1; }
+
+    var i;
+    var t = 0;
+    var end = items.length;
+
+    if (direction === 1)
+    {
+        //  Start to End
+        for (i = index; i < end; i++)
+        {
+            items[i][key] += value + (t * step);
+            t++;
+        }
+    }
+    else
+    {
+        //  End to Start
+        for (i = index; i >= 0; i--)
+        {
+            items[i][key] += value + (t * step);
+            t++;
+        }
+    }
+
+    return items;
+};
+
+module.exports = PropertyValueInc;