CCNode的属性以及方法的介绍

转自：http://blog.csdn.net/wujiabin468/article/details/7870838

CCNode是所有节点的父类包括(CCLayer, CCSprite, CCScene)

以下是CCNode的属性以及方法的介绍（参考：雨松MOMO程序研究院）

float rotation_

节点的旋转角度，如果是图片的话，会看到旋转效果，所以基本上是为屏幕输出服务的。

float scaleX_, scaleY_

节点的缩放比例，X为横向，Y为纵向，当值为1的时候表示原比例，0.5表示缩小一半，2表示放大1倍，如果是图片的话就会看到效果，也是为屏幕输出服务的。

CGPoint position_

节点的坐标，该属性是一个结构体，position_.x是它的横坐标，position_.y是纵坐标，基本上也是要显示到屏幕上才有意义。

float skewX_, skewY_

节点的扭曲角度，类似于Windows画图板中的扭曲功能，X是横向扭曲，Y是纵向扭曲，单位是度数，也是屏显用的。

CGPoint anchorPointInPoints_

节点的锚点坐标，所谓锚点就是当旋转、缩放或是用其它方式操作节点时的参考的基准点，例如图片的锚点在正中心，当放大它的时候，图片就会向四周扩散，当旋转一个锚点在左上角的图片时，图片就会以左上角为轴旋转。

CGPoint anchorPoint_

节点的锚点在节点位置的比例，比如说一个节点的坐标为(0, 0)，宽高各为100，那么当它的锚点坐标为(50, 50)的时候，anchorPoint_.x = 0.5，anchorPoint_.y = 0.5。

CGSize contentSize_

节点的宽高，它也是一个结构体，contentSize_.width表示宽，contentSize_.height表示高，它和position_配合可以用来检测碰撞，但需要注意，contentSize_不会因为节点的旋转和缩放而改变大小。

CCCamera *camera_

节点的镜头，cocos2d虽然是2D游戏引擎，但实际上它是通过3D方式绘制2D效果的，因此有镜头存在就不奇怪了。CCCamera也是 cocos2d的一个类，它默认情况下是正对着节点的，距离也是刚好使节点能够以1:1的比例显示到屏幕上，当我们手动修改它的参数后，节点就会呈现出歪 曲或缩放等效果。

NSInteger zOrder_

节点的Z轴，当有多个节点在屏幕显示时，引擎会根据它们Z轴的大小决定绘制顺序，Z轴大的会盖住Z轴小的。

CCArray *children_

重头戏来了，前面说过节点可以有N个子节点，children_就是存储这些子节点地址的变量，节点就是通过它们找到自己的子节点的。children_ 的类型是CCArray，这是cocos2d自己封装的一个数组类，每个元素存储一个子节点地址，它引入了tag机制，当节点有多个子节点时，可以根据它 们的tag找到自己想要的那一个。

CCNode *parent_

另一个重点——节点的父节点。因为树中的每个节点都继承自CCNode，所以用CCNode类型定义父节点是最万无一失的，节点可以通过它找到自己的父节点，因为父节点最多只有一个，所以不需要用数组保存。

NSInteger tag_

节点的标签，主要是帮助其父节点找到自己，因为每个节点的子节点并不一定是唯一的，当需要遍历时可以用该参数做区分，所以兄弟节点的标签尽量不要一样。

Bool isRunning_

表示节点是否在更新逻辑，之前说过，未加入树的节点是不会显示到屏幕上的，其实它的逻辑运算也是一样，就是说没有父节点的节点不会显示，也不会处理自己的 逻辑，它的一切活动都会停止。那么当节点被加入到树中的时候，isRunning_会被自动置为Yes，此时它会开始执行自己的运算，当节点离开树 时，isRunning_会被置为No，如果想在它在树中的时候暂停运算，就需要将它的isRunning_手动置为No。

Bool visible_

和isRunning_对应，用来表示节点是否在绘制，当visible_为No时，节点即使在树中也不会绘制到屏幕上，就相当于隐藏了起来。

以上就是CCNode比较重要的属性，不过我们在开发中直接操作它们的频率并不高，而是通过类中声明的相关方法去改变它们，下面我就来说说CCNode中的方法。

+(id) node

实例化一个CCnode对象，实际上就是封装了alloc、init和autorelease方法。

-(id) init

初始化，将一些数值型的参数归0，缩放比例设为1，指针型的参数设为nil。

-(CCArray*) children

返回对象的children_，即获取全部的子节点。

-(Bool) visible

返回visible_参数，用于检测该节点当前是否被绘制。

-(void) setVisible: (Bool)visible

设置节点的绘制状态，Yes为可见，No为不可见

-(CCNode*) parent

返回节点的parent_，即获取父节点

-(void) setParent: (CCNode*)parent

设置父节点，但实际应用中不要这样修改，因为极易出bug，正确的修改方法会在后面介绍。

-(NSInteger) tag

返回对象的tag_，即获取节点的标签。

-(NSInteger) zOrder

返回对象的zOrder_,即获取Z轴。

-(Bool) isRunning

返回对象的isRunning_，即检测该节点当前是否更新逻辑。

-(float) rotation

返回对象的rotation_，即获取节点的旋转角度。

-(void) setRotation: (float)rotation

设置对象的rotation_值，即旋转节点。

-(CGPoint) position

返回对象的position_，即获取节点的坐标。

-(void) setPosition: (CGPoint)position

设置对象的position_，即更改节点的坐标。

-(CGPoint) anchorPoint

返回对象的anchorPoint_，即获取节点的锚点。

-(void) setAnchorPoint: (CGPoint)anchorPoint

设置对象的anchorPoint_，即修改节点的描点。

-(CGSize) contentSize

返回对象的contentSize_，即获取节点的宽高。

-(void) setContentSize: (CGSize)contentSize

设置对象的contentSize_，即改变节点的宽高。

-(float) skewX

返回对象的skewX_，即获取节点的横向扭曲角度。

-(void) setSkewX: (float)skewX

设置对象的skewX_，即设置节点的横向扭曲角度。

-(float) skewY

返回对象的skewY_，即获取节点的纵向扭曲角度。

-(void) setSkewY: (float)skewY

设置对象的skewY_，即设置节点的纵向扭曲角度。

-(float) scaleX

返回对象的scaleX_，即获取节点的横向缩放比例。

-(void) setScaleX: (float)scaleX

设置对象的scaleX_，即横向缩放节点。

-(float) scaleY

返回对象的scaleY_，即获取节点的纵向缩放比例。

-(void) setScaleY: (float)scaleY

设置对象的scaleY_，即纵向缩放节点。

-(CGRect) boundingBox

返回对象的碰撞框（由坐标和宽高组合而成），这个参数会随着节点的缩放或旋转等操作而改变。

-(CCCamera*) camera

返回对象的camera_，即获取节点的镜头。

-(CCNode*) getChildByTag: (NSInteger) aTag

根据tag_返回children_数组中的某个元素，即根据标签获取节点的某个子节点。

-(void) addChild: (CCNode*)child z: (NSInteger)z tag: (NSInteger)aTag

向children_数组中添加一个CCNode对象，即给节点添加一个子节点，z是子节点的Z轴，aTag是子节点的标签，此方法会将该子节点的parent_指针指向自己，因此这才是设置父节点的正解，比setParent要安全的多。

-(void) addChild: (CCNode*)child z: (NSInteger)z

-(void) addChild: (CCNode*)child

缺省了tag或z的添加子节点方法，缺省值默认为0。

-(void) removeFromParentAndCleanup: (Bool)cleanup

将节点从它的父节点的children_数组中删除，即脱离树，cleanup表示是否将其从内存中清除。

-(void) removeChild: (CCNode*)child cleanup: (Bool)cleanup

将某一节点从children_数组中删除，即删除某一子节点。

-(void) removeChildByTag: (NSInteger)aTag cleanup: (Bool)cleanup

根据tag_删除children_数组中的某个元素，即根据标签删除节点的某个子节点。

-(void) removeAllChildrenWithCleanup: (Bool)cleanup

清空对象的children_数组，即删除所有子节点。

-(void) _setZOrder: (NSInteger)z

设置对象的zOrder_，即改变节点的Z轴。

-(void) reorderChild: (CCNode*)child z: (NSInteger)z

将某节点从子节点队列中取出，并重新重新插入队列，目的是改变其Z轴。

-(void) visit

绘制函数，用来将节点内容（多为图片或文字）显示到屏幕。

-(void) onEnter

相当于一个激活过程，它会在节点被添加到树中的时候执行，使其可以更新自己的逻辑。

-(void) onExit

取消激活，作用是暂停某节点的逻辑更新。

-(CCAction*)runAction: (CCAction*)action

一个会经常被用到的类，作用是执行一种行为，行为模式由参数action决定，CCAction就是上一章提到的行为类，runAction就是联系实体 类和行为类的桥梁。行为执行完毕后，action会自动释放（用了autorelease），所以使用时不用担心内存问题。但需要注意，当 isRunning_为No时，节点执行的行为会暂停，就是说onExit有暂停节点一切行为的功能。

-(void) stopAllActions

停止节点正在执行的所有行为，注意这里是停止，不是暂停，函数执行后节点中的所有行为类实例都将从内存中清除。

-(void) stopAction: (CCAction*)action

停止节点的某一个行为，如果没有执行该行为则什么都不做。

-(void) stopActionByTag: (NSInteger)aTag

根据标签停止节点的某一个行为。

-(CCAction*) getActionByTag: (NSInteger)aTag

根据标签获取某个正在执行的行为。

-(void) schedule: (SEL)selector interval: (ccTime)interval

Schedule是cocos2d中的一个很重要的机制，在作者看来它的实用性仅次于行为类，它的功能和CCAction有相似的地方，都是执行一种行 为；不同之处在于，schedule是通过调用方法来执行逻辑的，而且他它内部还有个计时器，可以每隔一定的时间调用一次，反复循环，直到手动将其停止或 者节点被删除（暂停）。这里的参数selector就是执行的方法，interval是间隔时间（秒），ccTime其实就是一个浮点数。

-(void) unschedule: (SEL)selector: (SEL)selector

停止一个schedule任务，注意这里是停止不是暂停。

-(void) unscheduleAllSeletors

停止所有schedule任务

-(void) resumeSchedulerAndActions

恢复运行节点的行为和schedule。

-(void) pauseSchedulerAndActions

暂停节点的行为和schedule。