【玩转cocos2d-x之八】精灵类CCSprite

原创作品，转载请标明：http://blog.csdn.net/jackystudio/article/details/12747385

精灵类CCSprite可以说是游戏的主角了，也是我们平时最常用到的类。

1.概况

CCSprite本质上就是一个二维图片，是静态的。游戏中的动画只不过是让一张张静态图片快速更换达到的动态效果。CCSprite继承于CCNodeRGBA，并实现了CCTextureProtocol的接口。因此CCNodeRGBA所具有的RGB和透明值这些属性和接口CCSprite都有，而CCTextureProtocol是一个抽象类，定义了和纹理相关的两个标准接口：

[cpp] view plain copy

1. //返回当前使用的纹理
2. virtualCCTexture2D*getTexture(void)=0;
4. //设置一个新的纹理，它会被retain
5. virtualvoidsetTexture(CCTexture2D*texture)=0;

2.常用接口

2.1.初始化

[cpp] view plain copy

1. //初始化函数
2. virtualboolinit(void);
4. //用CCTexture2D纹理来初始化，精灵大小即是纹理大小
5. virtualboolinitWithTexture(CCTexture2D*pTexture);
7. ///用CCTexture2D纹理和大小来初始化
8. virtualboolinitWithTexture(CCTexture2D*pTexture,constCCRect&rect);
10. //用CCTexture2D纹理，大小，旋转来初始化
11. virtualboolinitWithTexture(CCTexture2D*pTexture,constCCRect&rect,boolrotated);
13. //用CCSpriteFrame精灵帧来初始化
14. virtualboolinitWithSpriteFrame(CCSpriteFrame*pSpriteFrame);
16. //用CCSpriteFrame精灵帧名来初始化
17. virtualboolinitWithSpriteFrameName(constchar*pszSpriteFrameName);
19. //用外部文件初始化，外部文件会先被创建为纹理，再用纹理初始化精灵
20. virtualboolinitWithFile(constchar*pszFilename);
22. //用外部文件和大小来初始化
23. virtualboolinitWithFile(constchar*pszFilename,constCCRect&rect);

2.2.继承自CCTextureProtocol

[cpp] view plain copy

1. //设置/获取纹理
2. virtualvoidsetTexture(CCTexture2D*texture);
3. virtualCCTexture2D*getTexture(void);
5. //设置/获取颜色描绘时混合方案
6. voidsetBlendFunc(ccBlendFuncblendFunc);
7. ccBlendFuncgetBlendFunc(void);

2.3.继承自CCNode

参见CCNode。

[cpp] view plain copy

1. virtualvoidsetScaleX(floatfScaleX);
2. virtualvoidsetScaleY(floatfScaleY);
3. virtualvoidsetPosition(constCCPoint&pos);
4. virtualvoidsetRotation(floatfRotation);
5. virtualvoidsetRotationX(floatfRotationX);
6. virtualvoidsetRotationY(floatfRotationY);
7. virtualvoidsetSkewX(floatsx);
8. virtualvoidsetSkewY(floatsy);
9. virtualvoidremoveChild(CCNode*pChild,boolbCleanup);
10. virtualvoidremoveAllChildrenWithCleanup(boolbCleanup);
11. virtualvoidreorderChild(CCNode*pChild,intzOrder);
12. virtualvoidaddChild(CCNode*pChild);
13. virtualvoidaddChild(CCNode*pChild,intzOrder);
14. virtualvoidaddChild(CCNode*pChild,intzOrder,inttag);
15. virtualvoidsortAllChildren();
16. virtualvoidsetScale(floatfScale);
17. virtualvoidsetVertexZ(floatfVertexZ);
18. virtualvoidsetAnchorPoint(constCCPoint&anchor);//默认(0.5,0.5)
19. virtualvoidignoreAnchorPointForPosition(boolvalue);
20. virtualvoidsetVisible(boolbVisible);
21. virtualvoiddraw(void);

2.4.继承自CCNodeRGBA

[cpp] view plain copy

1. //设置颜色
2. virtualvoidsetColor(constccColor3B&color3);
4. //传递颜色
5. virtualvoidupdateDisplayedColor(constccColor3B&parentColor);
7. //设置透明度
8. virtualvoidsetOpacity(GLubyteopacity);
10. //设置/返回透明度是否跟随颜色值变化而变化
11. virtualvoidsetOpacityModifyRGB(boolmodify);
12. virtualboolisOpacityModifyRGB(void);
14. //传递透明度
15. virtualvoidupdateDisplayedOpacity(GLubyteparentOpacity);

2.5.批节点

[cpp] view plain copy

1. //更新4属性：x,y,rotation,scale
2. virtualvoidupdateTransform(void);
4. //如果精灵是由批节点CCSpriteBatchNode渲染的，则返回批节点
5. virtualCCSpriteBatchNode*getBatchNode(void);
6. //设置批节点，不推荐使用
7. virtualvoidsetBatchNode(CCSpriteBatchNode*pobSpriteBatchNode);

2.6.纹理

[cpp] view plain copy

1. //设置纹理区域
2. virtualvoidsetTextureRect(constCCRect&rect);
3. virtualvoidsetTextureRect(constCCRect&rect,boolrotated,constCCSize&untrimmedSize);
4. virtualvoidsetVertexRect(constCCRect&rect);

2.7.精灵帧和动画

[cpp] view plain copy

1. //设置新的精灵帧
2. virtualvoidsetDisplayFrame(CCSpriteFrame*pNewFrame);
4. //返回精灵帧是否在使用
5. virtualboolisFrameDisplayed(CCSpriteFrame*pFrame);
7. //返回当期使用精灵帧
8. virtualCCSpriteFrame*displayFrame(void);
10. //设置动画和显示索引
11. virtualvoidsetDisplayFrameWithAnimationName(constchar*animationName,intframeIndex);

2.8.Setter和Getter方法

设置/获取CCSprite属性。

[cpp] view plain copy

1. //设置获取是否更新
2. virtualboolisDirty(void);
3. virtualvoidsetDirty(boolbDirty);
5. //返回坐标、顶点、颜色信息
6. ccV3F_C4B_T2F_QuadgetQuad(void);
8. //返回纹理旋转
9. boolisTextureRectRotated(void);
11. //返回/设置地图集索引
12. unsignedintgetAtlasIndex(void);
13. voidsetAtlasIndex(unsignedintuAtlasIndex);
15. //返回精灵区域，单位为点
16. constCCRect&getTextureRect(void);
18. //如果采用批渲染，返回/设置纹理地图集
19. CCTextureAtlas*getTextureAtlas(void);
20. inlinevoidsetTextureAtlas(CCTextureAtlas*pobTextureAtlas);
22. //获取偏移
23. constCCPoint&getOffsetPosition(void);
25. //设置返回翻转
26. boolisFlipX(void);
27. voidsetFlipX(boolbFlipX);
28. boolisFlipY(void);
29. voidsetFlipY(boolbFlipY);