encodeAPA102_HD()

template<typename InputIterator, typename BrightnessIterator, typename OutputIterator>

void fl::encodeAPA102_HD	(	InputIterator	first,
		InputIterator	last,
		BrightnessIterator	brightness_first,
		OutputIterator	out )

Encode pixel data in APA102 format with per-LED brightness.

Template Parameters

InputIterator	Iterator yielding fl::array<u8, 3> (3 bytes in wire order)
BrightnessIterator	Iterator yielding uint8_t brightness values
OutputIterator	Output iterator accepting uint8_t

Parameters

first	Iterator to first pixel
last	Iterator past last pixel
brightness_first	Iterator to first brightness value (8-bit, 0-255)
out	Output iterator for encoded bytes

Note

Each LED has individual brightness (HD gamma mode)

APA102 uses BGR wire order: pixel[0]=Blue, pixel[1]=Green, pixel[2]=Red

Definition at line 86 of file apa102.h.

                                                                                          {
    // Start frame: 4 bytes of 0x00
    *out++ = 0x00;
    *out++ = 0x00;
    *out++ = 0x00;
    *out++ = 0x00;
 
    // LED data: brightness header + BGR (per-LED brightness, count as we go)
    size_t num_leds = 0;
    while (first != last) {
        const fl::array<u8, BYTES_PER_PIXEL_RGB>& pixel = *first;
        u8 brightness_8bit = *brightness_first;
        u8 brightness_5bit = mapBrightness8to5(brightness_8bit);
 
        *out++ = 0xE0 | brightness_5bit;
        *out++ = pixel[0];  // Index 0 (BGR order: Blue)
        *out++ = pixel[1];  // Index 1 (BGR order: Green)
        *out++ = pixel[2];  // Index 2 (BGR order: Red)
 
        ++first;
        ++brightness_first;
        ++num_leds;
    }
 
    // End frame: ⌈num_leds/32⌉ DWords of 0xFF
    size_t end_dwords = (num_leds / 32) + 1;
    for (size_t i = 0; i < end_dwords * 4; i++) {
        *out++ = 0xFF;
    }
}

References FL_NOEXCEPT, and mapBrightness8to5().

Referenced by fl::PixelIterator::writeAPA102().

Here is the call graph for this function:

Here is the caller graph for this function: