Detailed Description

Functions for filling LED arrays with colors and gradients.

Macros
#define	saccum87 int16_t
	ANSI: signed short _Accum.

#define	fill_gradient_HSV fill_gradient
	Convenience synonym.

Enumerations
enum	TGradientDirectionCode { FORWARD_HUES , BACKWARD_HUES , SHORTEST_HUES , LONGEST_HUES }
	Hue direction for calculating fill gradients. More...

Functions
void	fill_solid (struct CRGB *targetArray, int numToFill, const struct CRGB &color)
	Fill a range of LEDs with a solid color.

void	fill_solid (struct CHSV *targetArray, int numToFill, const struct CHSV &color)
	Fill a range of LEDs with a solid color.

void	fill_rainbow (struct CRGB *targetArray, int numToFill, uint8_t initialhue, uint8_t deltahue=5)
	Fill a range of LEDs with a rainbow of colors.

void	fill_rainbow (struct CHSV *targetArray, int numToFill, uint8_t initialhue, uint8_t deltahue=5)
	Fill a range of LEDs with a rainbow of colors.

void	fill_rainbow_circular (struct CRGB *targetArray, int numToFill, uint8_t initialhue, bool reversed=false)
	Fill a range of LEDs with a rainbow of colors, so that the hues are continuous between the end of the strip and the beginning.

void	fill_rainbow_circular (struct CHSV *targetArray, int numToFill, uint8_t initialhue, bool reversed=false)
	Fill a range of LEDs with a rainbow of colors, so that the hues are continuous between the end of the strip and the beginning.

template<typename T >
void	fill_gradient (T *targetArray, uint16_t startpos, CHSV startcolor, uint16_t endpos, CHSV endcolor, TGradientDirectionCode directionCode=SHORTEST_HUES)
	Fill a range of LEDs with a smooth HSV gradient between two HSV colors.

template<typename T >
void	fill_gradient (T *targetArray, uint16_t numLeds, const CHSV &c1, const CHSV &c2, TGradientDirectionCode directionCode=SHORTEST_HUES)
	Fill a range of LEDs with a smooth HSV gradient between two HSV colors.

template<typename T >
void	fill_gradient (T *targetArray, uint16_t numLeds, const CHSV &c1, const CHSV &c2, const CHSV &c3, TGradientDirectionCode directionCode=SHORTEST_HUES)
	Fill a range of LEDs with a smooth HSV gradient between three HSV colors.

template<typename T >
void	fill_gradient (T *targetArray, uint16_t numLeds, const CHSV &c1, const CHSV &c2, const CHSV &c3, const CHSV &c4, TGradientDirectionCode directionCode=SHORTEST_HUES)
	Fill a range of LEDs with a smooth HSV gradient between four HSV colors.

void	fill_gradient_RGB (CRGB *leds, uint16_t startpos, CRGB startcolor, uint16_t endpos, CRGB endcolor)
	Fill a range of LEDs with a smooth RGB gradient between two RGB colors.

void	fill_gradient_RGB (CRGB *leds, uint16_t numLeds, const CRGB &c1, const CRGB &c2)
	Fill a range of LEDs with a smooth RGB gradient between two RGB colors.

void	fill_gradient_RGB (CRGB *leds, uint16_t numLeds, const CRGB &c1, const CRGB &c2, const CRGB &c3)
	Fill a range of LEDs with a smooth RGB gradient between three RGB colors.

void	fill_gradient_RGB (CRGB *leds, uint16_t numLeds, const CRGB &c1, const CRGB &c2, const CRGB &c3, const CRGB &c4)
	Fill a range of LEDs with a smooth RGB gradient between four RGB colors.

CRGB	HeatColor (uint8_t temperature)
	Approximates a "black body radiation" spectrum for a given "heat" level.

Macro Definition Documentation

◆ fill_gradient_HSV

#define fill_gradient_HSV fill_gradient

Convenience synonym.

Definition at line 241 of file colorutils.h.

◆ saccum87

#define saccum87 int16_t

ANSI: signed short _Accum.

8 bits int, 7 bits fraction

See also: accum88

Definition at line 79 of file colorutils.h.

Enumeration Type Documentation

◆ TGradientDirectionCode

enum TGradientDirectionCode

Hue direction for calculating fill gradients.

Since "hue" is a value around a color wheel, there are always two directions to sweep from one hue to another.

Enumerator
FORWARD_HUES	Hue always goes clockwise around the color wheel.
BACKWARD_HUES	Hue always goes counter-clockwise around the color wheel.
SHORTEST_HUES	Hue goes whichever way is shortest.
LONGEST_HUES	Hue goes whichever way is longest.

Definition at line 69 of file colorutils.h.

Function Documentation

◆ fill_gradient() [1/4]

template<typename T >

void fill_gradient	(	T *	targetArray,
		uint16_t	numLeds,
		const CHSV &	c1,
		const CHSV &	c2,
		const CHSV &	c3,
		const CHSV &	c4,
		TGradientDirectionCode	directionCode = `SHORTEST_HUES`
	)

Fill a range of LEDs with a smooth HSV gradient between four HSV colors.

See also: fill_gradient()

Parameters

targetArray	a pointer to the color array to fill
numLeds	the number of LEDs to fill
c1	the starting color in the gradient
c2	the first middle color for the gradient
c3	the second middle color for the gradient
c4	the end color for the gradient
directionCode	the direction to travel around the color wheel

Definition at line 228 of file colorutils.h.

◆ fill_gradient() [2/4]

template<typename T >

void fill_gradient	(	T *	targetArray,
		uint16_t	numLeds,
		const CHSV &	c1,
		const CHSV &	c2,
		const CHSV &	c3,
		TGradientDirectionCode	directionCode = `SHORTEST_HUES`
	)

Fill a range of LEDs with a smooth HSV gradient between three HSV colors.

See also: fill_gradient()

Parameters

targetArray	a pointer to the color array to fill
numLeds	the number of LEDs to fill
c1	the starting color in the gradient
c2	the middle color for the gradient
c3	the end color for the gradient
directionCode	the direction to travel around the color wheel

Definition at line 208 of file colorutils.h.

◆ fill_gradient() [3/4]

template<typename T >

void fill_gradient	(	T *	targetArray,
		uint16_t	numLeds,
		const CHSV &	c1,
		const CHSV &	c2,
		TGradientDirectionCode	directionCode = `SHORTEST_HUES`
	)

Fill a range of LEDs with a smooth HSV gradient between two HSV colors.

See also: fill_gradient()

Parameters

targetArray	a pointer to the color array to fill
numLeds	the number of LEDs to fill
c1	the starting color in the gradient
c2	the end color for the gradient
directionCode	the direction to travel around the color wheel

Definition at line 192 of file colorutils.h.

◆ fill_gradient() [4/4]

template<typename T >

void fill_gradient	(	T *	targetArray,
		uint16_t	startpos,
		CHSV	startcolor,
		uint16_t	endpos,
		CHSV	endcolor,
		TGradientDirectionCode	directionCode = `SHORTEST_HUES`
	)

Fill a range of LEDs with a smooth HSV gradient between two HSV colors.

This function can write the gradient colors either:

Into an array of CRGBs (e.g., an leds[] array, or a CRGB palette)
Into an array of CHSVs (e.g. a CHSV palette).

In the case of writing into a CRGB array, the gradient is computed in HSV space, and then HSV values are converted to RGB as they're written into the CRGB array.

Parameters

targetArray	a pointer to the color array to fill
startpos	the starting position in the array
startcolor	the starting color for the gradient
endpos	the ending position in the array
endcolor	the end color for the gradient
directionCode	the direction to travel around the color wheel

Definition at line 98 of file colorutils.h.

◆ fill_gradient_RGB() [1/4]

void fill_gradient_RGB	(	CRGB *	leds,
		uint16_t	numLeds,
		const CRGB &	c1,
		const CRGB &	c2
	)

Fill a range of LEDs with a smooth RGB gradient between two RGB colors.

See also: fill_gradient_RGB()

Parameters

leds	a pointer to the LED array to fill
numLeds	the number of LEDs to fill
c1	the starting color in the gradient
c2	the end color for the gradient

Definition at line 188 of file colorutils.cpp.

◆ fill_gradient_RGB() [2/4]

void fill_gradient_RGB	(	CRGB *	leds,
		uint16_t	numLeds,
		const CRGB &	c1,
		const CRGB &	c2,
		const CRGB &	c3
	)

Fill a range of LEDs with a smooth RGB gradient between three RGB colors.

See also: fill_gradient_RGB()

Parameters

leds	a pointer to the LED array to fill
numLeds	the number of LEDs to fill
c1	the starting color in the gradient
c2	the middle color for the gradient
c3	the end color for the gradient

Definition at line 195 of file colorutils.cpp.

◆ fill_gradient_RGB() [3/4]

void fill_gradient_RGB	(	CRGB *	leds,
		uint16_t	numLeds,
		const CRGB &	c1,
		const CRGB &	c2,
		const CRGB &	c3,
		const CRGB &	c4
	)

Fill a range of LEDs with a smooth RGB gradient between four RGB colors.

See also: fill_gradient_RGB()

Parameters

leds	a pointer to the LED array to fill
numLeds	the number of LEDs to fill
c1	the starting color in the gradient
c2	the first middle color for the gradient
c3	the second middle color for the gradient
c4	the end color for the gradient

Definition at line 203 of file colorutils.cpp.

◆ fill_gradient_RGB() [4/4]

void fill_gradient_RGB	(	CRGB *	leds,
		uint16_t	startpos,
		CRGB	startcolor,
		uint16_t	endpos,
		CRGB	endcolor
	)

Fill a range of LEDs with a smooth RGB gradient between two RGB colors.

Unlike HSV, there is no "color wheel" in RGB space, and therefore there's only one "direction" for the gradient to go. This means there's no TGradientDirectionCode parameter for direction.

Parameters

leds	a pointer to the LED array to fill
startpos	the starting position in the array
startcolor	the starting color for the gradient
endpos	the ending position in the array
endcolor	the end color for the gradient

Definition at line 109 of file colorutils.cpp.

◆ fill_rainbow() [1/2]

void fill_rainbow	(	struct CHSV *	targetArray,
		int	numToFill,
		uint8_t	initialhue,
		uint8_t	deltahue = `5`
	)

Fill a range of LEDs with a rainbow of colors.

The colors making up the rainbow are at full saturation and full value (brightness).

Parameters

targetArray	a pointer to the LED array to fill
numToFill	the number of LEDs to fill in the array
initialhue	the starting hue for the rainbow
deltahue	how many hue values to advance for each LED

Definition at line 53 of file colorutils.cpp.

◆ fill_rainbow() [2/2]

void fill_rainbow	(	struct CRGB *	targetArray,
		int	numToFill,
		uint8_t	initialhue,
		uint8_t	deltahue = `5`
	)

Fill a range of LEDs with a rainbow of colors.

The colors making up the rainbow are at full saturation and full value (brightness).

Parameters

targetArray	a pointer to the LED array to fill
numToFill	the number of LEDs to fill in the array
initialhue	the starting hue for the rainbow
deltahue	how many hue values to advance for each LED

Definition at line 39 of file colorutils.cpp.

◆ fill_rainbow_circular() [1/2]

void fill_rainbow_circular	(	struct CHSV *	targetArray,
		int	numToFill,
		uint8_t	initialhue,
		bool	reversed = `false`
	)

Fill a range of LEDs with a rainbow of colors, so that the hues are continuous between the end of the strip and the beginning.

The colors making up the rainbow are at full saturation and full value (brightness).

Parameters

targetArray	a pointer to the LED array to fill
numToFill	the number of LEDs to fill in the array
initialhue	the starting hue for the rainbow
reversed	whether to progress through the rainbow hues backwards

Definition at line 88 of file colorutils.cpp.

◆ fill_rainbow_circular() [2/2]

void fill_rainbow_circular	(	struct CRGB *	targetArray,
		int	numToFill,
		uint8_t	initialhue,
		bool	reversed = `false`
	)

Fill a range of LEDs with a rainbow of colors, so that the hues are continuous between the end of the strip and the beginning.

The colors making up the rainbow are at full saturation and full value (brightness).

Parameters

targetArray	a pointer to the LED array to fill
numToFill	the number of LEDs to fill in the array
initialhue	the starting hue for the rainbow
reversed	whether to progress through the rainbow hues backwards

Definition at line 68 of file colorutils.cpp.

◆ fill_solid() [1/2]

void fill_solid	(	struct CHSV *	targetArray,
		int	numToFill,
		const struct CHSV &	color
	)

Fill a range of LEDs with a solid color.

Parameters

targetArray	a pointer to the LED array to fill
numToFill	the number of LEDs to fill in the array
color	the color to fill with

Definition at line 24 of file colorutils.cpp.

◆ fill_solid() [2/2]

void fill_solid	(	struct CRGB *	targetArray,
		int	numToFill,
		const struct CRGB &	color
	)

Fill a range of LEDs with a solid color.

Parameters

targetArray	a pointer to the LED array to fill
numToFill	the number of LEDs to fill in the array
color	the color to fill with

Definition at line 16 of file colorutils.cpp.

◆ HeatColor()

CRGB HeatColor ( uint8_t temperature )

Approximates a "black body radiation" spectrum for a given "heat" level.

This is useful for animations of "fire". Heat is specified as an arbitrary scale from 0 (cool) to 255 (hot). This is NOT a chromatically correct "black body radiation" spectrum, but it's surprisingly close, and it's fast and small.

Definition at line 511 of file colorutils.cpp.

Detailed Description

Macros

Enumerations

Functions

Macro Definition Documentation

◆ fill_gradient_HSV

◆ saccum87

Enumeration Type Documentation

◆ TGradientDirectionCode

Function Documentation

◆ fill_gradient() [1/4]

◆ fill_gradient() [2/4]

◆ fill_gradient() [3/4]

◆ fill_gradient() [4/4]

◆ fill_gradient_RGB() [1/4]

◆ fill_gradient_RGB() [2/4]

◆ fill_gradient_RGB() [3/4]

◆ fill_gradient_RGB() [4/4]

◆ fill_rainbow() [1/2]

◆ fill_rainbow() [2/2]

◆ fill_rainbow_circular() [1/2]

◆ fill_rainbow_circular() [2/2]

◆ fill_solid() [1/2]

◆ fill_solid() [2/2]

◆ HeatColor()