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。