cocos2dx[3.x](3)——大巨变3.x

【唠叨】

本节摘自：https://github.com/fusijie/Cocos2d-x3.0-Release-Note/blob/master/cocos2d-x_v3.0_release_notes.md

【目录】

v3.0 亮点
细节
- C++11 特性
  - std::function
  - 强类型枚举
  - 覆盖
- 去OC化
  - 移除C++类的“cc”前缀以及free functions
  - 使用 clone 替代 copy
  - 单例类采用了 getInstance 和 destroyInstance
  - 使用了 Ref 代替 Object
  - getters
  - POD 类型
- 新的渲染器
  - 渲染器特性
    - 自动批处理
    - 自动剔除
    - 全局 Z 值
  - Sprite 和 SpriteBatchNode
- 优化 LabelTTF / LabelBMFont / LabelAtlas
- 新的事件分发机制
- 物理引擎集成
其他 API 变更
- ccTypes.h
- 弃用的函数和全局变量
新的模板容器
- Map 替代 CCDictionary
- Vector 替代 CCArray
- Value 替代 CCBool, CCFLoat, CCDouble

v3.0 亮点

使用 C++(C++11) 的特性取代了 Objective-C 的特性
优化了 Labels
优化了渲染器（比 v2.2 更快）
新的事件分发机制
物理引擎集成
新的 UI 对象
模板容器
- 使用 cocos2d::Map<> 替代了 CCDictionary , 用法
- 使用 cocos2d::Vector<> 替代了 CCArray, 用法
- 使用 cocos2d::Value 替代了 CCBool, CCFLoat, CCDouble, 用法

细节

C++11 特性

C++11 的一部分特性已经被使用到 cocos2d-x 中了：

std::function, 包含了回调中使用的 lambda 对象
对于大多数的 cocos2d-x 枚举和常量采用了强类型枚举
在线程中使用了 std::thread
对于 Override 和 final 方法，增加了 override 和 final 上下文关键字

std::function

CallFunc 可以由 std::function<void()> 来创建
CallFuncN 可以由 std::function<void(Node*)> 来创建
CallFuncND 和 CallFuncO 已经被移除了因为它们可以类似地由 CallFuncN 和 CallFunc 来创建. 可以查看示例中的 ActionsTest.cpp 文件
MenuItem 支持 std::function<void(Node*)> 作为回调

CallFunc 示例:

//
// v2.1 版本
CCCallFunc *action1 = CCCallFunc::create( this, callfunc_selector( MyClass::callback_0 ) );

// v3.0 版本 (短版本)
auto action1 = CallFunc::create( CC_CALLBACK_0(MyClass::callback_0,this));
auto action2 = CallFunc::create( CC_CALLBACK_0(MyClass::callback_1,this, additional_parameters));

// v3.0 版本 (长版本)
auto action1 = CallFunc::create( std::bind( &MyClass::callback_0, this));
auto action2 = CallFunc::create( std::bind( &MyClass::callback_1, this, additional_parameters));

// v3.0 中你也可以使用lambda表达式或者其他函数对象
auto action1 = CallFunc::create(
[&](){
auto s = Director::sharedDirector()->getWinSize();
auto label = LabelTTF::create(“called:lambda callback”, “Marker Felt”, 16);
label->setPosition(ccp( s.width/4*1,s.height/2-40));
this->addChild(label);
} );
//

MenuItem 示例:

//
// v2.1 版本
CCMenuItemLabel *item = CCMenuItemLabel::create(label, this, menu_selector(MyClass::callback));

// v3.0 版本 (短版本)
auto item = MenuItemLabel::create(label, CC_CALLBACK_1(MyClass::callback, this));

// v3.0 版本 (长版本)
auto item = MenuItemLabel::create(label, std::bind(&MyClass::callback, this, std::placeholders::_1));

// v3.0 中你也可以使用lambda表达式或者其他函数对象
auto item = MenuItemLabel::create(label,
[&](Object *sender) {
// do something. Item “sender” clicked
});
//

强类型枚举

以 k 开头的常量和枚举量，通常被定义为 int 或者简单的 enum 类型，现在已经被强类型枚举（enum class）所替代，这样有利于避免冲突和类型错误。

新的格式是:

| v2.1 | v3.0 |
| kTypeValue | Type::VALUE |

示例:

覆盖

为了捕获覆盖方法中可能出现的错误，子类的覆盖方法添加了 override 的关键字。

示例:

//
class Sprite : public Node {
// Overrides
virtual void setTexture(Texture2D *texture) override;
virtual Texture2D* getTexture() const override;
}
//

去OC化

移除C++类的“cc”前缀以及free functions

类的变更

因为 cocos2d-x 已经使用了 cocos2d 的命名空间，因此也就不需要在所有的类中添加 CC 的前缀。

示例:

free functions 的变更

对于 drawing primitives:

已经被添加到 DrawPrimitives 命名空间
移除 cc 前缀

对于 gl proxy functions:

已经被添加到 GL 命名空间
移除 ccGL 前缀

示例:

使用 clone 替代 copy

clone() 返回了一份 autoreleased 版本的拷贝。

copy() 不再被支持，如果你使用它，仍然是可以编译的，但是代码会崩掉。

示例:

//
// v2.1
CCMoveBy *action = (CCMoveBy*) move->copy();
action->autorelease();

// v3.0
// 不需要使用autorelease，也不需要做转换
auto action = move->clone();
//

单例类采用了 getInstance 和 destroyInstance

所有的单例类使用 getInstance() 和 destroyInstance() (如果可用) 来获取和摧毁实例。

Examples:

| v2.1                          | v3.0                        |
| CCDirector->sharedDirector()  | Director->getInstance()     |
| CCDirector->endDirector()     | Director->destroyInstance() |
| etc…                                                      |

使用了 Ref 代替了 Object

因为 Object 容易让人混淆，所以重命名为 Ref ，同时移除了和引用计数无关的函数，之前所有继承于 Object 的类现在都改为继承于 Ref。

getters

Getters 现在使用了 get 前缀。

示例:

| v2.1                            | v3.0*                              |
| node->boundingBox()             | node->getBoundingBox()             |
| sprite->nodeToParentTransform() | sprite->getNodeToParentTransform() |
| etc…                                                               |

当然 getters 在声明中也被标识为 const 。

示例:

//
// v2.1
virtual float getScale();

// v3.0
virtual float getScale() const;
//

POD 类型

接收 POD 类型作为参数的方法（比如：TexParams, Point, Size,等等）已经修改为传递成 const 型引用。

示例:

//
// v2.1
void setTexParameters(ccTexParams* texParams);

// v3.0
void setTexParameters(const ccTexParams& texParams);
//

新的渲染器

Cocos2d-x v3.0 有了一个更威武，更优雅，更易扩展，更灵活的新渲染器，但是它依旧很容易使用也很好理解。Cocos2d-x 的老用户们将会发现新的API是如此的熟悉，根本不需要去考虑底层做了什么改变和更新，用起来仍然是这么的舒服。

它已经从 Scene Graph 中分离出来，draw() 方法替代了 “drawing” 发送了一个 渲染命令 给 渲染器，而 渲染器 负责绘制排队的 渲染命令 。
Quadcommands (Sprite 和 Particlesystem 对象使用) 将会自动进行批处理。
CustomCommand 对象允许用户自定义 OpenGL 代码，使用的 API 类似 v2.2。
GroupCommand 对象允许渲染器中拥有不同 OpenGL 值的“堆栈”。
Sprite 的自动剔除功能（虽然从技术上讲，自动剔除功能是表现在 Sprite 代码上而不是 Renderer 代码上）
全局 Z 轴顺序 (局部 Z 轴顺序仍然有效)

更多的细节信息，可以阅读如下文档: Renderer Specification document

渲染器特性

自动批处理

自动批处理功能意味着 渲染器将会把 多次绘制调用 打包为一次 大的绘制调用（AKA batch）。组合 绘制调用当然需要满足一定的条件：

它仅工作在 QuadCommand 命令下（由 Sprite 和 ParticleSystem 对象使用）
QuadCommadnds 必须共享相同的材质 ID ：相同的纹理ID，相同的 GLProgram 和相同的混合功能
QuadCommands 必须是连续的

如果这些条件都满足的话，渲染器 将会使用所有这些 QuadCommand 对象创建一个批处理（一次绘制调用）。

如果你不熟悉 OpenGL 的使用，批处理对于您游戏的能否拥有一个流畅的运行速度是很重要的，越少的批处理（绘制调用）越有利于您游戏的表现力。

自动剔除

目前，自动剔除功能只在 Sprite 对象中实现。

当 Sprite::draw() 被调用的时候，它将会检查 Sprite 是否超出屏幕，如果是的话，它将不会发送 QuadCommand 命令给 渲染器,因此可以获得一些性能上的提升。

全局 Z 值

Node 增加了新的函数 setGlobalZOrder() / getGlobalZOrder(),之前的旧函数 setZOrder() / getZOrder() 也被重命名为 setLocalZOrder() / getLocalZOrder()。

globalZOrder 是一个 float （不是 int）的参数。这个值在 渲染器 中用来给 RenderCommand 排序。较低的值拥有较高的优先级。这意味着一个 globalZorder 为 -10的节点会比一个 globalZOrder 为 10 的节点优先绘制。

globalZOrder 为 0 （默认值）的节点将会根据 Scene Graph 顺序绘制。

如果 globalZOrder 不变的话，Cocos2d-x v3.0 和 Cocos2d-x v2.2 行为一致。

globalZOrder() 和 localZOrder():

globalZOrder 是用于 渲染器 中用来给“绘制命令”排序的
localZOrder 是用于父节点的子节点数组中给 节点 对象排序的

Sprite 和 SpriteBatchNode

v2.2 版本中推荐的优化游戏方式是将 SpriteBatchNode 对象设置为 Sprite 对象的父节点。虽然使用SpriteBatchNode 对象仍然是一个非常好的优化游戏的方式，但是它仍然有一定的限制：

Sprite 对象的孩子只能是 Sprite （否则，Cocos2d-x 会触发断言）
- 当 Sprite 的父节点是 SpriteBactchNode 时，不能添加 ParticleSystem 作为 Sprite的子节点。
- 这将导致当 Sprite 的父节点是 SpriteBatchNode 时，不能使用 ParallaxNode
所有的 Sprite 对象必须共享相同的纹理ID (否则，Cocos2d-x 会触发断言)
Sprite 对象使用 SpriteBatchNode 的混合函数和着色器。

虽然 v3.0 仍然支持 SpriteBatchNode （与之前的版本拥有相同的特效和限制），但是我们不鼓励使用它。相反，我们推荐直接使用 Sprite，不需要再它作为子节点添加到 SpriteBatchNode 中。

但是，为了能让 v3.0 有更好的表现，你必须要确保你的 Sprite 对象满足以下条件：

贡献相同的纹理ID（把它们放在一个spritesheet中，就像使用 SpriteBatchNode 一样）
确保它们使用相同的着色器和混合函数（就像使用 SpriteBatchNode 一样）

如果这么做， Sprites 将会像使用 SpriteBatchNode 一样的快…（在旧设备上大概慢了10%，在新设备上基本上察觉不出）

v2.2 和 v3.0 最大的区别在于：

Sprite 对象可以有不同的纹理ID。
Sprite 对象可以有不同种类的 Node 作为子节点，包括 ParticleSystem。
Sprite 对象可以有不同的混合函数和不同的着色器。

但是如果你这么做，渲染器 可能无法对它所有的子节点进行批处理（性能较低）。但是游戏仍然可以正常运行，不会触发任何断言。

总结:

保持将所有的精灵放在一张大的 spritesheet 中。
使用相同的混合函数（使用默认）
使用相同的着色器（使用默认）
不要将精灵添加到 SpriteBatchNode

只有当你需要一些额外的性能上提升（虽然很小），SpriteBatchNode 才会是你最后的选择（你需要对它的限制条件很熟悉）。

优化 LabelTTF / LabelBMFont / LabelAtlas

LabelTTF, LabelBMFont 和 LabelAtlas 将会被新的 Label 代替. 新的 Label 带来的好处有:

统一了创建 LabelTTF, LabelBMFont 和 LabelAtlas 的 API
使用 freetype 生成 labels 的纹理，这样就能保证在不同的平台下 labels 有相同的效果。
缓存纹理以提高性能

新的事件分发机制

触摸事件，键盘事件，加速器事件和自定义事件等所有事件都由 EventDispatcher 分发。 TouchDispatcher,KeypadDispatcher, KeyboardDispatcher, AccelerometerDispatcher 已经被移除。

EventDispatcher 的特性主要有:

事件的分发基于渲染顺序
所有的事件都由 EventDispatcher 分发
可以使用 EventDispatcher 来分发自定义事件
可以注册一个 lambda 表达式作为回调函数

更多 EventDispatcher 细节可以参考 this document。

物理引擎集成

在 v3.0 中，我们把基于 Chipmunk2D 的物理引擎集成到 Cocos2d-x 中，通过这些特性，你可以很容易创建基于物理效果的游戏，而不必去理解物理引擎。

更的关于物理引擎集成的细节可以参考 this document。

其他 API 变更

ccTypes.h

在 ccType.h 中删除结构命名中的 cc 前缀，将全局函数移至静态成员函数，将全局常量移至静态成员常量。

全局函数变更示例

//
// in v2.1
ccColor3B color3B = ccc3(0, 0, 0);
ccc3BEqual(color3B, ccc3(1, 1, 1));
ccColor4B color4B = ccc4(0, 0, 0, 0);
ccColor4F color4F = ccc4f(0, 0, 0, 0);
color4F = ccc4FFromccc3B(color3B);
color4F = ccc4FFromccc4B(color4B);
ccc4FEqual(color4F, ccc4F(1, 1, 1, 1));
color4B = ccc4BFromccc4F(color4F);

color3B = ccWHITE;

// in v3.0
Color3B color3B = Color3B(0, 0, 0);
color3B.equals(Color3B(1, 1, 1));
Color4B color4B = Color4B(0, 0, 0, 0);
Color4F color4F = Color4F(0, 0, 0, 0);
color4F = Color4F(color3B);
color4F = Color4F(color4B);
color4F.equals(Color4F(1, 1, 1, 1));
color4B = Color4B(color4F);

color3B = Color3B::WHITE;
//

弃用的函数和全局变量

本文出自 “夏天的风” 博客，请务必保留此出处http://shahdza.blog.51cto.com/2410787/1549850

关键词：