Timer

public Timer();

Создаёт остановленную Timer Entity вне дерева. По умолчанию WaitTime = 1 секунда, ProcessCallback = Idle; Autostart, OneShot, Paused и IgnoreTimeScale выключены. Добавьте её в активное дерево перед Start.

public bool Autostart { get; set; }

При Ready запускает таймер автоматически и сбрасывается в false. Это не команда немедленного запуска уже готового объекта: для него используйте Start. Для редактируемого документа в редакторе автозапуск подавляется.

public bool IgnoreTimeScale { get; set; }

Определяет использование немасштабированного времени. Не включает обработку автоматически, когда ProcessMode запрещает её из-за паузы.

public bool OneShot { get; set; }

Если true, автоматическое истечение останавливает отсчёт перед Timeout. Если false, после истечения добавляется WaitTime и отсчёт продолжается. Таймер остаётся Entity дерева; режим не удаляет его.

public bool Paused { get; set; }

Приостанавливает этот Timer, не всё EntityTree. Условия ProcessMode дерева остаются отдельными.

public Timer.TimerProcessCallback ProcessCallback { get; set; }

Выбирает фазу обновления: Idle — процессные кадры, Physics — физические такты. Не задаёт отдельный поток и не обходит Paused или условия ProcessMode.

public double TimeLeft { get; }

Оставшийся отсчёт в секундах, ограниченный снизу нулём; свойство только для чтения. У остановленного таймера равно 0, у приостановленного сохраняется. Нулевой результат сам по себе не означает, что Entity удалена.

public double WaitTime { get; set; }

Интервал в секундах. Задавайте конечное положительное число; значение <= 0 вызывает native-ошибку и сохраняет прежний интервал, а не гарантированное исключение CLR. Изменение свойства само не запускает таймер и не сбрасывает оставшееся время. Очень короткие интервалы зависят от частоты выбранной фазы; это не высокоточный отдельный системный таймер.

public double GetTimeLeft();

Возвращает TimeLeft без изменения состояния таймера. Подробности — в описании свойства.

public Timer.TimerProcessCallback GetTimerProcessCallback();

Возвращает ProcessCallback без изменения состояния таймера. Подробности — в описании свойства.

public double GetWaitTime();

Возвращает WaitTime без изменения состояния таймера. Подробности — в описании свойства.

public bool HasAutostart();

Возвращает Autostart без изменения состояния таймера. Подробности — в описании свойства.

public bool IsIgnoringTimeScale();

Возвращает IgnoreTimeScale без изменения состояния таймера. Подробности — в описании свойства.

public bool IsOneShot();

Возвращает OneShot без изменения состояния таймера. Подробности — в описании свойства.

public bool IsPaused();

Возвращает Paused без изменения состояния таймера. Подробности — в описании свойства.

public bool IsStopped();

Проверяет GetTimeLeft() <= 0. У нового или остановленного таймера возвращает true; пауза с положительным остатком не считается остановкой. При отставании повторяющегося таймера остаток тоже может быть 0: метод не проверяет флаг обработки или существование Entity.

public void SetAutostart(bool enable);

Устанавливает Autostart с теми же правилами, что и свойство. Это не отдельный способ запуска таймера.

public void SetIgnoreTimeScale(bool ignore);

Устанавливает IgnoreTimeScale с теми же правилами, что и свойство. Это не отдельный способ запуска таймера.

public void SetOneShot(bool enable);

Устанавливает OneShot с теми же правилами, что и свойство. Это не отдельный способ запуска таймера.

public void SetPaused(bool paused);

Устанавливает Paused с теми же правилами, что и свойство. Это не отдельный способ запуска таймера.

public void SetTimerProcessCallback(Timer.TimerProcessCallback callback);

Устанавливает ProcessCallback с теми же правилами, что и свойство. Это не отдельный способ запуска таймера.

public void SetWaitTime(double timeSec);

Устанавливает WaitTime с теми же правилами, что и свойство. Это не отдельный способ запуска таймера.

public void Start(double timeSec = -1d);

Запускает или сбрасывает отсчёт в активном дереве. Положительный timeSec сначала заменяет WaitTime; 0 и отрицательное значение используют прежний интервал. Не снимает Paused. Вызов вне дерева сообщает native-ошибку; не рассчитывайте на исключение CLR.

Полный пример проверяет входные данные и подписывается до запуска. Вернувшийся Timer остаётся дочерним объектом parent после истечения. Для его отмены вызовите Stop; для удаления — QueueFree, когда объект больше не нужен.

using System;
using Reckfell;

public static class TimerExample
{
    // The returned Timer remains a child of parent after its one timeout.
    public static Timer StartOnce(Entity parent, double seconds, Action onTimeout)
    {
        ArgumentNullException.ThrowIfNull(parent);
        ArgumentNullException.ThrowIfNull(onTimeout);
        if (!parent.IsInsideTree())
            throw new ArgumentException("Parent must be inside the active tree.", nameof(parent));
        if (!double.IsFinite(seconds) || seconds <= 0)
            throw new ArgumentOutOfRangeException(nameof(seconds));
        var timer = new Timer { OneShot = true };
        parent.AddChild(timer);
        timer.Timeout += onTimeout;
        timer.Start(seconds);
        return timer;
    }
}

public void Stop();

Останавливает обработку, обнуляет видимый TimeLeft и сбрасывает Autostart. Не испускает Timeout и не удаляет Entity. Допустим вне дерева. Ожидание Timeout через await не становится автоматически отменённым или завершённым.

public event Action Timeout;

Сигнал автоматического истечения отсчёта без аргументов. Подписывайтесь до Start. При OneShot таймер к этому моменту остановлен; при повторении продолжает работу. Stop сам сигнал не испускает.