time.hpp

/*
    KTech, Kaup's C++ 2D terminal game engine library.
    Copyright (C) 2023-2025 Ethan Kaufman (AKA Kaup)
 
    This file is part of KTech.
 
    KTech is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    any later version.
 
    KTech is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
    along with KTech. If not, see <https://www.gnu.org/licenses/>.
*/
 
#pragma once
 
#define KTECH_DEFINITION
#include "../../ktech.hpp"
#undef KTECH_DEFINITION
 
#include <chrono>
 
class KTech::Time
{
public:
    enum class Measurement : uint8_t
    {
        ticks,
        seconds,
        milliseconds,
        microseconds
    };
 
    struct Invocation;
 
    unsigned long tpsLimit; 
    float tps = 0; 
    float tpsPotential = 0; 
    long deltaTime = 0; 
    unsigned long ticksCounter = 0; 
 
    void CallInvocations();
    void WaitUntilNextTick();
 
private:
    bool m_changedThisTick = false;
    Engine& engine;
    std::chrono::steady_clock::time_point m_currentTickStart;
    std::vector<Invocation*> m_invocations;
 
    inline Time(Engine& engine, unsigned long ticksPerSecondLimit)
        : engine(engine), tpsLimit(ticksPerSecondLimit) {}
 
    [[nodiscard]] auto TimeToMicroseconds(long p_time, Measurement p_measurement) const -> long;
    void RegisterCallback(Invocation* invocation);
    void DeregisterCallback(Invocation* invocation);
 
    friend class Invocation;
    friend class Output;
    friend class Engine;
};