Web Analytics Made Easy - Statcounter
Skip to content

Class SBDPaletteQualitativeHCL#

ClassList > SBDPaletteQualitativeHCL

The SBDPaletteQualitativeHCL class is a class for the qualitative HCL (Hue-Chroma-Luminance) color palette.More...

  • #include <SBDPaletteQualitativeHCL.hpp>

Inherits the following classes: SBDPaletteQualitative

Public Types inherited from SBDPalette#

See SBDPalette

Type Name
enum PaletteType

Public Functions#

Type Name
SBDPaletteQualitativeHCL ()
Default constructor.
SBDPaletteQualitativeHCL (int hue1, int hue2, int chroma=50, int luminance=70, std::string name=std::string(""), bool reverse=false)
SBDPaletteQualitativeHCL (const SBDPaletteQualitativeHCL & otherColorPalette)
Copy constructor.
virtual SBDPaletteQualitativeHCL * clone () override const
Clones the color palette.
virtual void getColor (float * color, float value) override const
Computes sRGB color color based on this palette for the given intensity valuevalue which should be in the range [0.0, 1.0].
virtual void getColorInPaletteColorSpace (float * color, float value) override const
Computes color coordinates color in this palette's color space for the given intensity valuevalue which should be in the range [0.0, 1.0].
virtual bool isSerializable () override const
Returns true.
virtual void serialize (SBCSerializer * serializer, const SBVersionNumber & sdkVersionNumber=SB_SDK_VERSION_NUMBER, const SBVersionNumber & classVersionNumber=SBVersionNumber(1, 0, 0)) override const
Serializes the document.
virtual std::string toPythonCode () const
Returns the string representation of the object that can be used to reconstruct it in Python.
virtual void unserialize (SBCSerializer * serializer, const SBVersionNumber & sdkVersionNumber=SB_SDK_VERSION_NUMBER, const SBVersionNumber & classVersionNumber=SBVersionNumber(1, 0, 0)) override
Unserializes the document.
virtual ~SBDPaletteQualitativeHCL ()

Public Functions inherited from SBDPaletteQualitative#

See SBDPaletteQualitative

Type Name
SBDPaletteQualitative ()
Default constructor.
SBDPaletteQualitative (int hue1, int hue2, int chroma=50, int luminance=70, std::string name=std::string(""), bool reverse=false)
SBDPaletteQualitative (const SBDPaletteQualitative & otherColorPalette)
Copy constructor.
virtual SBDPaletteQualitative * clone () override const
Clones the color palette.
int getChroma () const
Returns the value for the second coordinate.
virtual void getColor (float * color, float value) override const
Computes sRGB color color based on this palette for the given intensity valuevalue which should be in the range [0.0, 1.0].
virtual void getColorInPaletteColorSpace (float * color, float value) override const
Computes color coordinates color in this palette's color space for the given intensity valuevalue which should be in the range [0.0, 1.0].
int getHue1 () const
Returns the starting value for the first coordinate.
int getHue2 () const
Returns the end value for the first coordinate.
int getLuminance () const
Returns the value for the third coordinate.
virtual PaletteType getType () override const
Returns the type of the color palette.
virtual bool isEqual (const SBDPalette & other) override const
Returns whether this palette is equal to other .
virtual bool isSerializable () override const
Returns true.
virtual void serialize (SBCSerializer * serializer, const SBVersionNumber & sdkVersionNumber=SB_SDK_VERSION_NUMBER, const SBVersionNumber & classVersionNumber=SBVersionNumber(1, 0, 0)) override const
Serializes the document.
void setChroma (int chroma)
Sets the value for the second coordinate.
void setHue (int hue1, int hue2)
Sets the parameters for the first coordinate.
void setHue1 (int hue1)
Sets the starting value for the first coordinate.
void setHue2 (int hue2)
Sets the end value for the first coordinate.
void setLuminance (int luminance)
Sets the value for the third coordinate.
virtual std::string toPythonCode () const
Returns the string representation of the object that can be used to reconstruct it in Python.
virtual void unserialize (SBCSerializer * serializer, const SBVersionNumber & sdkVersionNumber=SB_SDK_VERSION_NUMBER, const SBVersionNumber & classVersionNumber=SBVersionNumber(1, 0, 0)) override
Unserializes the document.
virtual ~SBDPaletteQualitative ()

Public Functions inherited from SBDPalette#

See SBDPalette

Type Name
SBDPalette ()
Default constructor for HSV color palette.
SBDPalette (bool reverse)
Constructor for HSV color palette with reverse flag.
virtual SBDPalette * clone () const
Clones the palette.
SBColor getColor (float value) const
Returns SBColor based on the palette and an intensity value value .
virtual void getColor (float * color, float value) const
Computes RGB color color based on the palette and an intensity valuevalue which should be in the range [0.0, 1.0].
virtual void getColorInPaletteColorSpace (float * color, float value) const
Computes color coordinates color in this palette's color space for the given intensity valuevalue which should be in the range [0.0, 1.0].
const std::string & getName () const
Returns the palette's name.
bool getReverseFlag () const
Returns the reverse flag - whether the color palette is mirrored or not.
virtual PaletteType getType () const
Returns the type of the color palette.
std::string getTypeString (bool humanReadable=false) const
Returns the string representation of the color palette type.
virtual bool isEqual (const SBDPalette & other) const
Returns whether this palette is equal to other .
virtual bool isSerializable () const
Returns true.
bool operator!= (const SBDPalette & other) const
Non-equality operator.
bool operator== (const SBDPalette & other) const
Equality operator.
virtual void serialize (SBCSerializer * serializer, const SBVersionNumber & sdkVersionNumber=SB_SDK_VERSION_NUMBER, const SBVersionNumber & classVersionNumber=SBVersionNumber(1, 0, 0)) const
Serializes the document.
void setName (const std::string & name)
Sets the palette's name to name .
void setReverseFlag (bool b)
Sets the reverse flag - whether to mirror or not the color palette.
virtual std::string toPythonCode () const
Returns the string representation of the object that can be used to reconstruct it in Python.
virtual void unserialize (SBCSerializer * serializer, const SBVersionNumber & sdkVersionNumber=SB_SDK_VERSION_NUMBER, const SBVersionNumber & classVersionNumber=SBVersionNumber(1, 0, 0))
Unserializes the document.
virtual ~SBDPalette ()

Public Static Functions inherited from SBDPalette#

See SBDPalette

Type Name
std::string getTypeString (PaletteType paletteType, bool humanReadable=false)
Returns the string representation of the color palette type paletteType .
float getValueAlongLinearTrajectory (float y1, float y2, float power, float x)
Returns a value along the "linear" trajectory.
float getValueAlongTriangularTrajectory (float y1, float ymax, float y2, float power, float x)
Returns a value along "triangular" trajectory.

Protected Attributes inherited from SBDPaletteQualitative#

See SBDPaletteQualitative

Type Name
int chroma
The value of the second coordinate.
int hue1
The starting value for the first coordinate.
int hue2
The end value for the first coordinate.
int luminance
The value of the third coordinate.

Protected Attributes inherited from SBDPalette#

See SBDPalette

Type Name
std::string * name
The palette's name.
bool reverseFlag
Reverse flag: if true, then the palette is reversed/mirrored.

Detailed Description#

A qualitative HCL palette is constructed in a 3D color coordinate space with coordinates named Hue, Chroma, and Luminance, where the coordinate Hue can have an arbitrary value, and coordinates Chroma and Luminance are constant:

  • hue = hue1 + i * (hue2 - hue1), where i is a value (of intensity) based on which the colorization should be done.
  • chroma is constant
  • luminance is constant

Short name: SBPaletteQualitativeHCL

Public Functions Documentation#

function SBDPaletteQualitativeHCL [1/3]#

Default constructor. 

SBDPaletteQualitativeHCL::SBDPaletteQualitativeHCL ()

function SBDPaletteQualitativeHCL [2/3]#

SBDPaletteQualitativeHCL::SBDPaletteQualitativeHCL (
    int hue1,
    int hue2,
    int chroma=50,
    int luminance=70,
    std::string name=std::string(""),
    bool reverse=false
)

function SBDPaletteQualitativeHCL [3/3]#

Copy constructor. 

SBDPaletteQualitativeHCL::SBDPaletteQualitativeHCL (
    const SBDPaletteQualitativeHCL & otherColorPalette
)

function clone#

Clones the color palette. 

virtual SBDPaletteQualitativeHCL * SBDPaletteQualitativeHCL::clone () override const

Implements SBDPaletteQualitative::clone

function getColor#

Computes sRGB color color based on this palette for the given intensity valuevalue which should be in the range [0.0, 1.0]. 

virtual void SBDPaletteQualitativeHCL::getColor (
    float * color,
    float value
) override const

Implements SBDPaletteQualitative::getColor

function getColorInPaletteColorSpace#

Computes color coordinates color in this palette's color space for the given intensity valuevalue which should be in the range [0.0, 1.0]. 

virtual void SBDPaletteQualitativeHCL::getColorInPaletteColorSpace (
    float * color,
    float value
) override const

SBDPaletteQualitative::getColorInPaletteColorSpace - Computes color coordinates color in the HCL color space for the given intensity value value.

Parameters:

  • color - an array for color coordinates (with the size greater than or equal to 3) in the HCL color space.
  • value - an intensity value based on which the resulting color is computed, the intensity value should be in range [0.0, 1.0] where 1 corresponds to the full intensity.

Implements SBDPaletteQualitative::getColorInPaletteColorSpace

function isSerializable#

Returns true. 

virtual bool SBDPaletteQualitativeHCL::isSerializable () override const

Implements SBDPaletteQualitative::isSerializable

function serialize#

Serializes the document. 

virtual void SBDPaletteQualitativeHCL::serialize (
    SBCSerializer * serializer,
    const SBVersionNumber & sdkVersionNumber=SB_SDK_VERSION_NUMBER,
    const SBVersionNumber & classVersionNumber=SBVersionNumber (1, 0, 0)
) override const

Implements SBDPaletteQualitative::serialize

function toPythonCode#

Returns the string representation of the object that can be used to reconstruct it in Python. 

virtual std::string SBDPaletteQualitativeHCL::toPythonCode () const

Implements SBDPaletteQualitative::toPythonCode

function unserialize#

Unserializes the document. 

virtual void SBDPaletteQualitativeHCL::unserialize (
    SBCSerializer * serializer,
    const SBVersionNumber & sdkVersionNumber=SB_SDK_VERSION_NUMBER,
    const SBVersionNumber & classVersionNumber=SBVersionNumber (1, 0, 0)
) override

Implements SBDPaletteQualitative::unserialize

function ~SBDPaletteQualitativeHCL#

virtual SBDPaletteQualitativeHCL::~SBDPaletteQualitativeHCL ()