cocos2d－x之节点类CCNode

节点类CCNode可以说是游戏元素的鼻祖了，基本上我们看得到的游戏元素都是以它为原型进行扩展的。像CCScene，CCLayer，CCSprite，CCMenu，CCSpriteBatchNode等等都是从CCNode继承而来。另外如果我们要自定义精灵，那么从CCNode继承也是一个很不错的选择。

CCNode直接从CCObject继承而来，有如下几个特点：

（1）可以包含其他CCNode节点，可以进行添加/获取/删除子节点操作。

（2）可以执行周期性的回调任务。

（3）可以执行动作。

一些子类化的节点提供了更为丰富的特性和功能：

1、属性

1. Features of CCNode:  
2. - position                                   //位置，默认(0,0)  
3. - scale (x, y)                               //缩放，默认(1,1)  
4. - rotation (in degrees, clockwise)           //旋转，默认为0  
5. - skew                                       //倾斜，默认为0  
6. - CCCamera (an interface to gluLookAt )      //CCCamera，视点转换，每个节点都有，默认指向节点中心  
7. - CCGridBase (to do mesh transformations)    //CCGridBase，网类转变  
8. - anchor point                               //锚点，默认(0,0)  
9. - size                                       //尺寸，默认(0,0)  
10. - visible                                    //可见  
11. - z-order                                    //z轴值  
12. - openGL z position                          //OpenGL z值  

[cpp]  view plain copy

1.     //初始化函数，成功返回true  
2.    virtual bool init();  
3.   
4. //分配内存空间，调用init并添加autoRelease标记  
5.    static CCNode * create(void);  
6.      
7.    //返回描述字符串  
8.    const char* description(void);  

2.图形属性

[cpp]  view plain copy

1. //设置/获取Z轴顺序，Z轴大的覆盖Z轴小的  
2.     virtual void setZOrder(int zOrder);  
3.     virtual void _setZOrder(int z);  
4.     virtual int getZOrder();  
5.   
6.     //设置/获取OpenGL Z轴顶点  
7.     virtual void setVertexZ(float vertexZ);  
8.     virtual float getVertexZ();  
9.   
10.     //设置/获取缩放值  
11.     virtual void setScaleX(float fScaleX);  
12.     virtual float getScaleX();  
13.     virtual void setScaleY(float fScaleY);  
14.     virtual float getScaleY();  
15.     virtual void setScale(float scale);  
16.     virtual float getScale();  
17.     virtual void setScale(float fScaleX,float fScaleY);  
18.   
19.     //设置/获取位置  
20.     virtual void setPosition(const CCPoint &position);  
21.     virtual const CCPoint& getPosition();  
22.     virtual void setPosition(float x, float y);  
23.     virtual void getPosition(float* x, float* y);  
24.     virtual void  setPositionX(float x);  
25.     virtual float getPositionX(void);  
26.     virtual void  setPositionY(float y);  
27.     virtual float getPositionY(void);  
28.       
29.     //设置/获取倾斜角度  
30.     virtual void setSkewX(float fSkewX);  
31.     virtual float getSkewX();  
32.     virtual void setSkewY(float fSkewY);  
33.     virtual float getSkewY();  
34.   
35.     //设置/获取锚点  
36.     virtual void setAnchorPoint(const CCPoint& anchorPoint);  
37.     virtual const CCPoint& getAnchorPoint();  
38.     virtual const CCPoint& getAnchorPointInPoints();  
39.       
40.     //设置/获取大小  
41.     virtual void setContentSize(const CCSize& contentSize);  
42.     virtual const CCSize& getContentSize() const;  
43.   
44.     //设置/获取可见性  
45.     virtual void setVisible(bool visible);  
46.     virtual bool isVisible();  
47.   
48.     //设置/获取旋转角度  
49.     virtual void setRotation(float fRotation);  
50.     virtual float getRotation();  
51.     virtual void setRotationX(float fRotaionX);  
52.     virtual float getRotationX();  
53.     virtual void setRotationY(float fRotationY);  
54.     virtual float getRotationY();  

3.节点操作

[cpp]  view plain copy

1. //添加/获取子节点，可以带Z轴顺序（默认为0）和标签  
2.     virtual void addChild(CCNode * child);  
3.     virtual void addChild(CCNode * child, int zOrder);  
4.     virtual void addChild(CCNode* child, int zOrder, int tag);  
5.     CCNode * getChildByTag(int tag);  
6.     virtual CCArray* getChildren();  
7.     unsigned int getChildrenCount(void) const;  
8.       
9.     //设置/获取父节点  
10.     virtual void setParent(CCNode* parent);  
11.     virtual CCNode* getParent();  
12.       
13.     //从父节点中移除自身，默认cleanup为true  
14.     virtual void removeFromParent();  
15.     virtual void removeFromParentAndCleanup(bool cleanup);  
16.   
17.     //移除子节点  
18.     virtual void removeChild(CCNode* child);  
19.     virtual void removeChild(CCNode* child, bool cleanup);  
20.     virtual void removeChildByTag(int tag);  
21.     virtual void removeChildByTag(int tag, bool cleanup);  
22.   
23.     //移除所有节点  
24.     virtual void removeAllChildren();  
25.     virtual void removeAllChildrenWithCleanup(bool cleanup);  
26.       
27.     //重新设置节点顺序  
28.     virtual void reorderChild(CCNode * child, int zOrder);  

4.标签和用户数据

[cpp]  view plain copy

1. //设置/获取tag  
2. virtual int getTag() const;  
3. virtual void setTag(int nTag);  
4.   
5. //设置/获取userdata，它是一个指针可以指向你想要的任意数据块，不过记得要释放  
6. virtual void* getUserData();  
7. virtual void setUserData(void *pUserData);  
8.   
9. //设置/获取CCObject，和上面一样，只是数据换成了CCObject对象  
10. virtual CCObject* getUserObject();  
11. virtual void setUserObject(CCObject *pUserObject);  

5.事件回调

[cpp]  view plain copy

1. //事件回调  
2.       
3.     //节点开始进入触发  
4.     virtual void onEnter();  
5.     //节点完成进入触发  
6.     virtual void onEnterTransitionDidFinish();  
7.     //节点退出触发  
8.     virtual void onExit();  
9.     //如果节点退出有过渡动画，动画开始时触发  
10.     virtual void onExitTransitionDidStart();  
11.     //停止动画和调度器  
12.     virtual void cleanup(void);  

6.动作

[cpp]  view plain copy

1. //获取/设置动作管理器  
2.     virtual void setActionManager(CCActionManager* actionManager);  
3.     virtual CCActionManager* getActionManager();  
4.       
5.     //运行动作  
6.     CCAction* runAction(CCAction* action);  
7.   
8.     //停止动作  
9.     void stopAllActions(void);  
10.     void stopAction(CCAction* action);  
11.     void stopActionByTag(int tag);  
12.     CCAction* getActionByTag(int tag);  
13.   
14.     //获取正在运行动作数  
15.     unsigned int numberOfRunningActions(void);  

7.调度器和定时器

[cpp]  view plain copy

1. //获取/设置调度器  
2.     virtual void setScheduler(CCScheduler* scheduler);  
3.     virtual CCScheduler* getScheduler();  
4.       
5.     //检测某个调度器是否有在运行  
6.     bool isScheduled(SEL_SCHEDULE selector);  
7.   
8.     //开启update调度  
9.     void scheduleUpdate(void);  
10.     //设置调度优先级  
11.     void scheduleUpdateWithPriority(int priority);  
12.     //关闭update调度器  
13.     void unscheduleUpdate(void);  
14.   
15.     //开启/关闭/恢复/暂停调度器  
16.     void schedule(SEL_SCHEDULE selector, float interval, unsigned int repeat, float delay);  
17.     void schedule(SEL_SCHEDULE selector, float interval);  
18.     void scheduleOnce(SEL_SCHEDULE selector, float delay);  
19.     void schedule(SEL_SCHEDULE selector);  
20.     void unschedule(SEL_SCHEDULE selector);  
21.     void unscheduleAllSelectors(void);  
22.     void resumeSchedulerAndActions(void);  
23.     void pauseSchedulerAndActions(void);  
24.       
25.     //每帧调用函数  
26.     virtual void update(float delta);  

8.坐标转换

[cpp]  view plain copy

1. //坐标转换相关，这一部分后面再介绍  
2. CCPoint convertToNodeSpace(const CCPoint& worldPoint);  
3. CCPoint convertToWorldSpace(const CCPoint& nodePoint);  
4. CCPoint convertToNodeSpaceAR(const CCPoint& worldPoint);  
5. CCPoint convertToWorldSpaceAR(const CCPoint& nodePoint);  
6. CCPoint convertTouchToNodeSpace(CCTouch * touch);  
7. CCPoint convertTouchToNodeSpaceAR(CCTouch * touch);  

9.其他

[cpp]  view plain copy

1. //获取/设置着色程序  
2. virtual CCGLProgram* getShaderProgram();  
3. virtual void setShaderProgram(CCGLProgram *pShaderProgram);  
4.   
5. //获取CCCamera对象  
6. virtual CCCamera* getCamera();  
7.   
8. //节点是否在运行  
9. virtual bool isRunning();  
10.   
11. //绘制节点  
12. virtual void draw(void);  
13. //递归访问节点  
14. virtual void visit(void);  
15.   
16. //返回所占矩形，节点坐标系  
17. CCRect boundingBox(void);  

1. Features of CCNode:  
2. - position                                   //位置，默认(0,0)  
3. - scale (x, y)                               //缩放，默认(1,1)  
4. - rotation (in degrees, clockwise)           //旋转，默认为0  
5. - skew                                       //倾斜，默认为0  
6. - CCCamera (an interface to gluLookAt )      //CCCamera，视点转换，每个节点都有，默认指向节点中心  
7. - CCGridBase (to do mesh transformations)    //CCGridBase，网类转变  
8. - anchor point                               //锚点，默认(0,0)  
9. - size                                       //尺寸，默认(0,0)  
10. - visible                                    //可见  
11. - z-order                                    //z轴值  
12. - openGL z position                          //OpenGL z值