cocos2d-x v3.0新特性及使用

八月份cocos2d-x官网发布了v3.0版本,这次更新的内容特别多,包括2dx的架构以及使用

总得来说,给开发者带来了很大的便利:


运行环境需求:

  • Android 2.3 or newer
  • iOS 5.0 or newer
  • OS X 10.7 or newer
  • Windows (which version?)
  • Linux Ubuntu 12.04 (or newer)
编译环境需求:
  • Xcode 4.6 (for iOS or Mac)
  • gcc 4.7 for Linux or Android. For Android ndk-r8e or newer is required.
  • Visual Studio 2012 (for Windows)

重要更新内容:
  • Replace Objective-C patters with C++ (C++11) patterns and best practices
  • Improve Labels
  • Improve renderer
其中C++ 11 新特性:

A subset of C++11 features are being used in cocos2d-x:

  • std::function, including lambda objects for callbacks
  • strongly typed enums, for most of the cocos2d-x enums and constants
  • std::thread for threading
  • override context keyword, for overriden methods

st  std::function

  • CallFunc can be created with an std::function<void()>
  • CallFuncN can be created with an std::function<void(Node*)>
  • CallFuncND and CallFuncO were removed since it can be created with simulated with CallFuncN and CallFunc. See ActionsTest.cpp for more examples
  • MenuItem supports std::function<void(Node*)> as callbacks
强大枚举类型更新:
Examples:
v2.1 v3.0
kCCTexture2DPixelFormat_RGBA8888 Texture2D::PixelFormat::RGBA8888
kCCDirectorProjectionCustom Director::Projection::CUSTOM
ccGREEN Color3B::GREEN
CCPointZero Point::ZERO
CCSizeZero Size::ZERO

The old values can still be used, but are not deprecated.


override
当虚函数被override关健字修饰时,子类实现时有override标记


    Removed Objective-C patterns

移除了所有Object-c模式,删除了CC前辍使用纯C++函数

对于类的使用改变:
2dx-3.0 两也不用使用using coco2d namespace

     clone() instead of copy()

clone() returns an autoreleased version of the copy.

copy() is no longer supported. If you use it, it will compile, but the code will crash.

Example:

1// v2.1
2CCMoveBy *action = (CCMoveBy*) move->copy();
3action->autorelease();
4
5// v3.0
6// No need to do autorelease, no need to do casting.
7auto action = move->clone();

     

     Singletons use getInstance() and destroyInstance()

All singletons use getInstance() and destroyInstance() (if applicable) to get and destroy the instance.

Examples:

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

v2.1 methods are still available, but they were tagged as deprecated.


     getters

Getters now use the get prefix.

Examples:

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

And getters were also tagged as const in their declaration. Example:

1// v2.1
2virtual float getScale();
3
4// v3.0
5virtual float getScale() const;

v2.1 methods are still available, but they were tagged as deprecated.



     POD types

Methods that were receiving POD types as arguments (eg: TexParamsPointSize, etc.) are being passed as constreference.

Example:

1// v2.1
2void setTexParameters(ccTexParams* texParams);
3
4// v3.0
5void setTexParameters(const ccTexParams& texParams);

   Misc API Changes

  ccTypes.h

Remove cc prefix for structure names in ccTypes.h, move global functions into static member functions, and move global constants into const static member variables.

structure name before changing structure name after changing
ccColor3B Color3B
ccColor4B Color4B
ccColor4F Color4F
ccVertex2F Vertex2F
ccVertex3F Vertex3F
ccTex2F Tex2F
ccPointSprite PointSprite
ccQuad2 Quad2
ccQuad3 Quad3
ccV2F_C4B_T2F V2F_C4B_T2F
ccV2F_C4F_T2F V2F_C4F_T2F
ccV3F_C4B_T2F V3F_C4B_T2F
ccV2F_C4B_T2F_Triangle V2F_C4B_T2F_Triangle
ccV2F_C4B_T2F_Quad V2F_C4B_T2F_Quad
ccV3F_C4B_T2F_Quad V3F_C4B_T2F_Quad
ccV2F_C4F_T2F_Quad V2F_C4F_T2F_Quad
ccBlendFunc BlendFunc
ccT2F_Quad T2F_Quad
ccAnimationFrameData AnimationFrameData

Global functions changed example

 1
 2// in v2.1
 3ccColor3B color3B = ccc3(0, 0, 0);
 4ccc3BEqual(color3B, ccc3(1, 1, 1));
 5ccColor4B color4B = ccc4(0, 0, 0, 0); 
 6ccColor4F color4F = ccc4f(0, 0, 0, 0);
 7color4F = ccc4FFromccc3B(color3B);
 8color4F = ccc4FFromccc4B(color4B);
 9ccc4FEqual(color4F, ccc4F(1, 1, 1, 1));
10color4B = ccc4BFromccc4F(color4F);
11
12color3B = ccWHITE;
13
14// in v3.0
15Color3B color3B = Color3B(0, 0, 0);
16color3B.equals(Color3B(1, 1, 1));
17Color4B color4B = Color4B(0, 0, 0, 0);
18Color4F color4F = Color4F(0, 0, 0, 0);
19color4F = Color4F(color3B);
20color4F = Color4F(color4B);
21color4F.equals(Color4F(1, 1, 1, 1));
22color4B = Color4B(color4F);
23
24color3B = Color3B::WHITE;

  deprecated functions and global variables

old name new name
ccp Point
ccpNeg Point::-
ccpAdd Point::+
ccpSub Point::-
ccpMult Point::*
ccpMidpoint Point::getMidpoint
ccpDot Point::dot
ccpCrosss Point::cross
ccpPerp Point::getPerp
ccpRPerp Point::getRPerp
ccpProject Point::project
ccpRotate Point::rotate
ccpUnrotate Point::unrotate
ccpLengthSQ Point::getLengthSq()
ccpDistanceSQ Point::getDistanceSq
ccpLength Point::getLength
ccpDistance Point::getDistance
ccpNormalize Point::normalize
ccpForAngle Point::forAngle
ccpToAngle Point::getAngle
ccpClamp Point::getClampPoint
ccpFromSize Point::Point
ccpCompOp Point::compOp
ccpLerp Point::lerp
ccpFuzzyEqual Point::fuzzyEqual
ccpCompMult Point::Point
ccpAngleSigned Point::getAngle
ccpAngle Point::getAngle
ccpRotateByAngle Point::rotateByAngle
ccpLineInersect Point::isLineIntersect
ccpSegmentIntersect Point::isSegmentIntersect
ccpIntersectPoint Point::getIntersectPoint
CCPointMake Point::Point
CCSizeMake Size::Size
CCRectMake Rect::Rect
PointZero Point::ZERO
SizeZero Size::ZERO
RectZero Rect::ZERO
TiledGrid3DAction::tile TiledGrid3DAction::getTile
TiledGrid3DAction::originalTile TiledGrid3DAction::getOriginalTile
TiledGrid3D::tile TiledGrid3D::getTile
TiledGrid3D::originalTile TiledGrid3D::getOriginalTile
Grid3DAction::vertex Grid3DAction::getVertex
Grid3DAction::originalVertex Grid3DAction::getOriginalVertex
Grid3D::vertex Grid3D::getVertex
Grid3D::originalVertex Grid3D::getOriginalVertex
Configuration::sharedConfiguration Configuration::getInstance
Configuration::purgeConfiguration Configuration::destroyInstance()
Director::sharedDirector() Director::getInstance()
FileUtils::sharedFileUtils FileUtils::getInstance
FileUtils::purgeFileUtils FileUtils::destroyInstance
EGLView::sharedOpenGLView EGLView::getInstance
ShaderCache::sharedShaderCache ShaderCache::getInstance
ShaderCache::purgeSharedShaderCache ShaderCache::destroyInstance
AnimationCache::sharedAnimationCache AnimationCache::getInstance
AnimationCache::purgeSharedAnimationCache AnimationCache::destroyInstance
SpriteFrameCache::sharedSpriteFrameCache SpriteFrameCache::getInstance
SpriteFrameCache:: purgeSharedSpriteFrameCache SpriteFrameCache::destroyInstance
NotificationCenter::sharedNotificationCenter NotificationCenter::getInstance
NotificationCenter:: purgeNotificationCenter NotificationCenter::destroyInstance
Profiler::sharedProfiler Profiler::getInstance
UserDefault::sharedUserDefault UserDefault::getInstance
UserDefault::purgeSharedUserDefault UserDefault::destroyInstance
Application::sharedApplication Application::getInstance
ccc3() Color3B()
ccc3BEqual() Color3B::equals()
ccc4() Color4B()
ccc4FFromccc3B() Color4F()
ccc4f() Color4F()
ccc4FFromccc4B() Color4F()
ccc4BFromccc4F() Color4B()
ccc4FEqual() Color4F::equals()
ccWHITE Color3B::WHITE
ccYELLOW Color3B::YELLOW
ccBLUE Color3B::BLUE
ccGREEN Color3B::GREEN
ccRED Color3B::RED
ccMAGENTA Color3B::MAGENTA
ccBLACK Color3B::BLACK
ccORANGE Color3B::ORANGE
ccGRAY Color3B::GRAY
kBlendFuncDisable BlendFunc::BLEND_FUNC_DISABLE

--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------

创建新项目:
 v3.0不再需要创建Xcode模版,使用create-multi-platform-projects.py来创建一个跨平台的项目,使用方法
 1,cd 到2dx根目录,MAC平台使用./create-multi-platform-projects.py  然后提示:
-bash: ./create-multi-platform-projects.py: /usr/bin/evn: bad interpreter: No such file or directory
没关系,我们打开.py文件,发现其实引用的是tools/project_creator/create_project.py 这文件
 2,我们再cd 到project_creator文件中,使用 ./create_project.py -p <PROJECT_NAME> -k <PACKAGE_NAME> -l <cpp|lua|javascript>
 3,这样我们就可以在2dx的projects文件夹中找到创建好的项目

关于项目的选择:
图示:
cocos2d-x v3.0新特性及使用_第1张图片
红包点选就可以选择对应运行平台

你可能感兴趣的:(cocos2d-x v3.0新特性及使用)