showPixels()

template<int DATA_PIN, typename TIMING, EOrder RGB_ORDER, int WAIT_TIME, typename DriverTraits, int XTRA0 = 0, bool DIRECT_SHOW = SlimBridgeDirectShow<>::value, bool BATCHED_DIRECT_SHOW = false>

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

inlineoverrideprotected

Definition at line 187 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;
            }
        }
 
        // (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);
        }
 
        const int pixelCount = pixels.size();
        const fl::size bytesPerPixel = channelPixelFormatBytesPerPixel(mData->getPixelFormat());
        if (pixelCount < 0 || bytesPerPixel == 0 ||
            static_cast<fl::size>(pixelCount) > static_cast<fl::size>(-1) / bytesPerPixel) {
            detail::reject_legacy_frame<DriverTraits>(0);
            FL_WARN_ONCE("SlimBridgeController: invalid encoded frame size - dropping frame");
            return;
        }
        const fl::size expectedSize = static_cast<fl::size>(pixelCount) * bytesPerPixel;
        auto &encoded = mData->getData();
        // Reserve the complete snapshot before clearing the old one. Byte-wise
        // geometric growth could fail partway through encoding and enqueue a
        // silently truncated frame; exact reservation also bounds peak heap.
        encoded.reserve(expectedSize);
        if (encoded.capacity() < expectedSize) {
            detail::reject_legacy_frame<DriverTraits>(0);
            FL_WARN_ONCE("SlimBridgeController: cannot allocate encoded frame - dropping frame");
            return;
        }
 
        // Observe accepted frames only after allocation succeeds (e.g. feeding
        // ActiveStripTracker for stub/WASM channels).
        onBeforeEncode(pixels);
 
        // (A3) Re-encode into the same buffer every frame -- clear() keeps
        // capacity, so steady-state operation is allocation-free.
        encoded.clear();
        fl::PixelIterator iterator(&pixels, this->getRgbw(), this->getRgbww());
        iterator.writeWS2812(&encoded);
        if (encoded.size() != expectedSize) {
            encoded.clear();
            detail::reject_legacy_frame<DriverTraits>(0);
            FL_WARN_ONCE("SlimBridgeController: incomplete encoded frame - dropping frame");
            return;
        }
 
        driver.enqueue(mData);
        Policy::afterEnqueue(driver);
    }

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

Here is the call graph for this function: