<commit_before>CCHierarchiesSpriteX
====================

render flash animation in cocos2d-x, a animation sprite extension for cocos2d-x, base on hierarchies node like bone.


功能
-------------------
   * 支持Flash的经典插值(Motion)动画
   * 支持Flash的引导层动画(通过JSFL进行转换为关键帧实现)
   * 支持Flash的所有Color Effect
   * 支持MovieClip和Graphics的2D矩阵变换(缩放，旋转，切变，偏移，锚点)
   * 自动将MovieClip的原点每帧更新为CCNode的AnchorPoint坐标
   * 自动更新每帧的BoundingBox
   * 播放动画操作实现为Action类
   * 通过缓存提高加载和动画计算的速度
   * 支持Flash中MovieClip的嵌套
   * 支持Graphics的所有循环播放模式


局限
-------------------
   * 不支持Flash的非经典插值动画
   * 不支持Flash的蒙版
   * 不支持Flash的滤镜
   * 不支持Flash的shape变形动画
   * 不支持Flash的blend模式设置
   * 不支持插值动画的tweening设置


开发计划
-------------------
   * 合并同一个fla导出的所有.hanims数据到一个文件
   * 改善Mesh的数据结构，更有效的使用vertex index
   * 支持动画Avatar
   * 支持滤镜
   * 支持骨骼的CCNode插接


依赖
-------------------
   * cocos2d-x v2.1 以上
   * rapidxml v1.13 以上


性能
-------------------
   * iPad3同屏250个精灵平均50FPS


编译demo
------------------
   * 使用`git submodule init`和`git submodule update`下载cocos2d-x
   * 由于代码使用了部分c++11的功能，请将cocos2d-x编译配置也改为使用c++11和c++11标准库


整合cocos2d-x
-----------------
   * 将CCHierarchiesSprite目录复制到extensions目录下
   * 将rapidxml库加入工程
   * 在cocos-ext.h中加入
   
```c++
// CCHierarchiesSprite
#include "CCHierarchiesSprite/CCHierarchiesSprite.h"
#include "CCHierarchiesSprite/CCHierarchiesSpriteSheetCache.h"
#include "CCHierarchiesSprite/CCHierarchiesSpriteAnimationCache.h"
#include "CChierarchiesSprite/CCHierarchiesSpriteRuntime.h"
```


使用方法
-----------------
   * 在程序启动时调用`CCHierarchiesSpriteRuntime::sharedHierarchiesSpriteRuntime()->initializationRuntime();`
   * 通过`CCHierarchiesSpriteRuntime::sharedHierarchiesSpriteRuntime()->releaseUnusedResource();`释放缓存的数据
   * 具体播放动画的使用方法见demo的测试代码


工具
----------------
   * 详见tools/README.md的说明


FLA动画资源
------------------
   * 感谢肥熊-谁主三国项目提供的动画资源
<commit_msg>update README.md;<commit_after>CCHierarchiesSpriteX
====================

render flash animation in cocos2d-x, a animation sprite extension for cocos2d-x, base on hierarchies node like bone.


功能
-------------------
   * 支持Flash的经典插值(Motion)动画
   * 支持Flash的引导层动画(通过JSFL进行转换为关键帧实现)
   * 支持Flash的所有Color Effect
   * 支持MovieClip和Graphics的2D矩阵变换(缩放，旋转，切变，偏移，锚点)
   * 自动将MovieClip的原点每帧更新为CCNode的AnchorPoint坐标
   * 自动更新每帧的BoundingBox
   * 播放动画操作实现为Action类
   * 通过缓存提高加载和动画计算的速度
   * 支持Flash中MovieClip的嵌套
   * 支持Graphics的所有循环播放模式
   * 支持自定义动画事件


局限
-------------------
   * 不支持Flash的非经典插值动画
   * 不支持Flash的蒙版
   * 不支持Flash的滤镜
   * 不支持Flash的shape变形动画
   * 不支持Flash的blend模式设置
   * 不支持插值动画的tweening设置


开发计划
-------------------
   * 合并同一个fla导出的所有.hanims数据到一个文件
   * 改善Mesh的数据结构，更有效的使用vertex index
   * 支持动画Avatar
   * 支持滤镜
   * 支持骨骼的CCNode插接
   * 支持内嵌声音播放数据


依赖
-------------------
   * cocos2d-x v2.1 以上
   * rapidxml v1.13 以上


性能
-------------------
   * iPad3同屏250个精灵平均50FPS


编译demo
------------------
   * 使用`git submodule init`和`git submodule update`下载cocos2d-x
   * 由于代码使用了部分c++11的功能，请将cocos2d-x编译配置也改为使用c++11和c++11标准库


整合cocos2d-x
-----------------
   * 将CCHierarchiesSprite目录复制到extensions目录下
   * 将rapidxml库加入工程
   * 在cocos-ext.h中加入
   
```c++
// CCHierarchiesSprite
#include "CCHierarchiesSprite/CCHierarchiesSprite.h"
#include "CCHierarchiesSprite/CCHierarchiesSpriteSheetCache.h"
#include "CCHierarchiesSprite/CCHierarchiesSpriteAnimationCache.h"
#include "CChierarchiesSprite/CCHierarchiesSpriteRuntime.h"
```


使用方法
-----------------
   * 在程序启动时调用`CCHierarchiesSpriteRuntime::sharedHierarchiesSpriteRuntime()->initializationRuntime();`
   * 通过`CCHierarchiesSpriteRuntime::sharedHierarchiesSpriteRuntime()->releaseUnusedResource();`释放缓存的数据
   * 具体播放动画的使用方法见demo的测试代码


工具
----------------
   * 详见tools/README.md的说明


FLA动画资源
------------------
   * 感谢肥熊-谁主三国项目提供的动画资源

{'fraction_non_alphanumeric': 0.17829248586049018, 'fraction_numerical': 0.012927551844869378, 'mean_word_length': 2.946865037194474, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 4}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7499359', 'n_tokens_mistral': 1874, 'n_tokens_neox': 1990, 'n_words': 167}