Removed ability to set alpha per animation frame (you do it via onUpdate if needed)

Added showOnStart and hideOnComplete config options to set visible state of sprite.

Author: photonstorm

v3/src/animation/AnimationFrame.js

@@ -24,10 +24,6 @@ var AnimationFrame = function (index, frame)
     //  Callback if this frame gets displayed
     this.onUpdate = null;
 
-    //  When this frame hits, set sprite.alpha to this
-    this.setAlpha = false;
-    this.alpha = 1;
-
     //  When this frame hits, set sprite.visible to this
     this.setVisible = false;
     this.visible = false;

v3/src/animation/AnimationManager.js

@@ -46,7 +46,6 @@ AnimationManager.prototype = {
     //          { key: textureKey, frame: textureFrame },
     //          { key: textureKey, frame: textureFrame, duration: float },
     //          { key: textureKey, frame: textureFrame, onUpdate: function }
-    //          { key: textureKey, frame: textureFrame, alpha: float }
     //          { key: textureKey, frame: textureFrame, visible: boolean }
     //      ]
     //      framerate: integer
@@ -56,6 +55,7 @@ AnimationManager.prototype = {
     //      repeat: -1 = forever, otherwise integer
     //      repeatDelay: integer
     //      yoyo: boolean
+    //      showOnStart: boolean
     //      hideOnComplete: boolean
     //      onStart: function
     //      onRepeat: function

v3/src/animation/frame/Animation.js

@@ -55,6 +55,12 @@ var Animation = function (manager, key, config)
     //  Should the animation yoyo? (reverse back down to the start) before repeating?
     this.yoyo = GetObjectValue(config, 'yoyo', false);
 
+    //  Should sprite.visible = true when the animation starts to play?
+    this.showOnStart = GetObjectValue(config, 'showOnStart', false);
+
+    //  Should sprite.visible = false when the animation finishes?
+    this.hideOnComplete = GetObjectValue(config, 'hideOnComplete', false);
+
     //  Callbacks (swap for Events?)
     this.onStart = GetObjectValue(config, 'onStart', false);
     this.onRepeat = GetObjectValue(config, 'onRepeat', false);
@@ -144,8 +150,7 @@ Animation.prototype = {
             }
             else
             {
-                //  OnComplete
-                component.stop();
+                this.completeAnimation(component);
             }
         }
         else
@@ -173,8 +178,7 @@ Animation.prototype = {
             }
             else
             {
-                //  OnComplete
-                component.stop();
+                this.completeAnimation(component);
             }
         }
         else
@@ -209,6 +213,19 @@ Animation.prototype = {
         }
     },
 
+    completeAnimation: function (component)
+    {
+        component.stop();
+
+        if (this.hideOnComplete)
+        {
+            component.parent.visible = false;
+        }
+
+        //  Events
+
+    },
+
     setFrame: function (component)
     {
         //  Work out which frame should be set next on the child, and set it

v3/src/animation/frame/GetFrames.js

@@ -7,6 +7,7 @@ var GetFrames = function (textureManager, frames)
     //          { key: textureKey, frame: textureFrame },
     //          { key: textureKey, frame: textureFrame, duration: float },
     //          { key: textureKey, frame: textureFrame, onUpdate: function }
+    //          { key: textureKey, frame: textureFrame, visible: boolean }
     //      ],
 
     // console.table(frames);
@@ -31,7 +32,6 @@ var GetFrames = function (textureManager, frames)
         var frame = GetObjectValue(item, 'frame', 0);
         var duration = GetObjectValue(item, 'duration', 0);
         var onUpdate = GetObjectValue(item, 'onUpdate', null);
-        var alpha = GetObjectValue(item, 'alpha', null);
         var visible = GetObjectValue(item, 'visible', null);
 
         var textureFrame = textureManager.getFrame(key, frame);
@@ -41,12 +41,6 @@ var GetFrames = function (textureManager, frames)
         animationFrame.duration = duration;
         animationFrame.onUpdate = onUpdate;
 
-        if (alpha !== null)
-        {
-            animationFrame.setAlpha = true;
-            animationFrame.alpha = alpha;
-        }
-
         if (visible !== null)
         {
             animationFrame.setVisible = true;

v3/src/animation/frame/Play.js

@@ -15,6 +15,11 @@ var Play = function (key, startFrame)
 
     this.prevTick = this.mainloop.lastFrameTimeMs;
 
+    if (currentAnim.showOnStart)
+    {
+        this.parent.visible = true;
+    }
+
     return this;
 };
 

v3/src/animation/frame/UpdateFrame.js

@@ -12,11 +12,6 @@ var UpdateFrame = function (animationFrame)
         sprite.alpha = animationFrame.alpha;
     }
 
-    if (animationFrame.setVisible)
-    {
-        sprite.visible = animationFrame.visible;
-    }
-
     if (animationFrame.onUpdate)
     {
         animationFrame.onUpdate(sprite, animationFrame);

v3/src/checksum.js

@@ -1,4 +1,4 @@
 var CHECKSUM = {
-build: '1fc4c990-1bf4-11e7-a52f-5f7dcf3f36ad'
+build: 'e6996440-1de8-11e7-bd97-cdf675a0abb1'
 };
 module.exports = CHECKSUM;