Cocos2d-x学习笔记（三）CCNode分析

Cocos2d-x学习笔记（三）CCNode分析
http://www.52php.cn/article/p-cpwvnnwx-bcd.html
通过前两份学习笔记，我们不难发现CCScene、CCLayer、CCSprite等一系列元素都是CCNode的子类。

但是CCNode绝对是Cocos2d-x中举足轻重的一个核心，我们可以把它理解为节点。它是一个不能够可视化显示的抽象类，只是用来定义所有节点的公共属性和方法的。

特征

1）每个节点都可以通过addChild方法包含其他节点作为子节点，也可以通过removeChild来移除子节点。CCNode就像是一棵自由的树。

2）每个子节点都可以通过setTag来设置标记，通过getChildByTag来获取该子节点。

3）每个节点都可以执行计划任务，在Cocos2d-x的系统循环中处理这些任务。

4）每个节点都可以通过runAction执行瞬间动作或延时动作。

5）每个节点添加到场景中，当所在场景为激活场景时，这个节点的绘图方法就会被自动调用完成自我绘制。

属性
[cpp] view plaincopyprint?在CODE上查看代码片派生到我的代码片

class CC_DLL CCNode : public CCObject  
{  
public:  
    CCNode(void);  
    virtual ~CCNode(void);  

    // 初始化节点  
    virtual bool init();  

    // 创建一个节点对象  
    static CCNode * create(void);  

    // 获取一个描述字符串，便于调试  
    const char* description(void);  

    /** 
     * 设置/获取Z轴坐标 
     *  
     * zOrder独立于绘制顺序，它仅仅只是记录node在它父类以及相关兄弟之间的排序，其顺序是相对于其父类的子类而言，跟OpenGl的Z vertex没有关系 
     * 默认的Z vertex=0.它仅仅影响nodes的绘制顺序，数字越大，绘制越靠后 
     */  
    virtual void setZOrder(int zOrder);  
    virtual int getZOrder();  

    //设置Z轴坐标，与setZOrder的区别是，setZOrder先设置m_nZOrder，然后会重新录入父类的自节点数组  
    virtual void _setZOrder(int z);  

    // 设置/获取OpenGL真实Z轴坐标  
    virtual void setVertexZ(float vertexZ);  
    virtual float getVertexZ();  

    // 设置/获取X轴缩放系数  
    virtual void setScaleX(float fScaleX);  
    virtual float getScaleX();  

    // 设置/获取Y轴缩放系数  
    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);  

    // 设置/获取X轴Y轴坐标，这些方法用在与Lua、Javascript绑定  
    virtual void  setPositionX(float x);  
    virtual float getPositionX(void);  
    virtual void  setPositionY(float y);  
    virtual float getPositionY(void);  

    // 设置/获取X轴扭曲角度  
    virtual void setSkewX(float fSkewX);  
    virtual float getSkewX();  

    // 设置/获取Y轴扭曲角度  
    virtual void setSkewY(float fSkewY);  
    virtual float getSkewY();  

    // 设置/获取锚点  
    virtual void setAnchorPoint(const CCPoint& anchorPoint);  
    virtual const CCPoint& getAnchorPoint();  

    // 获取具体锚点在当前节点坐标系中的具体坐标，正常锚点是以0-1为范围的比例  
    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();  

    // 设置/获取节点X轴旋转角度  
    virtual void setRotationX(float fRotaionX);  
    virtual float getRotationX();  

    // 设置/获取节点Y轴旋转角度  
    virtual void setRotationY(float fRotationY);  
    virtual float getRotationY();  

    /** 
     * 设置/获取arrival order 
     * 
     * 一个节点调用addChild后将得到一个更大的arrival order,* 如果两个子节点有相同的Z order,那么arrival order大的将后绘制 
     */  
    virtual void setOrderOfArrival(unsigned int uOrderOfArrival);  
    virtual unsigned int getOrderOfArrival();  

    // 设置/获取OpenGL服务端状态  
    virtual void setGLServerState(ccGLServerState glServerState);  
    virtual ccGLServerState getGLServerState();  

    /** 
     * 设置/获取当你设置节点坐标位置的时候，锚点是否视作(0,0) 
     * 
     * 当设置为true的时候，锚点还是(0.5,0.5),但是此时是通过起始点(0,0)来定位的 
     * 而设置为false的时候，是通过锚点定位(0.5,0.5) 
     * 如果为true的时候，虽然定位是通过起始点(0,0)来起作用的 
     * 但是对于scale，还是通过锚点来放大缩小 
     */  
    virtual void ignoreAnchorPointForPosition(bool ignore);  
    virtual bool isIgnoreAnchorPointForPosition();  

    // 添加子节点  
    virtual void addChild(CCNode * child);  

    // 添加子节点，同时设置子节点Z轴坐标  
    virtual void addChild(CCNode * child,int zOrder);  

    // 添加子节点，同时设置子节点Z轴坐标及子节点Tag标签  
    virtual void addChild(CCNode* child,int zOrder,int tag);  

    // 通过Tag获取子节点  
    virtual CCNode * getChildByTag(int tag);  

    // 获取当前节点所有子节点  
    virtual CCArray* getChildren();  

    // 获取当前子节点数量  
    virtual unsigned int getChildrenCount(void) const;  

    // 设置/获取当前节点父节点  
    virtual void setParent(CCNode* parent);  
    virtual CCNode* getParent();  

    // 将当前节点从父节点中移除  
    virtual void removeFromParent();  

    // 移除此节点于父类中，并且清除本节点，当cleanup为true的时候，会将action停止，包括子类的action也一并停止  
    virtual void removeFromParentAndCleanup(bool cleanup);  

    // 移除子节点  
    virtual void removeChild(CCNode* child);  

    // 移除子节点，并设置是否清除本节点  
    virtual void removeChild(CCNode* child,bool cleanup);  

    // 通过Tag移除子节点  
    virtual void removeChildByTag(int tag);  

    // 通过Tag移除子节点，并设置是否清除本节点  
    virtual void removeChildByTag(int tag,bool cleanup);  

    // 移除所有子节点  
    virtual void removeAllChildren();  

    // 移除所有子节点，并设置是否清楚本节点  
    virtual void removeAllChildrenWithCleanup(bool cleanup);  

    // 重新设置某个子节点的Z轴坐标  
    virtual void reorderChild(CCNode * child,int zOrder);  

    // 给所有子节点排序  
    virtual void sortAllChildren();  

    // 获取/设置网格对象  
    virtual CCGridBase* getGrid();  
    virtual void setGrid(CCGridBase *pGrid);  

    // 获取/设置Tag标识  
    virtual int getTag() const;  
    virtual void setTag(int nTag);  

    // 获取/设置用户数据，可以放进指针，数据块，结构体，对象等，注意要release  
    virtual void* getUserData();  
    virtual void setUserData(void *pUserData);  

    // 获取/设置用户数据对象，可以放CCObject数据，加进来的CCObject需要release  
    virtual CCObject* getUserObject();  
    virtual void setUserObject(CCObject *pUserObject);  

    /** 
     * 引擎提供了CCGLProgram类来处理着色器相关操作，对当前绘图程序进行了封装， 
     * 其中使用频率最高的应该是获取着色器程序的接口：const GLuint getProgram(); 
     * 该接口返回了当前着色器程序的标识符。后面将会看到，在操作OpenGL的时候，我们常常需要针对不同的着色器程序作设置。 
     * 注意，这里返回的是一个无符号整型的标识符，而不是一个指针或结构引用，这是OpenGL接口的一个风格。 
     * 对象（纹理、着色器程序或其他非标准类型）都是使用整型标识符来表示的。 
     */  
    virtual CCGLProgram* getShaderProgram();  
    virtual void setShaderProgram(CCGLProgram *pShaderProgram);  

    // 获取摄像机对象  
    virtual CCCamera* getCamera();  

    // 获取当前节点是否在运行  
    virtual bool isRunning();  

    // 注册/取消注册脚本Handle  
    virtual void registerScriptHandler(int handler);  
    virtual void unregisterScriptHandler(void);  

    //获取脚本Handle  
    inline int getScriptHandler() { return m_nScriptHandler; };  

    // 根据优先级更新Handle（Lua调用）  
    void scheduleUpdateWithPriorityLua(int nHandler,int priority);  

    // 当节点进入时调用  
    virtual void onEnter();  

    // 当节点进入动画结束时调用  
    virtual void onEnterTransitionDidFinish();  

    // 当节点退出入时调用  
    virtual void onExit();  

    // 当节点退出动画结束时调用  
    virtual void onExitTransitionDidStart();  

    // 停止所有运行的动画及调度  
    virtual void cleanup(void);  

    // 重构这个方法能够绘制自己的节点  
    virtual void draw(void);  

    // 递归遍历当前节点树  
    virtual void visit(void);  

    // 获取经过缩放和旋转之后的外框盒大小  
    virtual CCRect boundingBox(void);  

    /** 
     * 设置/获取当前节点的一个ActionManager 
     *  
     * 当添加CCActionManager的时候，原先的action都将停止 
     * 初始化node时候CCActionManager是通过director->getActionManager()初始化的 
     * 当然m_pActionManager也retain()了,所以runAction中的一切action都是当前node的m_pActionManager管理的 
     */  
    virtual void setActionManager(CCActionManager* actionManager);  
    virtual CCActionManager* getActionManager();  

    // 执行Action  
    CCAction* runAction(CCAction* action);  

    // 停止所有Action  
    void stopAllActions(void);  

    // 停止指定Action  
    void stopAction(CCAction* action);  

    // 通过Tag停止/获取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);  

    // 计划更新方法  
    void scheduleUpdate(void);  

    // 根据优先级更新Handle  
    void scheduleUpdateWithPriority(int priority);  

    // 取消更新计划  
    void unscheduleUpdate(void);  

    /** 
     * 执行某个任务 
     * 
     * @param interval  触发间隔，0为每帧都触发，如果interval = 0，推荐使用scheduleUpdate()代替 
     * @param repeat    重复次数 
     * @param delay     延迟启动时间 
     * @lua NA 
     */  
    void schedule(SEL_SCHEDULE selector,float interval,unsigned int repeat,float delay);  
    void schedule(SEL_SCHEDULE selector,float interval);  
    void schedule(SEL_SCHEDULE selector);  

    // 执行任务单次  
    void scheduleOnce(SEL_SCHEDULE selector,float delay);  

    // 取消任务  
    void unschedule(SEL_SCHEDULE selector);  

    // 取消所有任务  
    void unscheduleAllSelectors(void);  

    // 恢复/暂停节点的动作和任务  
    void resumeSchedulerAndActions(void);  
    void pauseSchedulerAndActions(void);  

    // 当scheduleUpdate被调用，并且节点为活动状态时，这个方法将在每帧自动调用  
    virtual void update(float delta);  

    /** 
     * Performs OpenGL view-matrix transformation based on position,scale,rotation and other attributes. 
     */  
    void transform(void);  

    /** 
     * Performs OpenGL view-matrix transformation of it's ancestors. 
     * Generally the ancestors are already transformed,but in certain cases (eg: attaching a FBO) 
     * It's necessary to transform the ancestors again. 
     */  
    void transformAncestors(void);  

    /** 
     * Calls children's updateTransform() method recursively. 
     * 
     * This method is moved from CCSprite,so it's no longer specific to CCSprite. 
     * As the result,you apply CCSpriteBatchNode's optimization on your customed CCNode. 
     * e.g.,batchNode->addChild(myCustomNode),while you can only addChild(sprite) before. 
     */  
    virtual void updateTransform(void);  

    /** 
     * Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates. 
     * The matrix is in Pixels. 
     */  
    virtual CCAffineTransform nodeToParentTransform(void);  

    /** 
     * Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates. 
     * The matrix is in Pixels. 
     */  
    virtual CCAffineTransform parentToNodeTransform(void);  

    /** 
     * Returns the world affine transform matrix. The matrix is in Pixels. 
     */  
    virtual CCAffineTransform nodeToWorldTransform(void);  

    /** 
     * Returns the inverse world affine transform matrix. The matrix is in Pixels. 
     */  
    virtual CCAffineTransform worldToNodeTransform(void);  

    /** 
     * Converts a Point to node (local) space coordinates. The result is in Points. 
     */  
    CCPoint convertToNodeSpace(const CCPoint& worldPoint);  

    /** 
     * Converts a Point to world space coordinates. The result is in Points. 
     */  
    CCPoint convertToWorldSpace(const CCPoint& nodePoint);  

    /** 
     * Converts a Point to node (local) space coordinates. The result is in Points. 
     * treating the returned/received node point as anchor relative. 
     */  
    CCPoint convertToNodeSpaceAR(const CCPoint& worldPoint);  

    /** 
     * Converts a local Point to world space coordinates.The result is in Points. 
     * treating the returned/received node point as anchor relative. 
     */  
    CCPoint convertToWorldSpaceAR(const CCPoint& nodePoint);  

    /** 
     * convenience methods which take a CCTouch instead of CCPoint 
     */  
    CCPoint convertTouchToNodeSpace(CCTouch * touch);  

    /** 
     * converts a CCTouch (world coordinates) into a local coordinate. This method is AR (Anchor Relative). 
     */  
    CCPoint convertTouchToNodeSpaceAR(CCTouch * touch);  

    /** 
     *  Sets the additional transform. 
     */  
    void setAdditionalTransform(const CCAffineTransform& additionalTransform);  

    // 获取组件  
    CCComponent* getComponent(const char *pName) const;  

    // 添加组件  
    virtual bool addComponent(CCComponent *pComponent);  

    // 通过名字移除组件  
    virtual bool removeComponent(const char *pName);  

    // 通过指针移除组件  
    virtual bool removeComponent(CCComponent *pComponent);  

    // 移除所有组件  
    virtual void removeAllComponents();  
}

以上方法为CCNode中的提供，在public块中的方法主要由以下几个部分：
1）针对节点显示的属性信息读写
2）针对节点变化的属性信息读写
3）针对子节点管理的相关方法
4）针对节点数据绑定的相关方法
5）针对节点生命周期的相关方法
6）针对节点处理动作CCAction的相关方法
7）针对节点定时任务的相关方法
8）针对节点坐标变换的相关方法

结言 在CCNode中的节点都有自己的坐标系，成为节点坐标系，当节点坐标系变换后该节点的所有子节点都会随之变换。 节点添加到场景时会参考节点的锚点，锚点默认定义为该节点的中心，在贴图时会以锚点为中心，改变锚点并没有改变节点的位置，只是改变了贴图的位置。 Cocos2d-x的世界坐标系和openGL的坐标系一致，都是一左下角为0,0点，X轴向右，y轴向上。