124 lines
4.6 KiB
C++
124 lines
4.6 KiB
C++
#ifndef COLORSYS_H
|
|
#define COLORSYS_H
|
|
|
|
// STL includes
|
|
#include <cstdint>
|
|
|
|
///
|
|
/// Color transformation to adjust the saturation and luminance of a RGB color value
|
|
///
|
|
class ColorSys
|
|
{
|
|
public:
|
|
///
|
|
/// Translates an RGB (red, green, blue) color to an HSL (hue, saturation, luminance) color
|
|
///
|
|
/// @param[in] red The red RGB-component
|
|
/// @param[in] green The green RGB-component
|
|
/// @param[in] blue The blue RGB-component
|
|
/// @param[out] hue The hue HSL-component
|
|
/// @param[out] saturation The saturation HSL-component
|
|
/// @param[out] luminance The luminance HSL-component
|
|
///
|
|
|
|
static void rgb2hsl(uint8_t red, uint8_t green, uint8_t blue, uint16_t & hue, float & saturation, float & luminance);
|
|
|
|
///
|
|
/// Translates an HSL (hue, saturation, luminance) color to an RGB (red, green, blue) color
|
|
///
|
|
/// @param[in] hue The hue HSL-component
|
|
/// @param[in] saturation The saturation HSL-component
|
|
/// @param[in] luminance The luminance HSL-component
|
|
/// @param[out] red The red RGB-component
|
|
/// @param[out] green The green RGB-component
|
|
/// @param[out] blue The blue RGB-component
|
|
///
|
|
|
|
static void hsl2rgb(uint16_t hue, float saturation, float luminance, uint8_t & red, uint8_t & green, uint8_t & blue);
|
|
///
|
|
/// Translates an RGB (red, green, blue) color to an HSV (hue, saturation, value) color
|
|
///
|
|
/// @param[in] red The red RGB-component
|
|
/// @param[in] green The green RGB-component
|
|
/// @param[in] blue The blue RGB-component
|
|
/// @param[out] hue The hue HSV-component
|
|
/// @param[out] saturation The saturation HSV-component
|
|
/// @param[out] value The value HSV-component
|
|
///
|
|
/// @note Integer version of the conversion are faster, but a little less accurate all values
|
|
/// are unsigned 8 bit values and scaled between 0 and 255 except for the hue which is a 16 bit
|
|
/// number and scaled between 0 and 360
|
|
///
|
|
static void rgb2hsv(uint8_t red, uint8_t green, uint8_t blue, uint16_t & hue, uint8_t & saturation, uint8_t & value);
|
|
|
|
///
|
|
/// Translates an HSV (hue, saturation, value) color to an RGB (red, green, blue) color
|
|
///
|
|
/// @param[in] hue The hue HSV-component
|
|
/// @param[in] saturation The saturation HSV-component
|
|
/// @param[in] value The value HSV-component
|
|
/// @param[out] red The red RGB-component
|
|
/// @param[out] green The green RGB-component
|
|
/// @param[out] blue The blue RGB-component
|
|
///
|
|
/// @note Integer version of the conversion are faster, but a little less accurate all values
|
|
/// are unsigned 8 bit values and scaled between 0 and 255 except for the hue which is a 16 bit
|
|
/// number and scaled between 0 and 360
|
|
///
|
|
static void hsv2rgb(uint16_t hue, uint8_t saturation, uint8_t value, uint8_t & red, uint8_t & green, uint8_t & blue);
|
|
|
|
///
|
|
/// Translates a YUV (luminance, chrominance, chrominance) color to an RGB (red, green, blue) color
|
|
///
|
|
/// @param[in] y The luminance YUV-component
|
|
/// @param[in] u The chrominance YUV-component
|
|
/// @param[in] v The chrominance YUV-component
|
|
/// @param[out] red The red RGB-component
|
|
/// @param[out] green The green RGB-component
|
|
/// @param[out] blue The blue RGB-component
|
|
static void yuv2rgb(uint8_t y, uint8_t u, uint8_t v, uint8_t & r, uint8_t & g, uint8_t & b);
|
|
|
|
///
|
|
/// Translates an RGB (red, green, blue) color to an Okhsv (hue, saturation, value) color
|
|
///
|
|
/// @param[in] red The red RGB-component
|
|
/// @param[in] green The green RGB-component
|
|
/// @param[in] blue The blue RGB-component
|
|
/// @param[out] hue The hue Okhsv-component
|
|
/// @param[out] saturation The saturation Okhsv-component
|
|
/// @param[out] value The value Okhsv-component
|
|
///
|
|
/// @note See https://bottosson.github.io/posts/colorpicker/#okhsv
|
|
///
|
|
static void rgb2okhsv(uint8_t red, uint8_t green, uint8_t blue, double & hue, double & saturation, double & value);
|
|
|
|
///
|
|
/// Translates an Okhsv (hue, saturation, value) color to an RGB (red, green, blue) color
|
|
///
|
|
/// @param[in] hue The hue Okhsv-component
|
|
/// @param[in] saturation The saturation Okhsv-component
|
|
/// @param[in] value The value Okhsv-component
|
|
/// @param[out] red The red RGB-component
|
|
/// @param[out] green The green RGB-component
|
|
/// @param[out] blue The blue RGB-component
|
|
///
|
|
/// @note See https://bottosson.github.io/posts/colorpicker/#okhsv
|
|
///
|
|
static void okhsv2rgb(double hue, double saturation, double value, uint8_t & red, uint8_t & green, uint8_t & blue);
|
|
|
|
template <typename Pixel_T>
|
|
static double rgb_euclidean(Pixel_T p1, Pixel_T p2)
|
|
{
|
|
double val = sqrt(
|
|
(p1.red - p2.red) * (p1.red - p2.red) +
|
|
(p1.green - p2.green) * (p1.green - p2.green) +
|
|
(p1.blue - p2.blue) * (p1.blue - p2.blue)
|
|
);
|
|
|
|
return val;
|
|
}
|
|
|
|
};
|
|
|
|
#endif // COLORSYS_H
|