Aim: This class template may be used to (linearly) convert scalar values in a given range into a color with given lightness. More...

#include <DGtal/io/colormaps/ColorBrightnessColorMap.h>

Public Types
typedef PValue	Value

Public Member Functions
	ColorBrightnessColorMap (const PValue &min, const PValue &max, const Color color=Color(DGTAL_RED_COMPONENT(PDefaultColor), DGTAL_GREEN_COMPONENT(PDefaultColor), DGTAL_BLUE_COMPONENT(PDefaultColor)))

Color	operator() (const PValue &value) const

	~ColorBrightnessColorMap ()

	ColorBrightnessColorMap (const ColorBrightnessColorMap &other)

ColorBrightnessColorMap &	operator= (const ColorBrightnessColorMap &other)

void	selfDisplay (std::ostream &out) const

bool	isValid () const

const PValue &	min () const

const PValue &	max () const

Static Public Member Functions
static Color	getColor (const Color color, const PValue &min, const PValue &max, const PValue &value)

Protected Member Functions
	ColorBrightnessColorMap ()

Protected Attributes
PValue	myMin

PValue	myMax

Color	myColor

Static Private Member Functions
static void	HSVtoRGB (double &r, double &g, double &b, double h, const double s, const double v)

static void	RGBtoHSV (double &h, double &s, double &v, const unsigned char r, const unsigned char g, const unsigned char b)

Detailed Description

template<typename PValue, int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>
class DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >

Aim: This class template may be used to (linearly) convert scalar values in a given range into a color with given lightness.

Description of template class 'ColorBrightnessColorMap'

The ColorBrightnessColorMap can be used either as a functor object (the value range is given at the object's construction, together with the reference color) which converts a value into a LibBoard::Color structure, or it can be used through a static method taking both the range and the value as parameters.

The code below shows a possible use of this class.

#include "DGtal/io/Color.h"
#include "ColorBrightnessColorMap.h"
// ...
{
  ColorBrightnessColorMap<float> blueShade(0.0f,1.0f,Color::Blue);
  Color red = blueShade(1.0f);
  Color blue1 = blueShade(0.5f);
  // Or, equivalently:
  Color blue2 = ColorBrightnessColorMap<float>::getColor(Color::Blue,0.0f,1.0f,0.5f);
}

Template Parameters

PValue	The type of the range values.
PDefaultColor	The default color as an integer built using the DGTAL_RGB2INT macro.

Definition at line 89 of file ColorBrightnessColorMap.h.

Member Typedef Documentation

◆ Value

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

typedef PValue DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::Value

Definition at line 93 of file ColorBrightnessColorMap.h.

Constructor & Destructor Documentation

◆ ColorBrightnessColorMap() [1/3]

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::ColorBrightnessColorMap	(	const PValue &	min,
		const PValue &	max,
		const Color	color = `Color(DGTAL_RED_COMPONENT(PDefaultColor), DGTAL_GREEN_COMPONENT(PDefaultColor), DGTAL_BLUE_COMPONENT(PDefaultColor))`
	)

Constructor.

Parameters

min	The lower bound of the value range.
max	The upper bound of the value range.
color	The color associated with the upper bound.

◆ ~ColorBrightnessColorMap()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::~ColorBrightnessColorMap ( )

Destructor.

◆ ColorBrightnessColorMap() [2/3]

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::ColorBrightnessColorMap ( const ColorBrightnessColorMap< PValue, PDefaultColor > & other )

Copy constructor.

Parameters

other the object to clone.

◆ ColorBrightnessColorMap() [3/3]

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::ColorBrightnessColorMap ( )

protected

Constructor. Forbidden by default (protected to avoid g++ warnings).

Member Function Documentation

◆ getColor()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

static Color DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::getColor	(	const Color	color,
		const PValue &	min,
		const PValue &	max,
		const PValue &	value
	)

static

Computes the color associated with a value in a given range.

Parameters

color	The color associated with the upper bound.
min	The lower bound of the value range.
max	The upper bound of the value range.
value	A value within the value range.

Returns: A color whose brightness linearly depends on the position of [value] within the range [min]..[max].

◆ HSVtoRGB()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

static void DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::HSVtoRGB	(	double &	r,
		double &	g,
		double &	b,
		double	h,
		const double	s,
		const double	v
	)

staticprivate

Converts a color from the HSV (Hue,Saturation,Value) space to the RGB space.

Parameters

r	The red component (out).
g	The green component (out).
b	The blue component (out).
h	The hue of the color in [0..360)
s	The saturation of the color in [0..1].
v	The value of the color in [0..1].

◆ isValid()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

bool DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::isValid ( ) const

Checks the validity/consistency of the object.

Returns: 'true' if the object is valid, 'false' otherwise.

◆ max()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

const PValue& DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::max ( ) const

Returns the upper bound of the value range.

Returns: The upper bound of the value range.

◆ min()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

const PValue& DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::min ( ) const

Returns the lower bound of the value range.

Returns: The lower bound of the value range.

◆ operator()()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

Color DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::operator() ( const PValue & value ) const

Computes the color associated with a value in a given range.

Parameters

value A value within the value range.

Returns: A color whose brightness linearly depends on the position of [value] within the current range.

◆ operator=()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

ColorBrightnessColorMap& DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::operator= ( const ColorBrightnessColorMap< PValue, PDefaultColor > & other )

Assignment.

Parameters

other the object to copy.

Returns: a reference on 'this'.

◆ RGBtoHSV()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

static void DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::RGBtoHSV	(	double &	h,
		double &	s,
		double &	v,
		const unsigned char	r,
		const unsigned char	g,
		const unsigned char	b
	)

staticprivate

Converts a color from the RGB space to the HSV (Hue,Saturation,Value) space.

Parameters

h	(out) The hue of the color in [0..360)
s	(out) The saturation of the color in [0..1].
v	(out) The value of the color in [0..1].
r	The red component.
g	The green component.
b	The blue component.

◆ selfDisplay()

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

void DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::selfDisplay ( std::ostream & out ) const

Writes/Displays the object on an output stream.

Parameters

out	the output stream where the object is written.

Field Documentation

◆ myColor

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

Color DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::myColor

protected

The color of the upper bound value.

Definition at line 197 of file ColorBrightnessColorMap.h.

◆ myMax

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

PValue DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::myMax

protected

The lower bound of the value range.

Definition at line 196 of file ColorBrightnessColorMap.h.

◆ myMin

template<typename PValue , int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>

PValue DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >::myMin

protected

The lower bound of the value range.

Definition at line 195 of file ColorBrightnessColorMap.h.

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

ColorBrightnessColorMap.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Private Member Functions

Detailed Description

template<typename PValue, int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )> class DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >

Member Typedef Documentation

◆ Value

Constructor & Destructor Documentation

◆ ColorBrightnessColorMap() [1/3]

◆ ~ColorBrightnessColorMap()

◆ ColorBrightnessColorMap() [2/3]

◆ ColorBrightnessColorMap() [3/3]

Member Function Documentation

◆ getColor()

◆ HSVtoRGB()

◆ isValid()

◆ max()

◆ min()

◆ operator()()

◆ operator=()

◆ RGBtoHSV()

◆ selfDisplay()

Field Documentation

◆ myColor

◆ myMax

◆ myMin

template<typename PValue, int PDefaultColor = DGTAL_RGB2INT( 255, 255, 255 )>
class DGtal::ColorBrightnessColorMap< PValue, PDefaultColor >