新增场景过渡效果

source/src/Core.ts

@@ -26,6 +26,8 @@ module es {
          */
         public readonly debug: boolean;
         public _nextScene: Scene;
+        public _sceneTransition: SceneTransition;
+
         /**
          * 用于凝聚GraphicsDeviceReset事件
          */
@@ -131,6 +133,16 @@ module es {
             return null;
         }
 
+        /**
+         * 临时运行SceneTransition，允许一个场景平滑过渡到另一个场景，并具有自定义效果
+         * @param sceneTransition
+         */
+        public static startSceneTransition<T extends SceneTransition>(sceneTransition: T) {
+            Insist.isNull(this._instance._sceneTransition, "在前一个场景转换完成之前，无法启动新的场景转换");
+            this._instance._sceneTransition = sceneTransition;
+            return sceneTransition;
+        }
+
         /**
          * 启动一个coroutine。Coroutine可以将number延时几秒或延时到其他startCoroutine.Yielding 
          * null将使coroutine在下一帧被执行。
@@ -170,6 +182,7 @@ module es {
          * 在一个场景结束后，下一个场景开始之前调用
          */
         public onSceneChanged() {
+            Core.emitter.emit(CoreEvents.sceneChanged);
             Time.sceneChanged();
         }
 
@@ -189,7 +202,11 @@ module es {
                         this._globalManagers[i].update();
                 }
 
-                this._scene.update();
+                if (this._sceneTransition == null ||
+                    (this._sceneTransition != null &&
+                        (!this._sceneTransition._loadsNewScene || this._sceneTransition._isNewSceneLoaded))) {
+                    this._scene.update();
+                }
 
                 if (this._nextScene != null) {
                     this._scene.end();
@@ -203,6 +220,20 @@ module es {
             }
 
             this.startDebugDraw();
+            this.draw();
+        }
+
+        protected draw() {
+            if (this._sceneTransition != null)
+                this._sceneTransition.preRender();
+
+            if (this._sceneTransition != null && !this._sceneTransition.hasPreviousSceneRender) {
+                if (this._scene != null) {
+                    Core.startCoroutine(this._sceneTransition.onBeginTransition());
+                }
+
+                this._sceneTransition.render();
+            }
         }
     }
 }

source/src/ECS/SceneTransition.ts

@@ -0,0 +1,97 @@
+module es {
+    /**
+     * SceneTransition用于从一个场景过渡到另一个场景，或在一个场景内进行效果转换。
+     * 如果sceneLoadAction为null，框架将执行场景内过渡，而不是加载新的场景中间过渡。
+     */
+    export abstract class SceneTransition {
+        /** 该函数应返回新加载的场景 */
+        protected sceneLoadAction: () => Scene;
+
+        /**
+         * 在loadNextScene执行时调用
+         * 这在进行场景间转换时非常有用，这样您就可以知道何时可以重新设置相机或重置任何实体
+         */
+        public onScreenObscured: Function;
+
+        /**
+         * 转换完成后调用，以便调用其他工作，例如启动另一个场景转换
+         */
+        public onTransitionCompleted: Function;
+
+        /** 
+         * 指示此转换是否将加载新场景的标志
+         */
+        public _loadsNewScene: boolean = false;
+
+        private _hasPreviousSceneRender: boolean = false;
+
+        public get hasPreviousSceneRender() {
+            if (!this._hasPreviousSceneRender) {
+                this._hasPreviousSceneRender = true;
+                return false;
+            }
+
+            return true;
+        }
+
+        /**
+         * 将此用于两部分过渡。例如，褪色会先褪色为黑色，然后当_isNewSceneLoaded变为true时会褪色。
+         * 对于场景内转换，应在中点将isNewSceneLoaded设置为true，就像加载了新场景一样
+         */
+        public _isNewSceneLoaded: boolean = false;
+
+        protected constructor(sceneLoadAction: () => Scene) {
+            this.sceneLoadAction = sceneLoadAction;
+            this._loadsNewScene = sceneLoadAction != null;
+        }
+
+        protected * LoadNextScene() {
+            // 如果我们有渲染界面，可以在这让玩家知道屏幕是模糊的（正在加载）
+            if (this.onScreenObscured != null)
+                this.onScreenObscured();
+
+            // 如果我们不加载一个新场景，我们只需设置标志
+            if (!this._loadsNewScene) {
+                this._isNewSceneLoaded = true;
+                yield "break";
+            }
+
+            Core.scene = this.sceneLoadAction();
+            this._isNewSceneLoaded = true;
+
+            while (!this._isNewSceneLoaded)
+                yield null;
+        }
+
+        /**
+         * 在前一个场景出现第一次（也是唯一一次）后调用。
+         * 此时，可以在生成一帧后加载新场景（因此第一次渲染调用发生在场景加载之前）
+         */
+        public * onBeginTransition(): any {
+            yield null;
+            yield Core.startCoroutine(this.LoadNextScene());
+
+            this.transitionComplete();
+        }
+
+        /**
+         * 在渲染场景之前调用
+         */
+        public preRender() { }
+
+        /**
+         * 在这里进行所有渲染
+         */
+        public render() { }
+
+        /**
+         * 当过渡完成且新场景已设置时，将调用此函数
+         */
+        protected transitionComplete() {
+            Core.Instance._sceneTransition = null;
+
+            if (this.onTransitionCompleted != null)
+                this.onTransitionCompleted();
+        }
+    }
+}