cocos2d-x游戏开发(九)重要的基类CCNode

欢迎转载：http://blog.csdn.net/fylz1125/article/details/8522523

这个CCNode是个很重要的基类，没有理由不把它搞一搞。

首先看下类结构图：

它几乎是所有类的基类，官方注释如下：

CCNode是主要元素。任何一个能被绘制或者包含能被绘制的东西都是一个CCNode。

最常用的CCNode有：CCScene,cclayer,CCSprite,Ccmenu.

一个CCNode的主要特性包括：

1.他们能够容纳别的CCNode节点，别如能addChild,getChildByTag,removeChild 。

2.他们能定期的调度回调函数，比如能schedule，unschedule等。

3.他们能执行动作，比如runAciton，stopAction等。

一些节点能给自己或他们的子几点提供一些额外额功能。

继承一个CCNode节点通常意味着如下几条：

1.重写init()函数来初始化资源和回调

2.创建回调函数来处理时间片

3.重写draw来绘制节点

另外，一个CCNode是一个看不见对象，他没有纹理。每个节点都有一个Camera，默认指向节点的中心点。

看下这个类

[cpp] view plain copy print ?

1. classCC_DLLCCNode:publicCCObject
2. {
3. protected:
4. //rotationangle
5. floatm_fRotationX,m_fRotationY;
7. //scalingfactors缩放因子
8. floatm_fScaleX,m_fScaleY;
10. //openglrealZvertex
11. floatm_fVertexZ;
12. //positionofthenode
13. CCPointm_obPosition;
14. //skewangles
15. floatm_fSkewX,m_fSkewY;
16. //anchorpointinpoints锚点（points形式）
17. CCPointm_obAnchorPointInPoints;
18. //anchorpointnormalized(notinpoints)锚点（比例形式）
19. CCPointm_obAnchorPoint;
20. //untransformedsizeofthenode
21. CCSizem_obContentSize;
22. //transform
23. CCAffineTransformm_sTransform,m_sInverse;
24. //aCamera
25. CCCamera*m_pCamera;
26. //aGrid
27. CCGridBase*m_pGrid;
28. //z-ordervalue
29. intm_nZOrder;
30. //arrayofchildren
31. CCArray*m_pChildren;//关键数组，存子节点
32. //weakreftoparent
33. CCNode*m_pParent;//父节点
34. //atag.anynumberyouwanttoassigntothenode
35. intm_nTag;//tag标记
36. //userdatafield
37. void*m_pUserData;
38. CCObject*m_pUserObject;
39. //Shader
40. CCGLProgram*m_pShaderProgram;//着色器
41. //Serversidestate
42. ccGLServerStatem_eGLServerState;
43. //usedtopreservesequencewhilesortingchildrenwiththesamezOrder
44. unsignedintm_uOrderOfArrival;
45. //schedulerusedtoscheduletimersandupdates
46. CCScheduler*m_pScheduler;//调度器，调度定时器执行一些函数
47. //ActionManagerusedtohandlealltheactions
48. CCActionManager*m_pActionManager;//动作管理器，处理所有动作
49. //Isrunning
50. boolm_bRunning;//状态标志
51. boolm_bTransformDirty;
52. boolm_bInverseDirty;
53. //isvisible
54. boolm_bVisible;//是否可见
55. //Iftrue,theAnchorPointwillbe(0,0)whenyoupositiontheCCNode.
56. //UsedbycclayerandCCScene
57. boolm_bIgnoreAnchorPointForPosition;
58. boolm_bReorderChildDirty;
59. //Propertiesforscript
60. //scripthandler
61. intm_nScriptHandler;
62. intm_nUpdateScriptHandler;
63. //scripttype,luaorjavascript
64. ccScriptTypem_eScriptType;
65. public:
66. //getter&setter
67. /**Thezorderofthenoderelativetoit's"brothers":childrenofthesameparent*/
68. virtualintgetZOrder();//取得z坐标，相对于同一父节点
69. virtualvoidsetZOrder(intnZOrder);
70. /**TherealopenGLZvertex.
71. DifferencesbetweenopenGLZvertexandcocos2dZorder:
72. -OpenGLZmodifiestheZvertex,andnottheZorderintherelationbetweenparent-children
73. -OpenGLZmightrequiretoset2Dprojection
74. -cocos2dZorderworksOKifallthenodesusesthesameopenGLZvertex.eg:vertexZ=0
75. @warning:Useitatyourownrisksinceitmightbreakthecocos2dparent-childrenzorder
76. @sincev0.8
77. */
78. virtualfloatgetVertexZ();
79. virtualvoidsetVertexZ(floatfVertexZ);
80. /**Thescalefactorofthenode.1.0isthedefaultscalefactor.ItonlymodifiestheXscalefactor.*/
81. floatgetScaleX();
82. virtualvoidsetScaleX(floatfScaleX);
83. /**Thescalefactorofthenode.1.0isthedefaultscalefactor.Itonlymodifiestheyscalefactor.*/
84. floatgetScaleY();
85. virtualvoidsetScaleY(floatfScaleY);
86. /**Position(x,y)ofthenodeinopenGLcoordinates.(0,0)istheleft-bottomcorner.*/
87. virtualCCPointgetPosition();
88. virtualvoidsetPosition(constCCPoint&position);
89. /**TheXskewangleofthenodeindegrees.
90. ThisangledescribesthesheardistortionintheXdirection.
91. Thus,itistheanglebetweentheyaxisandtheleftedgeoftheshape
92. ThedefaultskewXangleis0.PositivevaluesdistortthenodeinaCWdirection.
93. floatgetSkewX();
94. virtualvoidsetSkewX(floatfSkewX);
95. /**Theyskewangleofthenodeindegrees.
96. Thisangledescribesthesheardistortionintheydirection.
97. ottomedgeoftheshape
98. ThedefaultskewYangleis0.Positivevaluesdistortthenodeinaccwdirection.
99. floatgetSkewY();
100. virtualvoidsetSkewY(floatfSkewY);
101. virtualCCArray*getChildren();
102. /**ACCCameraobjectthatletsyoumovethenodeusingagluLookAt
103. */
104. virtualCCCamera*getCamera();
105. /**ACCGridobjectthatisusedwhenapplyingeffects*/
106. virtualCCGridBase*getGrid();
107. virtualvoidsetGrid(CCGridBase*pGrid);
108. /**Atagusedtoidentifythenodeeasily*/
109. intgetTag();
110. virtualvoidsetTag(intnTag);
111. /**Acustomuserdatapointer*/
112. virtualvoid*getUserData();
113. virtualvoidsetUserData(void*pUserData);
114. /**SimilartouserData,butinsteadofholdingavoid*itholdsanid*/
115. virtualCCObject*getUserObject();
116. virtualvoidsetUserObject(CCObject*pUserObject);//retain
117. /**ShaderProgram
118. @sincev2.0
119. virtualCCGLProgram*getShaderProgram();
120. virtualvoidsetShaderProgram(CCGLProgram*pShaderProgram);
121. /**usedinternallyforzOrdersorting,don'tchangethismanually*/
122. virtualunsignedintgetorderOfArrival();
123. virtualvoidsetorderOfArrival(unsignedintuOrderOfArrival);
124. /**GLserversidestate
125. virtualccGLServerStategetGLServerState();
126. virtualvoidsetGLServerState(ccGLServerStateglServerState);
127. /**CCActionManagerusedbyalltheactions.
128. IMPORTANT:IfyousetanewCCActionManager,thenprevIoUslycreatedactionsaregoingtoberemoved.
129. @sincev2.0
130. virtualCCActionManager*getActionManager();
131. virtualvoidsetActionManager(CCActionManager*pActionManager);
132. /**CCSchedulerusedtoscheduleall"updates"andtimers.
133. IMPORTANT:IfyousetanewCCScheduler,thenprevIoUslycreatedtimers/updatearegoingtoberemoved.
134. virtualCCScheduler*getScheduler();
135. virtualvoidsetScheduler(CCScheduler*pScheduler);
136. /**Aweakreferencetotheparent*/
137. virtualCCNode*getParent();
138. virtualvoidsetParent(CCNode*pParent);
139. /**anchorPointisthepoinTaroundwhichalltransformationsandpositioningmanipulationstakeplace.
140. It'slikeapininthenodewhereitis"attached"toitsparent.
141. TheanchorPointisnormalized,likeapercentage.(0,0)meansthebottom-leftcornerand(1,1)meansthetop-rightcorner.
142. Butyoucanusevalueshigherthan(1,1)andlowerthan(0,0)too.
143. ThedefaultanchorPointis(0.5,0.5),soitstartsinthecenterofthenode.
144. virtualCCPointgetAnchorPoint();
145. virtualvoidsetAnchorPoint(constCCPoint&anchorPoint);
146. /**TheanchorPointinabsolutepixels.
147. Sincev0.8youcanonlyreadit.Ifyouwishtomodifyit,useanchorPointinstead
148. virtualCCPointgetAnchorPointInPoints();
149. /**Theuntransformedsizeofthenode.
150. ThecontentSizeremainsthesamenomatterthenodeisscaledorrotated.
151. Allnodeshasasize.LayerandScenehasthesamesizeofthescreen.
152. @sincev0.8
153. virtualCCSizegetContentSize();
154. virtualvoidsetContentSize(constCCSize&contentSize);
155. boolisVisible();
156. virtualvoidsetVisible(boolvisible);
157. /**Getthescalefactorofthenode.
158. @warning:Assertwhenm_fScaleX!=m_fScaleY.
159. floatgetScale();
160. /**Thescalefactorofthenode.1.0isthedefaultscalefactor.ItmodifiestheXandYscaleatthesametime.*/
161. virtualvoidsetScale(floatscale);
162. /**Therotation(angle)ofthenodeindegrees.0isthedefaultrotationangle.PositivevaluesrotatenodeCW.*/
163. floatgetRotation();
164. virtualvoidsetRotation(floatfRotation);
165. /**Therotation(angle)ofthenodeindegrees.0isthedefaultrotationangle.PositivevaluesrotatenodeCW.ItonlymodifiestheXrotationperformingahorizontalrotationalskew.*/
166. floatgetRotationX();
167. virtualvoidsetRotationX(floatfRotaionX);
168. /**Therotation(angle)ofthenodeindegrees.0isthedefaultrotationangle.PositivevaluesrotatenodeCW.Itonlymodifiestheyrotationperformingaverticalrotationalskew.*/
169. floatgetRotationY();
170. virtualvoidsetRotationY(floatfRotationY);
171. /**whetherornotthenodeisrunning*/
172. boolisRunning();
173. boolisIgnoreAnchorPointForPosition();
174. virtualvoidignoreAnchorPointForPosition(boolisIgnoreAnchorPointForPosition);
175. /**Getchildrencount*/
176. unsignedintgetChildrenCount(void);
177. void_setZOrder(intz);
178. /**GetscripthandlerforonEnter/onExitevent.*/
179. inlineintgetScriptHandler(){returnm_nScriptHandler;};
180. /**get/setPositionforLua(passnumberfasterthanCCPointobject)
182. luacode:
183. localpos=node:getPositionLua()--returnCCPointobjectfromC++
184. localx,y=node:getPosition()--returnx,yvaluesfromC++
185. localx=node:getPositionX()
186. localy=node:getPositionY()
187. node:setPosition(x,y)--passx,yvaluestoC++
188. node:setPositionX(x)
189. node:setPositionY(y)
190. constCCPoint&getPositionLua(void);
191. voidgetPosition(float*x,float*y);
192. floatgetPositionX(void);
193. floatgetPositionY(void);
194. voidsetPositionX(floatx);
195. voidsetPositionY(floaty);
196. voidsetPosition(floatx,87); font-weight:bold; background-color:inherit">floaty);
197. public:
198. CCNode(void);
199. virtual~CCNode(void);
200. constchar*description(void);
201. /**allocatesandinitializesanode.
202. Thenodewillbecreatedas"autorelease".
203. staticCCNode*create(void);//自动释放对象构造器
204. //scenemanagement
205. /**callbackthatiscalledeverytimetheCCNodeentersthe'stage'.
206. IftheCCNodeentersthe'stage'withatransition,thiscallbackiscalledwhenthetransitionstarts.
207. DuringonEnteryoucan'ta"sister/brother"node.
208. virtualvoidonEnter();//回调。如果节点进入时又过渡，那么在过渡开始时调度
209. /**callbackthatiscalledwhentheCCNodeentersinthe'stage'.
210. virtualvoidonEnterTransitionDidFinish();//回调，当过渡结束时调用
211. /**callbackthatiscalledeverytimetheCCNodeleavesthe'stage'.
212. IftheCCNodeleavesthe'stage'withatransition,0); background-color:inherit">DuringonExityoucan'taccessasiblingnode.
213. virtualvoidonExit();//回调，节点离开时，如果有过渡，则在过渡结束时调用
214. virtualvoidonExitTransitionDidStart();//回调，离开时，在过渡开始时调用
215. /**RegisteronEnter/onExithandlerscriptfunction
216. ScripthandlerautounregisterafteronEnter().
217. virtualvoidregisterScriptHandler(intnHandler);
218. virtualvoidunregisterScriptHandler(void);
219. //composition:ADD
220. /**Addsachildtothecontainerwithz-orderas0.
221. Ifthechildisaddedtoa'running'node,then'onEnter'and'onEnterTransitionDidFinish'willbecalledimmediately.
222. @sincev0.7.1
223. virtualvoidaddChild(CCNode*child);//添加一个子节点，默认z坐标为0.如果一个子节点被添加到一个正在运行的节点，那么这个子节点的onEnter和onEnterTransitionDidFinish会被立即调用
224. /**Addsachildtothecontainerwithaz-order
225. virtualvoidaddChild(CCNode*child,87); font-weight:bold; background-color:inherit">intzOrder);//添加一个子节点，设置z坐标
226. /**Addsachildtothecontainerwithzorderandtag
227. intzOrder,87); font-weight:bold; background-color:inherit">inttag);//添加子节点，设置z坐标和tag标记
228. //composition:REMOVE
229. /**Removeitselffromitsparentnodeforcingacleanup.
230. Ifthenodeorphan,thennothinghappens.
231. @sincev2.1
232. virtualvoidremoveFromParent();//从父节点删除自己，如果没有父节点则什么都不干
233. /**Removeitselffromitsparentnode.Ifcleanupistrue,thenalsoremoveallactionsandcallbacks.
234. @sincev0.99.3
235. virtualvoidremoveFromParentAndCleanup(boolcleanup);//从父节点删除自己，如果cleanup标记为true，则删除其所有动作和回调函数
236. /**Removesachildfromthecontainerforcingacleanup
237. @sincev2.1
238. virtualvoidremoveChild(CCNode*child);//删除一个子节点，强制cleanup为true
239. /**Removesachildfromthecontainer.Itwillalsocleanupallrunningactionsdependingonthecleanupparameter.
240. virtualvoidremoveChild(CCNode*child,87); font-weight:bold; background-color:inherit">boolcleanup);
241. /**Removesachildfromthecontainerbytagvalueforcingacleanup.
242. virtualvoidremoveChildByTag(inttag);
243. /**Removesachildfromthecontainerbytagvalue.Itwillalsocleanupallrunningactionsdependingonthecleanupparameter
244. virtualvoidremoveChildByTag(inttag,0); background-color:inherit">/**Removesallchildrenfromthecontainerforcingacleanup.
245. virtualvoidremoveAllChildren();//删除所有子节点及其动作和回调，即cleanup强置true
246. /**Removesallchildrenfromthecontaineranddoacleanupallrunningactionsdependingonthecleanupparameter.
247. virtualvoidremoveAllChildrenWithCleanup(//composition:GET
248. /**Getsachildfromthecontainergivenitstag
249. @returnreturnsaCCNodeobject
250. @sincev0.7.1
251. CCNode*getChildByTag(/**Reordersachildaccordingtoanewzvalue.
252. *ThechildMUSTbealreadyadded.
253. virtualvoidreorderChild(CCNode*child,87); font-weight:bold; background-color:inherit">intzOrder);
254. /**performanceimprovement,Sortthechildrenarrayoncebeforedrawing,insteadofeverytimewhenachildisaddedorreordered
255. don'tcallthismanuallyunlessachildaddedneedstoberemovedinthesameframe*/
256. virtualvoidsortAllChildren();
257. /**Stopsallrunningactionsandschedulers
258. virtualvoidcleanup(void);//停止所有动作和任务调度
259. //draw
260. /**Overridethismethodtodrawyourownnode.
261. ThefollowingGLstateswillbeenabledbydefault:
262. -glEnableClientState(GL_VERTEX_ARRAY);
263. -glEnableClientState(GL_COLOR_ARRAY);
264. -glEnableClientState(GL_TEXTURE_COORD_ARRAY);
265. -glEnable(GL_TEXTURE_2D);
267. ANDYOUSHOULDNOTdisABLETHEMAFTERDRAWINGYOURNODE
268. ButifyouenableanyotherGLstate,youshoulddisableitafterdrawingyournode.
269. virtualvoiddraw(void);//画自己
270. /**recursivemethodthatvisititschildrenanddrawthem*/
271. virtualvoidvisit(void);//递归访问子节点并绘制它们
272. //transformations
273. //MARMALADEADDEDTHIS...soITISNOLONGERSPECIFICTOCCSprite
274. /**updatesthequadaccordingthetherotation,position,scalevalues.*/
275. virtualvoidupdateTransform(void);
276. /**performsOpenGLview-matrixtransformationbasedonposition,scale,rotationandotherattributes.*/
277. voidtransform(void);
278. /**performsOpenGLview-matrixtransformationofit'sancestors.
279. Generallytheancestorsarealreadytransformed,butincertaincases(eg:attachingaFBO)
280. it'snecessarytotransformtheancestorsagain.
281. @sincev0.7.2
282. voidtransformAncestors(void);
283. /**returnsa"local"axisalignedboundingBoxofthenode.
284. ThereturnedBoxisrelativeonlytoitsparent.
285. @sincev0.8.2
286. CCRectboundingBox(void);//返回节点的边框矩形区域，相对于其父节点
287. //actions
288. /**Executesanaction,andreturnstheactionthatisexecuted.
289. Thenodebecomestheaction'starget.
290. @warningStartingfromv0.8actionsdon'tretaintheirtargetanymore.
291. @returnAnActionpointer
292. CCAction*runAction(CCAction*action);//执行一个动作。执行动作的节点将变成动作的target
293. /**Removesallactionsfromtherunningactionlist*/
294. voidstopAllActions(void);
295. /**Removesanactionfromtherunningactionlist*/
296. voidstopAction(CCAction*action);
297. /**Removesanactionfromtherunningactionlistgivenitstag
298. voidstopActionByTag(/**Getsanactionfromtherunningactionlistgivenitstag
299. @returntheActionthewiththegiventag
300. CCAction*getActionByTag(/**Returnsthenumbersofactionsthatarerunningplustheonesthatarescheduletorun(actionsinactionsToAddandactionsarrays).
301. *Composableactionsarecountedas1action.Example:
302. *Ifyouarerunning1Sequenceof7actions,itwillreturn1.
303. *Ifyouarerunning7Sequencesof2actions,itwillreturn7.
304. intnumberOfRunningActions(void);
305. //timers
306. /**checkwhetheraselectorisscheduled.*/
307. boolisScheduled(SEL_SCHEDULEselector);//检测一个选择器是否被调用
308. /**schedulesthe"update"method.Itwillusetheordernumber0.Thismethodwillbecalledeveryframe.
309. Scheduledmethodswithalowerordervaluewillbecalledbeforetheonesthathaveahigherordervalue.
310. Onlyone"update"methodCouldbescheduledpernode.
311. voidscheduleUpdate(void);//采用0优先级调度update函数，这个函数每一帧都会被执行，优先级数字越小，权重越高，也就越优先调用。每个节点只能有一个update被调度。
312. /**schedulesthe"update"selectorwithacustompriority.Thisselectorwillbecalledeveryframe.
313. Scheduledselectorswithalowerprioritywillbecalledbeforetheonesthathaveahighervalue.
314. Onlyone"update"selectorCouldbescheduledpernode(Youcan'thave2'update'selectors).
315. voidscheduleUpdateWithPriority(intpriority);//用一个优先级调度update函数，每一帧都调用
316. /*unschedulesthe"update"method.
317. voidunscheduleUpdate(void);//停止调度update函数
318. /**schedulesaselector.
319. Thescheduledselectorwillbetickedeveryframe
320. voidschedule(SEL_SCHEDULEselector);//选择器selector每一帧都被调一次
321. /**schedulesacustomselectorwithanintervaltimeinseconds.
322. Iftimeis0itwillbetickedeveryframe.
323. Iftimeis0,itisrecommendedtouse'scheduleUpdate'instead.
324. Iftheselectorisalreadyscheduled,thentheintervalparameter
325. willbeupdatedwithoutschedulingitagain.
326. voidschedule(SEL_SCHEDULEselector,87); font-weight:bold; background-color:inherit">floatinterval);//自定义时间间隔调度选择器selector,比如每秒一次
327. /**
328. repeatwillexecutetheactionrepeat+1times,foracontinuesactionusekCCRepeatForever
329. delayistheamountoftimetheactionwillwaitbeforeexecution
330. floatinterval,unsignedintrepeat,87); font-weight:bold; background-color:inherit">floatdelay);
331. Schedulesaselectorthatrunsonlyonce,withadelayof0orlarger
332. voidscheduleOnce(SEL_SCHEDULEselector,87); font-weight:bold; background-color:inherit">floatdelay);//以一个延迟时间调度回调selector，仅调用一次
333. /**unschedulesacustomselector.*/
334. voidunschedule(SEL_SCHEDULEselector);//停止调度自定义的选择器
335. /**unscheduleallscheduledselectors:customselectors,andthe'update'selector.
336. Actionsarenotaffectedbythismethod.
337. @sincev0.99.3
338. voidunscheduleAllSelectors(void);//停止调用所有选择器，包括自定义的和内置的update
339. /**resumesallscheduledselectorsandactions.
340. CalledinternallybyonEnter
341. voidresumeSchedulerAndActions(void);
342. /**pausesallscheduledselectorsandactions.
343. CalledinternallybyonExit
344. voidpauseSchedulerAndActions(void);
345. /*Updatewillbecalledautomaticallyeveryframeif"scheduleUpdate"iscalled,andthenodeis"live"
346. virtualvoidupdate(floatfDelta);//内置的选择器，如果调用了scheduleUpdate,那么这个选择器每一帧都会被调用
347. //transformationmethods
348. /**Returnsthematrixthattransformthenode's(local)spacecoordinatesintotheparent'sspacecoordinates.
349. ThematrixisinPixels.
350. virtualCCAffineTransformnodetoParentTransform(void);
351. /**Returnsthematrixthattransformparent'sspacecoordinatestothenode's(local)spacecoordinates.
352. virtualCCAffineTransformparentToNodeTransform(void);
353. /**Returnstheworldaffinetransformmatrix.ThematrixisinPixels.
354. virtualCCAffineTransformnodetoWorldTransform(void);
355. /**Returnstheinverseworldaffinetransformmatrix.ThematrixisinPixels.
356. virtualCCAffineTransformworldToNodeTransform(void);
357. /**ConvertsaPointtonode(local)spacecoordinates.TheresultisinPoints.
358. CCPointconvertToNodeSpace(constCCPoint&worldPoint);//将世界坐标系的点转换为节点的本地坐标系的点
359. /**ConvertsaPointtoworldspacecoordinates.TheresultisinPoints.
360. CCPointconvertToWorldspace(constCCPoint&nodePoint);//将节点的本地坐标系的点转换为世界坐标系的点
361. treatingthereturned/receivednodepointasanchorrelative.
362. CCPointconvertToNodeSpaceAR(constCCPoint&worldPoint);//将世界坐标系的点转换为基于锚点的节点本地坐标系的点
363. /**ConvertsalocalPointtoworldspacecoordinates.TheresultisinPoints.
364. treatingthereturned/receivednodepointasanchorrelative.
365. CCPointconvertToWorldspaceAR(constCCPoint&nodePoint);//将基于锚点的节点的本地坐标系的点转换为世界坐标系的点
366. /**conveniencemethodswhichtakeaCCTouchinsteadofCCPoint
367. CCPointconvertTouchToNodeSpace(CCTouch*touch);//将一个屏幕坐标系的touch转换为节点的本地坐标系的点
368. /**convertsaCCTouch(worldcoordinates)intoalocalcoordinate.ThismethodisAR(AnchorRelative).
369. CCPointconvertTouchToNodeSpaceAR(CCTouch*touch);
370. /**Schedulesforscript.*/
371. voidscheduleUpdateWithPriorityLua(intnHandler,87); font-weight:bold; background-color:inherit">intpriority);

其中有有些较重要的成员变量和函数，做了注释，后面陆续写写。