射线检测完善

射线检测

.github/workflows/node.js.yml

@@ -0,0 +1,34 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
+
+name: Node.js CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+
+    runs-on: windows-latest
+
+    strategy:
+      matrix:
+        node-version: [8.x]
+
+    defaults:
+      run:
+        shell: cmd
+        working-directory: ./source
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - name: Install Dependencies
+      run: npm install
+    - run: npm run build --if-present
+    - run: gulp build

.gitignore

@@ -1,2 +1,5 @@
 /source/node_modules
 /demo/bin-debug
+/demo/bin-release
+/.idea
+/.vscode

README.md

@@ -1,11 +1,61 @@
 # egret-framework
-用于egret 包含众多高性能方法以供使用
-（正在施工中）
 
-## 计划列表
 
-- [ ]  包含一套适配egret的ecs框架
+[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/esengine/egret-framework.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/esengine/egret-framework/context:javascript)
 
-- [ ]  高性能物理引擎
+这是一套用于egret的游戏框架，里面包含ECS框架用于管理场景实体，一些常用2D碰撞检测及A*寻路。如果您还需要包含其他的AI系统可以查看作者其他库（行为树、简易FSM、实用AI）。
+
+## 版本计划功能
+
+- [x] 简易ECS框架
+  - [x] 组件列表
+    - [x] 碰撞组件
+    - [x] 移动组件
+    - [ ] 刚体组件
+    - [ ] 点光源/灯光组件
+    - [ ] 阴影组件
+    - [ ] 轨迹组件
+    - [ ] 滚动组件
+    - [ ] 网格弹簧组件
+    - [ ] 相机震动组件
+    - [ ] 霓虹灯组件
+    - [x] 跟随相机组件
+  - [x] 系统列表
+    - [x] 被动系统
+    - [x] 协调系统
+- [x] A*寻路(AStar)
+- [x] 常用碰撞检测
+- [x] 数学库
+  - [x] 简易矩阵类
+  - [x] 简易2d 向量类
+  - [x] 掩码实用类
+  - [x] 贝塞尔曲线
+  - [x] 快速随机数类
+- [x] BreadthFirst 寻路算法
+- [x] Dijkstra 寻路算法
+- [x] 事件处理器
+
+## 关于egret用ecs框架（typescript/javascript）
+ecs 是功能强大的实体组件系统。typescript与其他语言不同，因此我对ecs的设计尽可能的支持typescript特性。虽然ecs拥有标准实体组件系统，但在细节上有很大不同。创建标准ecs通常处于原始速度、缓存位置和其他性能原因。使用typescript，我们没有struct，因为没有必要匹配标准实体组件系统的设计方式，因为我们对内存布局没有那种控制。
+
+ecs更灵活，可以更好的集中、组织、排序和过滤游戏中的对象。ecs让您拥有轻量级实体和组件，这些组件可以由系统批量处理。
+例如，您在制作一个射手，您可能会有几十到几百个子弹，这些作为轻量级实体由系统批量处理。
+
+所以ecs在设计当中拥有四种重要类型：世界（Scene），过滤器（Matcher），系统（System）和实体(Entity)
+
+## 世界（Scene）
+Scene是ecs包含系统和实体最外面的容器。
+
+## 实体（Entity）
+实体只由系统处理。
+
+## 组件(Component)
+组件应该只包含数据而没有逻辑代码。对数据进行逻辑是系统的工作。
+
+## 系统（System）
+ecs中的系统会不断的更新实体。系统使用过滤器选择某些实体，然后仅更新那些选择的实体。
+
+## 作者其他库（egret）
+
+- [行为树/实用AI 系统](https://github.com/esengine/egret-BehaviourTree-ai)
 
-> 尽可能的简单易用

SECURITY.md

@@ -0,0 +1,21 @@
+# Security Policy
+
+## Supported Versions
+
+Use this section to tell people about which versions of your project are
+currently being supported with security updates.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 5.1.x   | :white_check_mark: |
+| 5.0.x   | :x:                |
+| 4.0.x   | :white_check_mark: |
+| < 4.0   | :x:                |
+
+## Reporting a Vulnerability
+
+Use this section to tell people how to report a vulnerability.
+
+Tell them where to go, how often they can expect to get an update on a
+reported vulnerability, what to expect if the vulnerability is accepted or
+declined, etc.

_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-slate

demo/.idea/.gitignore

@@ -0,0 +1,2 @@
+# Default ignored files
+/workspace.xml

demo/.idea/demo.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

demo/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="JavaScriptSettings">
+    <option name="languageLevel" value="ES6" />
+  </component>
+</project>

demo/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/demo.iml" filepath="$PROJECT_DIR$/.idea/demo.iml" />
+    </modules>
+  </component>
+</project>

demo/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+  </component>
+</project>

demo/.vscode/tasks.json

@@ -0,0 +1,10 @@
+{
+   "version": "0.1.0",
+   "command": "egret",
+   "isShellCommand": true,
+   "showOutput": "silent",
+   "args": [
+      "build"
+   ],
+   "problemMatcher": "$tsc"
+}

demo/egretProperties.json

@@ -27,6 +27,10 @@
     {
       "name": "framework",
       "path": "./libs/framework"
+    },
+    {
+      "name": "long",
+      "path": "./libs/long"
     }
   ]
 }

demo/index.html

@@ -27,7 +27,7 @@
          data-entry-class="Main"
          data-orientation="auto"
          data-scale-mode="fixedWidth"
-         data-frame-rate="30"
+         data-frame-rate="60"
          data-content-width="640"
          data-content-height="1136"
          data-multi-fingered="2"
@@ -77,7 +77,7 @@
              * "calculateCanvasScaleFactor": //a function return canvas scale factor
              * }
              **/
-            egret.runEgret({ renderMode: "webgl", audioType: 0, calculateCanvasScaleFactor:function(context) {
+            egret.runEgret({ renderMode: "canvas", audioType: 0, calculateCanvasScaleFactor:function(context) {
                 var backingStore = context.backingStorePixelRatio ||
                     context.webkitBackingStorePixelRatio ||
                     context.mozBackingStorePixelRatio ||

demo/manifest.json

@@ -7,7 +7,8 @@
 		"libs/modules/game/game.js",
 		"libs/modules/tween/tween.js",
 		"libs/modules/promise/promise.js",
-		"libs/framework/framework.js"
+		"libs/framework/framework.js",
+		"libs/long/long.js"
 	],
 	"game": [
 		"bin-debug/AssetAdapter.js",
@@ -16,6 +17,8 @@
 		"bin-debug/Platform.js",
 		"bin-debug/ThemeAdapter.js",
 		"bin-debug/game/MainScene.js",
+		"bin-debug/game/PlayerController.js",
+		"bin-debug/game/SimplePooled.js",
 		"bin-debug/game/SpawnerComponent.js",
 		"bin-debug/game/SpawnerSystem.js"
 	]

demo/resource/default.res.json

@@ -132,9 +132,19 @@
 			"name": "egret_icon_png"
 		},
 		{
-			"name": "description_json",
+			"url": "config/description.json",
 			"type": "json",
-			"url": "config/description.json"
+			"name": "description_json"
+		},
+		{
+			"url": "assets/isometric_grass_and_water.json",
+			"type": "json",
+			"name": "isometric_grass_and_water_json"
+		},
+		{
+			"url": "assets/isometric_grass_and_water.png",
+			"type": "image",
+			"name": "isometric_grass_and_water_png"
 		}
 	]
 }

demo/src/Main.ts

@@ -27,63 +27,29 @@
 //
 //////////////////////////////////////////////////////////////////////////////////////
 
-
-class Main extends eui.UILayer {
-
-    protected createChildren(): void {
-        super.createChildren();
-
-        egret.lifecycle.addLifecycleListener((context) => {
-            // custom lifecycle plugin
-        })
-
-        egret.lifecycle.onPause = () => {
-            egret.ticker.pause();
-        }
-
-        egret.lifecycle.onResume = () => {
-            egret.ticker.resume();
-        }
-
-        //inject the custom material parser
-        //注入自定义的素材解析器
-        let assetAdapter = new AssetAdapter();
-        egret.registerImplementation("eui.IAssetAdapter", assetAdapter);
-        egret.registerImplementation("eui.IThemeAdapter", new ThemeAdapter());
-
-
+class Main extends es.Core {
+    protected initialize() {
         this.runGame();
     }
 
-    private async runGame() {
-        await this.loadResource();
-        this.createGameScene();
+    private runGame() {
+        this.loadResource();
     }
 
-    private async loadResource() {
-        try {
-            const loadingView = new LoadingUI();
-            this.stage.addChild(loadingView);
-            await RES.loadConfig("resource/default.res.json", "resource/");
-            await this.loadTheme();
-            await RES.loadGroup("preload", 0, loadingView);
-            this.stage.removeChild(loadingView);
-        }
-        catch (e) {
-            console.error(e);
-        }
-    }
 
-    private loadTheme() {
-        return new Promise((resolve, reject) => {
-            // load skin theme configuration file, you can manually modify the file. And replace the default skin.
-            //加载皮肤主题配置文件,可以手动修改这个文件。替换默认皮肤。
-            let theme = new eui.Theme("resource/default.thm.json", this.stage);
-            theme.addEventListener(eui.UIEvent.COMPLETE, () => {
-                resolve();
-            }, this);
-
-        })
+    private loadResource() {
+        const loadingView = new LoadingUI();
+        this.stage.addChild(loadingView);
+        RES.loadConfig("resource/default.res.json", "resource/").then(()=>{
+            RES.loadGroup("preload", 0, loadingView).then(()=>{
+                this.stage.removeChild(loadingView);
+                this.createGameScene();
+            }).catch(err => {
+                console.error(err);
+            });
+        }).catch(err =>{
+            console.error(err);
+        });
     }
 
     /**
@@ -91,9 +57,6 @@ class Main extends eui.UILayer {
      * Create scene interface
      */
     protected createGameScene(): void {
-        let scene = SceneManager.createScene("main", new MainScene(this)).setActive();
-        let player = scene.createEntity("player");
-        player.addComponent(new SpawnComponent(EnemyType.worm));
-        // console.log(player.transform.position);
+        es.Core.scene = new scene.MainScene();
     }
 }

demo/src/game/MainScene.ts

@@ -1,20 +1,90 @@
-class MainScene extends Scene {
-    constructor(displayContent: egret.DisplayObject){
-        super(displayContent);
+module scene {
+    export class MainScene extends es.Scene {
+        constructor() {
+            super();
 
-        this.addEntityProcessor(new SpawnerSystem(new Matcher()));
-        this.astarTest();
+            // this.addEntityProcessor(new SpawnerSystem(new Matcher()));
+            this.astarTest();
+            this.dijkstraTest();
+            this.breadthfirstTest();
+        }
+
+        public async onStart() {
+            let sprite = new es.Sprite(RES.getRes("checkbox_select_disabled_png"));
+            let bg = this.createEntity("bg");
+            bg.addComponent(new es.SpriteRenderer()).setSprite(sprite).setColor(0xff0000);
+            bg.addComponent(new component.PlayerController());
+            bg.addComponent(new es.Mover());
+            bg.addComponent(new es.ScrollingSpriteRenderer(sprite));
+            bg.addComponent(new es.BoxCollider());
+            bg.position = new es.Vector2(Math.random() * 200, Math.random() * 200);
+
+            for (let i = 0; i < 20; i++) {
+                let sprite = new es.Sprite(RES.getRes("checkbox_select_disabled_png"));
+                let player2 = this.createEntity("player2");
+                player2.addComponent(new es.SpriteRenderer()).setSprite(sprite);
+                player2.position = new es.Vector2(Math.random() * 1000, Math.random() * 1000);
+                player2.addComponent(new es.BoxCollider());
+            }
+
+            this.camera.follow(bg, es.CameraStyle.lockOn);
+
+            let pool = new es.ComponentPool<component.SimplePooled>(component.SimplePooled);
+            let c1 = pool.obtain();
+            let c2 = pool.obtain();
+            pool.free(c1);
+            let c1b = pool.obtain();
+
+            console.log(c1 != c2);
+            console.log(c1 == c1b);
+
+            let button = new eui.Button();
+            button.label = "切换场景";
+            this.addChild(button);
+            button.addEventListener(egret.TouchEvent.TOUCH_TAP, () => {
+                es.Core.startSceneTransition(new es.FadeTransition(() => {
+                    return new MainScene();
+                }));
+            }, this);
+        }
+
+        public breadthfirstTest() {
+            let graph = new es.UnweightedGraph<string>();
+
+            graph.addEdgesForNode("a", ["b"]); // a->b
+            graph.addEdgesForNode("b", ["a", "c", "d"]); // b->a b->c b->d
+            graph.addEdgesForNode("c", ["a"]); // c->a
+            graph.addEdgesForNode("d", ["e", "a"]); // d->e d->a
+            graph.addEdgesForNode("e", ["b"]); // e->b
+
+            // 计算从c到e的路径
+            let path = es.BreadthFirstPathfinder.search(graph, "c", "e");
+            console.log(path);
+        }
+
+        public dijkstraTest() {
+            let graph = new es.WeightedGridGraph(20, 20);
+
+            graph.weightedNodes.push(new es.Vector2(3, 3));
+            graph.weightedNodes.push(new es.Vector2(3, 4));
+            graph.weightedNodes.push(new es.Vector2(4, 3));
+            graph.weightedNodes.push(new es.Vector2(4, 4));
+
+            let path = graph.search(new es.Vector2(3, 4), new es.Vector2(15, 17));
+            console.log(path);
+        }
+
+        public astarTest() {
+            let graph = new es.AstarGridGraph(30, 30);
+
+            // graph.weightedNodes.push(new Vector2(3, 3));
+            // graph.weightedNodes.push(new Vector2(3, 4));
+            // graph.weightedNodes.push(new Vector2(4, 3));
+            // graph.weightedNodes.push(new Vector2(4, 4));
+
+            let startTime = egret.getTimer();
+            let path = graph.search(new es.Vector2(1, 1), new es.Vector2(29, 29));
+            console.log(egret.getTimer() - startTime);
+        }
     }
-
-    public astarTest(){
-        let graph = new AstarGridGraph(20, 20);
-
-        graph.weightedNodes.push(new Point(3, 3));
-        graph.weightedNodes.push(new Point(3, 4));
-        graph.weightedNodes.push(new Point(4, 3));
-        graph.weightedNodes.push(new Point(4, 4));
-
-        let path = graph.search(new Point(3, 4), new Point(15, 17));
-        console.log(path);
-    }
-}
+}

demo/src/game/PlayerController.ts

@@ -0,0 +1,66 @@
+module component {
+    import Component = es.Component;
+    import Vector2 = es.Vector2;
+    import Mover = es.Mover;
+    import SpriteRenderer = es.SpriteRenderer;
+    import Time = es.Time;
+    import Input = es.Input;
+    import CollisionResult = es.CollisionResult;
+
+    export class PlayerController extends Component {
+        private down: boolean = false;
+        private touchPoint: Vector2 = Vector2.zero;
+        private mover: Mover;
+        private spriteRenderer: SpriteRenderer;
+
+        public onAddedToEntity(){
+            this.entity.scene.stage.addEventListener(egret.TouchEvent.TOUCH_BEGIN, this.touchBegin, this);
+            this.entity.scene.stage.addEventListener(egret.TouchEvent.TOUCH_MOVE, this.touchBegin, this);
+            this.entity.scene.stage.addEventListener(egret.TouchEvent.TOUCH_END, this.touchEnd, this);
+        }
+
+        private touchBegin(evt: egret.TouchEvent){
+            this.down = true;
+            this.touchPoint = new Vector2(evt.stageX, evt.stageY);
+        }
+
+        private touchEnd(evt: egret.TouchEvent){
+            this.down = false;
+            this.touchPoint = new Vector2(evt.stageX, evt.stageY);
+        }
+
+        public update(){
+            if (!this.mover)
+                this.mover = this.entity.getComponent<Mover>(Mover);
+
+            if (!this.spriteRenderer)
+                this.spriteRenderer = this.entity.getComponent<SpriteRenderer>(SpriteRenderer);
+
+            if (!this.mover)
+                return;
+
+            if (!SpriteRenderer)
+                return;
+
+            if (this.down){
+                let moveLeft: number = 0;
+                let moveRight: number = 0;
+                let speed = 100;
+                let worldPos = this.entity.scene.camera.mouseToWorldPoint();
+                if (worldPos.x < this.spriteRenderer.transform.position.x){
+                    moveLeft = -1;
+                } else if(worldPos.x > this.spriteRenderer.transform.position.x){
+                    moveLeft = 1;
+                }
+
+                if (worldPos.y < this.spriteRenderer.transform.position.y){
+                    moveRight = -1;
+                } else if(worldPos.y > this.spriteRenderer.transform.position.y){
+                    moveRight = 1;
+                }
+                let collisionResult = new CollisionResult();
+                this.mover.move(new Vector2(moveLeft * speed * Time.deltaTime, moveRight * speed * Time.deltaTime), collisionResult);
+            }
+        }
+    }
+}

demo/src/game/SimplePooled.ts

@@ -0,0 +1,9 @@
+module component {
+    import PooledComponent = es.PooledComponent;
+
+    export class SimplePooled extends PooledComponent {
+        public reset(){
+
+        }
+    }
+}

demo/src/game/SpawnerComponent.ts

@@ -1,25 +1,37 @@
-class SpawnComponent extends Component {
-    public cooldown = -1;
-    public minInterval = 2;
-    public maxInterval = 60;
-    public enemyType = EnemyType.worm;
-    public numSpawned = 0;
-    public numAlive = 0;
+module component {
+    export class SpawnComponent extends es.Component implements es.ITriggerListener {
+        public cooldown = -1;
+        public minInterval = 2;
+        public maxInterval = 60;
+        public enemyType = EnemyType.worm;
+        public numSpawned = 0;
+        public numAlive = 0;
 
-    constructor(enemyType: EnemyType) {
-        super();
-        this.enemyType = enemyType;
+        constructor(enemyType: EnemyType) {
+            super();
+            this.enemyType = enemyType;
+        }
+
+        public initialize() {
+            // console.log("initialize");
+        }
+
+        public update() {
+            // console.log("update");
+        }
+
+        public onTriggerEnter(other: es.Collider, local: es.Collider){
+            if (other == local)
+                console.log("repeat collider");
+            console.log("enter collider");
+        }
+
+        public onTriggerExit(other: es.Collider, local: es.Collider){
+            console.log("exit collider");
+        }
     }
 
-    public initialize() {
-        // console.log("initialize");
-    }
-
-    public update() {
-        // console.log("update");
+    export enum EnemyType {
+        worm
     }
 }
-
-enum EnemyType {
-    worm
-}

demo/src/game/SpawnerSystem.ts

@@ -1,34 +1,36 @@
-class SpawnerSystem extends EntityProcessingSystem {
-    constructor(matcher: Matcher){
-        super(matcher);
-    }
-
-    public processEntity(entity: Entity){
-        let spawner = entity.getComponent<SpawnComponent>(SpawnComponent);
-        if (!spawner)
-            return;
-
-        if (spawner.numAlive <= 0)
-            spawner.enabled = true;
-
-        if (!spawner.enabled)
-            return;
-
-        console.log("cooldown", spawner.cooldown);
-        if (spawner.cooldown == -1){
-            spawner.cooldown = Math.random() * 60;
-            spawner.cooldown /= 4;
+module system {
+    export class SpawnerSystem extends es.EntityProcessingSystem {
+        constructor(matcher: es.Matcher){
+            super(matcher);
         }
 
-        spawner.cooldown -= Time.deltaTime;
-        if (spawner.cooldown <= 0){
-            spawner.cooldown = Math.random() * 60;
-            // CreateEnemy
-            spawner.numSpawned ++;
-            spawner.numAlive ++;
+        public processEntity(entity: es.Entity){
+            let spawner = entity.getComponent<component.SpawnComponent>(component.SpawnComponent);
+            if (!spawner)
+                return;
 
-            if (spawner.numAlive > 0)
-                spawner.enabled = false;
+            if (spawner.numAlive <= 0)
+                spawner.enabled = true;
+
+            if (!spawner.enabled)
+                return;
+
+            console.log("cooldown", spawner.cooldown);
+            if (spawner.cooldown == -1){
+                spawner.cooldown = Math.random() * 60;
+                spawner.cooldown /= 4;
+            }
+
+            spawner.cooldown -= es.Time.deltaTime;
+            if (spawner.cooldown <= 0){
+                spawner.cooldown = Math.random() * 60;
+                // CreateEnemy
+                spawner.numSpawned ++;
+                spawner.numAlive ++;
+
+                if (spawner.numAlive > 0)
+                    spawner.enabled = false;
+            }
         }
     }
-}
+}

demo/template/runtime/native_require.js

@@ -32,7 +32,7 @@ egret_native.egretStart = function () {
         //The following is automatically modified, please do not modify
         //----auto option start----
 		entryClassName: "Main",
-		frameRate: 30,
+		frameRate: 60,
 		scaleMode: "fixedWidth",
 		contentWidth: 640,
 		contentHeight: 1136,

demo/tsconfig.json

@@ -2,6 +2,7 @@
     "compilerOptions": {
         "target": "es5",
         "outDir": "bin-debug",
+        "sourceMap": true,
         "experimentalDecorators": true,
         "emitDecoratorMetadata": true,
         "lib": [

source/.vscode/tasks.json

@@ -1,13 +1,13 @@
 {
-    // See https://go.microsoft.com/fwlink/?LinkId=733558 
-    // for the documentation about the tasks.json format
-    "version": "2.0.0",
-    "tasks": [
-        {
-            "type": "gulp",
-            "task": "build",
-            "group": "build",
-            "problemMatcher": []
-        }
-    ]
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // for the documentation about the tasks.json format
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "type": "gulp",
+      "task": "build",
+      "group": "build",
+      "problemMatcher": []
+    }
+  ]
 }

source/.wing/settings.json

@@ -0,0 +1,3 @@
+{
+  "typescript.tsdk": "./node_modules/typescript/lib"
+}

source/gulpfile.js

@@ -11,7 +11,7 @@ gulp.task('buildJs', () => {
         .js.pipe(inject.replace('var framework;', ''))
         .pipe(inject.prepend('window.framework = {};\n'))
         .pipe(inject.replace('var __extends =', 'window.__extends ='))
-        .pipe(minify({ ext: { min: ".min.js" } }))
+        .pipe(minify({ext: {min: ".min.js"}}))
         .pipe(gulp.dest('./bin'));
 });
 

source/lib/egret.d.ts

@@ -10967,13 +10967,13 @@ declare namespace egret {
         const RUNTIME2 = "runtime2";
         /**
          * Running on Alipay
-         * @version Egret 5.2.23
+         * @version Egret 5.2.33
          * @platform All
          * @language en_US
          */
         /**
          * 运行在支付宝小游戏上
-         * @version Egret 5.2.26
+         * @version Egret 5.2.33
          * @platform All
          * @language zh_CN
          */

source/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@esengine/egret-framework",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "用于egret 包含众多高性能方法以供使用",
   "main": "index.js",
   "directories": {
     "lib": "lib"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "mocha --recursive --reporter tap --growl",
+    "eslint": "eslint src --ext .ts"
   },
   "author": "yhh",
   "license": "MIT",
@@ -18,6 +19,7 @@
     "gulp": "^3.9.1",
     "gulp-babel": "^8.0.0",
     "gulp-concat": "^2.6.1",
+    "gulp-inject-string": "^1.1.2",
     "gulp-minify": "^3.1.0",
     "gulp-string-replace": "^1.1.2",
     "gulp-typescript": "^3.1.6",
@@ -25,10 +27,10 @@
     "tsify": "^3.0.1",
     "typescript": "^2.2.2",
     "vinyl-source-stream": "^1.1.0",
-    "watchify": "^3.9.0",
-    "gulp-inject-string": "^1.1.2"
+    "watchify": "^3.9.0"
   },
   "publishConfig": {
     "registry": "https://npm.pkg.github.com/359807859@qq.com"
-  }
+  },
+  "dependencies": {}
 }

source/src/AI/Pathfinding/AStar/AStarPathfinder.ts

@@ -1,89 +1,103 @@
 ///<reference path="./PriorityQueueNode.ts" />
-/**
- * 计算路径给定的IAstarGraph和开始/目标位置
- */
-class AStarPathfinder {
-    public static search<T>(graph: IAstarGraph<T>, start: T, goal: T){
-        let foundPath = false;
-        let cameFrom = new Map<T, T>();
-        cameFrom.set(start, start);
+module es {
+    /**
+     * 计算路径给定的IAstarGraph和开始/目标位置
+     */
+    export class AStarPathfinder {
+        /**
+         * 尽可能从开始到目标找到一条路径。如果没有找到路径，则返回null。
+         * @param graph
+         * @param start
+         * @param goal
+         */
+        public static search<T>(graph: IAstarGraph<T>, start: T, goal: T) {
+            let foundPath = false;
+            let cameFrom = new Map<T, T>();
+            cameFrom.set(start, start);
 
-        let costSoFar = new Map<T, number>();
-        let frontier = new PriorityQueue<AStarNode<T>>(1000);
-        frontier.enqueue(new AStarNode<T>(start), 0);
+            let costSoFar = new Map<T, number>();
+            let frontier = new PriorityQueue<AStarNode<T>>(1000);
+            frontier.enqueue(new AStarNode<T>(start), 0);
 
-        costSoFar.set(start, 0);
+            costSoFar.set(start, 0);
 
-        while (frontier.count > 0){
-            let current = frontier.dequeue();
+            while (frontier.count > 0) {
+                let current = frontier.dequeue();
 
-            if (JSON.stringify(current.data) == JSON.stringify(goal)){
-                foundPath = true;
-                break;
+                if (JSON.stringify(current.data) == JSON.stringify(goal)) {
+                    foundPath = true;
+                    break;
+                }
+
+                graph.getNeighbors(current.data).forEach(next => {
+                    let newCost = costSoFar.get(current.data) + graph.cost(current.data, next);
+                    if (!this.hasKey(costSoFar, next) || newCost < costSoFar.get(next)) {
+                        costSoFar.set(next, newCost);
+                        let priority = newCost + graph.heuristic(next, goal);
+                        frontier.enqueue(new AStarNode<T>(next), priority);
+                        cameFrom.set(next, current.data);
+                    }
+                });
             }
 
-            graph.getNeighbors(current.data).forEach(next => {
-                let newCost = costSoFar.get(current.data) + graph.cost(current.data, next);
-                if (!this.hasKey(costSoFar, next) || newCost < costSoFar.get(next)){
-                    costSoFar.set(next, newCost);
-                    let priority = newCost + graph.heuristic(next, goal);
-                    frontier.enqueue(new AStarNode<T>(next), priority);
-                    cameFrom.set(next, current.data);
-                }
-            });
+            return foundPath ? this.recontructPath(cameFrom, start, goal) : null;
         }
 
-        return foundPath ? this.recontructPath(cameFrom, start, goal) : null;
+        /**
+         * 从cameFrom字典重新构造路径
+         * @param cameFrom
+         * @param start
+         * @param goal
+         */
+        public static recontructPath<T>(cameFrom: Map<T, T>, start: T, goal: T): T[] {
+            let path = [];
+            let current = goal;
+            path.push(goal);
+
+            while (current != start) {
+                current = this.getKey(cameFrom, current);
+                path.push(current);
+            }
+
+            path.reverse();
+
+            return path;
+        }
+
+        private static hasKey<T>(map: Map<T, number>, compareKey: T) {
+            let iterator = map.keys();
+            let r: IteratorResult<T>;
+            while (r = iterator.next() , !r.done) {
+                if (JSON.stringify(r.value) == JSON.stringify(compareKey))
+                    return true;
+            }
+
+            return false;
+        }
+
+        private static getKey<T>(map: Map<T, T>, compareKey: T) {
+            let iterator = map.keys();
+            let valueIterator = map.values();
+            let r: IteratorResult<T>;
+            let v: IteratorResult<T>;
+            while (r = iterator.next(), v = valueIterator.next(), !r.done) {
+                if (JSON.stringify(r.value) == JSON.stringify(compareKey))
+                    return v.value;
+            }
+
+            return null;
+        }
     }
 
-    private static hasKey<T>(map: Map<T, number>, compareKey: T){
-        let iterator = map.keys();
-        let r: IteratorResult<T>;
-        while (r = iterator.next() , !r.done) {
-            if (JSON.stringify(r.value) == JSON.stringify(compareKey))
-                return true;
+    /**
+     * 使用PriorityQueue需要的额外字段将原始数据封装在一个小类中
+     */
+    export class AStarNode<T> extends PriorityQueueNode {
+        public data: T;
+
+        constructor(data: T) {
+            super();
+            this.data = data;
         }
-
-        return false;
-    }
-
-    private static getKey<T>(map: Map<T, T>, compareKey: T){
-        let iterator = map.keys();
-        let valueIterator = map.values();
-        let r: IteratorResult<T>;
-        let v: IteratorResult<T>;
-        while (r = iterator.next(), v = valueIterator.next(), !r.done) {
-            if (JSON.stringify(r.value) == JSON.stringify(compareKey))
-                return v.value;
-        }
-
-        return null;
-    }
-
-    public static recontructPath<T>(cameFrom: Map<T, T>, start: T, goal: T): T[]{
-        let path = [];
-        let current = goal;
-        path.push(goal);
-
-        while (current != start){
-            current = this.getKey(cameFrom, current);
-            path.push(current);
-        }
-
-        path.reverse();
-
-        return path;
     }
 }
-
-/**
- * 使用PriorityQueue需要的额外字段将原始数据封装在一个小类中
- */
-class AStarNode<T> extends PriorityQueueNode {
-    public data: T;
-
-    constructor(data: T){
-        super();
-        this.data = data;
-    }
-}

source/src/AI/Pathfinding/AStar/AstarGridGraph.ts

@@ -1,67 +1,74 @@
-/**
- * 基本静态网格图与A*一起使用
- * 将walls添加到walls HashSet，并将加权节点添加到weightedNodes
- */
-class AstarGridGraph implements IAstarGraph<Point> {
-    public dirs: Point[] = [
-        new Point(1, 0),
-        new Point(0, -1),
-        new Point(-1, 0),
-        new Point(0, 1)
-    ];
-
-    public walls: Point[] = [];
-    public weightedNodes: Point[] = [];
-    public defaultWeight: number = 1;
-    public weightedNodeWeight = 5;
-
-    private _width;
-    private _height;
-    private _neighbors: Point[] = new Array(4);
-
-    constructor(width: number, height: number){
-        this._width = width;
-        this._height = height;
-    }
-
+module es {
     /**
-     * 确保节点在网格图的边界内
-     * @param node 
+     * 基本静态网格图与A*一起使用
+     * 将walls添加到walls HashSet，并将加权节点添加到weightedNodes
      */
-    public isNodeInBounds(node: Point): boolean {
-        return 0 <= node.x && node.x < this._width && 0 <= node.y && node.y < this._height;
+    export class AstarGridGraph implements IAstarGraph<Vector2> {
+        public dirs: Vector2[] = [
+            new Vector2(1, 0),
+            new Vector2(0, -1),
+            new Vector2(-1, 0),
+            new Vector2(0, 1)
+        ];
+
+        public walls: Vector2[] = [];
+        public weightedNodes: Vector2[] = [];
+        public defaultWeight: number = 1;
+        public weightedNodeWeight = 5;
+
+        private _width;
+        private _height;
+        private _neighbors: Vector2[] = new Array(4);
+
+        constructor(width: number, height: number) {
+            this._width = width;
+            this._height = height;
+        }
+
+        /**
+         * 确保节点在网格图的边界内
+         * @param node
+         */
+        public isNodeInBounds(node: Vector2): boolean {
+            return 0 <= node.x && node.x < this._width && 0 <= node.y && node.y < this._height;
+        }
+
+        /**
+         * 检查节点是否可以通过。walls是不可逾越的。
+         * @param node
+         */
+        public isNodePassable(node: Vector2): boolean {
+            return !this.walls.firstOrDefault(wall => JSON.stringify(wall) == JSON.stringify(node));
+        }
+
+        /**
+         * 调用AStarPathfinder.search的快捷方式
+         * @param start
+         * @param goal
+         */
+        public search(start: Vector2, goal: Vector2) {
+            return AStarPathfinder.search(this, start, goal);
+        }
+
+        public getNeighbors(node: Vector2): Vector2[] {
+            this._neighbors.length = 0;
+
+            this.dirs.forEach(dir => {
+                let next = new Vector2(node.x + dir.x, node.y + dir.y);
+                if (this.isNodeInBounds(next) && this.isNodePassable(next))
+                    this._neighbors.push(next);
+            });
+
+            return this._neighbors;
+        }
+
+        public cost(from: Vector2, to: Vector2): number {
+            return this.weightedNodes.find((p) => JSON.stringify(p) == JSON.stringify(to)) ? this.weightedNodeWeight : this.defaultWeight;
+        }
+
+        public heuristic(node: Vector2, goal: Vector2) {
+            return Math.abs(node.x - goal.x) + Math.abs(node.y - goal.y);
+        }
+
     }
-
-    /**
-     * 检查节点是否可以通过。墙壁是不可逾越的。
-     * @param node 
-     */
-    public isNodePassable(node: Point): boolean {
-        return !this.walls.contains(node);
-    }
-
-    public search(start: Point, goal: Point){
-        return AStarPathfinder.search(this, start, goal);
-    }
-
-    public getNeighbors(node: Point): Point[] {
-        this._neighbors.length = 0;
-
-        this.dirs.forEach(dir => {
-            let next = new Point(node.x + dir.x, node.y + dir.y);
-            if (this.isNodeInBounds(next) && this.isNodePassable(next))
-                this._neighbors.push(next);
-        });
-
-        return this._neighbors;
-    }
-
-    public cost(from: Point, to: Point): number {
-        return this.weightedNodes.find((p)=> JSON.stringify(p) == JSON.stringify(to)) ? this.weightedNodeWeight : this.defaultWeight;
-    }
-
-    public heuristic(node: Point, goal: Point) {
-        return Math.abs(node.x - goal.x) + Math.abs(node.y - goal.y);
-    }
-
-}
+}

source/src/AI/Pathfinding/AStar/IAstarGraph.ts

@@ -1,5 +1,26 @@
-interface IAstarGraph<T> {
-    getNeighbors(node: T): Array<T>;
-    cost(from: T, to: T): number;
-    heuristic(node: T, goal: T);
-}
+module es {
+    /**
+     * graph的接口，可以提供给AstarPathfinder.search方法
+     */
+    export interface IAstarGraph<T> {
+        /**
+         * getNeighbors方法应该返回从传入的节点可以到达的任何相邻节点
+         * @param node
+         */
+        getNeighbors(node: T): Array<T>;
+
+        /**
+         * 计算从从from到to的成本
+         * @param from
+         * @param to
+         */
+        cost(from: T, to: T): number;
+
+        /**
+         * 计算从node到to的启发式。参见WeightedGridGraph了解常用的Manhatten方法。
+         * @param node
+         * @param goal
+         */
+        heuristic(node: T, goal: T);
+    }
+}

source/src/AI/Pathfinding/AStar/PriorityQueue.ts

@@ -1,150 +1,236 @@
-class PriorityQueue<T extends PriorityQueueNode> {
-    private _numNodes: number;
-    private _nodes: T[];
-    private _numNodesEverEnqueued;
+module es {
+    /**
+     * 使用堆实现最小优先级队列 O(1)复杂度
+     * 这种查找速度比使用字典快5-10倍
+     * 但是，由于IPriorityQueue.contains()是许多寻路算法中调用最多的方法，因此尽可能快地实现它对于我们的应用程序非常重要。
+     */
+    export class PriorityQueue<T extends PriorityQueueNode> {
+        private _numNodes: number;
+        private _nodes: T[];
+        private _numNodesEverEnqueued;
 
-    constructor(maxNodes: number) {
-        this._numNodes = 0;
-        this._nodes = new Array(maxNodes + 1);
-        this._numNodesEverEnqueued = 0;
-    }
+        /**
+         * 实例化一个新的优先级队列
+         * @param maxNodes 允许加入队列的最大节点(执行此操作将导致undefined的行为)
+         */
+        constructor(maxNodes: number) {
+            this._numNodes = 0;
+            this._nodes = new Array(maxNodes + 1);
+            this._numNodesEverEnqueued = 0;
+        }
 
-    public clear() {
-        this._nodes.splice(1, this._numNodes);
-        this._numNodes = 0;
-    }
+        /**
+         * 返回队列中的节点数。
+         * O(1)复杂度
+         */
+        public get count() {
+            return this._numNodes;
+        }
 
-    public get count() {
-        return this._numNodes;
-    }
+        /**
+         * 返回可同时进入此队列的最大项数。一旦你达到这个数字(即。一旦Count == MaxSize)，尝试加入另一个项目将导致undefined的行为
+         * O(1)复杂度
+         */
+        public get maxSize() {
+            return this._nodes.length - 1;
+        }
 
-    public contains(node: T): boolean {
-        return (this._nodes[node.queueIndex] == node);
-    }
+        /**
+         * 从队列中删除每个节点。
+         *  O(n)复杂度 所有尽可能少调用该方法
+         */
+        public clear() {
+            this._nodes.splice(1, this._numNodes);
+            this._numNodes = 0;
+        }
 
-    public enqueue(node: T, priority: number) {
-        node.priority = priority;
-        this._numNodes++;
-        this._nodes[this._numNodes] = node;
-        node.queueIndex = this._numNodes;
-        node.insertionIndex = this._numNodesEverEnqueued++;
-        this.cascadeUp(this._nodes[this._numNodes]);
-    }
+        /**
+         * 返回(在O(1)中)给定节点是否在队列中
+         * O (1)复杂度
+         * @param node
+         */
+        public contains(node: T): boolean {
+            if (!node) {
+                console.error("node cannot be null");
+                return false;
+            }
 
-    public dequeue(): T {
-        let returnMe = this._nodes[1];
-        this.remove(returnMe);
-        return returnMe;
-    }
+            if (node.queueIndex < 0 || node.queueIndex >= this._nodes.length) {
+                console.error("node.QueueIndex has been corrupted. Did you change it manually? Or add this node to another queue?");
+                return false;
+            }
 
-    public remove(node: T) {
-        if (node.queueIndex == this._numNodes) {
-            this._nodes[this._numNodes] = null;
+            return (this._nodes[node.queueIndex] == node);
+        }
+
+        /**
+         * 将节点放入优先队列 较低的值放在前面 先入先出
+         * 如果队列已满，则结果undefined。如果节点已经加入队列，则结果undefined。
+         * O(log n)
+         * @param node
+         * @param priority
+         */
+        public enqueue(node: T, priority: number) {
+            node.priority = priority;
+            this._numNodes++;
+            this._nodes[this._numNodes] = node;
+            node.queueIndex = this._numNodes;
+            node.insertionIndex = this._numNodesEverEnqueued++;
+            this.cascadeUp(this._nodes[this._numNodes]);
+        }
+
+        /**
+         * 删除队列头(具有最小优先级的节点;按插入顺序断开连接)，并返回它。如果队列为空，结果undefined
+         * O(log n)
+         */
+        public dequeue(): T {
+            let returnMe = this._nodes[1];
+            this.remove(returnMe);
+            return returnMe;
+        }
+
+        /**
+         * 从队列中删除一个节点。节点不需要是队列的头。如果节点不在队列中，则结果未定义。如果不确定，首先检查Contains()
+         * O(log n)
+         * @param node
+         */
+        public remove(node: T) {
+            if (node.queueIndex == this._numNodes) {
+                this._nodes[this._numNodes] = null;
+                this._numNodes--;
+                return;
+            }
+
+            let formerLastNode = this._nodes[this._numNodes];
+            this.swap(node, formerLastNode);
+            delete this._nodes[this._numNodes];
             this._numNodes--;
-            return;
+
+            this.onNodeUpdated(formerLastNode);
         }
 
-        let formerLastNode = this._nodes[this._numNodes];
-        this.swap(node, formerLastNode);
-        delete this._nodes[this._numNodes];
-        this._numNodes--;
+        /**
+         * 检查以确保队列仍然处于有效状态。用于测试/调试队列。
+         */
+        public isValidQueue(): boolean {
+            for (let i = 1; i < this._nodes.length; i++) {
+                if (this._nodes[i]) {
+                    let childLeftIndex = 2 * i;
+                    if (childLeftIndex < this._nodes.length && this._nodes[childLeftIndex] &&
+                        this.hasHigherPriority(this._nodes[childLeftIndex], this._nodes[i]))
+                        return false;
 
-        this.onNodeUpdated(formerLastNode);
-    }
-
-    public isValidQueue(): boolean {
-        for (let i = 1; i < this._nodes.length; i++) {
-            if (this._nodes[i]) {
-                let childLeftIndex = 2 * i;
-                if (childLeftIndex < this._nodes.length && this._nodes[childLeftIndex] &&
-                    this.hasHigherPriority(this._nodes[childLeftIndex], this._nodes[i]))
-                    return false;
-
-                let childRightIndex = childLeftIndex + 1;
-                if (childRightIndex < this._nodes.length && this._nodes[childRightIndex] &&
-                    this.hasHigherPriority(this._nodes[childRightIndex], this._nodes[i]))
-                    return false;
-            }
-        }
-
-        return true;
-    }
-
-    private onNodeUpdated(node: T) {
-        let parentIndex = Math.floor(node.queueIndex / 2);
-        let parentNode = this._nodes[parentIndex];
-
-        if (parentIndex > 0 && this.hasHigherPriority(node, parentNode)) {
-            this.cascadeUp(node);
-        } else {
-            this.cascadeDown(node);
-        }
-    }
-
-    private cascadeDown(node: T) {
-        let newParent: T;
-        let finalQueueIndex = node.queueIndex;
-        while (true) {
-            newParent = node;
-            let childLeftIndex = 2 * finalQueueIndex;
-
-            if (childLeftIndex > this._numNodes) {
-                node.queueIndex = finalQueueIndex;
-                this._nodes[finalQueueIndex] = node;
-                break;
-            }
-
-            let childLeft = this._nodes[childLeftIndex];
-            if (this.hasHigherPriority(childLeft, newParent)) {
-                newParent = childLeft;
-            }
-
-            let childRightIndex = childLeftIndex + 1;
-            if (childRightIndex <= this._numNodes) {
-                let childRight = this._nodes[childRightIndex];
-                if (this.hasHigherPriority(childRight, newParent)) {
-                    newParent = childRight;
+                    let childRightIndex = childLeftIndex + 1;
+                    if (childRightIndex < this._nodes.length && this._nodes[childRightIndex] &&
+                        this.hasHigherPriority(this._nodes[childRightIndex], this._nodes[i]))
+                        return false;
                 }
             }
 
-            if (newParent != node) {
-                this._nodes[finalQueueIndex] = newParent;
+            return true;
+        }
 
-                let temp = newParent.queueIndex;
-                newParent.queueIndex = finalQueueIndex;
-                finalQueueIndex = temp;
+        private onNodeUpdated(node: T) {
+            // 将更新后的节点按适当的方式向上或向下冒泡
+            let parentIndex = Math.floor(node.queueIndex / 2);
+            let parentNode = this._nodes[parentIndex];
+
+            if (parentIndex > 0 && this.hasHigherPriority(node, parentNode)) {
+                this.cascadeUp(node);
             } else {
-                node.queueIndex = finalQueueIndex;
-                this._nodes[finalQueueIndex] = node;
-                break;
+                // 注意，如果parentNode == node(即节点是根)，则将调用CascadeDown。
+                this.cascadeDown(node);
             }
         }
-    }
 
-    private cascadeUp(node: T) {
-        let parent = Math.floor(node.queueIndex / 2);
-        while (parent >= 1) {
-            let parentNode = this._nodes[parent];
-            if (this.hasHigherPriority(parentNode, node))
-                break;
+        private cascadeDown(node: T) {
+            // 又名Heapify-down
+            let newParent: T;
+            let finalQueueIndex = node.queueIndex;
+            while (true) {
+                newParent = node;
+                let childLeftIndex = 2 * finalQueueIndex;
 
-            this.swap(node, parentNode);
+                // 检查左子节点的优先级是否高于当前节点
+                if (childLeftIndex > this._numNodes) {
+                    // 这可以放在循环之外，但是我们必须检查newParent != node两次
+                    node.queueIndex = finalQueueIndex;
+                    this._nodes[finalQueueIndex] = node;
+                    break;
+                }
 
-            parent = Math.floor(node.queueIndex / 2);
+                let childLeft = this._nodes[childLeftIndex];
+                if (this.hasHigherPriority(childLeft, newParent)) {
+                    newParent = childLeft;
+                }
+
+                // 检查右子节点的优先级是否高于当前节点或左子节点
+                let childRightIndex = childLeftIndex + 1;
+                if (childRightIndex <= this._numNodes) {
+                    let childRight = this._nodes[childRightIndex];
+                    if (this.hasHigherPriority(childRight, newParent)) {
+                        newParent = childRight;
+                    }
+                }
+
+                // 如果其中一个子节点具有更高(更小)的优先级，则交换并继续级联
+                if (newParent != node) {
+                    // 将新的父节点移动到它的新索引
+                    // 节点将被移动一次，这样做比调用Swap()少一个赋值操作。
+                    this._nodes[finalQueueIndex] = newParent;
+
+                    let temp = newParent.queueIndex;
+                    newParent.queueIndex = finalQueueIndex;
+                    finalQueueIndex = temp;
+                } else {
+                    // 参见上面的笔记
+                    node.queueIndex = finalQueueIndex;
+                    this._nodes[finalQueueIndex] = node;
+                    break;
+                }
+            }
+        }
+
+        /**
+         * 当没有内联时，性能会稍微好一些
+         * @param node
+         */
+        private cascadeUp(node: T) {
+            // 又名Heapify-up
+            let parent = Math.floor(node.queueIndex / 2);
+            while (parent >= 1) {
+                let parentNode = this._nodes[parent];
+                if (this.hasHigherPriority(parentNode, node))
+                    break;
+
+                // 节点具有较低的优先级值，因此将其向上移动到堆中
+                // 出于某种原因，使用Swap()比使用单独的操作更快，如CascadeDown()
+                this.swap(node, parentNode);
+
+                parent = Math.floor(node.queueIndex / 2);
+            }
+        }
+
+        private swap(node1: T, node2: T) {
+            // 交换节点
+            this._nodes[node1.queueIndex] = node2;
+            this._nodes[node2.queueIndex] = node1;
+
+            // 交换他们的indicies
+            let temp = node1.queueIndex;
+            node1.queueIndex = node2.queueIndex;
+            node2.queueIndex = temp;
+        }
+
+        /**
+         * 如果higher的优先级高于lower，则返回true，否则返回false。
+         * 注意，调用HasHigherPriority(节点，节点)(即。两个参数为同一个节点)将返回false
+         * @param higher
+         * @param lower
+         */
+        private hasHigherPriority(higher: T, lower: T) {
+            return (higher.priority < lower.priority ||
+                (higher.priority == lower.priority && higher.insertionIndex < lower.insertionIndex));
         }
     }
-
-    private swap(node1: T, node2: T) {
-        this._nodes[node1.queueIndex] = node2;
-        this._nodes[node2.queueIndex] = node1;
-
-        let temp = node1.queueIndex;
-        node1.queueIndex = node2.queueIndex;
-        node2.queueIndex = temp;
-    }
-
-    private hasHigherPriority(higher: T, lower: T) {
-        return (higher.priority < lower.priority ||
-            (higher.priority == lower.priority && higher.insertionIndex < lower.insertionIndex));
-    }
-}
+}

source/src/AI/Pathfinding/AStar/PriorityQueueNode.ts

@@ -1,14 +1,16 @@
-class PriorityQueueNode {
-    /**
-     * 插入此节点的优先级。在将节点添加到队列之前必须设置
-     */
-    public priority: number = 0;
-    /**
-     * 由优先级队列使用-不要编辑此值。表示插入节点的顺序
-     */
-    public insertionIndex: number = 0;
-    /**
-     * 由优先级队列使用-不要编辑此值。表示队列中的当前位置
-     */
-    public queueIndex: number = 0;
-}
+module es {
+    export class PriorityQueueNode {
+        /**
+         * 插入此节点的优先级。在将节点添加到队列之前必须设置
+         */
+        public priority: number = 0;
+        /**
+         * 由优先级队列使用-不要编辑此值。表示插入节点的顺序
+         */
+        public insertionIndex: number = 0;
+        /**
+         * 由优先级队列使用-不要编辑此值。表示队列中的当前位置
+         */
+        public queueIndex: number = 0;
+    }
+}

source/src/AI/Pathfinding/BreadthFirst/BreadthFirstPathfinder.ts

@@ -0,0 +1,43 @@
+module es {
+    /**
+     * 计算路径给定的IUnweightedGraph和开始/目标位置
+     */
+    export class BreadthFirstPathfinder {
+        public static search<T>(graph: IUnweightedGraph<T>, start: T, goal: T): T[] {
+            let foundPath = false;
+            let frontier = [];
+            frontier.unshift(start);
+
+            let cameFrom = new Map<T, T>();
+            cameFrom.set(start, start);
+
+            while (frontier.length > 0) {
+                let current = frontier.shift();
+                if (JSON.stringify(current) == JSON.stringify(goal)) {
+                    foundPath = true;
+                    break;
+                }
+
+                graph.getNeighbors(current).forEach(next => {
+                    if (!this.hasKey(cameFrom, next)) {
+                        frontier.unshift(next);
+                        cameFrom.set(next, current);
+                    }
+                });
+            }
+
+            return foundPath ? AStarPathfinder.recontructPath(cameFrom, start, goal) : null;
+        }
+
+        private static hasKey<T>(map: Map<T, T>, compareKey: T) {
+            let iterator = map.keys();
+            let r: IteratorResult<T>;
+            while (r = iterator.next() , !r.done) {
+                if (JSON.stringify(r.value) == JSON.stringify(compareKey))
+                    return true;
+            }
+
+            return false;
+        }
+    }
+}

source/src/AI/Pathfinding/BreadthFirst/IUnweightedGraph.ts

@@ -0,0 +1,9 @@
+module es {
+    export interface IUnweightedGraph<T> {
+        /**
+         * getNeighbors方法应该返回从传入的节点可以到达的任何相邻节点。
+         * @param node
+         */
+        getNeighbors(node: T): T[];
+    }
+}

source/src/AI/Pathfinding/BreadthFirst/UnweightedGraph.ts

@@ -0,0 +1,18 @@
+module es {
+    /**
+     * 一个未加权图的基本实现。所有的边都被缓存。这种类型的图最适合于非基于网格的图。
+     * 作为边添加的任何节点都必须在边字典中有一个条目作为键。
+     */
+    export class UnweightedGraph<T> implements IUnweightedGraph<T> {
+        public edges: Map<T, T[]> = new Map<T, T[]>();
+
+        public addEdgesForNode(node: T, edges: T[]) {
+            this.edges.set(node, edges);
+            return this;
+        }
+
+        public getNeighbors(node: T) {
+            return this.edges.get(node);
+        }
+    }
+}

source/src/AI/Pathfinding/BreadthFirst/UnweightedGridGraph.ts

@@ -0,0 +1,63 @@
+///<reference path="../../../Math/Vector2.ts" />
+module es {
+    /**
+     * 基本的未加权网格图形用于BreadthFirstPathfinder
+     */
+    export class UnweightedGridGraph implements IUnweightedGraph<Vector2> {
+        private static readonly CARDINAL_DIRS: Vector2[] = [
+            new Vector2(1, 0),
+            new Vector2(0, -1),
+            new Vector2(-1, 0),
+            new Vector2(0, -1)
+        ];
+
+        private static readonly COMPASS_DIRS = [
+            new Vector2(1, 0),
+            new Vector2(1, -1),
+            new Vector2(0, -1),
+            new Vector2(-1, -1),
+            new Vector2(-1, 0),
+            new Vector2(-1, 1),
+            new Vector2(0, 1),
+            new Vector2(1, 1),
+        ];
+
+        public walls: Vector2[] = [];
+
+        private _width: number;
+        private _hegiht: number;
+
+        private _dirs: Vector2[];
+        private _neighbors: Vector2[] = new Array(4);
+
+        constructor(width: number, height: number, allowDiagonalSearch: boolean = false) {
+            this._width = width;
+            this._hegiht = height;
+            this._dirs = allowDiagonalSearch ? UnweightedGridGraph.COMPASS_DIRS : UnweightedGridGraph.CARDINAL_DIRS;
+        }
+
+        public isNodeInBounds(node: Vector2): boolean {
+            return 0 <= node.x && node.x < this._width && 0 <= node.y && node.y < this._hegiht;
+        }
+
+        public isNodePassable(node: Vector2): boolean {
+            return !this.walls.firstOrDefault(wall => JSON.stringify(wall) == JSON.stringify(node));
+        }
+
+        public getNeighbors(node: Vector2) {
+            this._neighbors.length = 0;
+
+            this._dirs.forEach(dir => {
+                let next = new Vector2(node.x + dir.x, node.y + dir.y);
+                if (this.isNodeInBounds(next) && this.isNodePassable(next))
+                    this._neighbors.push(next);
+            });
+
+            return this._neighbors;
+        }
+
+        public search(start: Vector2, goal: Vector2): Vector2[] {
+            return BreadthFirstPathfinder.search(this, start, goal);
+        }
+    }
+}

source/src/AI/Pathfinding/Dijkstra/IWeightedGraph.ts

@@ -0,0 +1,16 @@
+module es {
+    export interface IWeightedGraph<T> {
+        /**
+         *
+         * @param node
+         */
+        getNeighbors(node: T): T[];
+
+        /**
+         *
+         * @param from
+         * @param to
+         */
+        cost(from: T, to: T): number;
+    }
+}

source/src/AI/Pathfinding/Dijkstra/WeightedGridGraph.ts

@@ -0,0 +1,69 @@
+///<reference path="../../../Math/Vector2.ts" />
+module es {
+    /**
+     * 支持一种加权节点的基本网格图
+     */
+    export class WeightedGridGraph implements IWeightedGraph<Vector2> {
+        public static readonly CARDINAL_DIRS = [
+            new Vector2(1, 0),
+            new Vector2(0, -1),
+            new Vector2(-1, 0),
+            new Vector2(0, 1)
+        ];
+
+        private static readonly COMPASS_DIRS = [
+            new Vector2(1, 0),
+            new Vector2(1, -1),
+            new Vector2(0, -1),
+            new Vector2(-1, -1),
+            new Vector2(-1, 0),
+            new Vector2(-1, 1),
+            new Vector2(0, 1),
+            new Vector2(1, 1),
+        ];
+
+        public walls: Vector2[] = [];
+        public weightedNodes: Vector2[] = [];
+        public defaultWeight = 1;
+        public weightedNodeWeight = 5;
+
+        private _width: number;
+        private _height: number;
+        private _dirs: Vector2[];
+        private _neighbors: Vector2[] = new Array(4);
+
+        constructor(width: number, height: number, allowDiagonalSearch: boolean = false) {
+            this._width = width;
+            this._height = height;
+            this._dirs = allowDiagonalSearch ? WeightedGridGraph.COMPASS_DIRS : WeightedGridGraph.CARDINAL_DIRS;
+        }
+
+        public isNodeInBounds(node: Vector2) {
+            return 0 <= node.x && node.x < this._width && 0 <= node.y && node.y < this._height;
+        }
+
+        public isNodePassable(node: Vector2): boolean {
+            return !this.walls.firstOrDefault(wall => JSON.stringify(wall) == JSON.stringify(node));
+        }
+
+        public search(start: Vector2, goal: Vector2) {
+            return WeightedPathfinder.search(this, start, goal);
+        }
+
+        public getNeighbors(node: Vector2): Vector2[] {
+            this._neighbors.length = 0;
+
+            this._dirs.forEach(dir => {
+                let next = new Vector2(node.x + dir.x, node.y + dir.y);
+                if (this.isNodeInBounds(next) && this.isNodePassable(next))
+                    this._neighbors.push(next);
+            });
+
+            return this._neighbors;
+        }
+
+        public cost(from: Vector2, to: Vector2): number {
+            return this.weightedNodes.find(t => JSON.stringify(t) == JSON.stringify(to)) ? this.weightedNodeWeight : this.defaultWeight;
+        }
+    }
+}

source/src/AI/Pathfinding/Dijkstra/WeightedPathfinder.ts

@@ -0,0 +1,85 @@
+module es {
+    export class WeightedNode<T> extends PriorityQueueNode {
+        public data: T;
+
+        constructor(data: T) {
+            super();
+            this.data = data;
+        }
+    }
+
+    export class WeightedPathfinder {
+        public static search<T>(graph: IWeightedGraph<T>, start: T, goal: T) {
+            let foundPath = false;
+
+            let cameFrom = new Map<T, T>();
+            cameFrom.set(start, start);
+
+            let costSoFar = new Map<T, number>();
+            let frontier = new PriorityQueue<WeightedNode<T>>(1000);
+            frontier.enqueue(new WeightedNode<T>(start), 0);
+
+            costSoFar.set(start, 0);
+
+            while (frontier.count > 0) {
+                let current = frontier.dequeue();
+
+                if (JSON.stringify(current.data) == JSON.stringify(goal)) {
+                    foundPath = true;
+                    break;
+                }
+
+                graph.getNeighbors(current.data).forEach(next => {
+                    let newCost = costSoFar.get(current.data) + graph.cost(current.data, next);
+                    if (!this.hasKey(costSoFar, next) || newCost < costSoFar.get(next)) {
+                        costSoFar.set(next, newCost);
+                        let priprity = newCost;
+                        frontier.enqueue(new WeightedNode<T>(next), priprity);
+                        cameFrom.set(next, current.data);
+                    }
+                });
+            }
+
+            return foundPath ? this.recontructPath(cameFrom, start, goal) : null;
+        }
+
+        public static recontructPath<T>(cameFrom: Map<T, T>, start: T, goal: T): T[] {
+            let path = [];
+            let current = goal;
+            path.push(goal);
+
+            while (current != start) {
+                current = this.getKey(cameFrom, current);
+                path.push(current);
+            }
+
+            path.reverse();
+
+            return path;
+        }
+
+        private static hasKey<T>(map: Map<T, number>, compareKey: T) {
+            let iterator = map.keys();
+            let r: IteratorResult<T>;
+            while (r = iterator.next() , !r.done) {
+                if (JSON.stringify(r.value) == JSON.stringify(compareKey))
+                    return true;
+            }
+
+            return false;
+        }
+
+        private static getKey<T>(map: Map<T, T>, compareKey: T) {
+            let iterator = map.keys();
+            let valueIterator = map.values();
+            let r: IteratorResult<T>;
+            let v: IteratorResult<T>;
+            while (r = iterator.next(), v = valueIterator.next(), !r.done) {
+                if (JSON.stringify(r.value) == JSON.stringify(compareKey))
+                    return v.value;
+            }
+
+            return null;
+        }
+    }
+}

source/src/Debug/Debug.ts

@@ -0,0 +1,24 @@
+module es {
+    export class Debug {
+        private static _debugDrawItems: DebugDrawItem[] = [];
+
+        public static drawHollowRect(rectanle: Rectangle, color: number, duration = 0) {
+            this._debugDrawItems.push(new DebugDrawItem(rectanle, color, duration));
+        }
+
+        public static render() {
+            if (this._debugDrawItems.length > 0) {
+                let debugShape = new egret.Shape();
+                if (Core.scene) {
+                    Core.scene.addChild(debugShape);
+                }
+
+                for (let i = this._debugDrawItems.length - 1; i >= 0; i--) {
+                    let item = this._debugDrawItems[i];
+                    if (item.draw(debugShape))
+                        this._debugDrawItems.removeAt(i);
+                }
+            }
+        }
+    }
+}

source/src/Debug/DebugDefaults.ts

@@ -0,0 +1,6 @@
+module es {
+    export class DebugDefaults {
+        public static verletParticle = 0xDC345E;
+        public static verletConstraintEdge = 0x433E36;
+    }
+}

source/src/Debug/DebugDrawItem.ts

@@ -0,0 +1,49 @@
+module es {
+    export enum DebugDrawType {
+        line,
+        hollowRectangle,
+        pixel,
+        text
+    }
+
+    export class DebugDrawItem {
+        public rectangle: Rectangle;
+        public color: number;
+        public duration: number;
+        public drawType: DebugDrawType;
+        public text: string;
+        public start: Vector2;
+        public end: Vector2;
+        public x: number;
+        public y: number;
+        public size: number;
+
+        constructor(rectangle: Rectangle, color: number, duration: number) {
+            this.rectangle = rectangle;
+            this.color = color;
+            this.duration = duration;
+            this.drawType = DebugDrawType.hollowRectangle;
+        }
+
+        public draw(shape: egret.Shape): boolean {
+            switch (this.drawType) {
+                case DebugDrawType.line:
+                    DrawUtils.drawLine(shape, this.start, this.end, this.color);
+                    break;
+                case DebugDrawType.hollowRectangle:
+                    DrawUtils.drawHollowRect(shape, this.rectangle, this.color);
+                    break;
+                case DebugDrawType.pixel:
+                    DrawUtils.drawPixel(shape, new Vector2(this.x, this.y), this.color, this.size);
+                    break;
+                case DebugDrawType.text:
+                    break;
+            }
+
+            this.duration -= Time.deltaTime;
+            return this.duration < 0;
+        }
+    }
+}
+
+

source/src/ECS/Component.ts

@@ -1,76 +1,137 @@
-abstract class Component {
-    public entity: Entity;
-    public displayRender: egret.DisplayObject;
-    private _enabled: boolean = true;
-    public updateInterval: number = 1;
+module es {
+    /**
+     * 执行顺序
+     *  - onAddedToEntity
+     *  - OnEnabled
+     *
+     *  删除执行顺序
+     *      - onRemovedFromEntity
+     */
+    export abstract class Component extends egret.HashObject {
+        /**
+         * 此组件附加的实体
+         */
+        public entity: Entity;
+        /**
+         * 更新该组件的时间间隔。这与实体的更新间隔无关。
+         */
+        public updateInterval: number = 1;
 
-    public get transform(){
-        return this.entity.transform;
-    }
-
-    public get enabled(){
-        return this.entity ? this.entity.enabled && this._enabled : this._enabled;
-    }
-
-    public set enabled(value: boolean){
-        this.setEnabled(value);
-    }
-
-    public setEnabled(isEnabled: boolean){
-        if (this._enabled != isEnabled){
-            this._enabled = isEnabled;
-
-            if (this._enabled){
-                this.onEnabled();
-            }else{
-                this.onDisabled();
-            }
+        /**
+         * 快速访问 this.entity.transform
+         */
+        public get transform(): Transform {
+            return this.entity.transform;
         }
 
-        return this;
+        private _enabled: boolean = true;
+
+        /**
+         * 如果组件和实体都已启用，则为。当启用该组件时，将调用该组件的生命周期方法。状态的改变会导致调用onEnabled/onDisable。
+         */
+        public get enabled() {
+            return this.entity ? this.entity.enabled && this._enabled : this._enabled;
+        }
+
+        /**
+         * 如果组件和实体都已启用，则为。当启用该组件时，将调用该组件的生命周期方法。状态的改变会导致调用onEnabled/onDisable。
+         * @param value
+         */
+        public set enabled(value: boolean) {
+            this.setEnabled(value);
+        }
+
+        private _updateOrder = 0;
+
+        /** 更新此实体上组件的顺序 */
+        public get updateOrder() {
+            return this._updateOrder;
+        }
+
+        /** 更新此实体上组件的顺序 */
+        public set updateOrder(value: number) {
+            this.setUpdateOrder(value);
+        }
+
+        /**
+         * 当此组件已分配其实体，但尚未添加到实体的活动组件列表时调用。有用的东西，如物理组件，需要访问转换来修改碰撞体的属性。
+         */
+        public initialize() {
+        }
+
+        /**
+         * 在提交所有挂起的组件更改后，将该组件添加到场景时调用。此时，设置了实体字段和实体。场景也设定好了。
+         */
+        public onAddedToEntity() {
+        }
+
+        /**
+         * 当此组件从其实体中移除时调用。在这里做所有的清理工作。
+         */
+        public onRemovedFromEntity() {
+        }
+
+        /**
+         * 当实体的位置改变时调用。这允许组件知道它们由于父实体的移动而移动了。
+         * @param comp
+         */
+        public onEntityTransformChanged(comp: transform.Component) {
+        }
+
+        /**
+         *
+         */
+        public debugRender() {
+        }
+
+        /**
+         *当父实体或此组件启用时调用
+         */
+        public onEnabled() {
+        }
+
+        /**
+         * 禁用父实体或此组件时调用
+         */
+        public onDisabled() {
+        }
+
+        /**
+         * 当该组件启用时每帧进行调用
+         */
+        public update() {
+        }
+
+        public setEnabled(isEnabled: boolean) {
+            if (this._enabled != isEnabled) {
+                this._enabled = isEnabled;
+
+                if (this._enabled) {
+                    this.onEnabled();
+                } else {
+                    this.onDisabled();
+                }
+            }
+
+            return this;
+        }
+
+        public setUpdateOrder(updateOrder: number) {
+            if (this._updateOrder != updateOrder) {
+                this._updateOrder = updateOrder;
+            }
+
+            return this;
+        }
+
+        /**
+         * 创建此组件的克隆
+         */
+        public clone(): Component {
+            let component = ObjectUtils.clone<Component>(this);
+            component.entity = null;
+
+            return component;
+        }
     }
-
-    public abstract initialize();
-
-    public onAddedToEntity(){
-
-    }
-
-    public onRemovedFromEntity(){
-
-    }
-
-    public onEnabled(){
-
-    }
-
-    public onDisabled(){
-
-    }
-
-    public onEntityTransformChanged(comp: ComponentTransform){
-        
-    }
-
-    public update(){
-
-    }
-
-    /** 绑定显示对象 */
-    public bind(displayRender: egret.DisplayObject){
-        this.displayRender = displayRender;
-
-        return this;
-    }
-
-    /** 内部使用 运行时不应该调用 */
-    public registerComponent(){
-        this.entity.componentBits.set(ComponentTypeManager.getIndexFor(this), false);
-        this.entity.scene.entityProcessors.onComponentAdded(this.entity);
-    }
-
-    public deregisterComponent(){
-        this.entity.componentBits.set(ComponentTypeManager.getIndexFor(this));
-        this.entity.scene.entityProcessors.onComponentRemoved(this.entity);
-    }
-}
+}

source/src/ECS/Components/Camera.ts

@@ -1,139 +1,484 @@
-///<reference path="../Component.ts"/>
-class Camera extends Component {
-    private _zoom;
-    private _origin: Vector2;
-    private _transformMatrix: Matrix2D = Matrix2D.identity;
-    private _inverseTransformMatrix = Matrix2D.identity;
-
-    private _minimumZoom = 0.3;
-    private _maximumZoom = 3;
-    private _areMatrixesDirty = true;
-
-    public get zoom(){
-        if (this._zoom == 0)
-            return 1;
-
-        if (this._zoom < 1)
-            return MathHelper.map(this._zoom, this._minimumZoom, 1, -1, 0);
-
-        return MathHelper.map(this._zoom, 1, this._maximumZoom, 0, 1);
+module es {
+    export enum CameraStyle {
+        lockOn,
+        cameraWindow,
     }
 
-    public set zoom(value: number){
-        this.setZoom(value);
+    export class CameraInset {
+        public left: number = 0;
+        public right: number = 0;
+        public top: number = 0;
+        public bottom: number = 0;
     }
 
-    public get minimumZoom(){
-        return this._minimumZoom;
-    }
+    export class Camera extends Component {
+        public _inset: CameraInset = new CameraInset();
+        public _areMatrixedDirty: boolean = true;
+        public _areBoundsDirty: boolean = true;
+        public _isProjectionMatrixDirty = true;
+        /**
+         * 如果相机模式为cameraWindow 则会进行缓动移动
+         * 该值为移动速度
+         */
+        public followLerp = 0.1;
+        /**
+         * 在cameraWindow模式下，宽度/高度被用做边界框，允许在不移动相机的情况下移动
+         * 在lockOn模式下，只使用deadZone的x/y值 你可以通过直接setCenteredDeadzone重写它来自定义deadZone
+         */
+        public deadzone: Rectangle = new Rectangle();
+        /**
+         * 相机聚焦于屏幕中心的偏移
+         */
+        public focusOffset: Vector2 = Vector2.zero;
+        /**
+         * 如果为true 相机位置则不会超出地图矩形（0, 0, mapwidth, mapheight）
+         */
+        public mapLockEnabled: boolean = false;
+        /**
+         * 當前地圖映射的寬度和高度
+         */
+        public mapSize: Vector2 = Vector2.zero;
+        public _targetEntity: Entity;
+        public _targetCollider: Collider;
+        public _desiredPositionDelta: Vector2 = new Vector2();
+        public _cameraStyle: CameraStyle;
+        public _worldSpaceDeadZone: Rectangle = new Rectangle();
 
-    public set minimumZoom(value: number){
-        this.setMinimumZoom(value);
-    }
+        constructor(targetEntity: Entity = null, cameraStyle: CameraStyle = CameraStyle.lockOn) {
+            super();
 
-    public get maximumZoom(){
-        return this._maximumZoom;
-    }
-
-    public set maximumZoom(value: number){
-        this.setMaximumZoom(value);
-    }
-
-    public get origin(){
-        return this._origin;
-    }
-
-    public set origin(value: Vector2){
-        if (this._origin != value){
-            this._origin = value;
-            this._areMatrixesDirty = true;
-        }
-    }
-
-    public get transformMatrix(){
-        this.updateMatrixes();
-
-        return this._transformMatrix;
-    }
-
-    constructor() {
-        super();
-
-        this.setZoom(0);
-    }
-
-    public setMinimumZoom(minZoom: number): Camera{
-        if (this._zoom < minZoom)
-            this._zoom = this.minimumZoom;
-
-        this._minimumZoom = minZoom;
-        return this;
-    }
-
-    public setMaximumZoom(maxZoom: number): Camera {
-        if (this._zoom > maxZoom)
-            this._zoom = maxZoom;
-
-        this._maximumZoom = maxZoom;
-        return this;
-    }
-
-    public setZoom(zoom: number){
-        let newZoom = MathHelper.clamp(zoom, -1, 1);
-        if (newZoom == 0){
-            this._zoom = 1;
-        } else if(newZoom < 0){
-            this._zoom = MathHelper.map(newZoom, -1, 0, this._minimumZoom, 1);
-        } else {
-            this._zoom = MathHelper.map(newZoom, 0, 1, 1, this._maximumZoom);
+            this._targetEntity = targetEntity;
+            this._cameraStyle = cameraStyle;
+            this.setZoom(0);
         }
 
-        this._areMatrixesDirty = true;
+        /**
+         * 对entity.transform.position的快速访问
+         */
+        public get position() {
+            return this.entity.transform.position;
+        }
 
-        return this;
-    }
+        /**
+         * 对entity.transform.position的快速访问
+         * @param value
+         */
+        public set position(value: Vector2) {
+            this.entity.transform.position = value;
+        }
 
-    public initialize() {
+        /**
+         * 对entity.transform.rotation的快速访问
+         */
+        public get rotation(): number {
+            return this.entity.transform.rotation;
+        }
 
-    }
+        /**
+         * 对entity.transform.rotation的快速访问
+         * @param value
+         */
+        public set rotation(value: number) {
+            this.entity.transform.rotation = value;
+        }
 
-    public update(){
-        SceneManager.getActiveScene().entities.buffer.forEach(entity => entity.components.buffer.forEach(component => {
-            if (component.displayRender){
-                let has = this.entity.scene.$children.indexOf(component.displayRender)
-                if (has == -1){
-                    this.entity.scene.stage.addChild(component.displayRender);
+        public _zoom;
+
+        /**
+         * 缩放值应该在-1和1之间、然后将该值从minimumZoom转换为maximumZoom。
+         * 允许你设置适当的最小/最大值，然后使用更直观的-1到1的映射来更改缩放
+         */
+        public get zoom() {
+            if (this._zoom == 0)
+                return 1;
+
+            if (this._zoom < 1)
+                return MathHelper.map(this._zoom, this._minimumZoom, 1, -1, 0);
+
+            return MathHelper.map(this._zoom, 1, this._maximumZoom, 0, 1);
+        }
+
+        /**
+         * 缩放值应该在-1和1之间、然后将该值从minimumZoom转换为maximumZoom。
+         * 允许你设置适当的最小/最大值，然后使用更直观的-1到1的映射来更改缩放
+         * @param value
+         */
+        public set zoom(value: number) {
+            this.setZoom(value);
+        }
+
+        public _minimumZoom = 0.3;
+
+        /**
+         * 相机变焦可以达到的最小非缩放值（0-number.max）。默认为0.3
+         */
+        public get minimumZoom() {
+            return this._minimumZoom;
+        }
+
+        /**
+         * 相机变焦可以达到的最小非缩放值（0-number.max）。默认为0.3
+         * @param value
+         */
+        public set minimumZoom(value: number) {
+            this.setMinimumZoom(value);
+        }
+
+        public _maximumZoom = 3;
+
+        /**
+         * 相机变焦可以达到的最大非缩放值（0-number.max）。默认为3
+         */
+        public get maximumZoom() {
+            return this._maximumZoom;
+        }
+
+        /**
+         * 相机变焦可以达到的最大非缩放值（0-number.max）。默认为3
+         * @param value
+         */
+        public set maximumZoom(value: number) {
+            this.setMaximumZoom(value);
+        }
+
+        public _bounds: Rectangle = new Rectangle();
+
+        /**
+         * 相机的世界-空间边界
+         */
+        public get bounds() {
+            if (this._areMatrixedDirty)
+                this.updateMatrixes();
+
+            if (this._areBoundsDirty) {
+                // 旋转或非旋转的边界都需要左上角和右下角
+                let topLeft = this.screenToWorldPoint(new Vector2(this._inset.left, this._inset.top));
+                let bottomRight = this.screenToWorldPoint(new Vector2(Core.graphicsDevice.viewport.width - this._inset.right,
+                    Core.graphicsDevice.viewport.height - this._inset.bottom));
+
+                if (this.entity.transform.rotation != 0) {
+                    // 特别注意旋转的边界。我们需要找到绝对的最小/最大值并从中创建边界
+                    let topRight = this.screenToWorldPoint(new Vector2(Core.graphicsDevice.viewport.width - this._inset.right,
+                        this._inset.top));
+                    let bottomLeft = this.screenToWorldPoint(new Vector2(this._inset.left,
+                        Core.graphicsDevice.viewport.height - this._inset.bottom));
+
+                    let minX = Math.min(topLeft.x, bottomRight.x, topRight.x, bottomLeft.x);
+                    let maxX = Math.max(topLeft.x, bottomRight.x, topRight.x, bottomLeft.x);
+                    let minY = Math.min(topLeft.y, bottomRight.y, topRight.y, bottomLeft.y);
+                    let maxY = Math.max(topLeft.y, bottomRight.y, topRight.y, bottomLeft.y);
+
+                    this._bounds.location = new Vector2(minX, minY);
+                    this._bounds.width = maxX - minX;
+                    this._bounds.height = maxY - minY;
+                } else {
+                    this._bounds.location = topLeft;
+                    this._bounds.width = bottomRight.x - topLeft.x;
+                    this._bounds.height = bottomRight.y - topLeft.y;
+                }
+
+                this._areBoundsDirty = false;
+            }
+
+            return this._bounds;
+        }
+
+        public _transformMatrix: Matrix2D = new Matrix2D().identity();
+
+        /**
+         * 用于从世界坐标转换到屏幕
+         */
+        public get transformMatrix(): Matrix2D {
+            if (this._areMatrixedDirty)
+                this.updateMatrixes();
+            return this._transformMatrix;
+        }
+
+        public _inverseTransformMatrix: Matrix2D = new Matrix2D().identity();
+
+        /**
+         * 用于从屏幕坐标到世界的转换
+         */
+        public get inverseTransformMatrix(): Matrix2D {
+            if (this._areMatrixedDirty)
+                this.updateMatrixes();
+            return this._inverseTransformMatrix;
+        }
+
+        public _origin: Vector2 = Vector2.zero;
+
+        public get origin() {
+            return this._origin;
+        }
+
+        public set origin(value: Vector2) {
+            if (this._origin != value) {
+                this._origin = value;
+                this._areMatrixedDirty = true;
+            }
+        }
+
+        /**
+         * 当场景渲染目标的大小发生变化时，我们会更新相机的原点并调整它的位置以保持它原来的位置
+         * @param newWidth
+         * @param newHeight
+         */
+        public onSceneSizeChanged(newWidth: number, newHeight: number) {
+            let oldOrigin = this._origin;
+            this.origin = new Vector2(newWidth / 2, newHeight / 2);
+
+            this.entity.transform.position = Vector2.add(this.entity.transform.position, Vector2.subtract(this._origin, oldOrigin));
+        }
+
+        /**
+         * 设置用于从视口边缘插入摄像机边界的量
+         * @param left
+         * @param right
+         * @param top
+         * @param bottom
+         */
+        public setInset(left: number, right: number, top: number, bottom: number): Camera {
+            this._inset = new CameraInset();
+            this._inset.left = left;
+            this._inset.right = right;
+            this._inset.top = top;
+            this._inset.bottom = bottom;
+            this._areBoundsDirty = true;
+            return this;
+        }
+
+        /**
+         * 对entity.transform.setPosition快速访问
+         * @param position
+         */
+        public setPosition(position: Vector2) {
+            this.entity.transform.setPosition(position.x, position.y);
+            return this;
+        }
+
+        /**
+         * 对entity.transform.setRotation的快速访问
+         * @param rotation
+         */
+        public setRotation(rotation: number): Camera {
+            this.entity.transform.setRotation(rotation);
+            return this;
+        }
+
+        /**
+         * 设置缩放值，缩放值应该在-1到1之间。然后将该值从minimumZoom转换为maximumZoom
+         * 允许您设置适当的最小/最大值。使用更直观的-1到1的映射来更改缩放
+         * @param zoom
+         */
+        public setZoom(zoom: number): Camera {
+            let newZoom = MathHelper.clamp(zoom, -1, 1);
+            if (newZoom == 0) {
+                this._zoom = 1;
+            } else if (newZoom < 0) {
+                this._zoom = MathHelper.map(newZoom, -1, 0, this._minimumZoom, 1);
+            } else {
+                this._zoom = MathHelper.map(newZoom, 0, 1, 1, this._maximumZoom);
+            }
+            this._areMatrixedDirty = true;
+
+            return this;
+        }
+
+        /**
+         * 相机变焦可以达到的最小非缩放值（0-number.max） 默认为0.3
+         * @param minZoom
+         */
+        public setMinimumZoom(minZoom: number): Camera {
+            if (minZoom <= 0) {
+                console.error("minimumZoom must be greater than zero");
+                return;
+            }
+
+            if (this._zoom < minZoom)
+                this._zoom = this.minimumZoom;
+
+            this._minimumZoom = minZoom;
+            return this;
+        }
+
+        /**
+         * 相机变焦可以达到的最大非缩放值（0-number.max） 默认为3
+         * @param maxZoom
+         */
+        public setMaximumZoom(maxZoom: number): Camera {
+            if (maxZoom <= 0) {
+                console.error("maximumZoom must be greater than zero");
+                return;
+            }
+
+            if (this._zoom > maxZoom)
+                this._zoom = maxZoom;
+
+            this._maximumZoom = maxZoom;
+            return this;
+        }
+
+        public onEntityTransformChanged(comp: transform.Component) {
+            this._areMatrixedDirty = true;
+        }
+
+        public zoomIn(deltaZoom: number) {
+            this.zoom += deltaZoom;
+        }
+
+        public zoomOut(deltaZoom: number) {
+            this.zoom -= deltaZoom;
+        }
+
+        /**
+         * 将一个点从世界坐标转换到屏幕
+         * @param worldPosition
+         */
+        public worldToScreenPoint(worldPosition: Vector2): Vector2 {
+            this.updateMatrixes();
+            worldPosition = Vector2.transform(worldPosition, this._transformMatrix);
+            return worldPosition;
+        }
+
+        /**
+         * 将点从屏幕坐标转换为世界坐标
+         * @param screenPosition
+         */
+        public screenToWorldPoint(screenPosition: Vector2): Vector2 {
+            this.updateMatrixes();
+            screenPosition = Vector2.transform(screenPosition, this._inverseTransformMatrix);
+            return screenPosition;
+        }
+
+        /**
+         * 返回鼠标在世界空间中的位置
+         */
+        public mouseToWorldPoint(): Vector2 {
+            return this.screenToWorldPoint(Input.touchPosition);
+        }
+
+        public onAddedToEntity() {
+            this.follow(this._targetEntity, this._cameraStyle);
+        }
+
+        public update() {
+            let halfScreen = Vector2.multiply(new Vector2(this.bounds.width, this.bounds.height), new Vector2(0.5));
+            this._worldSpaceDeadZone.x = this.position.x - halfScreen.x * Core.scene.scaleX + this.deadzone.x + this.focusOffset.x;
+            this._worldSpaceDeadZone.y = this.position.y - halfScreen.y * Core.scene.scaleY + this.deadzone.y + this.focusOffset.y;
+            this._worldSpaceDeadZone.width = this.deadzone.width;
+            this._worldSpaceDeadZone.height = this.deadzone.height;
+
+            if (this._targetEntity)
+                this.updateFollow();
+
+            this.position = Vector2.lerp(this.position, Vector2.add(this.position, this._desiredPositionDelta), this.followLerp);
+            this.entity.transform.roundPosition();
+
+            if (this.mapLockEnabled) {
+                this.position = this.clampToMapSize(this.position);
+                this.entity.transform.roundPosition();
+            }
+        }
+
+        /**
+         * 固定相机 永远不会离开地图的可见区域
+         * @param position
+         */
+        public clampToMapSize(position: Vector2) {
+            let halfScreen = Vector2.multiply(new Vector2(this.bounds.width, this.bounds.height), new Vector2(0.5));
+            let cameraMax = new Vector2(this.mapSize.x - halfScreen.x, this.mapSize.y - halfScreen.y);
+
+            return Vector2.clamp(position, halfScreen, cameraMax);
+        }
+
+        public updateFollow() {
+            this._desiredPositionDelta.x = this._desiredPositionDelta.y = 0;
+
+            if (this._cameraStyle == CameraStyle.lockOn) {
+                let targetX = this._targetEntity.transform.position.x;
+                let targetY = this._targetEntity.transform.position.y;
+
+                if (this._worldSpaceDeadZone.x > targetX)
+                    this._desiredPositionDelta.x = targetX - this._worldSpaceDeadZone.x;
+                else if (this._worldSpaceDeadZone.x < targetX)
+                    this._desiredPositionDelta.x = targetX - this._worldSpaceDeadZone.x;
+
+                if (this._worldSpaceDeadZone.y < targetY)
+                    this._desiredPositionDelta.y = targetY - this._worldSpaceDeadZone.y;
+                else if (this._worldSpaceDeadZone.y > targetY)
+                    this._desiredPositionDelta.y = targetY - this._worldSpaceDeadZone.y;
+            } else {
+                if (!this._targetCollider) {
+                    this._targetCollider = this._targetEntity.getComponent<Collider>(Collider);
+                    if (!this._targetCollider)
+                        return;
+                }
+
+                let targetBounds = this._targetEntity.getComponent<Collider>(Collider).bounds;
+                if (!this._worldSpaceDeadZone.containsRect(targetBounds)) {
+                    if (this._worldSpaceDeadZone.left > targetBounds.left)
+                        this._desiredPositionDelta.x = targetBounds.left - this._worldSpaceDeadZone.left;
+                    else if (this._worldSpaceDeadZone.right < targetBounds.right)
+                        this._desiredPositionDelta.x = targetBounds.right - this._worldSpaceDeadZone.right;
+
+                    if (this._worldSpaceDeadZone.bottom < targetBounds.bottom)
+                        this._desiredPositionDelta.y = targetBounds.bottom - this._worldSpaceDeadZone.bottom;
+                    else if (this._worldSpaceDeadZone.top > targetBounds.top)
+                        this._desiredPositionDelta.y = targetBounds.top - this._worldSpaceDeadZone.top;
                 }
             }
-        }));
-    }
-
-    public setPosition(position: Vector2){
-        this.entity.transform.setPosition(position);
-
-        return this;
-    }
-
-    public updateMatrixes(){
-        if (!this._areMatrixesDirty)
-            return;
-
-        let tempMat: Matrix2D;
-        this._transformMatrix = Matrix2D.createTranslation(-this.entity.transform.position.x, -this.entity.transform.position.y);
-        if (this._zoom != 1){
-            tempMat = Matrix2D.createScale(this._zoom, this._zoom);
-            this._transformMatrix = Matrix2D.multiply(this._transformMatrix, tempMat);
         }
 
-        tempMat = Matrix2D.createTranslation(this._origin.x, this._origin.y, tempMat);
-        this._transformMatrix = Matrix2D.multiply(this._transformMatrix, tempMat);
+        public follow(targetEntity: Entity, cameraStyle: CameraStyle = CameraStyle.cameraWindow) {
+            this._targetEntity = targetEntity;
+            this._cameraStyle = cameraStyle;
 
-        this._inverseTransformMatrix = Matrix2D.invert(this._transformMatrix);
+            switch (this._cameraStyle) {
+                case CameraStyle.cameraWindow:
+                    let w = this.bounds.width / 6;
+                    let h = this.bounds.height / 3;
+                    this.deadzone = new Rectangle((this.bounds.width - w) / 2, (this.bounds.height - h) / 2, w, h);
+                    break;
+                case CameraStyle.lockOn:
+                    this.deadzone = new Rectangle(this.bounds.width / 2, this.bounds.height / 2, 10, 10);
+                    break;
+            }
+        }
 
-        this._areMatrixesDirty = false;
+        /**
+         * 以给定的尺寸设置当前相机边界中心的死区
+         * @param width
+         * @param height
+         */
+        public setCenteredDeadzone(width: number, height: number) {
+            this.deadzone = new Rectangle((this.bounds.width - width) / 2, (this.bounds.height - height) / 2, width, height);
+        }
+
+        protected updateMatrixes() {
+            if (!this._areMatrixedDirty)
+                return;
+
+            let tempMat: Matrix2D;
+            this._transformMatrix = Matrix2D.create().translate(-this.entity.transform.position.x, -this.entity.transform.position.y);
+
+            if (this._zoom != 1) {
+                tempMat = Matrix2D.create().scale(this._zoom, this._zoom);
+                this._transformMatrix = this._transformMatrix.multiply(tempMat);
+            }
+
+            if (this.entity.transform.rotation != 0) {
+                tempMat = Matrix2D.create().rotate(this.entity.transform.rotation);
+                this._transformMatrix = this._transformMatrix.multiply(tempMat);
+            }
+
+            tempMat = Matrix2D.create().translate(this._origin.x, this._origin.y);
+            this._transformMatrix = this._transformMatrix.multiply(tempMat);
+
+            this._inverseTransformMatrix = this._transformMatrix.invert();
+
+            // 无论何时矩阵改变边界都是无效的
+            this._areBoundsDirty = true;
+            this._areMatrixedDirty = false;
+        }
     }
-
-    public destory() {
-
-    }
-}
+}

source/src/ECS/Components/ComponentPool.ts

@@ -0,0 +1,24 @@
+module es {
+    export class ComponentPool<T extends PooledComponent> {
+        private _cache: T[];
+        private _type: any;
+
+        constructor(typeClass: any) {
+            this._type = typeClass;
+            this._cache = [];
+        }
+
+        public obtain(): T {
+            try {
+                return this._cache.length > 0 ? this._cache.shift() : new this._type();
+            } catch (err) {
+                throw new Error(this._type + err);
+            }
+        }
+
+        public free(component: T) {
+            component.reset();
+            this._cache.push(component);
+        }
+    }
+}

source/src/ECS/Components/IUpdatableComparer.ts

@@ -0,0 +1,10 @@
+module es {
+    /**
+     * 用于比较组件更新排序
+     */
+    export class IUpdatableComparer {
+        public compare(a: Component, b: Component) {
+            return a.updateOrder - b.updateOrder;
+        }
+    }
+}

source/src/ECS/Components/Mesh.ts

@@ -0,0 +1,24 @@
+///<reference path="./RenderableComponent.ts" />
+module es {
+    export class Mesh extends RenderableComponent {
+        private _mesh: egret.Mesh;
+
+        constructor() {
+            super();
+
+            this._mesh = new egret.Mesh();
+        }
+
+        public setTexture(texture: egret.Texture): Mesh {
+            this._mesh.texture = texture;
+
+            return this;
+        }
+
+        public reset() {
+        }
+
+        render(camera: es.Camera) {
+        }
+    }
+}

source/src/ECS/Components/Physics/Colliders/BoxCollider.ts

@@ -0,0 +1,85 @@
+///<reference path="./Collider.ts" />
+module es {
+    export class BoxCollider extends Collider {
+        /**
+         * 零参数构造函数要求RenderableComponent在实体上，这样碰撞器可以在实体被添加到场景时调整自身的大小。
+         */
+        constructor() {
+            super();
+
+            // 我们在这里插入一个1x1框作为占位符，直到碰撞器在下一阵被添加到实体并可以获得更精确的自动调整大小数据
+            this.shape = new Box(1, 1);
+            this._colliderRequiresAutoSizing = true;
+        }
+
+        public get width() {
+            return (this.shape as Box).width;
+        }
+
+        public set width(value: number) {
+            this.setWidth(value);
+        }
+
+        public get height() {
+            return (this.shape as Box).height;
+        }
+
+        public set height(value: number) {
+            this.setHeight(value);
+        }
+
+        /**
+         * 设置BoxCollider的大小
+         * @param width
+         * @param height
+         */
+        public setSize(width: number, height: number) {
+            this._colliderRequiresAutoSizing = false;
+            let box = this.shape as Box;
+            if (width != box.width || height != box.height) {
+                // 更新框，改变边界，如果我们需要更新物理系统中的边界
+                box.updateBox(width, height);
+                if (this.entity && this._isParentEntityAddedToScene)
+                    Physics.updateCollider(this);
+            }
+
+            return this;
+        }
+
+        /**
+         * 设置BoxCollider的宽度
+         * @param width
+         */
+        public setWidth(width: number): BoxCollider {
+            this._colliderRequiresAutoSizing = false;
+            let box = this.shape as Box;
+            if (width != box.width) {
+                // 更新框，改变边界，如果我们需要更新物理系统中的边界
+                box.updateBox(width, box.height);
+                if (this.entity && this._isParentEntityAddedToScene)
+                    Physics.updateCollider(this);
+            }
+
+            return this;
+        }
+
+        /**
+         * 设置BoxCollider的高度
+         * @param height
+         */
+        public setHeight(height: number) {
+            this._colliderRequiresAutoSizing = false;
+            let box = this.shape as Box;
+            if (height != box.height) {
+                // 更新框，改变边界，如果我们需要更新物理系统中的边界
+                box.updateBox(box.width, height);
+                if (this.entity && this._isParentEntityAddedToScene)
+                    Physics.updateCollider(this);
+            }
+        }
+
+        public toString() {
+            return `[BoxCollider: bounds: ${this.bounds}]`;
+        }
+    }
+}

source/src/ECS/Components/Physics/Colliders/CircleCollider.ts

@@ -0,0 +1,48 @@
+module es {
+    export class CircleCollider extends Collider {
+        /**
+         * 创建一个有半径的圆
+         *
+         * @param radius
+         */
+        constructor(radius?: number) {
+            super();
+
+            if (radius)
+                this._colliderRequiresAutoSizing = true;
+            // 我们在这里插入一个1px的圆圈作为占位符
+            // 直到碰撞器被添加到实体并可以获得更精确的自动调整大小数据的下一帧
+            this.shape = new Circle(radius ? radius : 1);
+        }
+
+        public get radius(): number {
+            return (this.shape as Circle).radius;
+        }
+
+        public set radius(value: number) {
+            this.setRadius(value);
+        }
+
+        /**
+         * 设置圆的半径
+         * @param radius
+         */
+        public setRadius(radius: number): CircleCollider {
+            this._colliderRequiresAutoSizing = false;
+            let circle = this.shape as Circle;
+            if (radius != circle.radius) {
+                circle.radius = radius;
+                circle._originalRadius = radius;
+
+                if (this.entity && this._isParentEntityAddedToScene)
+                    Physics.updateCollider(this);
+            }
+
+            return this;
+        }
+
+        public toString() {
+            return `[CircleCollider: bounds: ${this.bounds}, radius: ${(this.shape as Circle).radius}]`
+        }
+    }
+}

source/src/ECS/Components/Physics/Colliders/Collider.ts

@@ -0,0 +1,238 @@
+module es {
+    export abstract class Collider extends Component {
+        /**
+         * 对撞机的基本形状
+         */
+        public shape: Shape;
+        /**
+         * 如果这个碰撞器是一个触发器，它将不会引起碰撞，但它仍然会触发事件
+         */
+        public isTrigger: boolean;
+        /**
+         * 在处理冲突时，physicsLayer可以用作过滤器。Flags类有帮助位掩码的方法
+         */
+        public physicsLayer = 1 << 0;
+        /**
+         * 碰撞器在使用移动器移动时应该碰撞的层
+         * 默认为所有层
+         */
+        public collidesWithLayers = Physics.allLayers;
+        /**
+         * 如果为true，碰撞器将根据附加的变换缩放和旋转
+         */
+        public shouldColliderScaleAndRotateWithTransform = true;
+        /**
+         * 这个对撞机在物理系统注册时的边界。
+         * 存储这个允许我们始终能够安全地从物理系统中移除对撞机，即使它在试图移除它之前已经被移动了。
+         */
+        public registeredPhysicsBounds: Rectangle = new Rectangle();
+        public _localOffsetLength: number;
+        public _isPositionDirty: boolean = true;
+        public _isRotationDirty: boolean = true;
+        protected _colliderRequiresAutoSizing;
+        /**
+         * 标记来跟踪我们的实体是否被添加到场景中
+         */
+        protected _isParentEntityAddedToScene;
+        /**
+         * 标记来记录我们是否注册了物理系统
+         */
+        protected _isColliderRegistered;
+
+        /**
+         * 镖师碰撞器的绝对位置
+         */
+        public get absolutePosition(): Vector2 {
+            return Vector2.add(this.entity.transform.position, this._localOffset);
+        }
+
+        /**
+         * 封装变换。如果碰撞器没和实体一起旋转 则返回transform.rotation
+         */
+        public get rotation(): number {
+            if (this.shouldColliderScaleAndRotateWithTransform && this.entity)
+                return this.entity.transform.rotation;
+
+            return 0;
+        }
+
+        public get bounds(): Rectangle {
+            if (this._isPositionDirty || this._isRotationDirty) {
+                this.shape.recalculateBounds(this);
+                this._isPositionDirty = this._isRotationDirty = false;
+            }
+
+            return this.shape.bounds;
+        }
+
+        protected _localOffset: Vector2 = Vector2.zero;
+
+        /**
+         * 将localOffset添加到实体。获取碰撞器几何图形的最终位置。
+         * 允许向一个实体添加多个碰撞器并分别定位，还允许你设置缩放/旋转
+         */
+        public get localOffset(): Vector2 {
+            return this._localOffset;
+        }
+
+        /**
+         * 将localOffset添加到实体。获取碰撞器几何图形的最终位置。
+         * 允许向一个实体添加多个碰撞器并分别定位，还允许你设置缩放/旋转
+         * @param value
+         */
+        public set localOffset(value: Vector2) {
+            this.setLocalOffset(value);
+        }
+
+        /**
+         * 将localOffset添加到实体。获取碰撞器的最终位置。
+         * 这允许您向一个实体添加多个碰撞器并分别定位它们。
+         * @param offset
+         */
+        public setLocalOffset(offset: Vector2): Collider {
+            if (this._localOffset != offset) {
+                this.unregisterColliderWithPhysicsSystem();
+                this._localOffset = offset;
+                this._localOffsetLength = this._localOffset.length();
+                this._isPositionDirty = true;
+                this.registerColliderWithPhysicsSystem();
+            }
+
+            return this;
+        }
+
+        /**
+         * 如果为true，碰撞器将根据附加的变换缩放和旋转
+         * @param shouldColliderScaleAndRotationWithTransform
+         */
+        public setShouldColliderScaleAndRotateWithTransform(shouldColliderScaleAndRotationWithTransform: boolean): Collider {
+            this.shouldColliderScaleAndRotateWithTransform = shouldColliderScaleAndRotationWithTransform;
+            this._isPositionDirty = this._isRotationDirty = true;
+            return this;
+        }
+
+        public onAddedToEntity() {
+            if (this._colliderRequiresAutoSizing) {
+                if (!(this instanceof BoxCollider || this instanceof CircleCollider)) {
+                    console.error("Only box and circle colliders can be created automatically");
+                    return;
+                }
+
+                let renderable = this.entity.getComponent<RenderableComponent>(RenderableComponent);
+                if (renderable) {
+                    let renderableBounds = renderable.bounds;
+
+                    // 这里我们需要大小*反尺度，因为当我们自动调整碰撞器的大小时，它需要没有缩放的渲染
+                    let width = renderableBounds.width / this.entity.scale.x;
+                    let height = renderableBounds.height / this.entity.scale.y;
+                    // 圆碰撞器需要特别注意原点
+                    if (this instanceof CircleCollider) {
+                        this.radius = Math.max(width, height) * 0.5;
+                    } else {
+                        this.width = width;
+                        this.height = height;
+                    }
+
+                    // 获取渲染的中心，将其转移到本地坐标，并使用它作为碰撞器的localOffset
+                    this.localOffset = Vector2.subtract(renderableBounds.center, this.entity.transform.position);
+                } else {
+                    console.warn("Collider has no shape and no RenderableComponent. Can't figure out how to size it.");
+                }
+            }
+
+            this._isParentEntityAddedToScene = true;
+            this.registerColliderWithPhysicsSystem();
+        }
+
+        public onRemovedFromEntity() {
+            this.unregisterColliderWithPhysicsSystem();
+            this._isParentEntityAddedToScene = false;
+        }
+
+        public onEntityTransformChanged(comp: transform.Component) {
+            switch (comp) {
+                case transform.Component.position:
+                    this._isPositionDirty = true;
+                    break;
+                case transform.Component.scale:
+                    this._isPositionDirty = true;
+                    break;
+                case transform.Component.rotation:
+                    this._isRotationDirty = true;
+                    break;
+            }
+
+            if (this._isColliderRegistered)
+                Physics.updateCollider(this);
+        }
+
+        public onEnabled() {
+            this.registerColliderWithPhysicsSystem();
+            this._isPositionDirty = this._isRotationDirty = true;
+        }
+
+        public onDisabled() {
+            this.unregisterColliderWithPhysicsSystem();
+        }
+
+        /**
+         * 父实体会在不同的时间调用它(当添加到场景，启用，等等)
+         */
+        public registerColliderWithPhysicsSystem() {
+            // 如果在将我们添加到实体之前更改了origin等属性，则实体可以为null
+            if (this._isParentEntityAddedToScene && !this._isColliderRegistered) {
+                Physics.addCollider(this);
+                this._isColliderRegistered = true;
+            }
+        }
+
+        /**
+         * 父实体会在不同的时候调用它(从场景中移除，禁用，等等)
+         */
+        public unregisterColliderWithPhysicsSystem() {
+            if (this._isParentEntityAddedToScene && this._isColliderRegistered) {
+                Physics.removeCollider(this);
+            }
+            this._isColliderRegistered = false;
+        }
+
+        /**
+         * 检查这个形状是否与物理系统中的其他对撞机重叠
+         * @param other
+         */
+        public overlaps(other: Collider): boolean {
+            return this.shape.overlaps(other.shape);
+        }
+
+        /**
+         * 检查这个与运动应用的碰撞器(移动向量)是否与碰撞器碰撞。如果是这样，将返回true，并且结果将填充碰撞数据。
+         * @param collider
+         * @param motion
+         * @param result
+         */
+        public collidesWith(collider: Collider, motion: Vector2, result: CollisionResult): boolean {
+            // 改变形状的位置，使它在移动后的位置，这样我们可以检查重叠
+            let oldPosition = this.entity.position;
+            this.entity.position = this.entity.position.add(motion);
+
+            let didCollide = this.shape.collidesWithShape(collider.shape, result);
+            if (didCollide)
+                result.collider = collider;
+
+            // 将图形位置返回到检查前的位置
+            this.entity.position = oldPosition;
+
+            return didCollide;
+        }
+
+        public clone(): Component {
+            let collider = ObjectUtils.clone<Collider>(this);
+            collider.entity = null;
+
+            if (this.shape)
+                collider.shape = this.shape.clone();
+
+            return collider;
+        }
+    }
+}

source/src/ECS/Components/Physics/Colliders/PolygonCollider.ts

@@ -0,0 +1,26 @@
+module es {
+    /**
+     * 多边形应该以顺时针方式定义
+     */
+    export class PolygonCollider extends Collider {
+        /**
+         * 如果这些点没有居中，它们将以localOffset的差异为居中。
+         * @param points
+         */
+        constructor(points: Vector2[]) {
+            super();
+
+            // 第一点和最后一点决不能相同。我们想要一个开放的多边形
+            let isPolygonClosed = points[0] == points[points.length - 1];
+
+            // 最后一个移除
+            if (isPolygonClosed)
+                points.splice(points.length - 1, 1);
+
+            let center = Polygon.findPolygonCenter(points);
+            this.setLocalOffset(center);
+            Polygon.recenterPolygonVerts(points);
+            this.shape = new Polygon(points);
+        }
+    }
+}

source/src/ECS/Components/Physics/ITriggerListener.ts

@@ -0,0 +1,23 @@
+module es {
+    /**
+     * 当添加到组件时，每当实体上的冲突器与另一个组件重叠/退出时，将调用这些方法。
+     * ITriggerListener方法将在实现接口的触发器实体上的任何组件上调用。
+     * 注意，这个接口只与Mover类一起工作
+     */
+    export interface ITriggerListener {
+        /**
+         * 当碰撞器与触发碰撞器相交时调用。这是在触发碰撞器和触发碰撞器上调用的。
+         * 移动必须由Mover/ProjectileMover方法处理，以使其自动工作。
+         * @param other
+         * @param local
+         */
+        onTriggerEnter(other: Collider, local: Collider);
+
+        /**
+         * 当另一个碰撞器离开触发碰撞器时调用
+         * @param other
+         * @param local
+         */
+        onTriggerExit(other: Collider, local: Collider);
+    }
+}

source/src/ECS/Components/Physics/Mover.ts

@@ -0,0 +1,89 @@
+module es {
+    /**
+     * 辅助类说明了一种处理移动的方法，它考虑了包括触发器在内的所有冲突。
+     * ITriggerListener接口用于管理对移动过程中违反的任何触发器的回调。
+     * 一个物体只能通过移动器移动。要正确报告触发器的move方法。
+     *
+     * 请注意，多个移动者相互交互将多次调用ITriggerListener。
+     */
+    export class Mover extends Component {
+        private _triggerHelper: ColliderTriggerHelper;
+
+        public onAddedToEntity() {
+            this._triggerHelper = new ColliderTriggerHelper(this.entity);
+        }
+
+        /**
+         * 计算修改运动矢量的运动，以考虑移动时可能发生的碰撞
+         * @param motion
+         * @param collisionResult
+         */
+        public calculateMovement(motion: Vector2, collisionResult: CollisionResult): boolean {
+            if (!this.entity.getComponent(Collider) || !this._triggerHelper) {
+                return false;
+            }
+
+            // 移动所有的非触发碰撞器并获得最近的碰撞
+            let colliders: Collider[] = this.entity.getComponents(Collider);
+            for (let i = 0; i < colliders.length; i++) {
+                let collider = colliders[i];
+
+                // 不检测触发器 在我们移动后会重新访问它
+                if (collider.isTrigger)
+                    continue;
+
+                // 获取我们在新位置可能发生碰撞的任何东西
+                let bounds = collider.bounds;
+                bounds.x += motion.x;
+                bounds.y += motion.y;
+                let neighbors = Physics.boxcastBroadphaseExcludingSelf(collider, bounds, collider.collidesWithLayers);
+
+                for (let j = 0; j < neighbors.length; j++) {
+                    let neighbor = neighbors[j];
+                    // 不检测触发器
+                    if (neighbor.isTrigger)
+                        continue;
+
+                    let _internalcollisionResult: CollisionResult = new CollisionResult();
+                    if (collider.collidesWith(neighbor, motion, _internalcollisionResult)) {
+                        // 如果碰撞 则退回之前的移动量
+                        motion = motion.subtract(_internalcollisionResult.minimumTranslationVector);
+
+                        // 如果我们碰到多个对象，为了简单起见，只取第一个。
+                        if (_internalcollisionResult.collider != null) {
+                            collisionResult = _internalcollisionResult;
+                        }
+                    }
+                }
+            }
+
+            ListPool.free(colliders);
+
+            return collisionResult.collider != null;
+        }
+
+        /**
+         *  将calculatemomovement应用到实体并更新triggerHelper
+         * @param motion
+         */
+        public applyMovement(motion: Vector2) {
+            // 移动实体到它的新位置，如果我们有一个碰撞，否则移动全部数量。当碰撞发生时，运动被更新
+            this.entity.position = Vector2.add(this.entity.position, motion);
+
+            // 对所有是触发器的碰撞器与所有宽相位碰撞器进行重叠检查。任何重叠都会导致触发事件。
+            if (this._triggerHelper)
+                this._triggerHelper.update();
+        }
+
+        /**
+         * 通过调用calculateMovement和applyMovement来移动考虑碰撞的实体;
+         * @param motion
+         * @param collisionResult
+         */
+        public move(motion: Vector2, collisionResult: CollisionResult) {
+            this.calculateMovement(motion, collisionResult);
+            this.applyMovement(motion);
+            return collisionResult.collider != null;
+        }
+    }
+}

source/src/ECS/Components/Physics/ProjectileMover.ts

@@ -0,0 +1,58 @@
+module es {
+    /**
+     * 只向itriggerlistener报告冲突的移动器
+     * 该对象将始终移动完整的距离
+     */
+    export class ProjectileMover extends Component {
+        private _tempTriggerList: ITriggerListener[] = [];
+        private _collider: Collider;
+
+        public onAddedToEntity() {
+            this._collider = this.entity.getComponent<Collider>(Collider);
+            if (!this._collider)
+                console.warn("ProjectileMover has no Collider. ProjectilMover requires a Collider!");
+        }
+
+        /**
+         * 移动考虑碰撞的实体
+         * @param motion
+         */
+        public move(motion: Vector2): boolean {
+            if (!this._collider)
+                return false;
+
+            let didCollide = false;
+
+            // 获取我们在新位置可能发生碰撞的任何东西
+            this.entity.position = Vector2.add(this.entity.position, motion);
+
+            // 获取任何可能在新位置发生碰撞的东西
+            let neighbors = Physics.boxcastBroadphase(this._collider.bounds, this._collider.collidesWithLayers);
+            for (let i = 0; i < neighbors.length; i++) {
+                let neighbor = neighbors[i];
+                if (this._collider.overlaps(neighbor) && neighbor.enabled) {
+                    didCollide = true;
+                    this.notifyTriggerListeners(this._collider, neighbor);
+                }
+            }
+
+            return didCollide;
+        }
+
+        private notifyTriggerListeners(self: Collider, other: Collider) {
+            // 通知我们重叠的碰撞器实体上的任何侦听器
+            other.entity.getComponents("ITriggerListener", this._tempTriggerList);
+            for (let i = 0; i < this._tempTriggerList.length; i++) {
+                this._tempTriggerList[i].onTriggerEnter(self, other);
+            }
+            this._tempTriggerList.length = 0;
+
+            // 通知此实体上的任何侦听器
+            this.entity.getComponents("ITriggerListener", this._tempTriggerList);
+            for (let i = 0; i < this._tempTriggerList.length; i++) {
+                this._tempTriggerList[i].onTriggerEnter(other, self);
+            }
+            this._tempTriggerList.length = 0;
+        }
+    }
+}

source/src/ECS/Components/PooledComponent.ts

@@ -0,0 +1,6 @@
+module es {
+    /** 回收实例的组件类型。 */
+    export abstract class PooledComponent extends Component {
+        public abstract reset();
+    }
+}

source/src/ECS/Components/RenderableComponent.ts

@@ -0,0 +1,192 @@
+///<reference path="./PooledComponent.ts" />
+module es {
+    /**
+     * 所有可渲染组件的基类
+     */
+    export abstract class RenderableComponent extends Component implements IRenderable {
+        /**
+         * 用于装载egret显示对象
+         */
+        public displayObject: egret.DisplayObject = new egret.DisplayObject();
+        /**
+         * 用于着色器处理精灵
+         */
+        public color: number = 0x000000;
+        protected _areBoundsDirty = true;
+
+        /**
+         * renderableComponent的宽度
+         * 如果你不重写bounds属性则需要实现这个
+         */
+        public get width() {
+            return this.bounds.width;
+        }
+
+        /**
+         * renderableComponent的高度
+         * 如果你不重写bounds属性则需要实现这个
+         */
+        public get height() {
+            return this.bounds.height;
+        }
+
+        protected _localOffset: Vector2 = Vector2.zero;
+
+        /**
+         * 从父实体的偏移量。用于向需要特定定位的实体
+         */
+        public get localOffset(): Vector2 {
+            return this._localOffset;
+        }
+
+        /**
+         * 从父实体的偏移量。用于向需要特定定位的实体
+         * @param value
+         */
+        public set localOffset(value: Vector2) {
+            this.setLocalOffset(value);
+        }
+
+        protected _renderLayer: number = 0;
+
+        /**
+         * 较低的渲染层在前面，较高的在后面
+         */
+        public get renderLayer(): number {
+            return this._renderLayer;
+        }
+
+        public set renderLayer(value: number) {
+
+        }
+
+        protected _bounds: Rectangle = new Rectangle();
+
+        /**
+         * 这个物体的AABB, 用于相机剔除
+         */
+        public get bounds(): Rectangle {
+            if (this._areBoundsDirty) {
+                this._bounds.calculateBounds(this.entity.transform.position, this._localOffset, Vector2.zero,
+                    this.entity.transform.scale, this.entity.transform.rotation, this.width, this.height);
+                this._areBoundsDirty = false;
+            }
+
+            return this._bounds;
+        }
+
+        private _isVisible: boolean;
+
+        /**
+         * 可渲染的可见性。状态的改变会调用onBecameVisible/onBecameInvisible方法
+         */
+        public get isVisible() {
+            return this._isVisible;
+        }
+
+        /**
+         * 可渲染的可见性。状态的改变会调用onBecameVisible/onBecameInvisible方法
+         * @param value
+         */
+        public set isVisible(value: boolean) {
+            if (this._isVisible != value) {
+                this._isVisible = value;
+
+                if (this._isVisible)
+                    this.onBecameVisible();
+                else
+                    this.onBecameInvisible();
+            }
+        }
+
+        public onEntityTransformChanged(comp: transform.Component) {
+            this._areBoundsDirty = true;
+        }
+
+        /**
+         * 由渲染器调用。可以使用摄像机进行剔除
+         * @param camera
+         */
+        public abstract render(camera: Camera);
+
+        /**
+         * 如果renderableComponent的边界与camera.bounds相交 返回true
+         * 用于处理isVisible标志的状态开关
+         * 在渲染方法中使用这个方法来决定是否渲染
+         * @param camera
+         */
+        public isVisibleFromCamera(camera: Camera): boolean {
+            this.isVisible = camera.bounds.intersects(this.bounds);
+            return this.isVisible;
+        }
+
+        /**
+         * 较低的渲染层在前面，较高的在后面
+         * @param renderLayer
+         */
+        public setRenderLayer(renderLayer: number): RenderableComponent {
+            if (renderLayer != this._renderLayer) {
+                let oldRenderLayer = this._renderLayer;
+                this._renderLayer = renderLayer;
+
+                // 如果该组件拥有一个实体，那么是由ComponentList管理，需要通知它改变了渲染层
+                if (this.entity && this.entity.scene)
+                    this.entity.scene.renderableComponents.updateRenderableRenderLayer(this, oldRenderLayer, this._renderLayer);
+            }
+
+            return this;
+        }
+
+        /**
+         * 用于着色器处理精灵
+         * @param color
+         */
+        public setColor(color: number): RenderableComponent {
+            this.color = color;
+            return this;
+        }
+
+        /**
+         * 从父实体的偏移量。用于向需要特定定位的实体
+         * @param offset
+         */
+        public setLocalOffset(offset: Vector2): RenderableComponent {
+            if (this._localOffset != offset) {
+                this._localOffset = offset;
+            }
+
+            return this;
+        }
+
+        /**
+         * 进行状态同步
+         */
+        public sync(camera: Camera) {
+            this.displayObject.x = this.entity.position.x + this.localOffset.x - camera.position.x + camera.origin.x;
+            this.displayObject.y = this.entity.position.y + this.localOffset.y - camera.position.y + camera.origin.y;
+            this.displayObject.scaleX = this.entity.scale.x;
+            this.displayObject.scaleY = this.entity.scale.y;
+            this.displayObject.rotation = this.entity.rotation;
+        }
+
+        public toString() {
+            return `[RenderableComponent] renderLayer: ${this.renderLayer}`;
+        }
+
+        /**
+         * 当renderableComponent进入相机框架时调用
+         * 如果渲染器不适用isVisibleFromCamera进行剔除检查 这些方法不会被调用
+         */
+        protected onBecameVisible() {
+            this.displayObject.visible = this.isVisible;
+        }
+
+        /**
+         * 当renderableComponent离开相机框架时调用
+         * 如果渲染器不适用isVisibleFromCamera进行剔除检查 这些方法不会被调用
+         */
+        protected onBecameInvisible() {
+            this.displayObject.visible = this.isVisible;
+        }
+    }
+}

source/src/ECS/Components/ScrollingSpriteRenderer.ts

@@ -0,0 +1,37 @@
+///<reference path="./TiledSpriteRenderer.ts"/>
+module es {
+    export class ScrollingSpriteRenderer extends TiledSpriteRenderer {
+        public scrollSpeedX = 15;
+        public scroolSpeedY = 0;
+        private _scrollX = 0;
+        private _scrollY = 0;
+
+        public update() {
+            this._scrollX += this.scrollSpeedX * Time.deltaTime;
+            this._scrollY += this.scroolSpeedY * Time.deltaTime;
+            this.sourceRect.x = this._scrollX;
+            this.sourceRect.y = this._scrollY;
+        }
+
+        public render(camera: Camera) {
+            if (!this.sprite)
+                return;
+
+            super.render(camera);
+
+            let renderTexture = new egret.RenderTexture();
+            let cacheBitmap = new egret.DisplayObjectContainer();
+            cacheBitmap.removeChildren();
+            cacheBitmap.addChild(this.leftTexture);
+            cacheBitmap.addChild(this.rightTexture);
+
+            this.leftTexture.x = this.sourceRect.x;
+            this.rightTexture.x = this.sourceRect.x - this.sourceRect.width;
+            this.leftTexture.y = this.sourceRect.y;
+            this.rightTexture.y = this.sourceRect.y;
+
+            cacheBitmap.cacheAsBitmap = true;
+            renderTexture.drawToTexture(cacheBitmap, new egret.Rectangle(0, 0, this.sourceRect.width, this.sourceRect.height));
+        }
+    }
+}

source/src/ECS/Components/Sprite.ts

@@ -0,0 +1,26 @@
+module es {
+    export class Sprite {
+        public texture2D: egret.Texture;
+        public readonly sourceRect: Rectangle;
+        public readonly center: Vector2;
+        public origin: Vector2;
+        public readonly uvs: Rectangle = new Rectangle();
+
+        constructor(texture: egret.Texture,
+                    sourceRect: Rectangle = new Rectangle(0, 0, texture.textureWidth, texture.textureHeight),
+                    origin: Vector2 = sourceRect.getHalfSize()) {
+            this.texture2D = texture;
+            this.sourceRect = sourceRect;
+            this.center = new Vector2(sourceRect.width * 0.5, sourceRect.height * 0.5);
+            this.origin = origin;
+
+            let inverseTexW = 1 / texture.textureWidth;
+            let inverseTexH = 1 / texture.textureHeight;
+
+            this.uvs.x = sourceRect.x * inverseTexW;
+            this.uvs.y = sourceRect.y * inverseTexH;
+            this.uvs.width = sourceRect.width * inverseTexW;
+            this.uvs.height = sourceRect.height * inverseTexH;
+        }
+    }
+}

source/src/ECS/Components/SpriteAnimation.ts

@@ -0,0 +1,11 @@
+module es {
+    export class SpriteAnimation {
+        public readonly sprites: Sprite[];
+        public readonly frameRate: number;
+
+        constructor(sprites: Sprite[], frameRate: number) {
+            this.sprites = sprites;
+            this.frameRate = frameRate;
+        }
+    }
+}

source/src/ECS/Components/SpriteAnimator.ts

@@ -0,0 +1,164 @@
+///<reference path="./SpriteRenderer.ts" />
+module es {
+    export enum LoopMode {
+        /** 在一个循环序列[A][B][C][A][B][C][A][B][C]... */
+        loop,
+        /** [A][B][C]然后暂停，设置时间为0 [A] */
+        once,
+        /** [A][B][C]。当它到达终点时，它会继续播放最后一帧，并且不会停止播放 */
+        clampForever,
+        /** 以一个乒乓循环的方式永远播放这个序列 [A][B][C][B][A][B][C][B]... */
+        pingPong,
+        /** 将顺序向前播放一次，然后返回到开始[A][B][C][B][A]，然后暂停并设置时间为0 */
+        pingPongOnce,
+    }
+
+    export enum State {
+        none,
+        running,
+        paused,
+        completed,
+    }
+
+    export class SpriteAnimator extends SpriteRenderer {
+        /**
+         * 在动画完成时触发，包括动画名称
+         */
+        public onAnimationCompletedEvent: (string) => {};
+        /**
+         * 动画播放速度
+         */
+        public speed = 1;
+        /**
+         * 动画的当前状态
+         */
+        public animationState = State.none;
+        /**
+         * 当前动画
+         */
+        public currentAnimation: SpriteAnimation;
+        /**
+         * 当前动画的名称
+         */
+        public currentAnimationName: string;
+        /**
+         * 当前动画的精灵数组中当前帧的索引
+         */
+        public currentFrame: number;
+        public _elapsedTime: number = 0;
+        public _loopMode: LoopMode;
+
+        constructor(sprite?: Sprite) {
+            super(sprite);
+        }
+
+        /**
+         * 检查当前动画是否正在运行
+         */
+        public get isRunning(): boolean {
+            return this.animationState == State.running;
+        }
+
+        private _animations: Map<string, SpriteAnimation> = new Map<string, SpriteAnimation>();
+
+        /** 提供对可用动画列表的访问 */
+        public get animations() {
+            return this._animations;
+        }
+
+        public update() {
+            if (this.animationState != State.running || !this.currentAnimation) return;
+
+            let animation = this.currentAnimation;
+            let secondsPerFrame = 1 / (animation.frameRate * this.speed);
+            let iterationDuration = secondsPerFrame * animation.sprites.length;
+
+            this._elapsedTime += Time.deltaTime;
+            let time = Math.abs(this._elapsedTime);
+
+            // Once和PingPongOnce完成后重置为Time = 0
+            if (this._loopMode == LoopMode.once && time > iterationDuration ||
+                this._loopMode == LoopMode.pingPongOnce && time > iterationDuration * 2) {
+                this.animationState = State.completed;
+                this._elapsedTime = 0;
+                this.currentFrame = 0;
+                this.sprite = animation.sprites[this.currentFrame];
+                return;
+            }
+
+            // 弄清楚我们在哪个坐标系上
+            let i = Math.floor(time / secondsPerFrame);
+            let n = animation.sprites.length;
+            if (n > 2 && (this._loopMode == LoopMode.pingPong || this._loopMode == LoopMode.pingPongOnce)) {
+                // pingpong
+                let maxIndex = n - 1;
+                this.currentFrame = maxIndex - Math.abs(maxIndex - i % (maxIndex * 2));
+            } else {
+                this.currentFrame = i % n;
+            }
+
+            this.sprite = animation.sprites[this.currentFrame];
+        }
+
+        /**
+         * 添加一个SpriteAnimation
+         * @param name
+         * @param animation
+         */
+        public addAnimation(name: string, animation: SpriteAnimation): SpriteAnimator {
+            // 如果我们没有精灵，使用我们找到的第一帧
+            if (!this.sprite && animation.sprites.length > 0)
+                this.setSprite(animation.sprites[0]);
+            this._animations[name] = animation;
+            return this;
+        }
+
+        /**
+         * 以给定的名称放置动画。如果没有指定循环模式，则默认为循环
+         * @param name
+         * @param loopMode
+         */
+        public play(name: string, loopMode: LoopMode = null) {
+            this.currentAnimation = this._animations[name];
+            this.currentAnimationName = name;
+            this.currentFrame = 0;
+            this.animationState = State.running;
+
+            this.sprite = this.currentAnimation.sprites[0];
+            this._elapsedTime = 0;
+            this._loopMode = loopMode ? loopMode : LoopMode.loop;
+        }
+
+        /**
+         * 检查动画是否正在播放(即动画是活动的)。它可能仍然处于暂停状态)
+         * @param name
+         */
+        public isAnimationActive(name: string): boolean {
+            return this.currentAnimation && this.currentAnimationName == name;
+        }
+
+        /**
+         * 暂停动画
+         */
+        public pause() {
+            this.animationState = State.paused;
+        }
+
+        /**
+         * 继续动画
+         */
+        public unPause() {
+            this.animationState = State.running;
+        }
+
+        /**
+         * 停止当前动画并将其设为null
+         */
+        public stop() {
+            this.currentAnimation = null;
+            this.currentAnimationName = null;
+            this.currentFrame = 0;
+            this.animationState = State.none;
+        }
+    }
+}

source/src/ECS/Components/SpriteRenderer.ts

@@ -0,0 +1,131 @@
+module es {
+    import Bitmap = egret.Bitmap;
+
+    export class SpriteRenderer extends RenderableComponent {
+        constructor(sprite: Sprite | egret.Texture = null) {
+            super();
+            if (sprite instanceof Sprite)
+                this.setSprite(sprite);
+            else if (sprite instanceof egret.Texture)
+                this.setSprite(new Sprite(sprite));
+        }
+
+        public get bounds() {
+            if (this._areBoundsDirty) {
+                if (this._sprite) {
+                    this._bounds.calculateBounds(this.entity.transform.position, this._localOffset, this._origin,
+                        this.entity.transform.scale, this.entity.transform.rotation, this._sprite.sourceRect.width,
+                        this._sprite.sourceRect.height);
+                    this._areBoundsDirty = false;
+                }
+            }
+
+            return this._bounds;
+        }
+
+        /**
+         * 用归一化方法设置原点
+         * x/y 均为 0-1
+         */
+        public get originNormalized(): Vector2 {
+            return new Vector2(this._origin.x / this.width * this.entity.transform.scale.x,
+                this._origin.y / this.height * this.entity.transform.scale.y);
+        }
+
+        /**
+         * 用归一化方法设置原点
+         * x/y 均为 0-1
+         * @param value
+         */
+        public set originNormalized(value: Vector2) {
+            this.setOrigin(new Vector2(value.x * this.width / this.entity.transform.scale.x,
+                value.y * this.height / this.entity.transform.scale.y));
+        }
+
+        protected _origin: Vector2;
+
+        /**
+         * 精灵的原点。这是在设置精灵时自动设置的
+         */
+        public get origin(): Vector2 {
+            return this._origin;
+        }
+
+        /**
+         * 精灵的原点。这是在设置精灵时自动设置的
+         * @param value
+         */
+        public set origin(value: Vector2) {
+            this.setOrigin(value);
+        }
+
+        protected _sprite: Sprite;
+
+        /**
+         * 应该由这个精灵显示的精灵
+         * 当设置时，精灵的原点也被设置为精灵的origin
+         */
+        public get sprite(): Sprite {
+            return this._sprite;
+        }
+
+        /**
+         * 应该由这个精灵显示的精灵
+         * 当设置时，精灵的原点也被设置为精灵的origin
+         * @param value
+         */
+        public set sprite(value: Sprite) {
+            this.setSprite(value);
+        }
+
+        /**
+         * 设置精灵并更新精灵的原点以匹配sprite.origin
+         * @param sprite
+         */
+        public setSprite(sprite: Sprite): SpriteRenderer {
+            this._sprite = sprite;
+            if (this._sprite) {
+                this._origin = this._sprite.origin;
+                this.displayObject.anchorOffsetX = this._origin.x;
+                this.displayObject.anchorOffsetY = this._origin.y;
+            }
+            this.displayObject = new Bitmap(sprite.texture2D);
+
+            return this;
+        }
+
+        /**
+         * 设置可渲染的原点
+         * @param origin
+         */
+        public setOrigin(origin: Vector2): SpriteRenderer {
+            if (this._origin != origin) {
+                this._origin = origin;
+                this.displayObject.anchorOffsetX = this._origin.x;
+                this.displayObject.anchorOffsetY = this._origin.y;
+                this._areBoundsDirty = true;
+            }
+
+            return this;
+        }
+
+        /**
+         * 用归一化方法设置原点
+         * x/y 均为 0-1
+         * @param value
+         */
+        public setOriginNormalized(value: Vector2): SpriteRenderer {
+            this.setOrigin(new Vector2(value.x * this.width / this.entity.transform.scale.x,
+                value.y * this.height / this.entity.transform.scale.y));
+            return this;
+        }
+
+        public render(camera: Camera) {
+            this.sync(camera);
+
+            this.displayObject.x = this.entity.position.x - this.origin.x + this.localOffset.x - camera.position.x + camera.origin.x;
+            this.displayObject.y = this.entity.position.y - this.origin.y + this.localOffset.y - camera.position.y + camera.origin.y;
+        }
+    }
+}
+

source/src/ECS/Components/TiledSpriteRenderer.ts

@@ -0,0 +1,60 @@
+///<reference path="./SpriteRenderer.ts" />
+module es {
+    /**
+     * 滚动由两张图片组合而成
+     */
+    export class TiledSpriteRenderer extends SpriteRenderer {
+        protected sourceRect: Rectangle;
+        protected leftTexture: egret.Bitmap;
+        protected rightTexture: egret.Bitmap;
+
+        constructor(sprite: Sprite) {
+            super(sprite);
+
+            this.leftTexture = new egret.Bitmap();
+            this.rightTexture = new egret.Bitmap();
+            this.leftTexture.texture = sprite.texture2D;
+            this.rightTexture.texture = sprite.texture2D;
+
+            this.setSprite(sprite);
+            this.sourceRect = sprite.sourceRect;
+        }
+
+        public get scrollX() {
+            return this.sourceRect.x;
+        }
+
+        public set scrollX(value: number) {
+            this.sourceRect.x = value;
+        }
+
+        public get scrollY() {
+            return this.sourceRect.y;
+        }
+
+        public set scrollY(value: number) {
+            this.sourceRect.y = value;
+        }
+
+        public render(camera: es.Camera) {
+            if (!this.sprite)
+                return;
+
+            super.render(camera);
+
+            let renderTexture = new egret.RenderTexture();
+            let cacheBitmap = new egret.DisplayObjectContainer();
+            cacheBitmap.removeChildren();
+            cacheBitmap.addChild(this.leftTexture);
+            cacheBitmap.addChild(this.rightTexture);
+
+            this.leftTexture.x = this.sourceRect.x;
+            this.rightTexture.x = this.sourceRect.x - this.sourceRect.width;
+            this.leftTexture.y = this.sourceRect.y;
+            this.rightTexture.y = this.sourceRect.y;
+
+            cacheBitmap.cacheAsBitmap = true;
+            renderTexture.drawToTexture(cacheBitmap, new egret.Rectangle(0, 0, this.sourceRect.width, this.sourceRect.height));
+        }
+    }
+}