showPixels()

template<fl::SpiChipset CHIPSET, EOrder RGB_ORDER, fl::Bus B, fl::u8 B_WHICH>

void fl::SlimSpiBridgeController< CHIPSET, RGB_ORDER, B, B_WHICH >::showPixels ( PixelController< RGB_ORDER > & pixels )

inlineoverrideprotected

Definition at line 98 of file slim_spi_bridge_controller.h.

                                                                              {
        fl::shared_ptr<IChannelDriver> driver = resolveDriver();
        if (!driver) {
            return;
        }
 
        // (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 (!ChannelManager::registry().isDriverEnabled(driver->getName().c_str())) {
            FL_WARN_ONCE("SlimSpiBridgeController: driver '%s' is disabled - dropping frame",
                         driver->getName().c_str());
            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 transfer.
        if (mData->isInUse()) {
            if (!driver->waitForReady()) {
                FL_WARN_ONCE("SlimSpiBridgeController: driver '%s' did not become ready in "
                             "time - dropping frame", driver->getName().c_str());
                return;
            }
        }
 
        // (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);
        }
 
        // Dither reseed mirrors Channel::encodeFrame(): only reseed when a
        // non-zero dither mode is set.
        if (pixels.ditherActive()) {
            pixels.reseed_binary_dithering(mDitherPhase);
        }
 
        // (A3) Re-encode into the same buffer every frame -- clear() keeps
        // capacity, so steady-state operation is allocation-free.
        mData->getData().clear();
        fl::PixelIterator it(&pixels, this->getRgbw(), this->getRgbww());
        encode(it, mData->getData());
 
        driver->enqueue(mData);
        // Presented, per the driver contract: an accepted enqueue is the
        // frame -- mirrors Channel::submitFrame()'s ++mDitherPhase placement
        // (dither only advances when a frame is actually handed to the
        // driver, not on every showPixels() attempt).
        ++mDitherPhase;
    }

References encode(), fl::FL_NO_EXCEPT, FL_WARN_ONCE, fl::CLEDController::getRgbw(), fl::CLEDController::getRgbww(), mData, mDitherPhase, fl::ChannelManager::registry(), resolveDriver(), fl::RGB, fl::RGBW, and fl::RGBWW.

Here is the call graph for this function: