kis_hsv_adjustment.cpp File Reference

#include "kis_hsv_adjustment.h"
#include <KoConfig.h>
#include <kis_debug.h>
#include <klocalizedstring.h>
#include <KoColorConversions.h>
#include <KoColorModelStandardIds.h>
#include <KoColorSpace.h>
#include <KoColorSpaceTraits.h>
#include <KoColorTransformation.h>
#include <KoID.h>
#include "kis_global.h"

Go to the source code of this file.

Classes
struct	HCIPolicy
struct	HCYPolicy
struct	HSLPolicy
struct	HSVPolicy
class	KisHSVAdjustment< _channel_type_, traits >
class	KisHSVCurveAdjustment< _channel_type_, traits >

Macros
#define	FLOAT_CLAMP(v)   *v = (*v < 0.0) ? 0.0 : ( (*v>1.0) ? 1.0 : *v )
#define	SCALE_FROM_FLOAT(v)   KoColorSpaceMaths< float, _channel_type_>::scaleToA( v )
#define	SCALE_TO_FLOAT(v)   KoColorSpaceMaths< _channel_type_, float>::scaleToA( v )

Functions
template<typename _channel_type_ >
void	clamp (float *r, float *g, float *b)
template<>
void	clamp< float > (float *r, float *g, float *b)
template<>
void	clamp< quint16 > (float *r, float *g, float *b)
template<>
void	clamp< quint8 > (float *r, float *g, float *b)
template<class ValuePolicy >
void	HSVTransform (float *r, float *g, float *b, float dh, float ds, float dv, ValuePolicy valuePolicy)
static void	writeRGBSimple (float *r, float *g, float *b, int sextant, float x, float m, float M)

Macro Definition Documentation

FLOAT_CLAMP

#define FLOAT_CLAMP

(

v

)

*v = (*v < 0.0) ? 0.0 : ( (*v>1.0) ? 1.0 : *v )

Definition at line 30 of file kis_hsv_adjustment.cpp.

SCALE_FROM_FLOAT

#define SCALE_FROM_FLOAT

(

v

)

KoColorSpaceMaths< float, _channel_type_>::scaleToA( v )

Definition at line 25 of file kis_hsv_adjustment.cpp.

SCALE_TO_FLOAT

#define SCALE_TO_FLOAT

(

v

)

KoColorSpaceMaths< _channel_type_, float>::scaleToA( v )

Definition at line 24 of file kis_hsv_adjustment.cpp.

Function Documentation

clamp()

template<typename _channel_type_ >

void clamp	(	float *	r,
		float *	g,
		float *	b )

clamp< float >()

template<>

void clamp< float >	(	float *	r,
		float *	g,
		float *	b )

Definition at line 59 of file kis_hsv_adjustment.cpp.

{
    *r = qMax(0.0f, *r);
    *g = qMax(0.0f, *g);
    *b = qMax(0.0f, *b);
}

clamp< quint16 >()

template<>

void clamp< quint16 >	(	float *	r,
		float *	g,
		float *	b )

Definition at line 41 of file kis_hsv_adjustment.cpp.

{
    FLOAT_CLAMP(r);
    FLOAT_CLAMP(g);
    FLOAT_CLAMP(b);
}

References FLOAT_CLAMP.

clamp< quint8 >()

template<>

void clamp< quint8 >	(	float *	r,
		float *	g,
		float *	b )

Definition at line 33 of file kis_hsv_adjustment.cpp.

{
    FLOAT_CLAMP(r);
    FLOAT_CLAMP(g);
    FLOAT_CLAMP(b);
}

References FLOAT_CLAMP.

HSVTransform()

template<class ValuePolicy >

void HSVTransform	(	float *	r,
		float *	g,
		float *	b,
		float	dh,
		float	ds,
		float	dv,
		ValuePolicy	valuePolicy )

approximation of a nonlinear slider: ds = 0.0 -> chroma *= 1.0; ds = 0.5 -> chroma *= 2.0; ds = 1.0 -> chroma *= 4.0;

Definition at line 237 of file kis_hsv_adjustment.cpp.

{
    static const float EPSILON = 1e-9f;
 
    float h;
 
    float M = qMax(*r, qMax(*g, *b));
    float m = qMin(*r, qMin(*g, *b));
 
    float chroma = M - m;
 
    float v = valuePolicy.valueFromRGB(*r, *g, *b, m, M);
 
    if (!valuePolicy.hasChroma(v)) {
        chroma = 0.0f;
        h = 0.0f;
        if (dv < 0) {
            v *= dv + 1.0f;
        } else {
            v += dv * (1.0f - v);
        }
    } else {
        if (chroma > EPSILON) {
            if (*r == M)
                h = (*g - *b) / chroma;
            else if (*g == M)
                h = 2 + (*b - *r) / chroma;
            else
                h = 4 + (*r - *g) / chroma;
 
            h *= 60;
            h += dh * 180;
 
            h = normalizeAngleDegrees(h);
 
            if (ds > 0) {
 
                chroma = qMin(1.0f, chroma * (1.0f + ds + 2.0f * pow2(ds)));
            } else {
                chroma *= ds + 1.0f;
            }
 
        } else {
            h = 0.0f;
        }
 
        {
            const float dstV = dv > 0.0f ? 1.0f : 0.0f;
            const float vCoeff = dstV - v;
            const float chromaCoeff = 0 - chroma;
            const float movement = std::abs(dv);
 
            v += movement * vCoeff;
            chroma += movement * chromaCoeff;
        }
 
        v = qBound(0.0f, v, 1.0f);
        chroma = valuePolicy.fixupChroma(chroma, v);
    }
 
    if (v <= EPSILON) {
        *r = *g = *b = 0.0;
    } else {
        h /= 60.0f;
        const int sextant = static_cast<int>(h);
        const float fract = h - sextant;
 
        const float x =
            sextant & 0x1 ?
            chroma - chroma * fract :
            chroma * fract;
 
        valuePolicy.writeRGB(r, g, b, sextant, x, chroma, v);
    }
}

References EPSILON, normalizeAngleDegrees(), pow2(), and v.

writeRGBSimple()

static void writeRGBSimple ( float * r, float * g, float * b, int sextant, float x, float m, float M )

inlinestatic

Definition at line 68 of file kis_hsv_adjustment.cpp.

{
    switch (sextant) {
    case 0: *r = M; *g = x + m; *b = m; break;
    case 1: *r = x + m; *g = M; *b = m; break;
    case 2: *r = m; *g = M; *b = x + m; break;
    case 3: *r = m; *g = x + m; *b = M; break;
    case 4: *r = x + m; *g = m; *b = M; break;
    case 5: *r = M; *g = m; *b = x + m; break;
    }
}