cocos2dx v3.9 与SpriteFrameCache和AnimationCache之间的对话

最新推荐文章于 2022-09-26 10:09:32 发布
最新推荐文章于 2022-09-26 10:09:32 发布
阅读量1.9k 收藏
点赞数 2
文章标签： cocos2d-x 动画
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/vermilliontear/article/details/50488506
版权

我：前段时间去过动画制作组，你们两个的名字与动画制作组中的SpriteFrame和Animation很相似，难道说你们之间有什么关系？
SpriteFrameCache和AnimationCache：没错，我们都是仓库管理员，管理着存放他们的仓库。
我：果然，Cache，看名字就应该能想到。不过你们存储他们的意义何在？
SpriteFrameCache：想必SpriteFrame和您提起过，他为了节省内存空间的使用，对于指定给他的图片，只有在真正使用这张图片时，即调用他的getTexture()时，他才将图片加载进内存创建纹理，这样避免了可能出现的长时间不使用的图片却一直占用着内存空间的情况。但这样的做法对于一些较大的图片或是一些经常使用的图片却并不妥当，因为加载图片必定会耗用一定的时间，由其对于大图片耗用的时间就更长。游戏运行过程中经常的加载图片或是突然加载了一张大图片，很可能使游戏出现不同程度的卡顿，这样游戏的体验性就大大的降低了。比较合理的做法是在游戏开始前有一个加载资源的过程，将经常使用的图片或是比较大的图片先加载进内存并创建为SpriteFrame存入我这个仓库里，实际使用的时候再从我这里取走，这样牺牲了空间节省了时间。
AnimationCache：我与SpriteFrameCache存在的意义大致相同，不过我的着眼点不在图片，而是在整个动画。一个动画通常由多张图片组成，就算每张图片都很小，但如果数量很庞大，那么整个动画所占用的资源也不可小觑。试想如果在即将要播放动画时才一张一张的加载图片组合成动画，游戏就定在那里，对于玩家来说将是多么痛苦的事情。所以在游戏开始前加载资源的过程中，一般也会将经常用到的动画创建出来放到我这里，实际使用的时候再从我这里取走，同样牺牲了空间节省了时间。同时我与SpriteFrameCache也是唇亡齿寒的关系，经常播放的动画所使用的图片自然也就是经常使用的图片，所以这些图片也必须先被创建为SpriteFrame存入SpriteFrameCache那里。没有SpriteFrameCache的鼎力相助，我无法完成我的工作。
（两人此时正深情的对视着……）
我：额，两位。
（无应答）
我：我说两位。
（……）
我：下班了。
SpriteFrameCache和AnimationCache：走了， 走了。终于下班了，去哪儿喝一杯啊。
我：……

我：还是来说说你们是如何工作的吧。SpriteFrameCache，既然AnimationCache需要你的协助，那么还是从你开始，先来说说如何使用你。
SpriteFrameCache：使用我的方式有很多，但我实际需要的其实与SpriteFrame需要的相同，毕竟我是存储他的仓库，我的工作也包含创建他。还记得创建SpriteFrame需要的那些参数吧（texture，rect，rotated，offset，originalSize），不过您无需将这些参数像创建SpriteFrame那样一一指定给我，您可以将这些参数写在一个plist文件中，然后将这个plist文件指定给我，

// 如何使用图片的参数存放在plist文件中，图片名
void addSpriteFramesWithFile(const std::string& plist, const std::string& textureFileName);
/* 函数内部
 * 调用Director::getInstance()->getTextureCache()->addImage()将图片加载为纹理。
 * 调用addSpriteFramesWithFile()。
 */

当然，如果您已经创建好了纹理也可以，

void addSpriteFramesWithFile(const std::string&plist, Texture2D *texture);
/* 函数内部
 * 调用FileUtils::getInstance()->getValueMapFromFile()读取plist文件内容。
 * 调用addSpriteFramesWithDictionary()。
 */

又或者，不指定plist文件，您将plist文件的内容指定给我也没问题，

void addSpriteFramesWithFileContent(const std::string& plist_content, Texture2D *texture);
/* 函数内部
 * 调用FileUtils::getInstance()->getValueMapFromData()读取plist文件内容。
 * 调用addSpriteFramesWithDictionary()。
 */

再或者，您将图片名称放在plist文件中也ok，

void addSpriteFramesWithFile(const std::string& plist);
/* 函数内部
 * 使用FileUtils::getInstance()->fullPathForFilename()获取plist文件的全路径。
 * 调用FileUtils::getInstance()->getValueMapFromFile()读取plist文件内容。
 * 尝试从plist中找metadata域，如果找到了则从metadata域的textureFileName域得到图片的文件名，
 * 之后将plist所在路径与该图片名使用FileUtils::getInstance()->fullPathFromRelativeFile()拼在一起作为图片的完整路径名。
 * 如果没有在plist中找到图片名，则将plist文件的全路径中文件名的后缀由.plist更改为.png，以此更改后的全路径作为图片的完整路径名。
 * 调用Director::getInstance()->getTextureCache()->addImage()将图片加载为纹理。
 * 调用addSpriteFramesWithDictionary()。
 */

最后，如果您已经创建好了SpriteFrame，那我是再高兴不过的了，

// 每个SpriteFrame在SpriteFrameCache中都有个名字，这里作为参数传递了，通常这个名字放在之前提到的plist文件中。
void addSpriteFrame(SpriteFrame *frame, const std::string& frameName);
/* 函数内部
 * 调用_spriteFrames.insert()存储SpriteFrame与其名字的映射。
 */

此外还要说明一点，我存储的这些SpriteFrame不仅可以用于动画制作，您还可以使用他们直接来创建Sprite，

// xxx.plist中存储了名为xxx.png的SpriteFrame信息。
SpriteFrameCache::getInstance()->addSpriteFramesWithFile("xxx.plist");
// Sprite::createWithSpriteFrameName()会从SpriteFrameCache中查找指定的SpriteFrame，然后使用找到的SpriteFrame创建Sprite。
auto sprite = Sprite::createWithSpriteFrameName("xxx.png");

我：很多函数都调用了addSpriteFramesWithDictionary()。
SpriteFrameCache：嗯，这个函数乍一看很复杂，其实他只做了三件事，
1、继续解析plist文件（plist中存储SpriteFrame信息的格式可以有多种，通过metadata域中的format域进行标识，不同的格式提供SpriteFrame信息的方式不同。举个简单的例子，比如创建SpriteFrame所需要的rect这个变量，既可以使用一个key-value表示

<key>frame</key>
<string>{{2,2},{250,30}}</string>

也可以使用四个key-value表示

<key>x</key>
<float>2</float>
<key>y</key>
<float>2</float>
<key>width</key>
<float>250</float>
<key>height</key>
<float>30</float>

这些不同的表示形式就对应不同的format。其中当format为3时在plist文件中frames域中aliases域会给出SpriteFrame的别名，这些别名与原SpriteFrameName的映射我就会存在_spriteFramesAliases变量中。
）。
2、使用解析出来的信息创建SpriteFrame.
3、存储SpriteFrame与其名字的映射。
我：存储SpriteFrame的plist文件的格式竟然还有多种。
SpriteFrameCache：不用担心，plist文件一般是通过软件创建的，比如TexturePacker，cocostudio的合图功能等等。这些格式是由这些软件来负责的，而解析plist也是我的内部实现的，对于用户只需要使用软件创建plist，之后调用我们添加SpriteFrame即可。
我：添加SpriteFrame的方式有这么多，删除的呢？
SpriteFrameCache：删除的方式也有几种，
您可以指定加载过的plist或者其内容，这样从这个plist中添加的SpriteFrame就会被删除，

void removeSpriteFramesFromFile(const std::string& plist);
/* 函数内部
 * FileUtils::getInstance()->fullPathForFilename()读取plist文件的内容。
 * 调用removeSpriteFramesFromDictionary()。
 */
void removeSpriteFramesFromFileContent(const std::string& plist_content);
/* 函数内部
 * 调用FileUtils::getInstance()->getValueMapFromData()读取plist文件内容。
 * 调用removeSpriteFramesFromDictionary()。
 */
// 以上两个函数都调用了removeSpriteFramesFromDictionary()。
void removeSpriteFramesFromDictionary(ValueMap& dictionary);
/* 函数内部
 * dictionary中存储了plist文件的内容，其中可以找到待删除的SpriteFrame的名字，一一从_spriteFrames中删除。
 */

或者通过texture，

void removeSpriteFramesFromTexture(Texture2D* texture);
/* 函数内部
 * 遍历_spriteFrames中的每一个映射，通过映射获得每一个SpriteFrame。
 * SpriteFrame->getTexture()与给定的texture比对，相同则删除该SpriteFrame。
 */

又或者通过SpriteFrame的名字，

void removeSpriteFrameByName(const std::string& name);
/* 函数内部
 * 如果给定的是SpriteFrame的别名，则会在_spriteFramesAliases中找到其原本的名字。
 * 使用SpriteFrame原本的名字删除_spriteFrames中的此SpriteFrame。
 */

或者直接删除所有的，

void removeUnusedSpriteFrames();
/* 函数内部
 * 清空_spriteFrames。
 */

此外，还有一个比较有用的方法，删除掉未被使用的SpriteFrame，

void removeUnusedSpriteFrames();
/* 函数内部
 * 删除_spriteFrames中引用计数为1的SpriteFrame（引用计数为1代表此SpriteFrame只被SpriteFrameCache使用）。
 */

我：我看还有个获取的方法。
SpriteFrameCache：获取很简单，只有一种方式，

SpriteFrame* getSpriteFrameByName(const std::string& name);
/* 函数内部
 * 用给定的name在_spriteFrames中寻找。
 * 如果没找到则用name在_spriteFramesAliases中查找别名，并用别名在_spriteFrames中寻找。
 * 最终找到了返回SpriteFrame，未找到返回nullptr。
 */

我：你在介绍使用方式的同时也介绍了不少实现方式，同时提到了许多你使用的变量，简单做个总结。
SpriteFrameCache：嗯，好的。其实我只用到了三个变量，

Map<std::string, SpriteFrame*> _spriteFrames;    // 存储SpriteFrame的名字与SpriteFrame之间的映射。
ValueMap _spriteFramesAliases;    // 存储SpriteFrame的别名与SpriteFrame的名字之间的映射。
std::set<std::string>*  _loadedFileNames;    // 存储加载过的plist文件名。加载过的plist不会重复加载。

其中最核心的就是_spriteFrames这个变量。每个SpriteFrame在我这里都有个名字，从我这里取走SpriteFrame或是删除SpriteFrame都需要提供他们的名字。
我：终于，你的工作差不多都聊完了。
SpriteFrameCache：其实还未完全，我的实现中还支持SpriteFrame的PolygonInfo以及.9.png类型的图片。
我：这些等我对他们了解了之后，再回过头来看吧。

我：和SpriteFrameCache聊了很长时间，现在终于轮到你了AnimationCache。
AnimationCache：我的使用方式没有SpriteFrameCache的那么多，添加Animation的方式有两种，可以通过plist文件添加，

void addAnimationsWithFile(const std::string& plist);
/* 函数内部
 * 读取plist文件的内容。
 * 调用addAnimationsWithDictionary();
 */
void addAnimationsWithDictionary(const ValueMap& dictionary,const std::string& plist);
/* 函数内部
 * 根据plist的内容，获取自己需要用到的spritesheets，并将他们添加进SpriteFrameCache中。
 * 根据plist的format，解析出创建AnimationFrame所需信息，并创建它。
 * 根据plist的format，解析出创建Animation所需信息，并创建它。
 * 将Animation与其名字作为映射存入_animations变量中。
 */

一个实际的例子，

auto cache = AnimationCache::getInstance();
cache->addAnimationsWithFile("xxx.plist");
auto dance_animation = cache->getAnimation("dance");

或者您已经创建好了Animation，我也是再高兴不过的了，

void addAnimation(Animation *animation, const std::string& name);
/* 函数内部
 * _animations.insert(name, animation);
 */

删除Animation的方式只有一个，

void removeAnimation(const std::string& name);
/* 函数内部
 * _animations.erase(name);
 */

获取Animation的方式也只有一个，

Animation* getAnimation(const std::string& name);
/* 函数内部
 * _animations.at(name);
 */

此外要说明一点，在plist文件中您可以为每一个动画帧指定userInfo，通过在每一个动画帧中加入如下key-value，

<key>notification</key>
<dict>
    ...
</dict>

具体点的例子，

<key>notification</key>
<dict>
    <key>key1</key>
    <integer>1234</integer>
    <key>key2</key>
    <false/>
</dict>

在解析plist中每一动画帧的信息时，会把这些作为用户信息存入AnimationFrame::_userInfo中。还记得Animate的工作方式吗，在动画播放此帧时他将发送这些信息，您只需要在程序中接收这些信息即可，

/* AnimationFrameDisplayedNotification定义在cocos/base/ccMacros.h，
 * #define AnimationFrameDisplayedNotification "CCAnimationFrameDisplayedNotification"
 * 是用户自定义事件的名字。
 * 当动画帧播放完成时，Animate会将该帧的userInfo通过名为CCAnimationFrameDisplayedNotification的自定义事件发送。
 * userInfo会以AnimationFrame::DisplayedEventInfo结构体的形式发送。
 */
auto listener = EventListenerCustom::create(AnimationFrameDisplayedNotification, [](EventCustom *e) {
    auto userdata = static_cast<AnimationFrame::DisplayedEventInfo *>(e->getUserData());

    log("target[%p], data[%s]", userdata->target, Value(*(userdata->userInfo)).getDescription().c_str());
});

我：你的内容真的少很多，那么同SpriteFrameCache一样，对你使用的变量，做个简单的总结。
AnimationCache：我使用的变量只有一个，也是最核心的，

Map<std::string, Animation*> _animations;    // 存储Animation的名字与Animation之间的映射。

每个Animation在我这里都有个名字，从我这里取走或是删除Animation都需要提供他们的名字。
我：今天的对话总算是结束了，不过SpriteFrameCache并没有了解完全，以下这些东西还需要了解。
PolygonInfo
.9.png

VermillionTear
关注
专栏目录
四、cocos2dx动画Animation介绍
qinning199的专栏
09-10 1万+
一、帧动画 你可以通过一系列图片文件，像如下这样，创建一个动画： CCAnimation *animation = CCAnimation::create(); //从本地文件系统中加载图片文件到CCSpriteFrame中区，然后添加到CCAnimation中 for (int i = 1; i < 15; i++) { char szImageFileName[128] = {0}
cocos2dx学习之路----第一篇（cocos2dx版本3.9开发环境的搭建及HelloWold的见面)
小乐子的博客
02-17 4787
这里我将开始写曾经学过的cocos2dx的表层教程。 这开篇可能我要多说几句，希望不要嫌弃哈~毕竟每一个引擎背后都有一些不为人知的故事，很值得缅怀。
cocos2d-x3.0 SpriteFrameCache
杜甲同学的专栏
04-26 2616
bool HelloWorld::init() { ////////////////////////////// // 1. super init first if ( !Layer::init() ) { return false; } auto s = Director::getInstance()->getWinSize();
Cocos2d-x 3.0 中文基础教程-精灵帧缓存（SpriteFrameCache）
码农之初心
05-06 887
简介 SpriteFrameCache 主要服务于多张碎图合并出来的纹理图片。这种纹理在一张大图中包含了多张小图，直接通过TextureCache引用会有诸多不便，因而衍生出来精灵框帧的处理方式，即把截取好的纹理信息保存在一个精灵框帧内，精灵通过切换不同的框帧来显示出不同的图案。 SpriteFrameCache SpriteFrameCache的内部封装了一个Map _spri
cocos2d-x 动画缓存CCAnimationCache
yhhwatl的专栏
08-15 1670
这一篇来学习怎么使用cocos2d-x引擎播放帧动画，就是把一帧一帧的图片像电影那样显示出来。 1. 首先来了解一下相关的类 CCAnimation：是精灵用来播放动画的参数，内部封装了一个帧序列(CCMutableArray)和每帧播放间隔时间（float m_fDelay），初始化该对象时记得指定delay时间，否则默认是0。 CCAnimationCache:从名字很容易看出，它是用来
Cocos2d-x 之精灵帧 SpriteFrame
xingxinmanong的博客
07-14 5974
前面介绍精灵Sprite和贴图Texture2D的时候都有涉及到精灵帧SpriteFrame，这三个的关系可以粗略看成，Texture2D是封装了一张图片的相关信息，SpriteFrame是对Texture2D的再次封装，可用于创建帧动画，而Sprite是对Texture2D和SpriteFrame的再次封装，以实现一个包含图片信息的“角色”，可执行各种动作和交互。
Cocos2dx-3.9 中文API CHM 文档
12-28
Cocos2dx-3.9 中文API CHM 文档 用过的都懂
cocos2dx3.x游戏开发之旅电子版
12-26
Cocos2dx是一个开源的游戏开发框架，它基于C++，同时支持多种语言，如Lua和JavaScript，为跨平台游戏开发提供了强大的工具。 在Cocos2dx 3.x版本中，框架进行了诸多优化和改进，提高了性能，简化了API，使得开发者...
Cocos2dx中UIWebView替换为WKWebView
08-09
在iOS开发中，Cocos2dx是一个广泛使用的游戏开发框架，它允许开发者创建跨平台的2D和3D游戏。然而，随着Apple对App Store审核政策的调整，使用UIWebView的App将不再被接受，因为Apple已经将其列为弃用API。在2020年...
使用c++基于Cocos2dx V3.16 开发的植物大战僵尸游戏
最新发布
05-10
Cocos2dx V3.16是该框架的一个版本，它包含了多项改进和优化，使得开发者能够更高效地构建游戏。在这个项目中，我们将深入探讨如何利用Cocos2dx V3.16来复刻经典游戏——植物大战僵尸。 首先，C++是游戏开发中广泛...
cocos2dxz之CCAnimationCache
专注，努力，勤奋
02-12 3466
通常情况下，对于一个精灵动画，每次创建时都需要加载精灵帧，按顺序添加到数组，再创建对应动作类，这是一个非常烦琐的计算过程。对于使用频率高的动画，比如鱼的游动，将其加入缓存可以有效降低每次创建的巨大消耗。由于这个类的目的和缓存内容都非常简单直接，所以其接口也是最简单明了的，如下所示： /** Retruns ths shared instance of the Animation
Cocos2d-x 学习笔记(6) Sprite SpriteFrameCache Texture2D TextureCache
weixin_30544657的博客
07-23 320
1. 概述 TextureCache是对Texture2D纹理的缓存，对图片文件的缓存。SpriteFrameCache是对SpriteFrame的缓存，是对纹理大图的矩形块的缓存，每个SpriteFrame是对Texture2D的封装，每个精灵帧都在同一个纹理大图中。 Sprite是对Texture2D和SpriteFrame的封装，可以实现一张图片在屏幕上的显示和变换。 2. ...
cocos2d-x 动画详解之三CCSpriteFrame
zmzsoftware的专栏
05-16 2265
CCSpriteFrame 精灵帧 CCTexture2D 将被用于CCSprite 默认的构造方法 通过 图片纹理+纹理上的矩形来创建 或通过 图片纹理+纹理上的矩形+是否旋转+偏移坐标+真实size   这里简单讲下 是否旋转      为了节省图片空间 图片将会被旋转90度 偏移坐标+真实size      为了节
Cocos2d-X使用CCAnimation创建动画
meishadevs的个人博客
10-29 3116
动画在游戏中是非常常见的 程序1：创建一个简单的动画 首先需要在工程目录下的Resource文件夹中放一张有各种不同动作的图片 在程序中添加下面的代码 #include "Animation.h" CCScene* Animation::scene() { CCScene* s = CCScene::create(); Animation* laye
cocos2dx 源码学习2 CCAnimationCache
huahua12300的专栏
11-13 858
我们经常会使用到CCSprite这个类，
【cocos2dx之CCAnimation、CCAnimate、CCAnimationCache使用】
知至智
11-03 1615
【cocos2dx之CCAnimation、CCAnimate、CCAnimationCache使用】
cocos2dx学习笔记之plist文件，SpriteFrame，SpriteFrameCache
ellis1970的博客
01-07 894
cocos2dx学习笔记之plist文件，SpriteFrame，SpriteFrameCache
Cocos2d-x中AnimationCache的用法
tsbyj的博客
07-21 1026
AnimationCache是一个单例类。可以用来存储创建好的Animation. 存储时使用函数void addAnimation(Animation* animation,const std::string & name)将一个Animation变量和它的名字存储到AnimationCache中。 删除时使用函数void removeAnimation(const std::string&
cocos2dx：addAnimation如何创建精灵动画并在工程中调用展示
ImCode
09-26 2017
但是如果某个动画会被多个精灵共用，为了简化代码，就需要写一个共用的动画以便使用，这时候就需要用到。通过给函数传递多个参数来初始化不同的动画，然后在需要的时候进行调用即可,代码如下。希望能给大家带来帮助！有什么问题需要讨论的可以评论私信欢迎讨论~工程中很多时候需要为精灵添加动画，也就是cocos2dx中的。如此一来就简化了许多代码而且不易出错。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值