Cocos2d-x CCProgressTimer

Cocos2d-x CCProgressTimer

CCProgressTimer，创建使用这个节点可以大致实现两个作用的效果：
其一：在游戏中几乎大部分的游戏启动界面都是游戏加载画面，那么用到的一般是进度条提示加载进度，其使用的就是CCProgressTimer。
其二：在游戏中需要对精灵的出现等动作***一些渐显的效果。

（1）类型一般就是两种：


typedef enum {

/// Radial Counter-Clockwise

kCCProgressTimerTypeRadial,

/// Bar

kCCProgressTimerTypeBar,

} CCProgressTimerType;

（2）类型1：radial（环形）



CCSize wSize = CCDirector::sharedDirector()->getWinSize();

progressTimer = CCProgressTimer::create(CCSprite::create("progress.gif"));

progressTimer->setType(kCCProgressTimerTypeRadial);

// 默认的情况下，环形渐变的方向是：顺时针

// 改变其渐变的方向 Makes the ridial CCW (逆时针)

progressTimer->setReverseProgress(true);

progressTimer->setPosition(wSize.width/2,wSize.height/2);

this->addChild(progressTimer);



（3）类型2：bar （条形：包括vertical 和 horizontal）

渐变的方向问题：
vertical竖直方法包括从上到下和从下到上；
horizontal水平方向包括从左到右和从右到左。
这里涉及到两个设置参数：
首先是setMidpoint设置起点


/**

* Midpoint is used to modify the progress start position.

* If you're using radials type then the midpoint changes the center point

* If you're using bar type the the midpoint changes the bar growth

* it expands from the center but clamps to the sprites edge so:

* you want a left to right then set the midpoint all the way to ccp(0,y)

* you want a right to left then set the midpoint all the way to ccp(1,y)

* you want a bottom to top then set the midpoint all the way to ccp(x,0)

* you want a top to bottom then set the midpoint all the way to ccp(x,1)

*/

其次是setBarChangeRate设置变化rate



/**

* This allows the bar type to move the component at a specific rate

* Set the component to 0 to make sure it stays at 100%.

* For example you want a left to right bar but not have the height stay 100%

* Set the rate to be ccp(0,1); and set the midpoint to = ccp(0,.5f);

*/

如果不用变化的方向，则设置该方向为0，否则设置为1。



CCSize wSize = CCDirector::sharedDirector()->getWinSize();

progressTimer = CCProgressTimer::create(CCSprite::create("progress.gif"));

progressTimer->setType(kCCProgressTimerTypeBar);



//从左到右

progressTimer->setMidpoint(ccp(0, 0.5));

progressTimer->setBarChangeRate(ccp(1, 0));



//从右到左

// progressTimer->setMidpoint(ccp(1, 0.5));

// progressTimer->setBarChangeRate(ccp(1, 0));



//从上到下

// progressTimer->setMidpoint(ccp(0.5, 1));

// progressTimer->setBarChangeRate(ccp(0, 1));



//从下到上

// progressTimer->setMidpoint(ccp(0.5, 0));

// progressTimer->setBarChangeRate(ccp(0, 1));



progressTimer->setPosition(wSize.width/2,wSize.height/2);

this->addChild(progressTimer);

(4) 执行变化


①、如果是要实现精灵渐变的显示效果：
创建CCProgressTo或者是CCProgressFromTo动作，让CCProgressTimer执行。

CCProgressTo和CCProgressFromTo的区别是：
前者：Progress to percentage（初始化有两个参数）(float duration, float fPercent)
后者：Progress from a percentage to another percentage（初始化有三个参数）(float duration, float fFromPercentage, float fToPercentage)


CCProgressTo *progressTo = CCProgressTo::create(2.0, 100);

//等价于：

//CCProgressFromTo *progressFromTo = CCProgressFromTo::create(2.0, 0, 100);

progressTimer->runAction(CCRepeatForever::create(progressTo));

②、如果是要实现加载进度条的效果：

需要重载update方法，在这个方法中实现进度条percentage的变化。


this->scheduleUpdate();



void HelloWorld::update(float dt)

{

float percentage = progressTimer->getPercentage();



if (percentage < 100) {

percentage += 1;

progressTimer->setPercentage(percentage);

}

}



关于CCProgressTimer的更加详细的使用 demo可以参看引擎中sample中的ActionProgressTest。