KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType > Class Template Reference

#include <KisCmykDitherOpFactory.h>

Inheritance diagram for KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >:

Public Member Functions
void	dither (const quint8 *src, quint8 *dst, int x, int y) const override
void	dither (const quint8 *srcRowStart, int srcRowStride, quint8 *dstRowStart, int dstRowStride, int x, int y, int columns, int rows) const override
	KisCmykDitherOpImpl (const KoID &srcId, const KoID &dstId)
Public Member Functions inherited from KisDitherOpImpl< srcCSTraits, dstCSTraits, dType >
KoID	destinationDepthId () const override
void	dither (const quint8 *src, quint8 *dst, int x, int y) const override
void	dither (const quint8 *srcRowStart, int srcRowStride, quint8 *dstRowStart, int dstRowStride, int x, int y, int columns, int rows) const override
	KisDitherOpImpl (const KoID &srcId, const KoID &dstId)
KoID	sourceDepthId () const override
DitherType	type () const override
Public Member Functions inherited from KisDitherOp
virtual	~KisDitherOp ()=default

Private Types
using	dstChannelsType = typename dstCSTraits::channels_type
using	srcChannelsType = typename srcCSTraits::channels_type

Private Member Functions
template<typename A , typename std::enable_if< std::numeric_limits< A >::is_integer, void >::type * = nullptr>
A	denormalize (float value) const
template<typename A , typename std::enable_if<!std::numeric_limits< A >::is_integer, void >::type * = nullptr>
A	denormalize (float value) const
template<DitherType t = dType, typename std::enable_if< t !=DITHER_NONE, void >::type * = nullptr>
void	ditherImpl (const quint8 *src, quint8 *dst, int x, int y) const
template<DitherType t = dType, typename std::enable_if< t==DITHER_NONE &&std::is_same< srcCSTraits, dstCSTraits >::value, void >::type * = nullptr>
void	ditherImpl (const quint8 *src, quint8 *dst, int, int) const
template<DitherType t = dType, typename std::enable_if< t==DITHER_NONE &&!std::is_same< srcCSTraits, dstCSTraits >::value, void >::type * = nullptr>
void	ditherImpl (const quint8 *src, quint8 *dst, int, int) const
template<DitherType t = dType, typename std::enable_if< t !=DITHER_NONE, void >::type * = nullptr>
void	ditherImpl (const quint8 *srcRowStart, int srcRowStride, quint8 *dstRowStart, int dstRowStride, int x, int y, int columns, int rows) const
template<DitherType t = dType, typename std::enable_if< t==DITHER_NONE &&std::is_same< srcCSTraits, dstCSTraits >::value, void >::type * = nullptr>
void	ditherImpl (const quint8 *srcRowStart, int srcRowStride, quint8 *dstRowStart, int dstRowStride, int, int, int columns, int rows) const
template<DitherType t = dType, typename std::enable_if< t==DITHER_NONE &&!std::is_same< srcCSTraits, dstCSTraits >::value, void >::type * = nullptr>
void	ditherImpl (const quint8 *srcRowStart, int srcRowStride, quint8 *dstRowStart, int dstRowStride, int, int, int columns, int rows) const
template<DitherType t = dType, typename std::enable_if< t==DITHER_BAYER, void >::type * = nullptr>
float	factor (int x, int y) const
template<DitherType t = dType, typename std::enable_if< t==DITHER_BLUE_NOISE, void >::type * = nullptr>
float	factor (int x, int y) const
template<typename A , typename U = srcCSTraits, typename std::enable_if< std::numeric_limits< A >::is_integer, void >::type * = nullptr>
float	normalize (A value) const
template<typename A , typename std::enable_if<!std::numeric_limits< A >::is_integer, void >::type * = nullptr>
float	normalize (A value) const
template<typename U = typename dstCSTraits::channels_type, typename std::enable_if<!std::numeric_limits< U >::is_integer, void >::type * = nullptr>
constexpr float	scale () const
template<typename U = typename dstCSTraits::channels_type, typename std::enable_if< std::numeric_limits< U >::is_integer, void >::type * = nullptr>
constexpr float	scale () const
template<typename A , typename B >
B	scaleToA (A c) const

Detailed Description

template<typename srcCSTraits, typename dstCSTraits, DitherType dType>
class KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >

THIS CLASS OVERRIDES THE STANDARD FACTORY. Floating point CMYK uses different normalization for the color and alpha channels.

Definition at line 17 of file KisCmykDitherOpFactory.h.

Member Typedef Documentation

dstChannelsType

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

using KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::dstChannelsType = typename dstCSTraits::channels_type

private

Definition at line 20 of file KisCmykDitherOpFactory.h.

srcChannelsType

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

using KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::srcChannelsType = typename srcCSTraits::channels_type

private

Definition at line 19 of file KisCmykDitherOpFactory.h.

Constructor & Destructor Documentation

KisCmykDitherOpImpl()

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::KisCmykDitherOpImpl ( const KoID & srcId, const KoID & dstId )

inline

Definition at line 23 of file KisCmykDitherOpFactory.h.

        : KisDitherOpImpl<srcCSTraits, dstCSTraits, dType>(srcId, dstId)
    {
    }

Member Function Documentation

denormalize() [1/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<typename A , typename std::enable_if< std::numeric_limits< A >::is_integer, void >::type * = nullptr>

A KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::denormalize ( float value ) const

inlineprivate

Definition at line 183 of file KisCmykDitherOpFactory.h.

    {
        return static_cast<A>(value * static_cast<float>(KoColorSpaceMathsTraits<A>::unitValue));
    };

References A, and value().

denormalize() [2/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<typename A , typename std::enable_if<!std::numeric_limits< A >::is_integer, void >::type * = nullptr>

A KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::denormalize ( float value ) const

inlineprivate

Definition at line 188 of file KisCmykDitherOpFactory.h.

    {
        return static_cast<A>(value * static_cast<float>(KoCmykColorSpaceMathsTraits<A>::unitValueCMYK));
    };

References A, and value().

dither() [1/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

void KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::dither ( const quint8 * src, quint8 * dst, int x, int y ) const

inlineoverridevirtual

Implements KisDitherOp.

Definition at line 28 of file KisCmykDitherOpFactory.h.

    {
        ditherImpl(src, dst, x, y);
    }

References KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::ditherImpl().

dither() [2/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

void KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::dither ( const quint8 * srcRowStart, int srcRowStride, quint8 * dstRowStart, int dstRowStride, int x, int y, int columns, int rows ) const

inlineoverridevirtual

Implements KisDitherOp.

Definition at line 33 of file KisCmykDitherOpFactory.h.

    {
        ditherImpl(srcRowStart, srcRowStride, dstRowStart, dstRowStride, x, y, columns, rows);
    }

References KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::ditherImpl().

ditherImpl() [1/6]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<DitherType t = dType, typename std::enable_if< t !=DITHER_NONE, void >::type * = nullptr>

void KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::ditherImpl ( const quint8 * src, quint8 * dst, int x, int y ) const

inlineprivate

Definition at line 60 of file KisCmykDitherOpFactory.h.

    {
        const srcChannelsType *nativeSrc = srcCSTraits::nativeArray(src);
        dstChannelsType *nativeDst = dstCSTraits::nativeArray(dst);
 
        float f = factor(x, y);
        float s = scale();
 
        // In (non-integer) CMYK, all channels except alpha are normalized
        // to a different range, [0, 100].
        for (uint channelIndex = 0; channelIndex < srcCSTraits::channels_nb; ++channelIndex) {
            if (channelIndex == srcCSTraits::alpha_pos) {
                // The standard normalization.
                float c = KoColorSpaceMaths<srcChannelsType, float>::scaleToA(nativeSrc[channelIndex]);
                c = KisDitherMaths::apply_dither(c, f, s);
                nativeDst[channelIndex] = KoColorSpaceMaths<float, dstChannelsType>::scaleToA(c);
                ;
            } else {
                // Normalize using unitCMYKValue.
                float c = normalize<srcChannelsType>(nativeSrc[channelIndex]);
                c = KisDitherMaths::apply_dither(c, f, s);
                nativeDst[channelIndex] = denormalize<dstChannelsType>(c);
                ;
            }
        }
    }

References KisDitherMaths::apply_dither(), KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::factor(), KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::scale(), and KoColorSpaceMaths< _T, _Tdst >::scaleToA().

ditherImpl() [2/6]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<DitherType t = dType, typename std::enable_if< t==DITHER_NONE &&std::is_same< srcCSTraits, dstCSTraits >::value, void >::type * = nullptr>

void KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::ditherImpl ( const quint8 * src, quint8 * dst, int , int  ) const

inlineprivate

Definition at line 39 of file KisCmykDitherOpFactory.h.

    {
        memcpy(dst, src, srcCSTraits::pixelSize);
    }

ditherImpl() [3/6]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<DitherType t = dType, typename std::enable_if< t==DITHER_NONE &&!std::is_same< srcCSTraits, dstCSTraits >::value, void >::type * = nullptr>

void KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::ditherImpl ( const quint8 * src, quint8 * dst, int , int  ) const

inlineprivate

Definition at line 44 of file KisCmykDitherOpFactory.h.

    {
        const srcChannelsType *nativeSrc = srcCSTraits::nativeArray(src);
        dstChannelsType *nativeDst = dstCSTraits::nativeArray(dst);
 
        for (uint channelIndex = 0; channelIndex < srcCSTraits::channels_nb; ++channelIndex) {
            if (channelIndex == srcCSTraits::alpha_pos) {
                // The standard normalization.
                nativeDst[channelIndex] = KoColorSpaceMaths<srcChannelsType, dstChannelsType>::scaleToA(nativeSrc[channelIndex]);
            } else {
                // Normalize using unitCMYKValue.
                nativeDst[channelIndex] = scaleToA<srcChannelsType, dstChannelsType>(nativeSrc[channelIndex]);
            }
        }
    }

References KoColorSpaceMaths< _T, _Tdst >::scaleToA().

ditherImpl() [4/6]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<DitherType t = dType, typename std::enable_if< t !=DITHER_NONE, void >::type * = nullptr>

void KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::ditherImpl ( const quint8 * srcRowStart, int srcRowStride, quint8 * dstRowStart, int dstRowStride, int x, int y, int columns, int rows ) const

inlineprivate

Definition at line 132 of file KisCmykDitherOpFactory.h.

    {
        const quint8 *nativeSrc = srcRowStart;
        quint8 *nativeDst = dstRowStart;
 
        float s = scale();
 
        for (int a = 0; a < rows; ++a) {
            const srcChannelsType *srcPtr = srcCSTraits::nativeArray(nativeSrc);
            dstChannelsType *dstPtr = dstCSTraits::nativeArray(nativeDst);
 
            for (int b = 0; b < columns; ++b) {
                float f = factor(x + b, y + a);
 
                for (uint channelIndex = 0; channelIndex < srcCSTraits::channels_nb; ++channelIndex) {
                    if (channelIndex == srcCSTraits::alpha_pos) {
                        // The standard normalization.
                        float c = KoColorSpaceMaths<srcChannelsType, float>::scaleToA(srcPtr[channelIndex]);
                        c = KisDitherMaths::apply_dither(c, f, s);
                        dstPtr[channelIndex] = KoColorSpaceMaths<float, dstChannelsType>::scaleToA(c);
                        ;
                    } else {
                        // Normalize using unitCMYKValue.
                        float c = normalize<srcChannelsType>(srcPtr[channelIndex]);
                        c = KisDitherMaths::apply_dither(c, f, s);
                        dstPtr[channelIndex] = denormalize<dstChannelsType>(c);
                        ;
                    }
                }
 
                srcPtr += srcCSTraits::channels_nb;
                dstPtr += dstCSTraits::channels_nb;
            }
 
            nativeSrc += srcRowStride;
            nativeDst += dstRowStride;
        }
    }

References KisDitherMaths::apply_dither(), KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::factor(), KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::scale(), and KoColorSpaceMaths< _T, _Tdst >::scaleToA().

ditherImpl() [5/6]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<DitherType t = dType, typename std::enable_if< t==DITHER_NONE &&std::is_same< srcCSTraits, dstCSTraits >::value, void >::type * = nullptr>

void KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::ditherImpl ( const quint8 * srcRowStart, int srcRowStride, quint8 * dstRowStart, int dstRowStride, int , int , int columns, int rows ) const

inlineprivate

Definition at line 88 of file KisCmykDitherOpFactory.h.

    {
        const quint8 *nativeSrc = srcRowStart;
        quint8 *nativeDst = dstRowStart;
 
        for (int y = 0; y < rows; ++y) {
            memcpy(nativeDst, nativeSrc, srcCSTraits::pixelSize * columns);
 
            nativeSrc += srcRowStride;
            nativeDst += dstRowStride;
        }
    }

ditherImpl() [6/6]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<DitherType t = dType, typename std::enable_if< t==DITHER_NONE &&!std::is_same< srcCSTraits, dstCSTraits >::value, void >::type * = nullptr>

void KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::ditherImpl ( const quint8 * srcRowStart, int srcRowStride, quint8 * dstRowStart, int dstRowStride, int , int , int columns, int rows ) const

inlineprivate

Definition at line 102 of file KisCmykDitherOpFactory.h.

    {
        const quint8 *nativeSrc = srcRowStart;
        quint8 *nativeDst = dstRowStart;
 
        for (int y = 0; y < rows; ++y) {
            const srcChannelsType *srcPtr = srcCSTraits::nativeArray(nativeSrc);
            dstChannelsType *dstPtr = dstCSTraits::nativeArray(nativeDst);
 
            for (int x = 0; x < columns; ++x) {
                for (uint channelIndex = 0; channelIndex < srcCSTraits::channels_nb; ++channelIndex) {
                    if (channelIndex == srcCSTraits::alpha_pos) {
                        // The standard normalization.
                        dstPtr[channelIndex] = KoColorSpaceMaths<srcChannelsType, dstChannelsType>::scaleToA(srcPtr[channelIndex]);
                    } else {
                        // Normalize using unitCMYKValue.
                        dstPtr[channelIndex] = scaleToA<srcChannelsType, dstChannelsType>(srcPtr[channelIndex]);
                    }
                }
 
                srcPtr += srcCSTraits::channels_nb;
                dstPtr += dstCSTraits::channels_nb;
            }
 
            nativeSrc += srcRowStride;
            nativeDst += dstRowStride;
        }
    }

References KoColorSpaceMaths< _T, _Tdst >::scaleToA().

factor() [1/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<DitherType t = dType, typename std::enable_if< t==DITHER_BAYER, void >::type * = nullptr>

float KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::factor ( int x, int y ) const

inlineprivate

Definition at line 208 of file KisCmykDitherOpFactory.h.

    {
        return KisDitherMaths::dither_factor_bayer_8(x, y);
    }

References KisDitherMaths::dither_factor_bayer_8().

factor() [2/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<DitherType t = dType, typename std::enable_if< t==DITHER_BLUE_NOISE, void >::type * = nullptr>

float KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::factor ( int x, int y ) const

inlineprivate

Definition at line 213 of file KisCmykDitherOpFactory.h.

    {
        return KisDitherMaths::dither_factor_blue_noise_64(x, y);
    }

References KisDitherMaths::dither_factor_blue_noise_64().

normalize() [1/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<typename A , typename U = srcCSTraits, typename std::enable_if< std::numeric_limits< A >::is_integer, void >::type * = nullptr>

float KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::normalize ( A value ) const

inlineprivate

Definition at line 173 of file KisCmykDitherOpFactory.h.

    {
        return static_cast<float>(value) / KoColorSpaceMathsTraits<A>::unitValue;
    };

References value().

normalize() [2/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<typename A , typename std::enable_if<!std::numeric_limits< A >::is_integer, void >::type * = nullptr>

float KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::normalize ( A value ) const

inlineprivate

Definition at line 178 of file KisCmykDitherOpFactory.h.

    {
        return static_cast<float>(value) / KoCmykColorSpaceMathsTraits<A>::unitValueCMYK;
    };

References value().

scale() [1/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<typename U = typename dstCSTraits::channels_type, typename std::enable_if<!std::numeric_limits< U >::is_integer, void >::type * = nullptr>

constexpr float KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::scale ( ) const

inlineconstexprprivate

Definition at line 198 of file KisCmykDitherOpFactory.h.

    {
        return 0.f; // no dithering for floating point
    }

scale() [2/2]

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<typename U = typename dstCSTraits::channels_type, typename std::enable_if< std::numeric_limits< U >::is_integer, void >::type * = nullptr>

constexpr float KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::scale ( ) const

inlineconstexprprivate

Definition at line 203 of file KisCmykDitherOpFactory.h.

    {
        return 1.f / static_cast<float>(1 << dstCSTraits::depth);
    }

scaleToA()

template<typename srcCSTraits , typename dstCSTraits , DitherType dType>

template<typename A , typename B >

B KisCmykDitherOpImpl< srcCSTraits, dstCSTraits, dType >::scaleToA ( A c ) const

inlineprivate

Definition at line 193 of file KisCmykDitherOpFactory.h.

    {
        return denormalize<B>(normalize<A>(c));
    }

---

The documentation for this class was generated from the following file:

• libs/pigment/dithering/KisCmykDitherOpFactory.h