Detailed Description

RGB color palette with 32 discrete values.

Definition at line 1429 of file colorutils.h.

#include <colorutils.h>

Public Member Functions
	CRGBPalette32 ()
	Default constructor.

	CRGBPalette32 (const CRGB &c00, const CRGB &c01, const CRGB &c02, const CRGB &c03, const CRGB &c04, const CRGB &c05, const CRGB &c06, const CRGB &c07, const CRGB &c08, const CRGB &c09, const CRGB &c10, const CRGB &c11, const CRGB &c12, const CRGB &c13, const CRGB &c14, const CRGB &c15)
	Create palette from 16 CRGB values.

	CRGBPalette32 (const CRGBPalette32 &rhs)
	Copy constructor.

	CRGBPalette32 (const CRGB rhs[32])
	Create palette from array of CRGB colors.

CRGBPalette32 &	operator= (const CRGBPalette32 &rhs)
	Copy constructor.

CRGBPalette32 &	operator= (const CRGB rhs[32])
	Create palette from array of CRGB colors.

	CRGBPalette32 (const CHSVPalette32 &rhs)
	Create palette from CHSV palette.

	CRGBPalette32 (const CHSV rhs[32])
	Create palette from array of CHSV colors.

CRGBPalette32 &	operator= (const CHSVPalette32 &rhs)
	Create palette from CHSV palette.

CRGBPalette32 &	operator= (const CHSV rhs[32])
	Create palette from array of CHSV colors.

	CRGBPalette32 (const TProgmemRGBPalette32 &rhs)
	Create palette from palette stored in PROGMEM.

CRGBPalette32 &	operator= (const TProgmemRGBPalette32 &rhs)
	Create palette from palette stored in PROGMEM.

bool	operator== (const CRGBPalette32 &rhs) const
	Check if two palettes have the same color entries.

bool	operator!= (const CRGBPalette32 &rhs) const
	Check if two palettes do not have the same color entries.

CRGB &	operator[] (uint8_t x)
	Array access operator to index into the gradient entries.

const CRGB &	operator[] (uint8_t x) const
	Array access operator to index into the gradient entries.

CRGB &	operator[] (int x)
	Array access operator to index into the gradient entries.

const CRGB &	operator[] (int x) const
	Array access operator to index into the gradient entries.

	operator CRGB * ()
	Get the underlying pointer to the CRGB entries making up the palette.

	CRGBPalette32 (const CHSV &c1)
	Create palette filled with one color.

	CRGBPalette32 (const CHSV &c1, const CHSV &c2)
	Create palette with a gradient from one color to another.

	CRGBPalette32 (const CHSV &c1, const CHSV &c2, const CHSV &c3)
	Create palette with three-color gradient.

	CRGBPalette32 (const CHSV &c1, const CHSV &c2, const CHSV &c3, const CHSV &c4)
	Create palette with four-color gradient.

	CRGBPalette32 (const CRGB &c1)
	Create palette filled with one color.

	CRGBPalette32 (const CRGB &c1, const CRGB &c2)
	Create palette with a gradient from one color to another.

	CRGBPalette32 (const CRGB &c1, const CRGB &c2, const CRGB &c3)
	Create palette with three-color gradient.

	CRGBPalette32 (const CRGB &c1, const CRGB &c2, const CRGB &c3, const CRGB &c4)
	Create palette with four-color gradient.

	CRGBPalette32 (const CRGBPalette16 &rhs16)
	Create upscaled palette from 16-entry palette.

CRGBPalette32 &	operator= (const CRGBPalette16 &rhs16)
	Create upscaled palette from 16-entry palette.

	CRGBPalette32 (const TProgmemRGBPalette16 &rhs)
	Create palette from palette stored in PROGMEM.

CRGBPalette32 &	operator= (const TProgmemRGBPalette16 &rhs)
	Create palette from palette stored in PROGMEM.

	CRGBPalette32 (TProgmemRGBGradientPalette_bytes progpal)
	Creates a palette from a gradient palette in PROGMEM.

CRGBPalette32 &	operator= (TProgmemRGBGradientPalette_bytes progpal)
	Creates a palette from a gradient palette in PROGMEM.

CRGBPalette32 &	loadDynamicGradientPalette (TDynamicRGBGradientPalette_bytes gpal)
	Creates a palette from a gradient palette in dynamic (heap) memory.

Public Attributes
CRGB	entries [32]
	the color entries that make up the palette

Constructor & Destructor Documentation

◆ CRGBPalette32() [1/18]

CRGBPalette32::CRGBPalette32 ( )

inline

Default constructor.

Warning: Default values are UNITIALIZED!

Definition at line 1434 of file colorutils.h.

◆ CRGBPalette32() [2/18]

CRGBPalette32::CRGBPalette32	(	const CRGB &	c00,
		const CRGB &	c01,
		const CRGB &	c02,
		const CRGB &	c03,
		const CRGB &	c04,
		const CRGB &	c05,
		const CRGB &	c06,
		const CRGB &	c07,
		const CRGB &	c08,
		const CRGB &	c09,
		const CRGB &	c10,
		const CRGB &	c11,
		const CRGB &	c12,
		const CRGB &	c13,
		const CRGB &	c14,
		const CRGB &	c15 )

inline

Create palette from 16 CRGB values.

Definition at line 1441 of file colorutils.h.

◆ CRGBPalette32() [3/18]

CRGBPalette32::CRGBPalette32 ( const CRGBPalette32 & rhs )

inline

Copy constructor.

Definition at line 1455 of file colorutils.h.

◆ CRGBPalette32() [4/18]

CRGBPalette32::CRGBPalette32 ( const CRGB rhs[32] )

inline

Create palette from array of CRGB colors.

Definition at line 1460 of file colorutils.h.

◆ CRGBPalette32() [5/18]

CRGBPalette32::CRGBPalette32 ( const CHSVPalette32 & rhs )

inline

Create palette from CHSV palette.

Definition at line 1478 of file colorutils.h.

◆ CRGBPalette32() [6/18]

CRGBPalette32::CRGBPalette32 ( const CHSV rhs[32] )

inline

Create palette from array of CHSV colors.

Definition at line 1485 of file colorutils.h.

◆ CRGBPalette32() [7/18]

CRGBPalette32::CRGBPalette32 ( const TProgmemRGBPalette32 & rhs )

inline

Create palette from palette stored in PROGMEM.

Definition at line 1509 of file colorutils.h.

◆ CRGBPalette32() [8/18]

CRGBPalette32::CRGBPalette32 ( const CHSV & c1 )

inline

Create palette filled with one color.

Parameters

c1	the color to fill the palette with

Definition at line 1572 of file colorutils.h.

◆ CRGBPalette32() [9/18]

CRGBPalette32::CRGBPalette32	(	const CHSV &	c1,
		const CHSV &	c2 )

inline

Create palette with a gradient from one color to another.

Parameters

c1	the starting color for the gradient
c2	the end color for the gradient

Definition at line 1577 of file colorutils.h.

◆ CRGBPalette32() [10/18]

CRGBPalette32::CRGBPalette32	(	const CHSV &	c1,
		const CHSV &	c2,
		const CHSV &	c3 )

inline

Create palette with three-color gradient.

Parameters

c1	the starting color for the gradient
c2	the middle color for the gradient
c3	the end color for the gradient

Definition at line 1582 of file colorutils.h.

◆ CRGBPalette32() [11/18]

CRGBPalette32::CRGBPalette32	(	const CHSV &	c1,
		const CHSV &	c2,
		const CHSV &	c3,
		const CHSV &	c4 )

inline

Create palette with four-color gradient.

Parameters

c1	the starting color for 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 1587 of file colorutils.h.

◆ CRGBPalette32() [12/18]

CRGBPalette32::CRGBPalette32 ( const CRGB & c1 )

inline

Create palette filled with one color.

Parameters

c1	the color to fill the palette with

Definition at line 1593 of file colorutils.h.

◆ CRGBPalette32() [13/18]

CRGBPalette32::CRGBPalette32	(	const CRGB &	c1,
		const CRGB &	c2 )

inline

Create palette with a gradient from one color to another.

Parameters

c1	the starting color for the gradient
c2	the end color for the gradient

Definition at line 1598 of file colorutils.h.

◆ CRGBPalette32() [14/18]

CRGBPalette32::CRGBPalette32	(	const CRGB &	c1,
		const CRGB &	c2,
		const CRGB &	c3 )

inline

Create palette with three-color gradient.

Parameters

c1	the starting color for the gradient
c2	the middle color for the gradient
c3	the end color for the gradient

Definition at line 1603 of file colorutils.h.

◆ CRGBPalette32() [15/18]

CRGBPalette32::CRGBPalette32	(	const CRGB &	c1,
		const CRGB &	c2,
		const CRGB &	c3,
		const CRGB &	c4 )

inline

Create palette with four-color gradient.

Parameters

c1	the starting color for 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 1608 of file colorutils.h.

◆ CRGBPalette32() [16/18]

CRGBPalette32::CRGBPalette32 ( const CRGBPalette16 & rhs16 )

inline

Create upscaled palette from 16-entry palette.

Definition at line 1615 of file colorutils.h.

◆ CRGBPalette32() [17/18]

CRGBPalette32::CRGBPalette32 ( const TProgmemRGBPalette16 & rhs )

inline

Create palette from palette stored in PROGMEM.

Definition at line 1627 of file colorutils.h.

◆ CRGBPalette32() [18/18]

CRGBPalette32::CRGBPalette32 ( TProgmemRGBGradientPalette_bytes progpal )

inline

Creates a palette from a gradient palette in PROGMEM.

Gradient palettes are loaded into CRGBPalettes in such a way that, if possible, every color represented in the gradient palette is also represented in the CRGBPalette.

For example, consider a gradient palette that is all black except for a single, one-element-wide (1/256th!) spike of red in the middle:

  0,   0,0,0
124,   0,0,0
125, 255,0,0  // one 1/256th-palette-wide red stripe
126,   0,0,0
255,   0,0,0

A naive conversion of this 256-element palette to a 16-element palette might accidentally completely eliminate the red spike, rendering the palette completely black.

However, the conversions provided here would attempt to include a the red stripe in the output, more-or-less as faithfully as possible. So in this case, the resulting CRGBPalette16 palette would have a red stripe in the middle which was 1/16th of a palette wide – the narrowest possible in a CRGBPalette16.

This means that the relative width of stripes in a CRGBPalette16 will be, by definition, different from the widths in the gradient palette. This code attempts to preserve "all the colors", rather than the exact stripe widths at the expense of dropping some colors.

Definition at line 1642 of file colorutils.h.

Member Function Documentation

◆ loadDynamicGradientPalette()

CRGBPalette32 & CRGBPalette32::loadDynamicGradientPalette ( TDynamicRGBGradientPalette_bytes gpal )

inline

Creates a palette from a gradient palette in dynamic (heap) memory.

Gradient palettes are loaded into CRGBPalettes in such a way that, if possible, every color represented in the gradient palette is also represented in the CRGBPalette.

For example, consider a gradient palette that is all black except for a single, one-element-wide (1/256th!) spike of red in the middle:

  0,   0,0,0
124,   0,0,0
125, 255,0,0  // one 1/256th-palette-wide red stripe
126,   0,0,0
255,   0,0,0

A naive conversion of this 256-element palette to a 16-element palette might accidentally completely eliminate the red spike, rendering the palette completely black.

However, the conversions provided here would attempt to include a the red stripe in the output, more-or-less as faithfully as possible. So in this case, the resulting CRGBPalette16 palette would have a red stripe in the middle which was 1/16th of a palette wide – the narrowest possible in a CRGBPalette16.

This means that the relative width of stripes in a CRGBPalette16 will be, by definition, different from the widths in the gradient palette. This code attempts to preserve "all the colors", rather than the exact stripe widths at the expense of dropping some colors.

Definition at line 1690 of file colorutils.h.

◆ operator CRGB *()

CRGBPalette32::operator CRGB * ( )

inline

Get the underlying pointer to the CRGB entries making up the palette.

Definition at line 1566 of file colorutils.h.

◆ operator!=()

bool CRGBPalette32::operator!= ( const CRGBPalette32 & rhs ) const

inline

Check if two palettes do not have the same color entries.

Definition at line 1538 of file colorutils.h.

◆ operator=() [1/8]

CRGBPalette32 & CRGBPalette32::operator= ( const CHSV rhs[32] )

inline

Create palette from array of CHSV colors.

Definition at line 1500 of file colorutils.h.

◆ operator=() [2/8]

CRGBPalette32 & CRGBPalette32::operator= ( const CHSVPalette32 & rhs )

inline

Create palette from CHSV palette.

Definition at line 1492 of file colorutils.h.

◆ operator=() [3/8]

CRGBPalette32 & CRGBPalette32::operator= ( const CRGB rhs[32] )

inline

Create palette from array of CRGB colors.

Definition at line 1471 of file colorutils.h.

◆ operator=() [4/8]

CRGBPalette32 & CRGBPalette32::operator= ( const CRGBPalette16 & rhs16 )

inline

Create upscaled palette from 16-entry palette.

Definition at line 1620 of file colorutils.h.

◆ operator=() [5/8]

CRGBPalette32 & CRGBPalette32::operator= ( const CRGBPalette32 & rhs )

inline

Copy constructor.

Definition at line 1465 of file colorutils.h.

◆ operator=() [6/8]

CRGBPalette32 & CRGBPalette32::operator= ( const TProgmemRGBPalette16 & rhs )

inline

Create palette from palette stored in PROGMEM.

Definition at line 1633 of file colorutils.h.

◆ operator=() [7/8]

CRGBPalette32 & CRGBPalette32::operator= ( const TProgmemRGBPalette32 & rhs )

inline

Create palette from palette stored in PROGMEM.

Definition at line 1516 of file colorutils.h.

◆ operator=() [8/8]

CRGBPalette32 & CRGBPalette32::operator= ( TProgmemRGBGradientPalette_bytes progpal )

inline

Creates a palette from a gradient palette in PROGMEM.

Gradient palettes are loaded into CRGBPalettes in such a way that, if possible, every color represented in the gradient palette is also represented in the CRGBPalette.

For example, consider a gradient palette that is all black except for a single, one-element-wide (1/256th!) spike of red in the middle:

  0,   0,0,0
124,   0,0,0
125, 255,0,0  // one 1/256th-palette-wide red stripe
126,   0,0,0
255,   0,0,0

A naive conversion of this 256-element palette to a 16-element palette might accidentally completely eliminate the red spike, rendering the palette completely black.

However, the conversions provided here would attempt to include a the red stripe in the output, more-or-less as faithfully as possible. So in this case, the resulting CRGBPalette16 palette would have a red stripe in the middle which was 1/16th of a palette wide – the narrowest possible in a CRGBPalette16.

This means that the relative width of stripes in a CRGBPalette16 will be, by definition, different from the widths in the gradient palette. This code attempts to preserve "all the colors", rather than the exact stripe widths at the expense of dropping some colors.

Definition at line 1647 of file colorutils.h.

◆ operator==()

bool CRGBPalette32::operator== ( const CRGBPalette32 & rhs ) const

inline

Check if two palettes have the same color entries.

Definition at line 1525 of file colorutils.h.

◆ operator[]() [1/4]

CRGB & CRGBPalette32::operator[] ( int x )

inline

Array access operator to index into the gradient entries.

Parameters

x	the index to retrieve

Returns: reference to an entry in the palette's color array

Note: This does not perform any interpolation like ColorFromPalette(), it accesses the underlying entries that make up the gradient. Beware of bounds issues!

Definition at line 1555 of file colorutils.h.

◆ operator[]() [2/4]

const CRGB & CRGBPalette32::operator[] ( int x ) const

inline

Array access operator to index into the gradient entries.

Parameters

x	the index to retrieve

Returns: reference to an entry in the palette's color array

Note: This does not perform any interpolation like ColorFromPalette(), it accesses the underlying entries that make up the gradient. Beware of bounds issues!

Definition at line 1560 of file colorutils.h.

◆ operator[]() [3/4]

CRGB & CRGBPalette32::operator[] ( uint8_t x )

inline

Array access operator to index into the gradient entries.

Parameters

x	the index to retrieve

Returns: reference to an entry in the palette's color array

Note: This does not perform any interpolation like ColorFromPalette(), it accesses the underlying entries that make up the gradient. Beware of bounds issues!

Definition at line 1544 of file colorutils.h.

◆ operator[]() [4/4]

const CRGB & CRGBPalette32::operator[] ( uint8_t x ) const

inline

Array access operator to index into the gradient entries.

Parameters

x	the index to retrieve

Returns: reference to an entry in the palette's color array

Note: This does not perform any interpolation like ColorFromPalette(), it accesses the underlying entries that make up the gradient. Beware of bounds issues!

Definition at line 1549 of file colorutils.h.

Member Data Documentation

◆ entries

CRGB CRGBPalette32::entries[32]

the color entries that make up the palette

Definition at line 1431 of file colorutils.h.

The documentation for this class was generated from the following file:

/home/runner/work/FastLED/FastLED/src/colorutils.h

Detailed Description

Public Member Functions

Public Attributes

Constructor & Destructor Documentation

◆ CRGBPalette32() [1/18]

◆ CRGBPalette32() [2/18]

◆ CRGBPalette32() [3/18]

◆ CRGBPalette32() [4/18]

◆ CRGBPalette32() [5/18]

◆ CRGBPalette32() [6/18]

◆ CRGBPalette32() [7/18]

◆ CRGBPalette32() [8/18]

◆ CRGBPalette32() [9/18]

◆ CRGBPalette32() [10/18]

◆ CRGBPalette32() [11/18]

◆ CRGBPalette32() [12/18]

◆ CRGBPalette32() [13/18]

◆ CRGBPalette32() [14/18]

◆ CRGBPalette32() [15/18]

◆ CRGBPalette32() [16/18]

◆ CRGBPalette32() [17/18]

◆ CRGBPalette32() [18/18]

Member Function Documentation

◆ loadDynamicGradientPalette()

◆ operator CRGB *()

◆ operator!=()

◆ operator=() [1/8]

◆ operator=() [2/8]

◆ operator=() [3/8]

◆ operator=() [4/8]

◆ operator=() [5/8]

◆ operator=() [6/8]

◆ operator=() [7/8]

◆ operator=() [8/8]

◆ operator==()

◆ operator[]() [1/4]

◆ operator[]() [2/4]

◆ operator[]() [3/4]

◆ operator[]() [4/4]

Member Data Documentation

◆ entries