cocos2d-x v3.6 发布说明

目录 generated with DocToc

• 概况
• 需求
  • 环境需求
  • 编译需求
  • 如何运行 TestCpp
    • Mac OSX & iOS
    • Android
    • Windows
    • Linux
  • 如何开始一个新游戏
• v3.6
  • v3.6亮点
  • 细节
    • 3D立方纹理
    • 3D天空盒
    • 3D地形
    • 3D骨骼动画质量控制
    • 使用SpritePolygon，让填充率不再成为你的瓶颈
    • luajit arm64
    • Button内存使用优化
      • iOS平台
      • Mac平台

概况

• 完整更新日记
• v3.0 发布说明: v3.0 Release Notes

需求

环境需求

• Android 2.3 及以上
• iOS 5.0 及以上
• OS X 10.7 及以上
• Windows 7 及以上
• Windows Phone 8.1
• Linux Ubuntu 14.04 及以上

编译需求

• Xcode 5.1 及以上 (for iOS or Mac)
• gcc 4.9 及以上 (for Linux)
• ndk-r10c (for Android)
• Visual Studio 2012 及以上 (for Windows (win32))
• Visual Studio 2012 及以上 (for Windows Phone 8)

如何运行 TestCpp

Mac OSX & iOS

• 进入 cocos2d-x/build 文件夹, 打开 cocos2d_test.xcodeproj
• 在 Xcode 的 scheme toolbar 选择 iOS 或者 OS X 平台
• 点击 run 按钮

Android

你可以运行一下示例...

使用命令行：

$ cd cocos2d-x
$ ./setup.py
$ cd build
$ ./android-build.py cpp-empty-test -p 10
$ adb install cocos2d-x/tests/cpp-empty-test/proj.android/bin/CppEmptyTest-debug.apk

然后点击安卓设备上的程序运行测试例，-p 指定了 Android API 等级，cocos2d-x 支持 level10 以上。

使用 Eclipse:

$ cd cocos2d-x
$ ./setup.py
$ cd build
$ ./android-build.py cpp-empty-test -p 10

然后

• 把 cocos2d-x Android 项目导入 Eclipse 中，导入的路径是 cocos/platform/android
• 把 cpp-empty-test Android 项目导入 Eclipse 中，导入的路径是 tests/cpp-empty-test/proj.android
• 编译 cpp-empty-test Android 项目，然后运行即可

Windows

• 进入 cocos2d-x/build 目录, 然后打开 cocos2d-win32.vs2012.sln 文件
• 选择 cpp-empty-test 作为启动项
• 点击运行按钮

Linux

$ cd cocos2d-x/build
$ ./install-deps-linux.sh
$ cd ../..

然后

$ mkdir build
$ cd build
$ cmake ../cocos2d-x
$ make -j4

运行

$ cd bin/cpp-empty-test
$ ./cpp-empty-test

如何开始一个新游戏

请参考: ReadMe

v3.6

v3.6亮点

• 3D: 添加天空盒支持
• 3D: 添加地形支持
• 添加SpritePolygon以解决绘制填充率的问题
• iOS 64位架构使用luajit v2.1-20150331版本
• 移除WP8支持
• 优化ui::Button内存使用
• 第三方库: Spine运行时库更新到v2.1.25版本
• 第三方库: libcurl更新到v7.4版本（支持全平台，除了WP8.1平台）
• 第三方库: chipmunk更新到v6.2.2版本
• 第三方库: openssl更新到v1.0.11版本
• 第三方库: freetype更新到v2.5.5版本
• 第三方库: png更新到v1.6.16版本

因为Angle不再支持WP8，而且全世界范围内WP8的市场份额大概在20%左右，所以在微软OPEN TECH的建议下，从3.6版本开始，我们移除了对WP8的支持。

细节

3D立方纹理

立方纹理对天空盒和环境贴图非常有用，它使用6张纹理分别投影到立方体的6个面上，进行纹理采用。

立方纹理的用法

auto texturecube = TextureCube::create("left.jpg", "right.jpg", "top.jpg", "bottom.jpg","front.jpg", "back.jpg");
//设置纹理参数
Texture2D::TexParams tRepeatParams;
tRepeatParams.magFilter = GL_NEAREST;
tRepeatParams.minFilter = GL_NEAREST;
tRepeatParams.wrapS = GL_MIRRORED_REPEAT;
tRepeatParams.wrapT = GL_MIRRORED_REPEAT;
texturecube->setTexParameters(tRepeatParams);

//使用自定义着色器创建一个GLProgramState
auto shader = GLProgram::createWithFilenames("cube_map.vert", "cube_map.frag");
auto state = GLProgramState::create(shader);
//传递纹理采样器到我们自定义的着色器中，state是一个指向GLProgramState的指针，u_cubeTex是shader中的一个uniform变量
state->setUniformTexture("u_cubeTex", texturecube);

cube_map.frag着色器如下，

varying vec3        v_reflect; //reflect direction
uniform samplerCube u_cubeTex;

void main(void)
{
    gl_FragColor = textureCube(u_cubeTex, v_reflect); //sample the color of reflection direction
}

更多详细信息请参考 cpp-tests/Sprite3DTest/Sprite3DCubeMapTest。

3D天空盒

天空盒是3D游戏的一个常用组件。它基于立方纹理实现。

天空盒的用法

// 创建一个立方纹理
auto textureCube = TextureCube::create("left.jpg", "right.jpg","top.jpg", "bottom.jpg","front.jpg", "back.jpg");
// 创建一个天空盒
auto skyBox = Skybox::create();
skyBox->retain();
// 将立方纹理设置给天空盒
skyBox->setTexture(textureCube);
addChild(_skyBox);

更多详细信息请参考 cpp-tests/Sprite3DTest/Sprite3DCubeMapTest。

3D地形

地形是3D游戏的一个常用组件。使用一张纹理来代表地形的高度，最多可以使用4张纹理混合模拟地表的细节，比如草地，道路等等。

地形的用法

//混合层
Terrain::DetailMap dirt("TerrainTest/dirt.jpg"), grass("TerrainTest/Grass2.jpg"), road("TerrainTest/road.jpg"), green("TerrainTest/GreenSkin.jpg");

//高度地图，透明度地图（混合权重）和混合层
Terrain::TerrainData data("TerrainTest/heightmap16.jpg", "TerrainTest/alphamap.png", dirt, grass, road, green);

//创建地形
_terrain = Terrain::create(data,Terrain::CrackFixedType::SKIRT);
//set lod distance
_terrain->setLODDistance(3.2,6.4,9.6);
//必须小于5
_terrain->setMaxDetailMapAmount(4);
addChild(_terrain);

更多详细信息请参考 cpp-tests/Sprite3DTest/TerrainTest。

3D骨骼动画质量控制

为了让3D骨骼动画运行地更流畅，你可以使用低质量的动画。这里有3种动画质量：

• Animate3DQuality::QUALITY_NONE
• Animate3DQuality::QUALITY_LOW
• Animate3DQuality::QUALITY_HIGH

Animate3DQuality::QUALITY_NONE 意思是动画将不会更新. 如果你可以确定3D精灵不可见，那么你可以使用这种类型。Animate3DQuality::QUALITY_LOW 会直接使用最近的帧。 Animate3DQuality::QUALITY_HIGH 则会使用临近的两帧进行插值运算出当前帧。

std::string fileName = "Sprite3DTest/orc.c3b";
auto sprite = Sprite3D::create(fileName);
addChild(sprite);

auto animation = Animation3D::create(fileName);
if (animation)
{
   auto animate = Animate3D::create(animation);
   //use low quality animation
   animate->setQuality(Animate3DQuality::QUALITY_LOW);
   sprite->runAction(RepeatForever::create(animate));
}

也可以通过修改config.plist来配置默认的动画质量，对应的值是cocos2d.x.3d.animate_high_quality。如果这个值存在的话，所有的3D骨骼动画都会受到这个值的影响。当然你也可以通过上面的代码来修改。

使用SpritePolygon，让填充率不再成为你的瓶颈

SpritePolygon是一个2d节点，和Sprite一样，它显示了一个2d图像。但区别在于，Sprite使用了2个三角形来组成四边形，而SpritePolygon则是由N个三角形组成的。该特性目前还是一个实验特性。

对于绘制相同的图像，SpritePolygon会让GPU节省大量的像素填充。

因为通常2d游戏的顶点数量比3d游戏少得多，而且几乎所有2d图片都不是四边形，这就导致了显卡浪费大量的带宽来绘制完全透明的区域，所以像素填充率往往是2d游戏的性能瓶颈。SpritePolygon是解决像素填充率瓶颈的有效手段。

下图是性能测试对比图，对应的测试例在tests/cpp-tests/Classes/SpritePolygonTest：

更多详细信息请参考 这个帖子

luajit arm64

Luajit的版本是v2.1-20150331。 我们咨询过luajit的作者，他告知这个版本已经非常稳定了，等v2.1最终版发布时我们将会进行更新。

使用luajit arm64是因为它可以提高性能。在之前的Cocos2d-x版本中，iOS 64位设备使用的是lua。

luajit和luajit arm64的字节码是不兼容的，这意味着你不能在iOS32位和64位设备上使用同一份字节码。

因为Android商店没有强制要求必须上传64位应用程序，所以我们没有在Android上使用luajit arm64版本，因为它的字节码和luajit arm32是不兼容的。

Button内存使用优化

现在Button上的title文本控件是按需创建的，如果没有title将不会创建一个额外的空文本控件。

我们也移除了Button头文件里的一些无用字符串变量。

我们使用Cpp-Empty-Test来验证优化效果。

以下是代码：

auto visibleSize = Director::getInstance()->getVisibleSize();
auto origin = Director::getInstance()->getVisibleOrigin();

int num = 100;
for (int i=0; i < num; ++i)
{
auto button = ui::Button::create("ClosedNormal.png",
"ClosedSelected.png");
button->setPosition(origin + visibleSize/2);
this->addChild(button);
}

以下是结果：

iOS平台

Mac平台