liz/rawTherapee
liz/rawTherapee
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
rawTherapee/rtengine/color.h

727 lines
31 KiB
C++
Raw Blame History

/*
* This file is part of RawTherapee.
*
* Copyright (c) 2004-2010 Gabor Horvath <hgabor@rawtherapee.com>
*
* RawTherapee is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* RawTherapee is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with RawTherapee. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef _COLOR_H_
#define _COLOR_H_
#include "rt_math.h"
#include "LUT.h"
#include "labimage.h"
#include "iccstore.h"
#include "iccmatrices.h"
namespace rtengine {
#ifdef _DEBUG
class MunsellDebugInfo {
public:
float maxdhuelum[4];
float maxdhue[4];
unsigned int depass;
unsigned int depassLum;
MunsellDebugInfo();
void reinitValues();
};
#endif
class Color {
private:
// Jacques' 195 LUTf for Munsell Lch correction
static LUTf _4P10,_4P20,_4P30,_4P40,_4P50,_4P60;
static LUTf _1P10,_1P20,_1P30,_1P40,_1P50,_1P60;
static LUTf _5B40,_5B50,_5B60, _5B70,_5B80;
static LUTf _7B40,_7B50,_7B60, _7B70,_7B80;
static LUTf _9B40,_9B50,_9B60, _9B70,_9B80;
static LUTf _10B40,_10B50,_10B60, _10B70,_10B80;
static LUTf _05PB40,_05PB50,_05PB60, _05PB70,_05PB80;
static LUTf _10PB10,_10PB20,_10PB30,_10PB40,_10PB50,_10PB60;
static LUTf _9PB10,_9PB20,_9PB30,_9PB40,_9PB50,_9PB60,_9PB70,_9PB80;
static LUTf _75PB10,_75PB20,_75PB30,_75PB40,_75PB50,_75PB60,_75PB70,_75PB80;
static LUTf _6PB10,_6PB20,_6PB30,_6PB40,_6PB50,_6PB60,_6PB70,_6PB80;
static LUTf _45PB10,_45PB20,_45PB30,_45PB40,_45PB50,_45PB60,_45PB70,_45PB80;
static LUTf _3PB10,_3PB20,_3PB30,_3PB40,_3PB50,_3PB60,_3PB70,_3PB80;
static LUTf _15PB10,_15PB20,_15PB30,_15PB40,_15PB50,_15PB60, _15PB70,_15PB80;
static LUTf _10YR20, _10YR30, _10YR40,_10YR50,_10YR60,_10YR70,_10YR80,_10YR90;
static LUTf _85YR20, _85YR30, _85YR40,_85YR50,_85YR60,_85YR70,_85YR80,_85YR90;
static LUTf _7YR30, _7YR40,_7YR50,_7YR60,_7YR70,_7YR80;
static LUTf _55YR30, _55YR40,_55YR50,_55YR60,_55YR70,_55YR80,_55YR90;
static LUTf _4YR30, _4YR40,_4YR50,_4YR60,_4YR70,_4YR80;
static LUTf _25YR30, _25YR40,_25YR50,_25YR60,_25YR70;
static LUTf _10R30, _10R40,_10R50,_10R60,_10R70;
static LUTf _9R30, _9R40,_9R50,_9R60,_9R70;
static LUTf _7R30, _7R40,_7R50,_7R60,_7R70;
static LUTf _5R10, _5R20,_5R30;
static LUTf _25R10, _25R20,_25R30;
static LUTf _10RP10, _10RP20,_10RP30;
static LUTf _7G30, _7G40,_7G50,_7G60,_7G70,_7G80;
static LUTf _5G30, _5G40,_5G50,_5G60,_5G70,_5G80;
static LUTf _25G30, _25G40,_25G50,_25G60,_25G70,_25G80;
static LUTf _1G30, _1G40,_1G50,_1G60,_1G70,_1G80;
static LUTf _10GY30, _10GY40,_10GY50,_10GY60,_10GY70,_10GY80;
static LUTf _75GY30, _75GY40,_75GY50,_75GY60,_75GY70,_75GY80;
static LUTf _5GY30, _5GY40,_5GY50,_5GY60,_5GY70,_5GY80;
// Separated from init() to keep the code clear
static void initMunsell ();
static double hue2rgb(double p, double q, double t);
public:
const static double sRGBGamma; // standard average gamma
const static double sRGBGammaCurve; // 2.4 in the curve
const static double eps_max, kappa, epskap;
const static float D50x, D50z;
const static double u0, v0;
static cmsToneCurve* linearGammaTRC;
static LUTf cachef;
static LUTf gamma2curve;
// look-up tables for the standard srgb gamma and its inverse (filled by init())
static LUTf igammatab_srgb;
static LUTf gammatab_srgb;
// static LUTf igammatab_709;
// static LUTf gammatab_709;
static LUTf igammatab_55;
static LUTf gammatab_55;
static LUTf igammatab_4;
static LUTf gammatab_4;
static LUTf igammatab_26_11;
static LUTf gammatab_26_11;
static LUTf igammatab_24_17;
static LUTf gammatab_24_17a;
// look-up tables for the simple exponential gamma
static LUTf gammatab;
static void init ();
static void cleanup ();
/**
* @brief Extract luminance "sRGB" from red/green/blue values
* The range of the r, g and b channel has no importance ([0 ; 1] or [0 ; 65535]...) ; r,g,b can be negatives or > max, but must be in "sRGB"
* @param r red channel
* @param g green channel
* @param b blue channel
* @return luminance value
*/
// xyz_sRGBD65 : conversion matrix from XYZ to sRGB for D65 illuminant: we use diagonal values
static float rgbLuminance(float r, float g, float b) { return r*float(xyz_sRGBd65[1][0]) + g*float(xyz_sRGBd65[1][1]) + b*float(xyz_sRGBd65[1][2]); }
static double rgbLuminance(double r, double g, double b) { return r*xyz_sRGBd65[1][0] + g*xyz_sRGBd65[1][1] + b*xyz_sRGBd65[1][2]; }
/**
* @brief Convert red/green/blue to hue/saturation/luminance
* @param r red channel [0 ; 65535]
* @param g green channel [0 ; 65535]
* @param b blue channel [0 ; 65535]
* @param h hue channel [0 ; 1] (return value)
* @param s saturation channel [0 ; 1] (return value)
* @param l luminance channel [0; 1] (return value)
*/
static void rgb2hsl (float r, float g, float b, float &h, float &s, float &l);
/**
* @brief Convert hue/saturation/luminance in red/green/blue
* @param h hue channel [0 ; 1]
* @param s saturation channel [0 ; 1]
* @param l luminance channel [0 ; 1]
* @param r red channel [0 ; 65535] (return value)
* @param g green channel [0 ; 65535] (return value)
* @param b blue channel [0 ; 65535] (return value)
*/
static void hsl2rgb (float h, float s, float l, float &r, float &g, float &b);
/**
* @brief Convert red green blue to hue saturation value
* @param r red channel [0 ; 65535]
* @param g green channel [0 ; 65535]
* @param b blue channel [0 ; 65535]
* @param h hue channel [0 ; 1] (return value)
* @param s saturation channel [0 ; 1] (return value)
* @param v value channel [0 ; 1] (return value)
*/
static void rgb2hsv (float r, float g, float b, float &h, float &s, float &v);
/**
* @brief Convert hue saturation value in red green blue
* @param h hue channel [0 ; 1]
* @param s saturation channel [0 ; 1]
* @param v value channel [0 ; 1]
* @param r red channel [0 ; 65535] (return value)
* @param g green channel [0 ; 65535] (return value)
* @param b blue channel [0 ; 65535] (return value)
*/
static void hsv2rgb (float h, float s, float v, float &r, float &g, float &b);
static void hsv2rgb (float h, float s, float v, int &r, int &g, int &b);
/**
* @brief Convert hue saturation value in red green blue
* @param h hue channel [0 ; 1]
* @param s saturation channel [0 ; 1]
* @param v value channel [0 ; 1]
* @param r red channel [0 ; 1] (return value)
* @param g green channel [0 ; 1] (return value)
* @param b blue channel [0 ; 1] (return value)
*/
static void hsv2rgb01 (float h, float s, float v, float &r, float &g, float &b);
/**
* @brief Convert xyz to red/green/blue
* Color space : sRGB - illuminant D50 - use matrix sRGB_xyz[]
* @param x X coordinate [0 ; 1] or [0 ; 65535]
* @param y Y coordinate [0 ; 1] or [0 ; 65535]
* @param z Z coordinate [0 ; 1] or [0 ; 65535]
* @param r red channel [same range than xyz channel] (return value)
* @param g green channel [same range than xyz channel] (return value)
* @param b blue channel [same range than xyz channel] (return value)
*/
static void xyz2srgb (float x, float y, float z, float &r, float &g, float &b);
/**
* @brief Convert xyz to red/green/blue
* Color space : Prophoto - illuminant D50 - use the Prophoto_xyz[] matrix
* @param x X coordinate [0 ; 1] or [0 ; 65535]
* @param y Y coordinate [0 ; 1] or [0 ; 65535]
* @param z Z coordinate [0 ; 1] or [0 ; 65535]
* @param r red channel [same range than xyz channel] (return value)
* @param g green channel [same range than xyz channel] (return value)
* @param b blue channel [same range than xyz channel] (return value)
*/
static void xyz2Prophoto (float x, float y, float z, float &r, float &g, float &b);
/**
* @brief Convert rgb in xyz
* Color space : Prophoto - illuminant D50 - use matrix xyz_prophoto[]
* @param r red channel [0 ; 1] or [0 ; 65535] (return value)
* @param g green channel [0 ; 1] or [0 ; 65535] (return value)
* @param b blue channel [0 ; 1] or [0 ; 65535] (return value)
* @param x X coordinate [same range than xyz channel]
* @param y Y coordinate [same range than xyz channel]
* @param z Z coordinate [same range than xyz channel]
*/
static void Prophotoxyz (float r, float g, float b, float &x, float &y, float &z);
/**
* @brief Convert xyz in rgb
* Color space : undefined - use adhoc matrix: rgb_xyz[3][3] (iccmatrice.h) in function of working space
* @param x X coordinate [0 ; 1] or [0 ; 65535]
* @param y Y coordinate [0 ; 1] or [0 ; 65535]
* @param z Z coordinate [0 ; 1] or [0 ; 65535]
* @param r red channel [same range than xyz channel] (return value)
* @param g green channel [same range than xyz channel] (return value)
* @param b blue channel [same range than xyz channel] (return value)
* @param rgb_xyz[3][3] transformation matrix to use for the conversion
*/
static void xyz2rgb (float x, float y, float z, float &r, float &g, float &b, double rgb_xyz[3][3]);
static void xyz2rgb (float x, float y, float z, float &r, float &g, float &b, float rgb_xyz[3][3]);
/**
* @brief Convert rgb in xyz
* Color space : undefined - use matrix adhoc : xyz_rgb[3][3] (iccmatrice.h) in function of working space
* @param r red channel [0 ; 1] or [0 ; 65535]
* @param g green channel [0 ; 1] or [0 ; 65535]
* @param b blue channel [0 ; 1] or [0 ; 65535]
* @param x X coordinate [same range than rgb channel] (return value)
* @param y Y coordinate [same range than rgb channel] (return value)
* @param z Z coordinate [same range than rgb channel] (return value)
* @param xyz_rgb[3][3] transformation matrix to use for the conversion
*/
static void rgbxyz (float r, float g, float b, float &x, float &y, float &z, double xyz_rgb[3][3]);
/**
* @brief Convert Lab in xyz
* @param L L channel [0 ; 32768] ; L can be negative rarely or superior 32768
* @param a channel [-42000 ; +42000] ; can be more than 42000
* @param b channel [-42000 ; +42000] ; can be more than 42000
* @param x X coordinate [0 ; 65535] ; can be negative! (return value)
* @param y Y coordinate [0 ; 65535] ; can be negative! (return value)
* @param z Z coordinate [0 ; 65535] ; can be negative! (return value)
*/
static void Lab2XYZ(float L, float a, float b, float &x, float &y, float &z);
/**
* @brief Convert xyz in Lab
* @param x X coordinate [0 ; 65535] ; can be negative or superior to 65535
* @param y Y coordinate [0 ; 65535] ; can be negative or superior to 65535
* @param z Z coordinate [0 ; 65535] ; can be negative or superior to 65535
* @param L L channel [0 ; 32768] ; L can be negative rarely or superior 32768 (return value)
* @param a channel [-42000 ; +42000] ; can be more than 42000 (return value)
* @param b channel [-42000 ; +42000] ; can be more than 42000 (return value)
*/
static void XYZ2Lab(float X, float Y, float Z, float &L, float &a, float &b);
/**
* @brief Convert Lab in Yuv
* @param L L channel [0 ; 32768] ; L can be negative rarely or superior 32768
* @param a channel [-42000 ; +42000] ; can be more than 42000
* @param b channel [-42000 ; +42000] ; can be more than 42000
* @param Y luminance channel [0 ; 65535] (return value)
* @param u red chrominance channel [0 ; 65535] (return value)
* @param v blue chrominance channel [0 ; 65535] (return value)
*/
static void Lab2Yuv(float L, float a, float b, float &Y, float &u, float &v);
/**
* @brief Convert Yuv in Lab
* @param Y luminance channel [0 ; 65535]
* @param u red chrominance channel [0 ; 65535]
* @param v blue chrominance channel [0 ; 65535]
* @param L L channel [0 ; 32768] ; L can be negative rarely or superior 32768 (return value)
* @param a channel [-42000 ; +42000] ; can be more than 42000 (return value)
* @param b channel [-42000 ; +42000] ; can be more than 42000 (return value)
*/
static void Yuv2Lab(float Y, float u, float v, float &L, float &a, float &b, double wp[3][3]);
/**
* @brief Return "f" in function of CIE's kappa and epsilon constants
* @param f f can be fx fy fz where:
* fx=a/500 + fy a=chroma green red [-128 ; +128]
* fy=(L+16)/116 L=luminance [0 ; 100]
* fz=fy-b/200 b=chroma blue yellow [-128 ; +128]
*/
static inline double f2xyz(double f) {
const double epsilonExpInv3 = 6.0/29.0;
const double kappaInv = 27.0/24389.0; // inverse of kappa
return (f > epsilonExpInv3) ? f*f*f : (116. * f - 16.) * kappaInv;
}
static inline float f2xyz(float f) {
const float epsilonExpInv3 = 6.0f/29.0f;
const float kappaInv = 27.0f/24389.0f; // inverse of kappa
return (f > epsilonExpInv3) ? f*f*f : (116.f * f - 16.f) * kappaInv;
}
/**
* @brief Get the gamma curves' parameters used by LCMS2
* @param pwr gamma value [>1]
* @param ts slope [0 ; 20]
* @param mode [always 0]
* @imax imax [always 0]
* @param gamma0 used in ip2Lab2rgb [0 ; 1], usually near 0.5 (return value)
* @param gamma1 used in ip2Lab2rgb [0 ; 20], can be superior to 20, but it's quite unusual(return value)
* @param gamma2 used in ip2Lab2rgb [0 ; 1], usually near 0.03(return value)
* @param gamma3 used in ip2Lab2rgb [0 ; 1], usually near 0.003(return value)
* @param gamma4 used in ip2Lab2rgb [0 ; 1], usually near 0.03(return value)
* @param gamma5 used in ip2Lab2rgb [0 ; 1], usually near 0.5 (return value)
*/
static void calcGamma (double pwr, double ts, int mode, int imax, double &gamma0, double &gamma1, double &gamma2, double &gamma3, double &gamma4,double &gamma5);
/**
* @brief Used by Black and White to correct gamma for each channel red, green and blue channel
* @param r red channel input and output value [0 ; 65535]
* @param g green channel input and output value [0 ; 65535]
* @param b blue channel input and output value [0 ; 65535]
* @param gammabwr gamma value for red channel [>0]
* @param gammabwg gamma value for red channel [>0]
* @param gammabwb gamma value for red channel [>0]
*/
static void trcGammaBW (float &r, float &g, float &b, float gammabwr, float gammabwg, float gammabwb);
/** @brief Compute the B&W constants for the Black and White processing and its GUI
* @param setting main mode
* @param filter string of the filter effect to use
* @param algo choice between linear and special for OYCPM colors
* @param mixerRed red channel value of the channel mixer [-100 ; +200]
* @param mixerGreen green channel value of the channel mixer [-100 ; +200]
* @param mixerBlue blue channel value of the channel mixer [-100 ; +200]
* @param mixerOrange orange channel value of the channel mixer [-100 ; +200]
* @param mixerYellow yellow channel value of the channel mixer [-100 ; +200]
* @param mixerCyan cyan channel value of the channel mixer [-100 ; +200]
* @param mixerPurple purple channel value of the channel mixer [-100 ; +200]
* @param mixerMagenta magenta channel value of the channel mixer [-100 ; +200]
* @param autoc automatic mode of the channel mixer
* @param complement adjust complementary channel
* @param kcorec in absolute mode, value to correct the mixer [1 ; 3], usually near 1 (return value)
* @param rrm red channel of the mixer (return value)
* @param ggm green channel of the mixer (return value)
* @param bbm blue channel of the mixer (return value)
*/
static void computeBWMixerConstants (const Glib::ustring &setting, const Glib::ustring &filter, const Glib::ustring &algo, float &mixerRed, float &mixerGreen,
float &mixerBlue, float mixerOrange, float mixerYellow, float mixerCyan, float mixerPurple, float mixerMagenta,
bool autoc, bool complement, float &kcorec, double &rrm, double &ggm, double &bbm);
// standard srgb gamma and its inverse
/**
* @brief sRGB gamma
* See also calcGamma above with the following values: pwr=2.4 ts=12.92 mode=0.003041 imax=0.055011
* @param x red, green or blue channel's value [0 ; 1]
* @return the gamma modified's value [0 ; 1]
*/
static inline double gamma2 (double x) { // g3 1+g4
return x <= 0.003041 ? x*12.92 : 1.055011*exp(log(x)/sRGBGammaCurve)-0.055011;
}
/**
* @brief Inverse sRGB gamma
* See also calcGamma above with the following values: pwr=2.4 ts=12.92 mode=0.003041 imax=0.055011
* @param x red, green or blue channel's value [0 ; 1]
* @return the inverse gamma modified's value [0 ; 1]
*/
static inline double igamma2 (double x) { //g2
return x <= 0.039293 ? x/12.92 : exp(log((x+0.055011)/1.055011)*sRGBGammaCurve);
}
/**
* @brief Get the gamma value for Gamma=5.5 Slope=10
* @param x red, green or blue channel's value [0 ; 1]
* @return the gamma modified's value [0 ; 1]
*/
static inline double gamma55 (double x) { // g3 1+g4
return x <= 0.013189 ? x*10.0 : 1.593503*exp(log(x)/5.5)-0.593503;// 5.5 10
}
/**
* @brief Get the inverse gamma value for Gamma=5.5 Slope=10
* @param x red, green or blue channel's value [0 ; 1]
* @return the inverse gamma modified's value [0 ; 1]
*/
static inline double igamma55 (double x) { //g2
return x <= 0.131889 ? x/10.0 : exp(log((x+0.593503)/1.593503)*5.5); // 5.5 10
}
/**
* @brief Get the gamma value for Gamma=4 Slope=5
* @param x red, green or blue channel's value [0 ; 1]
* @return the gamma modified's value [0 ; 1]
*/
static inline double gamma4 (double x) { // g3 1+g4
return x <= 0.03089 ? x*5.0 : 1.478793*exp(log(x)/4.1)-0.478793;// 4 5
}
/**
* @brief Get the inverse gamma value for Gamma=4 Slope=5
* @param x red, green or blue channel's value [0 ; 1]
* @return the inverse gamma modified's value [0 ; 1]
*/
static inline double igamma4 (double x) { //g2
return x <= 0.154449 ? x/5.0 : exp(log((x+0.478793)/1.478793)*4.1);// 4 5
}
/*
* @brief Get the gamma value for Gamma=2.2 Slope=4.5
* @param x red, green or blue channel's value [0 ; 1]
* @return the gamma modified's value [0 ; 1]
*
static inline double gamma709 (double x) {
return x <= 0.0176 ? x*4.5 : 1.0954*exp(log(x)/2.2)-0.0954;
}
* @brief Get the inverse gamma value for Gamma=2.2 Slope=4.5
* @param x red, green or blue channel's value [0 ; 1]
* @return the inverse gamma modified's value [0 ; 1]
*
static inline double igamma709 (double x) {
return x <= 0.0795 ? x/4.5 : exp(log((x+0.0954)/1.0954)*2.2);
}
*/
/**
* @brief Get the gamma value for Gamma=2.4 Slope=17
* @param x red, green or blue channel's value [0 ; 1]
* @return the gamma modified's value [0 ; 1]
*/
static inline double gamma24_17 (double x) {
return x <= 0.001867 ? x*17.0 : 1.044445*exp(log(x)/2.4)-0.044445;
}
/**
* @brief Get the inverse gamma value for Gamma=2.4 Slope=17
* @param x red, green or blue channel's value [0 ; 1]
* @return the inverse gamma modified's value [0 ; 1]
*/
static inline double igamma24_17 (double x) {
return x <= 0.031746 ? x/17.0 : exp(log((x+0.044445)/1.044445)*2.4);
}
/**
* @brief Get the gamma value for Gamma=2.6 Slope=11
* @param x red, green or blue channel's value [0 ; 1]
* @return the gamma modified's value [0 ; 1]
*/
static inline double gamma26_11 (double x) {
return x <= 0.004921 ? x*11.0 : 1.086603*exp(log(x)/2.6)-0.086603;
}
/**
* @brief Get the inverse gamma value for Gamma=2.6 Slope=11
* @param x red, green or blue channel's value [0 ; 1]
* @return the inverse gamma modified's value [0 ; 1]
*/
static inline double igamma26_11 (double x) {
return x <= 0.054127 ? x/11.0 : exp(log((x+0.086603)/1.086603)*2.6);
}
// gamma function with adjustable parameters
//same as above with values calculate with Calcgamma above
// X range 0..1
static inline double gamma (double x, double gamma, double start, double slope, double mul, double add){
return (x <= start ? x*slope : exp(log(x)/gamma)*mul-add);
}
static inline double igamma (double x, double gamma, double start, double slope, double mul, double add){
return (x <= start*slope ? x/slope : exp(log((x+add)/mul)*gamma) );
}
/**
* @brief Very basic gamma
* @param x red, green or blue channel's value [0 ; 1]
* @param gamma gamma value [1 ; 5]
* @return the gamma modified's value [0 ; 1]
*/
static inline double gamman (double x, double gamma) { //standard gamma without slope...
return (x =exp(log(x)/gamma));
}
/**
* @brief Very simply inverse gamma
* @param x red, green or blue channel's value [0 ; 1]
* @param gamma gamma value [1 ; 5]
* @return the inverse gamma modified's value [0 ; 1]
*/
static inline double igamman (double x, double gamma){ //standard inverse gamma without slope...
return (x = exp(log(x)*gamma) );
}
/**
* @brief Get the gamma value out of look-up tables
* Calculated with gamma function above. e.g. :
* for (int i=0; i<65536; i++)
* gammatab_srgb[i] = (65535.0 * gamma2 (i/65535.0));
* @param x [0 ; 1]
* @return the gamma modified's value [0 ; 65535]
*/
static inline float gamma_srgb (char x) { return gammatab_srgb[x]; }
static inline float gamma (char x) { return gammatab[x]; }
static inline float igamma_srgb (char x) { return igammatab_srgb[x]; }
static inline float gamma_srgb (int x) { return gammatab_srgb[x]; }
static inline float gamma (int x) { return gammatab[x]; }
static inline float igamma_srgb (int x) { return igammatab_srgb[x]; }
static inline float gamma_srgb (float x) { return gammatab_srgb[x]; }
static inline float gamma (float x) { return gammatab[x]; }
static inline float igamma_srgb (float x) { return igammatab_srgb[x]; }
//static inline float gamma_srgb (double x) { return gammatab_srgb[x]; }
//static inline float gamma (double x) { return gammatab[x]; }
//static inline float igamma_srgb (double x) { return igammatab_srgb[x]; }
// -------------------------------- Jacques's Munsell correction
/**
* @brief Corrects the color (hue) depending on chromaticity and luminance changes
*
* To use in a "for" or "do while" statement.
*
* @param lumaMuns true => luminance correction (for delta L > 10) and chroma correction ; false => only chroma
* @param Lprov1 luminance after [0 ; 100]
* @param Loldd luminance before [0 ; 100]
* @param HH hue before [-PI ; +PI]
* @param Chprov1 chroma after [0 ; 180 (can be superior)]
* @param CC chroma before [0 ; 180]
* @param corectionHuechroma hue correction depending on chromaticity (saturation), in radians [0 ; 0.45] (return value)
* @param correctlum hue correction depending on luminance (brightness, contrast,...), in radians [0 ; 0.45] (return value)
* @param munsDbgInfo (Debug target only) object to collect informations
*/
#ifdef _DEBUG
static void AllMunsellLch (bool lumaMuns, float Lprov1, float Loldd, float HH, float Chprov1, float CC, float &correctionHueChroma, float &correctlum, MunsellDebugInfo* munsDbgInfo);
#else
static void AllMunsellLch (bool lumaMuns, float Lprov1, float Loldd, float HH, float Chprov1, float CC, float &correctionHueChroma, float &correctlum);
#endif
/**
* @brief Correct chromaticity and luminance so that the color stays in the working profile's gamut
*
* This function puts the data (Lab) in the gamut of "working profile":
* it returns the corrected values of the chromaticity and luminance
*
* @param HH : hue, in radians [-PI ; +PI]
* @param Lprov1 : input luminance value, sent back corrected [0 ; 100] (input & output value)
* @param Chprov1: input chroma value, sent back corrected [0 ; 180 (can be superior)] (input & output value)
* @param R red value of the corrected color [0 ; 65535 but can be negative or superior to 65535] (return value)
* @param G green value of the corrected color [0 ; 65535 but can be negative or superior to 65535] (return value)
* @param B blue value of the corrected color [0 ; 65535 but can be negative or superior to 65535] (return value)
* @param wip working profile
* @param isHLEnabled true if "Highlight Reconstruction " is enabled
* @param lowerCoef a float number between [0.95 ; 1.0[
* The nearest it is from 1.0, the more precise it will be, and the longer too as more iteration will be necessary
* @param higherCoef a float number between [0.95 ; 1.0[
* The nearest it is from 1.0, the more precise it will be, and the longer too as more iteration will be necessary
* @param neg (Debug target only) to calculate iterations for negatives values
* @param moreRGB (Debug target only) to calculate iterations for values >65535
*/
#ifdef _DEBUG
static void gamutLchonly (float HH, float &Lprov1, float &Chprov1, float &R, float &G, float &B, double wip[3][3], const bool isHLEnabled, const float lowerCoef, const float higherCoef, bool &neg, bool &more_rgb);
#else
static void gamutLchonly (float HH, float &Lprov1, float &Chprov1, float &R, float &G, float &B, double wip[3][3], const bool isHLEnabled, const float lowerCoef, const float higherCoef);
#endif
/**
* @brief Munsell gamut correction
*
* This function is the overall Munsell's corrections, but only on global statement. It may be better to use local statement with AllMunsellLch.
* Not for use in a "for" or "do while" loop
* They are named accordingly : gamutLchonly and AllMunsellLch
* It can be used before and after treatment (saturation, gamma, luminance, ...)
*
* @param lab input and output image
* L channel's usual range is [0 ; 100], but values can be negative or >100
* a and b channel's range is usually [-128 ; +128], but values can be >128
* @param Lold luminance before [same range than lab.L]
* @param Cold chrominance before [0 ; 180 (can be superior)]
* @param corMuns performs Munsell correction
* @param lumaMuns whether to apply luma correction or not (used only if corMuns=true)
* true: apply luma + chroma Munsell correction if delta L > 10;
* false: leaves luma untouched
* @param gamut performs gamutLch
* @param working working profile's name
* @param multiThread whether to parallelize the loop or not
*/
static void LabGamutMunsell (LabImage *lab, float *Lold, float *Cold, bool corMunsell, bool lumaMuns, bool isHLEnabled, bool gamut, const Glib::ustring &working, bool multiThread );
/*
* @brief Skin tone protection factor
* Skin colors: mixed from NX2 skin color palette, Von Luschan, and photos of white, black, yellow people...
* There are some little exceptions, but it should cover 99% case.
* Pay attention to white balance, and do not change hue and saturation, upstream of the modification
* Used by vibrance
* @param lum luma value [0 ; 100]
* @param hue hue value [-PI ; +PI]
* @param chrom chroma value [0 ; 180]
* @param satreduc [0.1 ; 1] (return value)
* @param chromx [0 or 1], actually only 0 is used
*/
static void SkinSat (float lum, float hue, float chrom, float &satreduc, int chromx);//jacques Skin color
/**
* @brief Munsell Lch correction
* Find the right LUT and calculate the correction
* @param lum luma value [0 ; 100]
* @param hue hue value [-PI ; +PI]
* @param chrom chroma value [0 ; 180]
* @param memChprov store chroma [0 ; 180]
* @param correction correction value, in radians [0 ; 0.45]
* @param lbe hue in function of chroma, in radian [-PI ; +PI]
* @param zone [1 ; 4] 1=PB correction + sky 2=red yellow correction 3=Green yellow correction 4=Red purple correction
* @param correctL true=enable the Luminance correction
*/
static void MunsellLch (float lum, float hue, float chrom, float memChprov, float &correction, int zone, float &lbe, bool &correctL);//jacques: Munsell correction
// -------------------------------- end Munsell
static void scalered ( float rstprotection, float param, float limit, float HH, float deltaHH, float &scale, float &scaleext);
static void transitred (float HH, float Chprov1, float dred, float factorskin, float protect_red, float factorskinext, float deltaHH, float factorsat, float &factor);
static void skinred ( double J, double h, double sres, double Sp, float dred, float protect_red, int sk, float rstprotection, float ko, double &s);
static void skinredfloat ( float J, float h, float sres, float Sp, float dred, float protect_red, int sk, float rstprotection, float ko, float &s);
// static void scaleredcdbl ( float skinprot, float param, float limit, float HH, float deltaHH, float &scale,float &scaleext);
static void SkinSatcdbl (float lum, float hue, float chrom, float skinprot, float &scale, bool ciec, bool neg, float b_l, float t_l, float t_r, float b_r, int choice);
/**
* @brief Gamut correction in the XYZ color space
* @param X X channel input value and corrected output value [0 ; 65535]
* @param Y Y channel input value and corrected output value [0 ; 65535]
* @param Z Z channel input value and corrected output value [0 ; 65535]
* @param p working profile
*/
static void gamutmap(float &X, float &Y, float &Z, const double p[3][3]);
/**
* @brief Get HSV's hue from the Lab's hue
* @param HH Lab's hue value, in radians [-PI ; +PI]
* @return HSV's hue value [0 ; 1]
*/
static inline double huelab_to_huehsv2 (float HH){
//hr=translate Hue Lab value (-Pi +Pi) in approximative hr (hsv values) (0 1) [red 1/6 yellow 1/6 green 1/6 cyan 1/6 blue 1/6 magenta 1/6 ]
// with multi linear correspondances (I expect there is no error !!)
double hr = 0.0;
//allways put h between 0 and 1
if (HH>=0.f && HH < 0.6f ) hr=0.11666*double(HH) + 0.93; //hr 0.93 1.00 full red
else if (HH>=0.6f && HH < 1.4f ) hr=0.1125 *double(HH) - 0.0675; //hr 0.00 0.09 red yellow orange
else if (HH>=1.4f && HH < 2.f ) hr=0.2666 *double(HH) - 0.2833; //hr 0.09 0.25 orange yellow
else if (HH>=2.f && HH < 3.14159f) hr=0.1489 *double(HH) - 0.04785; //hr 0.25 0.42 yellow green green
else if (HH>=-3.14159f && HH < -2.8f ) hr=0.23419*double(HH) + 1.1557; //hr 0.42 0.50 green
else if (HH>=-2.8f && HH < -2.3f ) hr=0.16 *double(HH) + 0.948; //hr 0.50 0.58 cyan
else if (HH>=-2.3f && HH < -0.9f ) hr=0.12143*double(HH) + 0.85928; //hr 0.58 0.75 blue blue-sky
else if (HH>=-0.9f && HH < -0.1f ) hr=0.2125 *double(HH) + 0.94125; //hr 0.75 0.92 purple magenta
else if (HH>=-0.1f && HH < 0.f ) hr=0.1 *double(HH) + 0.93; //hr 0.92 0.93 red
// in case of !
if (hr<0.0) hr += 1.0;
else if(hr>1.0) hr -= 1.0;
return (hr);
}
};
}
#endif
Reference in New Issue View Git Blame Copy Permalink