blur1d() [2/2]

void fl::gfx::blur1d	(	fl::span< CRGB >	leds,
		fract8	blur_amount )

One-dimensional blur filter (span version).

Spreads light to 2 line neighbors.

• 0 = no spread at all
• 64 = moderate spreading
• 172 = maximum smooth, even spreading
• 173..255 = wider spreading, but increasing flicker

Total light is NOT entirely conserved, so many repeated calls to 'blur' will also result in the light fading, eventually all the way to black; this is by design so that it can be used to (slowly) clear the LEDs to black.

Parameters

leds	span of LEDs to blur
blur_amount	the amount of blur to apply

Definition at line 69 of file blur.cpp.hpp.

                                                   {
    const fl::u16 numLeds = static_cast<fl::u16>(leds.size());
    fl::u8 keep = 255 - blur_amount;
    fl::u8 seep = blur_amount >> 1;
    CRGB carryover = CRGB::Black;
    for (fl::u16 i = 0; i < numLeds; ++i) {
        CRGB cur = leds[i];
        CRGB part = cur;
        part.nscale8(seep);
        cur.nscale8(keep);
        cur += carryover;
        if (i)
            leds[i - 1] += part;
        leds[i] = cur;
        carryover = part;
    }
}

References fl::CRGB::Black, fl::blur_amount, fl::cur, leds, and fl::CRGB::nscale8().

Referenced by fl::blur1d(), fl::blur1d(), and blur1d().

Here is the call graph for this function:

Here is the caller graph for this function: