cocos2d-x 节点类CCNode

转载:http://blog.csdn.net/jackystudio/article/details/12703741

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


1.概况

cocos2d-x 节点类CCNode_第1张图片

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

(1)可以包含其他CCNode节点,可以进行添加/获取/删除子节点操作。

(2)可以执行周期性的回调任务。

(3)可以执行动作。

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


2.属性

[cpp] view plain copy
  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值  

3.接口


3.1.初始化

[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);  

3.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.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(voidconst;  
  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);  

3.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);  

3.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);  

3.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);  

3.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);  

3.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);  

3.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);  

4.CCNodeRGBA

cocos2d-x 节点类CCNode_第2张图片

CCNodeRGBA继承于CCNode,所以它拥有CCNode的所有特性,并且它也继承于CCRGBAProtocol。从名字看来我们就知道它是一个带有颜色和透明度的节点。

所以它比起CCNode就多了2个特性,Opacity和RGB值。

如果要给子节点传递透明度属性,那么需要设置setCascadeOpacityEnabled(true),如果传递的过程中遇到了CCNode,那么传递会中断。颜色值的传递也是一样的道理。

你可能感兴趣的:(cocos2d-x 节点类CCNode)