Union.Timer - краткое описание класса

[Gratt]

Назначение: циклические таймеры
Определение: Timer

- Операторы

Спойлер

TimerBlock& operator[]( const uint& index )
    Создает или возвращает таймер с заданным индексом index

TimerBlock& operator[]( const void* index )
    Создает или возвращает таймер с заданным индексом index

- Методы

Спойлер

void ClearUnused()
    Вызывается в цикле, в котором работает таймер. Удаляет все неиспользуемые блоки.

 

[Gratt]

Назначение: элементы циклический тймеров
Определение: TimerBlock

- Конструкторы

Спойлер

TimerBlock()
    Создает нулевой блок.

TimerBlock( const uint& index )
    Создает блок с индексом index.

- Методы

Спойлер

bool Await( const uint& delay = 100, const bool& firstCallIsWorking = false )
    Проверяет, прошло ли delay миллисекунд с предыдущего возврата истины.
    Следующее время на итерацию засекается относительно последнего обращения к функции.
    Если firstCallIsWorking, то первое обращение к методу сразу возвращает истину.
    
uint AwaitExact( const uint& delay = 100, const bool& firstCallIsWorking = false )
    Отличие от первой функции заключается в том, что функция возвращает количество прошедших за период итераций, если таймер быстрее цикла.
    При этом время на следующую итерацию засекается относительно самой первой итерации этого блока.
    Если firstCallIsWorking, то первое обращение к методу сразу возвращает истину.

void Suspend( const bool& suspend )
    Ставит таймер на паузу, если suspend = true. И снимает с пауны, если suspend = false;

uint TimeHasPassed()
    Возвращает количество оставшегося времени до завершения текущей итерации.

TimerBlock& TimeAppend( const uint& delay )
    Прибавляет к текущей задержке таймера delay миллисекунд.

TimerBlock& ResetTime()
    Сбрасывает засеченные значения таймера.

void Delete()
    Помечает таймер на удаление методом ClearUnused.

 

[Gratt]

- Пример использования таймера

Спойлер

void Game_Loop() {
    static Timer timer;
    timer.ClearUnused();

    // Выполнять прибавку маны каждые 100мс для таймера по индексу player
    if( timer[player].Await( 100 ) )
        if( player->attribute[NPC_ATR_MANA] < player->attribute[NPC_ATR_MANAMAX] )
            player->attribute[NPC_ATR_MANA]++;

    // Выполнять прибавку здоровье каждую секунду для таймера по индексу 0
    if( timer[0u].AwaitExact( 1000, true ) )
        if( player->attribute[NPC_ATR_HITPOINTS] < player->attribute[NPC_ATR_HITPOINTSMAX] )
            player->attribute[NPC_ATR_HITPOINTS]++;
}