【玩转cocos2d-x之六】节点类CCNode

原创作品，转载请标明：http://blog.csdn.net/jackystudio/article/details/12703741

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

1.概况

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

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

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

（3）可以执行动作。

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

2.属性

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

3.接口

3.1.初始化

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

3.2.图形属性

//设置/获取Z轴顺序，Z轴大的覆盖Z轴小的
    virtual void setZOrder(int zOrder);
    virtual void _setZOrder(int z);
    virtual int getZOrder();

    //设置/获取OpenGL Z轴顶点
    virtual void setVertexZ(float vertexZ);
    virtual float getVertexZ();

    //设置/获取缩放值
    virtual void setScaleX(float fScaleX);
    virtual float getScaleX();
    virtual void setScaleY(float fScaleY);
    virtual float getScaleY();
    virtual void setScale(float scale);
    virtual float getScale();
    virtual void setScale(float fScaleX,float fScaleY);

    //设置/获取位置
    virtual void setPosition(const CCPoint &position);
    virtual const CCPoint& getPosition();
    virtual void setPosition(float x, float y);
    virtual void getPosition(float* x, float* y);
    virtual void  setPositionX(float x);
    virtual float getPositionX(void);
    virtual void  setPositionY(float y);
    virtual float getPositionY(void);
    
    //设置/获取倾斜角度
    virtual void setSkewX(float fSkewX);
    virtual float getSkewX();
    virtual void setSkewY(float fSkewY);
    virtual float getSkewY();

    //设置/获取锚点
    virtual void setAnchorPoint(const CCPoint& anchorPoint);
    virtual const CCPoint& getAnchorPoint();
    virtual const CCPoint& getAnchorPointInPoints();
    
    //设置/获取大小
    virtual void setContentSize(const CCSize& contentSize);
    virtual const CCSize& getContentSize() const;

    //设置/获取可见性
    virtual void setVisible(bool visible);
    virtual bool isVisible();

    //设置/获取旋转角度
    virtual void setRotation(float fRotation);
    virtual float getRotation();
    virtual void setRotationX(float fRotaionX);
    virtual float getRotationX();
    virtual void setRotationY(float fRotationY);
    virtual float getRotationY();

3.3.节点操作

//添加/获取子节点，可以带Z轴顺序（默认为0）和标签
    virtual void addChild(CCNode * child);
    virtual void addChild(CCNode * child, int zOrder);
    virtual void addChild(CCNode* child, int zOrder, int tag);
    CCNode * getChildByTag(int tag);
    virtual CCArray* getChildren();
    unsigned int getChildrenCount(void) const;
    
    //设置/获取父节点
    virtual void setParent(CCNode* parent);
    virtual CCNode* getParent();
    
    //从父节点中移除自身，默认cleanup为true
    virtual void removeFromParent();
    virtual void removeFromParentAndCleanup(bool cleanup);

    //移除子节点
    virtual void removeChild(CCNode* child);
    virtual void removeChild(CCNode* child, bool cleanup);
    virtual void removeChildByTag(int tag);
    virtual void removeChildByTag(int tag, bool cleanup);

    //移除所有节点
    virtual void removeAllChildren();
    virtual void removeAllChildrenWithCleanup(bool cleanup);
    
    //重新设置节点顺序
    virtual void reorderChild(CCNode * child, int zOrder);

3.4.标签和用户数据

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

3.5.事件回调

//事件回调
    
    //节点开始进入触发
    virtual void onEnter();
    //节点完成进入触发
    virtual void onEnterTransitionDidFinish();
    //节点退出触发
    virtual void onExit();
    //如果节点退出有过渡动画，动画开始时触发
    virtual void onExitTransitionDidStart();
    //停止动画和调度器
    virtual void cleanup(void);

3.6.动作

//获取/设置动作管理器
    virtual void setActionManager(CCActionManager* actionManager);
    virtual CCActionManager* getActionManager();
    
    //运行动作
    CCAction* runAction(CCAction* action);

    //停止动作
    void stopAllActions(void);
    void stopAction(CCAction* action);
    void stopActionByTag(int tag);
    CCAction* getActionByTag(int tag);

    //获取正在运行动作数
    unsigned int numberOfRunningActions(void);

3.7.调度器和定时器

//获取/设置调度器
    virtual void setScheduler(CCScheduler* scheduler);
    virtual CCScheduler* getScheduler();
    
    //检测某个调度器是否有在运行
    bool isScheduled(SEL_SCHEDULE selector);

    //开启update调度
    void scheduleUpdate(void);
    //设置调度优先级
    void scheduleUpdateWithPriority(int priority);
    //关闭update调度器
    void unscheduleUpdate(void);

    //开启/关闭/恢复/暂停调度器
    void schedule(SEL_SCHEDULE selector, float interval, unsigned int repeat, float delay);
    void schedule(SEL_SCHEDULE selector, float interval);
    void scheduleOnce(SEL_SCHEDULE selector, float delay);
    void schedule(SEL_SCHEDULE selector);
    void unschedule(SEL_SCHEDULE selector);
    void unscheduleAllSelectors(void);
    void resumeSchedulerAndActions(void);
    void pauseSchedulerAndActions(void);
    
    //每帧调用函数
    virtual void update(float delta);

3.8.坐标转换

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

3.9.其他

    //获取/设置着色程序
    virtual CCGLProgram* getShaderProgram();
    virtual void setShaderProgram(CCGLProgram *pShaderProgram);
    
    //获取CCCamera对象
    virtual CCCamera* getCamera();
    
    //节点是否在运行
    virtual bool isRunning();

    //绘制节点
    virtual void draw(void);
    //递归访问节点
    virtual void visit(void);

    //返回所占矩形，节点坐标系
    CCRect boundingBox(void);

4.CCNodeRGBA

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

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

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