blur1d()

void fl::blur1d	(	CRGB *	leds,
		uint16_t	numLeds,
		fract8	blur_amount )

One-dimensional blur filter.

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	a pointer to the LED array to blur
numLeds	the number of LEDs to blur
blur_amount	the amount of blur to apply

Definition at line 54 of file blur.cpp.

                                                              {
    uint8_t keep = 255 - blur_amount;
    uint8_t seep = blur_amount >> 1;
    CRGB carryover = CRGB::Black;
    for (uint16_t 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 CRGB::Black, leds, and CRGB::nscale8().

Here is the call graph for this function: