showPixels()

template<int DATA_PIN, typename TIMING, EOrder RGB_ORDER, int WAIT_TIME, typename DriverTraits, int XTRA0 = 0, bool DIRECT_SHOW = (FL_SLIM_BRIDGE_DIRECT_SHOW != 0)>

void fl::SlimBridgeController< DATA_PIN, TIMING, RGB_ORDER, WAIT_TIME, DriverTraits, XTRA0, DIRECT_SHOW >::showPixels ( PixelController< RGB_ORDER > & pixels )

inlineoverrideprotected

Definition at line 133 of file slim_bridge_controller.h.

                                                                              {
        IChannelDriver& driver = DriverTraits::instance();
 
        // (A1) Respect runtime driver enable/disable: ChannelManager is the
        // single source of truth. A disabled driver means "drop this frame",
        // not "enqueue and hope" -- silently enqueuing to a disabled driver
        // is the #2517 silent-drop failure mode.
        if (!Policy::enabled(driver)) {
            FL_WARN_ONCE("SlimBridgeController: driver '" << driver.getName().c_str() << "' is disabled - dropping frame");
            return;
        }
 
        // (A8) If the previous frame's buffer is still in flight, block
        // (bounded) until the driver reports it can accept more work rather
        // than racing the driver's in-progress DMA/RMT transfer.
        if (mData->isInUse()) {
            if (!driver.waitForReady()) {
                FL_WARN_ONCE("SlimBridgeController: driver '" << driver.getName().c_str() << "' did not become ready in time - dropping frame");
                return;
            }
        }
 
        // Give subclasses a chance to observe the accepted frame before it is
        // encoded (e.g. feeding ActiveStripTracker for stub/WASM channels).
        onBeforeEncode(pixels);
 
        // (A5) Publish the pixel byte layout so the driver (and any
        // downstream padding/diagnostic code) knows the encoded stride.
        if (this->getRgbww().active()) {
            mData->setPixelFormat(ChannelPixelFormat::RGBWW);
        } else if (this->getRgbw().active()) {
            mData->setPixelFormat(ChannelPixelFormat::RGBW);
        } else {
            mData->setPixelFormat(ChannelPixelFormat::RGB);
        }
 
        // (A3) Re-encode into the same buffer every frame -- clear() keeps
        // capacity, so steady-state operation is allocation-free.
        mData->getData().clear();
        fl::PixelIterator iterator(&pixels, this->getRgbw(), this->getRgbww());
        iterator.writeWS2812(&mData->getData());
 
        driver.enqueue(mData);
        Policy::afterEnqueue(driver);
    }

References fl::basic_string::c_str(), fl::IChannelDriver::enqueue(), fl::FL_NO_EXCEPT, FL_WARN_ONCE, fl::IChannelDriver::getName(), fl::CLEDController::getRgbw(), fl::CLEDController::getRgbww(), mData, onBeforeEncode(), fl::RGB, fl::RGBW, fl::RGBWW, and fl::IChannelDriver::waitForReady().

Here is the call graph for this function: