【3.x】
(1)去掉 “CC”
(2)CCProgressTimerType 改为强枚举 ProgressTimer::Type::
//
RADIAL //扇形进度计时器
BAR //条形进度计时器
//
1、进度动作CCProgressTo、CCProgressFromTo
在讲解进度条CCProgressTimer之前,先讲讲和进度条有半毛线关系的两个动作类:
(1)CCProgressTo (2)CCProgressFromTo
为什么在之前的基本动作CCAction那章不介绍,而放在这里进行介绍呢?这是因为,这两个动作只是针对CCProgressTimer而言的,对其他的CCNode子类(如:CCSprite)没啥用处。
从这两个动作的字面上,也可以看出他们的用处了吧?就是进度条的进度从 a% 变化到 b% 。
使用方法如下:
//
//几秒内从0%变化到指定进度
CCProgressTo::create('时间', '变化到百分之几');
//几秒内从a%进度变化到b%进度
CCProgressFromTo::create('时间', '从百分之几', '变化到百分之几');
//
2、CCProgressTimer
CCProgressTimer就是拿一张CCSprite精灵图片来作为进度条,然后根据一个百分比属性,实现显示/隐藏图片的一部分区域,达到图形化显示进度的作用。
进度条有两种样式:扇形进度条、条形进度条。默认锚点(0.5,0.5)。
常用操作如下:
//
class CCProgressTimer : public CCNodeRGBA
{
/**
* 创建方法 create
*/
//精灵图片作为进度条
CCProgressTimer::create(CCSprite* sp);
/**
* 属性设置
* setSprite , setPercentage , setType
*/
//设置进度条所使用的精灵图片
void setSprite(CCSprite *pSprite);
CCSprite* getSprite();
//设置进度百分值[0,100]
void setPercentage(float fPercentage);
float getPercentage();
//设置进度条样式
// kCCProgressTimerTypeRadial 扇形进度计时器
// kCCProgressTimerTypeBar 条形进度计时器
void setType(CCProgressTimerType type);
CCProgressTimerType getType();
//反进度显示
//条形:从100到0。
//扇形:false顺时针,true逆时针
void setReverseProgress(bool reverse);
/**
* 进度条设置
* setMidpoint , setBarChangeRate
*/
//设置进度条起始的中心位置,范围[0,1](默认图片中点ccp(0.5,0.5))
void setMidpoint(CCPoint);
CCPoint getMidpoint();
//用于做进度条所占的图片比例
void setBarChangeRate(CCPoint);
CCPoint getBarChangeRate();
/**
* 父类继承
* setAnchorPoint , setColor , setOpacity
*/
//设置锚点
void setAnchorPoint(CCPoint anchorPoint);
//设置颜色
virtual void setColor(const ccColor3B& color);
virtual const ccColor3B& getColor() const;
//设置透明度
virtual void setOpacity(GLubyte opacity);
virtual GLubyte getOpacity() const;
};
//
3、setMidpoint
setMidpoint是用来设置进度条的起始中心位置的。
(1)对于扇形进度条:相当于“圆心”,从0到100,慢慢展开扇形。
(2)对于条形进度条:相当于从某点向两边扩散。
3、setBarChangeRate
setBarChangeRate是用于设置条形进度条所占的图片比例,对于扇形是无效的。
下列三组图解中,黄颜色区域表示一开始就已经显示的图片区域。而ccp(x,y):表示宽度还有 x 比例的图片还未显示,高度还有 y 比例的图片还未显示,用作显示进度条。
有下图可知,“进度百分值”是相对剩余ccp(x,y)用作显示进度条的那一部分,已经显示的百分率,而不是整张图片的百分率。
常用方式如下:
//
setBarChangeRate( ccp(1,0) ) : //只有X轴变化。 (起始X轴不显示)
setBarChangeRate( ccp(0,1) ) : //只有Y轴变化。 (起始Y轴不显示)
setBarChangeRate( ccp(1,1) ) : //X,Y轴都变化。(起始X,y轴都不显示)
setBarChangeRate( ccp(0.5,0.5) ): //X,Y轴都变化。(起始X,y轴都已显示一半)
//
三组图片对比图:
4、常用的进度条方式
由上面的讲解可以得出,进度条的显示方式主要受三个设置的影响:
(1)setType :扇形、条形进度条。
(2)setMidpoint :中心位置。
(3)setBarChangeRate:用作条形进度条显示的图片所占比例。
其中(1)的设置决定了进度条的类型。而(2)(3)的配合使用可以有多种不同的显示方式。
常用的(2)(3)配合使用方式如下:
//
//当条形进度条样式为:setBarChangeRate( ccp(1,0) )
ccp(1,0): "从右到左显示"
ccp(0.5,0): "从中间到两边显示"
ccp(0,0): "从左到右显示"
//当条形进度条样式为:setBarChangeRate( ccp(0,1) )
ccp(0,1): "从上到下显示。"
ccp(0,0.5): "从中间到两边显示。
ccp(0,0): "从下到上显示。"
//当条形进度条样式为:setBarChangeRate( ccp(1,1) )
ccp(0,1): "X从左到右显示, Y从上到下显示"
ccp(0,0.5): "X从左到右显示, Y从中间到两边显示"
ccp(1,0): "X从右到左显示, Y从下到上显示"
ccp(0.5,0): "X从中间到两边显示,Y从下到上显示"
ccp(0,0): "X从左到右显示, Y从下到上显示"
ccp(0.5,0.5): "X从中间到两边显示,Y从中间到两边显示"
ccp(1,1): "X从右到左显示, Y从上到下显示"
//
【代码实战】
1、资源图片
2、创建两类进度条:条形、扇形
并定义进度条显示方式。
//
//条形进度条pro1
CCSprite* bg1 = CCSprite::create("Icon.png");
CCProgressTimer* pro1 = CCProgressTimer::create(bg1);
pro1->setPosition( ccp(130, 100) );
this->addChild(pro1);
//条形,定义进度条方式:从右到左显示
pro1->setType(kCCProgressTimerTypeBar);
pro1->setBarChangeRate( ccp(1, 0) );
pro1->setMidpoint( ccp(1, 0) );
//pro1->setReverseProgress(true); //反进度显示
//扇形进度条pro2
CCSprite* bg2 = CCSprite::create("Icon.png");
CCProgressTimer* pro2 = CCProgressTimer::create(bg2);
pro2->setPosition( ccp(350, 100) );
this->addChild(pro2);
//扇形,圆心ccp(0.3 , 0.7)
pro2->setType(kCCProgressTimerTypeRadial);
pro2->setMidpoint( ccp(0.3, 0.7) );
//pro2->setReverseProgress(true); //逆时针
//
3、创建进度动作CCProgressTo、CCProgressFromTo
并让pro1、pro2分别执行两个进度动作。
//
//进度动作
CCProgressTo* ac1 = CCProgressTo::create(2.0f, 100);
CCProgressFromTo* ac2 = CCProgressFromTo::create(2.0f, 30, 100);
pro1->runAction( CCRepeatForever::create(ac1) ); //2秒内,从0到100
pro2->runAction( CCRepeatForever::create(ac2) ); //2秒内,从30到100
//
4、运行结果
若添加反进度显示setReverseProgress()
//
pro1->setReverseProgress(true); //反进度显示
pro2->setReverseProgress(true); //逆时针
//
结果如下: