iphone游戏开发之cocos2d(三)CCNode官方API翻译

        CCNode是cocos2d中最重要的一个基类,是一个抽象类,定义了所有节点的公共属性和方法,因为其重要性,所以这里把官方API对CCNode的属性方法描述粗略了翻译下,方便日后查询使用,也希望能帮到大家,如果有的地方描述不准确,大家可以直接参考官方英文原版的说明:点击打开链接。

     CCNode是一个重要的元素,所有我们看到绘制下来的东西都是CCNode,最常见的CCNode有:CCScene,CCLayer,CCSprite,CCMenu; 

        CCNode的主要特征有:每个节点都可以包含子节点、可以定时执行回调、可以执行动作;

        部分CCNode子类提供了一些独特的功能;

        子类化一个CCNode通常意味着下面这些操作:重写初始化方法以初始化资源或回调、创建回调来控制时间、重写绘制着色;

         CCNode的特征有:position、scale(x,y)、rotation(in degrees,clockwise)、CCCamera(an interface to gluLookAt)、CCGridBase(to do mesh transformations)、anchor point 、size、visible、z-order、openGL z position

默认值为:rotation:0、position:(x=0,y=0)、scale:(x=1,y=0)、contentSize:(x=0,y=0)、anchorPoint:(x=0,y=0).

成员方法描述:

- (void) addChild:
(CCNode *)  node
      以z轴为0在当前容器中添加一个子节点,如果该子节点添加到了一个自在运行的节点,“onEnter"和"onEnterTransitionDidFinish"会直接运行;

- (void) addChild:
(CCNode *)  node
z:
(NSInteger)  z 
     同上,不过z轴可手动设置; 

- (void) addChild:(CCNode *) nodez:(NSInteger) ztag:(NSInteger) tag 

同上,除了可设置z轴,可给要添加到子节点添加tag,方便在父节点中取;

- (CGRect) boundingBox


返回一个CGRect格式的边界范围,该范围仅与父节点相关; 该范围以坐标形式存在;

补充一下:该方法用来补充getContentSize方法,boundingBox可以获得节点缩放或者旋转之后的范围,getContentSize获取原始节点的大小;

- (void) cleanup
当一个正在运行的节点不再运行时(比如其所依附的场景被切换掉了),这时会发生cleanup事件,这时你要中断所有相关的循环引用,该方法移除所有可能的定时方法,动作等;

- (CGPoint) convertToNodeSpace:(CGPoint) worldPoint

将参数worldPoint转换为node的空间坐标

  补充一下:基本的两个坐标系:屏幕坐标系和GL坐标系。屏幕坐标系x轴朝右,y轴朝下。默认原点在左上角。GL坐标系x轴朝右,y轴朝上。默认原点在左下角。

- (CGPoint) convertToNodeSpaceAR:(CGPoint) worldPoint 

将参数以节点锚点为原点,转换为世界坐标;

- (void) draw
重写该方法以绘制自定义节点,需要用到cocos2d的 GL API,详细信息查看ccGLstate.h;另外,[super draw]不可调用; 

- (CCAction*) getActionByTag:
(NSInteger)  tag

通过tag从当前正在运行的动作列表中获取动作;

- (CCNode*) getChildByTag:
(NSInteger)  tag
通过tag从容器中取到一个子节点;

- (id) init

初始化节点; 

+ (id) node
声明并初始化一个节点,该节点以autorelease方式创建;

- (CGAffineTransform) nodeToParentTransform


节点的矩阵变换方法,返回在父节点中的空间矩阵坐标;

- (CGAffineTransform) nodeToWorldTransform

同上相反;

- (NSUInteger) numberOfRunningActions
返回当前正在运行的动作个数,包括正在运行的和计划运行的,动作组视为一个动作;例如:运行7个动作组成的动作序列,返回1;运行2个动作组成的七个动作序列,返回7;

- (void) onEnter
当节点进入"stage"时调用,如果伴随着transition,则在transition开始时调用;

- (void) onEnterTransitionDidFinish

当节点进入"stage"时调用,如果节点伴随着transition,则在transition结束后调用; 

- (void) onExit
当节点离开"stage"时调用,如果节点离开时伴随着transition,则在transition结束后调用;

- (void) onExitTransitionDidStart

当节点离开"stage"时调用,如果节点离开时伴随着transition,则在transition开始时调用; 

- (CGAffineTransform) parentToNodeTransform


将父节点中的空间坐标系转换为当前节点坐标系;

- (void) pauseSchedulerAndActions

暂停节点的所有调动和动作,被onExit内部调用;

- (void) removeAllChildrenWithCleanup:
(BOOL)  cleanup

移除所有子节点,并根据参数决定是否清空所有动作;

- (void) removeChild:(CCNode *) node cleanup:(BOOL) cleanup 

移除指定的子节点,并根据cleanup参数决定是否清除所有的动作;

- (void) removeChildByTag:(NSInteger) tag cleanup:(BOOL) cleanup 

同上差不多;

- (void) removeFromParentAndCleanup:
(BOOL)  cleanup
由本身调用,将其从父节点上移除,并根据cleanup决定是否清空所有动作; 

- (void) reorderChild:
(CCNode *)  child
z:
(NSInteger)  zOrder
将已存在的子节点重新插入,用于发变z轴;

- (void) resumeSchedulerAndActions


恢复节点的序列方法和动作,可以由onEnter内部调用;

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

执行动作;

- (void) schedule:(SEL) s

执行一个SEL方法,该方法在每帧时都会调用;

- (void) schedule:
(SEL)  s
interval:
(ccTime)  seconds 
以seconds参数为判断定时执行一个SEL方法s,如果seconds为0,则该方法会在每一帧都运行,这时我们建议以“scheduleUpdate"方法来代替;

如果方法s已经被定义了,then the interval parameter will be updated without scheduling it again(不太明白);

- (void) schedule:
(SEL)  selector
interval:
(ccTime)  interval
repeat:
(uint)  repeat
delay:
(ccTime)  delay 
重复执行方法repeat+1次,每次执行前会等待delay个时间;

- (void) scheduleOnce:
(SEL)  selector
delay:
(ccTime)  delay 
延迟delay个时间,执行方法一次;

- (void) scheduleUpdate

check whether a selector is scheduled. schedules the "update" method. It will use the order number 0. This method will be called every frame. Scheduled methods with a lower order value will be called before the ones that have a higher order value. Only one "udpate" method could be scheduled per node.

这个方法我怕我翻译不好,大家看下官方说法吧;相当于自动生成的每帧都会执行的方法;
- (void) scheduleUpdateWithPriority:(NSInteger) priority

schedules the "update" selector with a custom priority. This selector will be called every frame. Scheduled selectors with a lower priority will be called before the ones that have a higher value. Only one "udpate" selector could be scheduled per node (You can't have 2 'update' selectors).
带优先级的update,并且强调了每个节点上只能定义一个update方法(官方文档上也有错字,哇哈哈);

- (void) sortAllChildren


性能改进,在绘制前对子节点进行排序
- (void) stopAction:
(CCAction *)  action
从动作运行序列中移除一个动作;
- (void) stopActionByTag:
(NSInteger)  tag

同上
- (void) stopAllActions
从动作运行序列中移除所有动作;

- (void) transform
 position, scale, rotation and other attributes为基础,执行openGL 矩阵坐标转换;
- (void) transformAncestors
同上
- (void) unschedule:(SEL) s
停止指定selector
- (void) unscheduleAllSelectors
停止所有selector方法;
- (void) visit
用于访问并绘制children的递归方法;
- (CGAffineTransform) worldToNodeTransform
用于反转世界矩阵坐标;



你可能感兴趣的:(ios,ios,ios,c,c,api,cocos2d,api,cocos2d,cocos2d,cocos2d,api,iPhone,iPhone,iPhone,iPhone,iPhone,objective,objective)