show() [2/2]

FL_KEEP_ALIVE void CFastLED::show

(

fl::u8

scale

)

Update all our controllers with the current led colors, using the passed in brightness.

Parameters

scale

the brightness value to use in place of the stored value

Warning

This function is not interrupt-safe and must not be called from an interrupt service routine (ISR). On ESP32, doing so can deadlock or trigger an interrupt-watchdog panic. Have the ISR set a flag, then call show() from loop() or a normal task after leaving the interrupt context.

Definition at line 373 of file FastLED.cpp.hpp.

                                                         {
    FL_SCOPED_TRACE;
    onBeginFrame();
    throttleToMaxRefreshRate(mMaxRefreshHz ? 1000000UL / mMaxRefreshHz : 0);
    lastshow = fl::micros();
 
    mLastRequestedScale = scale;
    // If we have a function for computing power, use it!
    if(mPPowerFunc) {
        scale = (*mPPowerFunc)(scale, mNPowerData);
    }
    mLastShownScale = scale;
 
 
    // A byte index saves bookkeeping on 16-bit-int targets; retain wider limits.
    using ControllerIndex = fl::conditional_t<
        (sizeof(int) == 2 && MAX_CLED_CONTROLLERS <= 255), fl::u8, int>;
    ControllerIndex length = 0;
    CLEDController *pCur = CLEDController::head();
 
    while(pCur && length < MAX_CLED_CONTROLLERS) {
        if (pCur->getEnabled()) {
            gControllersData[length] = pCur->beginShowLeds(pCur->size());
        } else {
            gControllersData[length] = nullptr;
        }
        length++;
        if (mNFPS < FL_DITHER_ENABLE_MIN_REFRESH_HZ) { pCur->setDither(0); }
        pCur = pCur->next();
    }
 
    pCur = CLEDController::head();
    for (length = 0; length < MAX_CLED_CONTROLLERS && pCur; length++) {
        if (pCur->getEnabled()) {
            pCur->showLedsInternal(scale);
        }
        pCur = pCur->next();
 
    }
 
    length = 0;  // Reset length to 0 and iterate again.
    pCur = CLEDController::head();
    while(pCur && length < MAX_CLED_CONTROLLERS) {
        if (pCur->getEnabled()) {
            pCur->endShowLeds(gControllersData[length]);
        }
        length++;
        pCur = pCur->next();
    }
    countFPS();
    onEndFrame();
    onEndShowLeds();
}

References fl::CLEDController::beginShowLeds(), countFPS(), fl::CLEDController::endShowLeds(), FL_DITHER_ENABLE_MIN_REFRESH_HZ, FL_KEEP_ALIVE, FL_NO_EXCEPT, FL_SCOPED_TRACE, gControllersData, fl::CLEDController::getEnabled(), fl::CLEDController::head(), lastshow, length(), MAX_CLED_CONTROLLERS, fl::micros(), mLastRequestedScale, mLastShownScale, mMaxRefreshHz, mNFPS, mNPowerData, mPPowerFunc, fl::CLEDController::next(), onBeginFrame(), onEndFrame(), onEndShowLeds(), scale, fl::CLEDController::setDither(), fl::CLEDController::showLedsInternal(), fl::CLEDController::size(), and throttleToMaxRefreshRate().

Here is the call graph for this function: