time_alpha.cpp.hpp

Go to the documentation of this file.

 
#include "fl/math/time_alpha.h"
#include "fl/log/log.h"
#include "fl/math/math.h"
#include "fl/stl/noexcept.h"
 
namespace fl {
 
u8 time_alpha8(u32 now, u32 start, u32 end) FL_NO_EXCEPT {
    if (now < start) {
        return 0;
    }
    if (now > end) {
        return 255;
    }
    u32 elapsed = now - start;
    u32 total = end - start;
    u32 out = (elapsed * 255) / total;
    if (out > 255) {
        out = 255;
    }
    return static_cast<u8>(out);
}
 
u16 time_alpha16(u32 now, u32 start, u32 end) FL_NO_EXCEPT {
    if (now < start) {
        return 0;
    }
    if (now > end) {
        return 65535;
    }
    u32 elapsed = now - start;
    u32 total = end - start;
    u32 out = (elapsed * 65535) / total;
    if (out > 65535) {
        out = 65535;
    }
    return static_cast<u16>(out);
}
 
TimeRamp::TimeRamp(u32 risingTime, u32 latchMs, u32 fallingTime) FL_NO_EXCEPT
    : mLatchMs(latchMs), mRisingTime(risingTime), mFallingTime(fallingTime) {}
 
bool TimeRamp::isActive(u32 now) const FL_NO_EXCEPT {
 
    bool not_started = (mFinishedRisingTime == 0) &&
                       (mFinishedPlateauTime == 0) &&
                       (mFinishedFallingTime == 0);
    if (not_started) {
        // if we have not started, we are not active
        return false;
    }
 
    if (now < mStart) {
        // if the time is before the start, we are not active
        return false;
    }
 
    if (now > mFinishedFallingTime) {
        // if the time is after the finished rising, we are not active
        return false;
    }
 
    return true;
}
 
RampPhase TimeRamp::getCurrentPhase(u32 now) const FL_NO_EXCEPT {
    if (!isActive(now)) {
        return RampPhase::Inactive;
    }
 
    if (now < mFinishedRisingTime) {
        return RampPhase::Rising;
    } else if (now < mFinishedPlateauTime) {
        return RampPhase::Plateau;
    } else if (now < mFinishedFallingTime) {
        return RampPhase::Falling;
    }
 
    return RampPhase::Inactive;
}
 
void TimeRamp::trigger(u32 now) FL_NO_EXCEPT {
    RampPhase phase = getCurrentPhase(now);
 
    switch (phase) {
        case RampPhase::Inactive:
            // Not active, start fresh
            mStart = now;
            mFinishedRisingTime = mStart + mRisingTime;
            mFinishedPlateauTime = mFinishedRisingTime + mLatchMs;
            mFinishedFallingTime = mFinishedPlateauTime + mFallingTime;
            break;
 
        case RampPhase::Rising:
            // Continue rising, just extend the plateau end time
            mFinishedPlateauTime = mFinishedRisingTime + mLatchMs;
            mFinishedFallingTime = mFinishedPlateauTime + mFallingTime;
            break;
 
        case RampPhase::Plateau:
            // Extend the plateau by the full latch time from now
            mFinishedPlateauTime = now + mLatchMs;
            mFinishedFallingTime = mFinishedPlateauTime + mFallingTime;
            break;
 
        case RampPhase::Falling:
            // Reverse back to plateau
            // Jump immediately to plateau and hold for latch time
            mFinishedRisingTime = now;
            mFinishedPlateauTime = now + mLatchMs;
            mFinishedFallingTime = mFinishedPlateauTime + mFallingTime;
            mStart = now - mRisingTime; // Adjust start so timing stays consistent
            break;
    }
}
 
u8 TimeRamp::update8(u32 now) FL_NO_EXCEPT {
    if (!isActive(now)) {
        return 0;
    }
    // u32 elapsed = now - mStart;
    u8 out = 0;
    if (now < mFinishedRisingTime) {
        out = time_alpha8(now, mStart, mFinishedRisingTime);
    } else if (now < mFinishedPlateauTime) {
        // plateau
        out = 255;
    } else if (now < mFinishedFallingTime) {
        // ramp down
        u8 alpha =
            time_alpha8(now, mFinishedPlateauTime, mFinishedFallingTime);
        out = 255 - alpha;
    } else {
        // finished
        out = 0;
    }
 
    mLastValue = out;
    return out;
}
 
} // namespace fl