15#include "five_bit_hd_gamma.h"
16#include "force_inline.h"
19#include "dither_mode.h"
20#include "pixel_iterator.h"
23FASTLED_NAMESPACE_BEGIN
32#define RO(X) RGB_BYTE(RGB_ORDER, X)
40#define RGB_BYTE(RO,X) (((RO)>>(3*(2-(X)))) & 0x3)
44#define RGB_BYTE0(RO) ((RO>>6) & 0x3)
47#define RGB_BYTE1(RO) ((RO>>3) & 0x3)
50#define RGB_BYTE2(RO) ((RO) & 0x3)
61template<EOrder RGB_ORDER,
int LANES=1, u
int32_t MASK=0xFFFFFFFF>
82 template<EOrder RGB_ORDER_OTHER>
87 template<
typename PixelControllerT>
88 void copy(
const PixelControllerT& other) {
99 for(
int i = 0; i < LANES; ++i) {
mOffsets[i] = other.mOffsets[i]; }
106 for(
int i = 0; i < LANES; ++i) {
108 if((1<<i) & MASK) { nOffset += (len *
mAdvance); }
120 const uint8_t *
d,
int len,
CRGB & pre_mixed,
121 EDitherMode
dither,
bool advance, uint8_t skip)
135 const CRGB *
d,
int len,
CRGB & pre_mixed,
157#if !defined(NO_DITHERING) || (NO_DITHERING != 1)
160#define MAX_LIKELY_UPDATE_RATE_HZ 400
163#define MIN_ACCEPTABLE_DITHER_RATE_HZ 50
166#define UPDATES_PER_FULL_DITHER_CYCLE (MAX_LIKELY_UPDATE_RATE_HZ / MIN_ACCEPTABLE_DITHER_RATE_HZ)
181#define RECOMMENDED_VIRTUAL_BITS ((UPDATES_PER_FULL_DITHER_CYCLE>1) + \
182 (UPDATES_PER_FULL_DITHER_CYCLE>2) + \
183 (UPDATES_PER_FULL_DITHER_CYCLE>4) + \
184 (UPDATES_PER_FULL_DITHER_CYCLE>8) + \
185 (UPDATES_PER_FULL_DITHER_CYCLE>16) + \
186 (UPDATES_PER_FULL_DITHER_CYCLE>32) + \
187 (UPDATES_PER_FULL_DITHER_CYCLE>64) + \
188 (UPDATES_PER_FULL_DITHER_CYCLE>128) )
191#define VIRTUAL_BITS RECOMMENDED_VIRTUAL_BITS
198#if !defined(NO_DITHERING) || (NO_DITHERING != 1)
200 static uint8_t R = 0;
205 uint8_t ditherBits = VIRTUAL_BITS;
206 R &= (0x01 << ditherBits) - 1;
215 if(R & 0x01) { Q |= 0x80; }
216 if(R & 0x02) { Q |= 0x40; }
217 if(R & 0x04) { Q |= 0x20; }
218 if(R & 0x08) { Q |= 0x10; }
219 if(R & 0x10) { Q |= 0x08; }
220 if(R & 0x20) { Q |= 0x04; }
221 if(R & 0x40) { Q |= 0x02; }
222 if(R & 0x80) { Q |= 0x01; }
229 if( ditherBits < 8) {
230 Q += 0x01 << (7 - ditherBits);
238 for(
int i = 0; i < 3; ++i) {
240 e[i] = s ? (256/s) + 1 : 0;
242#if (FASTLED_SCALE8_FIXED == 1)
253 FASTLED_FORCE_INLINE
bool has(
int n) {
265 default:
d[0]=
d[1]=
d[2]=
e[0]=
e[1]=
e[2]=0;
break;
275 FASTLED_FORCE_INLINE
int lanes() {
return LANES; }
296 d[RO(0)] =
e[RO(0)] -
d[RO(0)];
442 FASTLED_FORCE_INLINE
void loadAndScale_APA102_HD(uint8_t *b0_out, uint8_t *b1_out,
444 uint8_t *brightness_out) {
446 uint8_t brightness = 0;
448 five_bit_hd_gamma_bitshift(
453 &rgb.
r, &rgb.
g, &rgb.
b, &brightness);
455 const uint8_t b0_index = RGB_BYTE0(RGB_ORDER);
456 const uint8_t b1_index = RGB_BYTE1(RGB_ORDER);
457 const uint8_t b2_index = RGB_BYTE2(RGB_ORDER);
458 *b0_out = rgb.
raw[b0_index];
459 *b1_out = rgb.
raw[b1_index];
460 *b2_out = rgb.
raw[b2_index];
461 *brightness_out = brightness;
464 FASTLED_FORCE_INLINE
void loadAndScaleRGB(uint8_t *b0_out, uint8_t *b1_out,
471 FASTLED_FORCE_INLINE
void loadAndScaleRGBW(
Rgbw rgbw, uint8_t *b0_out, uint8_t *b1_out,
472 uint8_t *b2_out, uint8_t *b3_out) {
482 EOrderW w_placement = rgbw.w_placement;
484 rgbw_partial_reorder(
485 w_placement, out[0], out[1], out[2],
487 b0_out, b1_out, b2_out, b3_out);
489 const uint8_t b0_index = RGB_BYTE0(RGB_ORDER);
490 const uint8_t b1_index = RGB_BYTE1(RGB_ORDER);
491 const uint8_t b2_index = RGB_BYTE2(RGB_ORDER);
495 rgb_2_rgbw(rgbw.rgbw_mode,
496 rgbw.white_color_temp,
499 &rgb.
r, &rgb.
g, &rgb.
b, &w);
501 rgbw_partial_reorder(
507 b0_out, b1_out, b2_out, b3_out);
central include file for FastLED, defines the CFastLED class/object
LIB8STATIC_ALWAYS_INLINE uint8_t qadd8(uint8_t i, uint8_t j)
Add one byte to another, saturating at 0xFF.
uint8_t raw[3]
Access the red, green, and blue data as an array.
uint8_t r
Red channel value.
uint8_t g
Green channel value.
uint8_t b
Blue channel value.
LIB8STATIC_ALWAYS_INLINE uint8_t scale8(uint8_t i, fract8 scale)
Scale one byte by a second one, which is treated as the numerator of a fraction whose denominator is ...
Representation of an RGB pixel (Red, Green, Blue)
FASTLED_FORCE_INLINE uint8_t loadAndScale0(int lane)
non-template alias of loadAndScale<0>()
static FASTLED_FORCE_INLINE uint8_t scale(PixelController &pc, uint8_t b)
Scale a value using the per-channel scale data.
FASTLED_FORCE_INLINE uint8_t stepAdvanceAndLoadAndScale0()
stepDithering() and advanceAndLoadAndScale0()
int8_t mAdvance
how many bytes to advance the pointer by each time. For CRGB this is 3.
FASTLED_FORCE_INLINE uint8_t loadAndScale1(int lane, uint8_t scale)
non-template alias of loadAndScale<1>()
FASTLED_FORCE_INLINE uint8_t stepAdvanceAndLoadAndScale0(int lane)
stepDithering() and advanceAndLoadAndScale0()
static FASTLED_FORCE_INLINE uint8_t loadAndScale(PixelController &pc, int lane, uint8_t scale)
Loads and scales a single byte for a given output slot and lane.
void init_binary_dithering()
Set up the values for binary dithering.
FASTLED_FORCE_INLINE uint8_t loadAndScale1(int lane)
non-template alias of loadAndScale<1>()
FASTLED_FORCE_INLINE uint8_t getScale0()
non-template alias of getscale<0>()
int mLenRemaining
counter for the number of LEDs left to process
FASTLED_FORCE_INLINE uint8_t loadAndScale2(int lane, uint8_t scale)
non-template alias of loadAndScale<2>()
void initOffsets(int len)
Initialize the PixelController::mOffsets array based on the length of the strip.
FASTLED_FORCE_INLINE void preStepFirstByteDithering()
Some chipsets pre-cycle the first byte, which means we want to cycle byte 0's dithering separately.
FASTLED_FORCE_INLINE uint8_t loadAndScale2(int lane)
non-template alias of loadAndScale<2>()
FASTLED_FORCE_INLINE uint8_t loadAndScale0(int lane, uint8_t scale)
non-template alias of loadAndScale<0>()
FASTLED_FORCE_INLINE uint8_t loadAndScale0()
non-template alias of loadAndScale<0>()
FASTLED_FORCE_INLINE int advanceBy()
Get the amount to advance the pointer by.
const uint8_t * mData
pointer to the underlying LED data
static FASTLED_FORCE_INLINE uint8_t loadAndScale(PixelController &pc)
Loads, dithers, and scales a single byte for a given output slot, using class dither and scale values...
uint8_t d[3]
values for the scaled dither signal
FASTLED_FORCE_INLINE int lanes()
Get the number of lanes of the Controller.
int mOffsets[LANES]
the number of bytes to offset each lane from the starting pointer
FASTLED_FORCE_INLINE uint8_t advanceAndLoadAndScale0(int lane, uint8_t scale)
non-template alias of advanceAndLoadAndScale<0>()
FASTLED_FORCE_INLINE uint8_t getScale2()
non-template alias of getscale<2>()
static FASTLED_FORCE_INLINE uint8_t advanceAndLoadAndScale(PixelController &pc)
A version of loadAndScale() that advances the output data pointer.
int mLen
number of LEDs in the data for one lane
static FASTLED_FORCE_INLINE uint8_t loadAndScale(PixelController &pc, int lane)
Loads, dithers, and scales a single byte for a given output slot and lane, using class dither and sca...
static FASTLED_FORCE_INLINE uint8_t loadByte(PixelController &pc)
Read a byte of LED data.
static FASTLED_FORCE_INLINE uint8_t advanceAndLoadAndScale(PixelController &pc, int lane, uint8_t scale)
A version of loadAndScale() that advances the output data pointer without dithering.
static FASTLED_FORCE_INLINE uint8_t loadAndScale(PixelController &pc, int lane, uint8_t d, uint8_t scale)
Loads, dithers, and scales a single byte for a given output slot and lane.
FASTLED_FORCE_INLINE int size()
Get the length of the LED strip.
static FASTLED_FORCE_INLINE uint8_t getd(PixelController &pc)
Gets the dithering data for the provided output slot.
FASTLED_FORCE_INLINE uint8_t advanceAndLoadAndScale0(int lane)
non-template alias of advanceAndLoadAndScale<0>()
uint8_t e[3]
values for the scaled dither signal
CRGB mScale
the per-channel scale values, provided by a color correction function such as CLEDController::compute...
static FASTLED_FORCE_INLINE uint8_t getscale(PixelController &pc)
Gets the scale data for the provided output slot.
static FASTLED_FORCE_INLINE uint8_t dither(PixelController &, uint8_t b, uint8_t d)
Calculate a dither value.
static FASTLED_FORCE_INLINE uint8_t dither(PixelController &pc, uint8_t b)
Calculate a dither value using the per-channel dither data.
FASTLED_FORCE_INLINE uint8_t advanceAndLoadAndScale0()
non-template alias of advanceAndLoadAndScale<0>()
void enable_dithering(EDitherMode dither)
Toggle dithering enable If dithering is set to enabled, this will re-init the dithering values (init_...
PixelController(const CRGB &d, int len, CRGB &pre_mixed, EDitherMode dither)
Constructor.
static FASTLED_FORCE_INLINE uint8_t scale(PixelController &, uint8_t b, uint8_t scale)
Scale a value.
FASTLED_FORCE_INLINE void advanceData()
Advance the data pointer forward, adjust position counter.
FASTLED_FORCE_INLINE bool has(int n)
Do we have n pixels left to process?
FASTLED_FORCE_INLINE void stepDithering()
Step the dithering forward.
FASTLED_FORCE_INLINE uint8_t stepAdvanceAndLoadAndScale0(int lane, uint8_t scale)
stepDithering() and advanceAndLoadAndScale0()
PixelController(const uint8_t *d, int len, CRGB &pre_mixed, EDitherMode dither, bool advance, uint8_t skip)
Constructor.
PixelController(const PixelController &other)
Copy constructor.
FASTLED_FORCE_INLINE uint8_t loadAndScale1()
non-template alias of loadAndScale<1>()
static FASTLED_FORCE_INLINE uint8_t advanceAndLoadAndScale(PixelController &pc, int lane)
A version of loadAndScale() that advances the output data pointer.
FASTLED_FORCE_INLINE uint8_t getScale1()
non-template alias of getscale<1>()
static FASTLED_FORCE_INLINE uint8_t loadByte(PixelController &pc, int lane)
Read a byte of LED data for parallel output.
FASTLED_FORCE_INLINE uint8_t loadAndScale2()
non-template alias of loadAndScale<2>()
PixelController(const CRGB *d, int len, CRGB &pre_mixed, EDitherMode dither)
Constructor.