[cocos2dx]重要父类——CCNode节点类

概述

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

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

• 可以执行周期性的回调任务。
• 可以执行动作。
  

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

属性

    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值

初始化

    //初始化函数，成功返回true
    virtual bool init();

    //分配内存空间，调用init并添加autoRelease标记
    static CCNode * create(void);

    //返回描述字符串
    const char* description(void);

图形属性

    //设置/获取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();

节点操作

     //添加/获取子节点，可以带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);

标签和用户数据

    //设置/获取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);

事件回调

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

动作

    //获取/设置动作管理器
    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);

调度器和定时器

     //获取/设置调度器
     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);

坐标转换

    //坐标转换相关，这一部分后面再介绍
    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);

其他

    //获取/设置着色程序
    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);

Node API详解