qualpal/qualpal_2qualpal_8h.html

// Basic usage with RGB input, 6 color palette

qualpal::Qualpal qp;

qp.setInputRGB(<rgb_colors>)

  .setCvd({{"protan", 0.5}, {"deuter", 0.2}})

  .setBackground("#ffffff")

  .setMetric(qualpal::metrics::MetricType::DIN99d)

  .setWhitePoint(qualpal::WhitePoint::D50)  // Optional: D50 for printing

  .setMemoryLimit(2.0);

auto palette = qp.generate(6);


// Use colorspace input (HSL space)

qualpal::Qualpal qp4;

qp4.setInputColorspace({0, 360}, {0.5, 1.0}, {0.3, 0.7});

auto palette4 = qp4.generate(8);


// Use multiple colorspace regions (warm and cool colors only)

qualpal::Qualpal qp5;

qp5.setInputColorspaceRegions({

  {{0, 60}, {0.5, 1.0}, {0.3, 0.7}},      // Warm: reds/oranges

  {{180, 240}, {0.5, 1.0}, {0.3, 0.7}}    // Cool: cyans/blues

}, qualpal::ColorspaceType::HSL);

auto palette5 = qp5.generate(8);


// Using hex color input

qualpal::Qualpal qp2;

qp2.setInputHex({"#ff0000", "#00ff00", "#0000ff"});

auto palette2 = qp2.generate(3);


// Use a built-in palette

auto palette3 =

  qualpal::Qualpal{}.setInputPalette("ColorBrewer:Set2").generate(5);


// Extend an existing palette

std::vector<qualpal::colors::RGB> base{ "#ff0000", "#a9ef93", "#ffe302" };

auto pal_extended = qualpal::Qualpal{}.extend(base, 3); // base + 3 new

qualpal::Qualpal
Builder for qualitative color palette generation.
Definition qualpal.h:105

qualpal::Qualpal::setInputRGB
Qualpal & setInputRGB(const std::vector< colors::RGB > &colors)
Set input colors from a vector of RGB values.

qualpal::Qualpal::setMetric
Qualpal & setMetric(metrics::MetricType metric)
Set the color difference metric to use.

qualpal::Qualpal::setInputPalette
Qualpal & setInputPalette(const std::string &palette_name)
Set input colors from a named palette.

qualpal::Qualpal::generate
std::vector< colors::RGB > generate(std::size_t n)
Generate a qualitative color palette with the configured options.

qualpal::Qualpal::setMemoryLimit
Qualpal & setMemoryLimit(double gb)
Set the maximum memory limit (in GB) for color difference matrix.

qualpal::Qualpal::setInputColorspace
Qualpal & setInputColorspace(const std::array< double, 2 > &h_lim, const std::array< double, 2 > &s_or_c_lim, const std::array< double, 2 > &l_lim, ColorspaceType space=ColorspaceType::HSL)
Set input colors by sampling a colorspace (HSL or LCHab).

qualpal::Qualpal::setWhitePoint
Qualpal & setWhitePoint(WhitePoint wp)
Set the reference white point for color conversions.

qualpal::Qualpal::extend
std::vector< colors::RGB > extend(const std::vector< colors::RGB > &palette, std::size_t n)
Extend an existing palette by adding n new colors.

qualpal::Qualpal::setInputColorspaceRegions
Qualpal & setInputColorspaceRegions(const std::vector< ColorspaceRegion > &regions, ColorspaceType space=ColorspaceType::HSL)
Set input colors by sampling multiple regions in a colorspace.

qualpal::Qualpal::setInputHex
Qualpal & setInputHex(const std::vector< std::string > &colors)
Set input colors from a vector of hex color strings.

qualpal::Qualpal::setCvd
Qualpal & setCvd(const std::map< std::string, double > &cvd_params)
Set color vision deficiency simulation parameters.

qualpal::metrics::MetricType::DIN99d
@ DIN99d
DIN99d color difference.

qualpal::WhitePoint::D50
@ D50
Daylight 5000K {0.96422, 1.0, 0.82521}.
Classes
struct	qualpal::ColorspaceRegion
	Defines a rectangular region in a cylindrical color space. More...

class	qualpal::Qualpal
	Builder for qualitative color palette generation. More...
Namespaces
namespace	qualpal
	Qualitative color palette generation library.
Enumerations
enum class	qualpal::ColorspaceType { HSL , LCHab }
	Supported cylindrical color spaces for input colors. More...