#include <KoColorProfile.h>

Inheritance diagram for KoColorProfile:

Public Member Functions
virtual KoColorProfile *	clone () const =0

virtual QString	colorModelID () const

virtual bool	compareTRC (TransferCharacteristics characteristics, float error) const =0

QString	copyright () const

virtual void	delinearizeFloatValue (QVector< qreal > &Value) const =0

virtual void	delinearizeFloatValueFast (QVector< qreal > &Value) const =0

QString	fileName () const

virtual QVector< KoColorimetryUtils::xyY >	getColorantsxyY () const =0

virtual QVector< KoColorimetryUtils::XYZ >	getColorantsXYZ () const =0

virtual ColorPrimaries	getColorPrimaries () const
	getColorPrimaries

virtual QVector< qreal >	getEstimatedTRC () const =0

virtual TransferCharacteristics	getTransferCharacteristics () const
	getTransferCharacteristics This function should be subclassed at some point so we can get the value from the lcms profile.

virtual KoColorimetryUtils::xyY	getWhitePointxyY () const =0

virtual KoColorimetryUtils::XYZ	getWhitePointXYZ () const =0

virtual bool	hasColorants () const =0

virtual bool	hasTRC () const =0

QString	info () const

virtual bool	isLinear () const =0

virtual bool	isSuitableForDisplay () const =0

virtual bool	isSuitableForInput () const =0

virtual bool	isSuitableForOutput () const =0

virtual bool	isSuitableForPrinting () const =0

virtual bool	isSuitableForWorkspace () const =0

	KoColorProfile (const KoColorProfile &profile)

	KoColorProfile (const QString &fileName=QString())

virtual void	linearizeFloatValue (QVector< qreal > &Value) const =0

virtual void	linearizeFloatValueFast (QVector< qreal > &Value) const =0

virtual bool	load ()

QString	manufacturer () const

QString	name () const

virtual bool	operator== (const KoColorProfile &) const =0

virtual QByteArray	rawData () const

virtual bool	save (const QString &fileName)

void	setFileName (const QString &filename)

virtual bool	supportsAbsolute () const =0

virtual bool	supportsPerceptual () const =0

virtual bool	supportsRelative () const =0

virtual bool	supportsSaturation () const =0

virtual QString	type () const

virtual QByteArray	uniqueId () const =0

virtual bool	valid () const =0

virtual float	version () const =0

virtual	~KoColorProfile ()

Public Member Functions inherited from Private
	Private (KisCanvas2 *c)

Static Public Member Functions
static void	colorantsForType (ColorPrimaries primaries, KoColorimetryUtils::xy &whitePoint, QList< KoColorimetryUtils::xy > &colorants, const bool prequantized=false)
	colorantsForPrimaries fills a QVector<float> with the xy values of the whitepoint and red, green, blue colorants for a given predefined value. Will not change the vector when the primaries are set to 'undefined'.

static QString	getColorPrimariesName (ColorPrimaries primaries)
	getColorPrimariesName

static QString	getTransferCharacteristicName (TransferCharacteristics curve)
	getTransferCharacteristicName

Public Attributes
TransferCharacteristics	characteristics {TRC_UNSPECIFIED}

QString	copyright

QString	fileName

QString	info

QString	manufacturer

QString	name

int	primaries {-1}

Public Attributes inherited from Private
KisCanvas2 *	canvas

int	displayedFrame

int	intendedFrame

Protected Member Functions
void	setCharacteristics (ColorPrimaries primaries, TransferCharacteristics curve)
	setCharacteristics ideally, we'd read this from the icc profile curve, but that can be tricky, instead we'll set it on profile creation.

void	setCopyright (const QString &copyright)

void	setInfo (const QString &info)

void	setManufacturer (const QString &manufacturer)

void	setName (const QString &name)

Private Attributes
Private *const	d

Detailed Description

Contains information needed for color transformation.

Definition at line 15 of file KoColorProfile.cpp.

Constructor & Destructor Documentation

◆ KoColorProfile() [1/2]

KoColorProfile::KoColorProfile ( const QString & fileName = QString() )

explicit

Parameters

fileName file name to load or save that profile

Definition at line 25 of file KoColorProfile.cpp.

                                                      : d(new Private)
{
//     dbgPigment <<" Profile filename =" << fileName;
    d->fileName = fileName;
}

References d, and fileName.

◆ KoColorProfile() [2/2]

KoColorProfile::KoColorProfile ( const KoColorProfile & profile )

Definition at line 31 of file KoColorProfile.cpp.

    : d(new Private(*profile.d))
{
}

◆ ~KoColorProfile()

KoColorProfile::~KoColorProfile ( )

virtual

Definition at line 36 of file KoColorProfile.cpp.

{
    delete d;
}

References d.

Member Function Documentation

◆ clone()

virtual KoColorProfile * KoColorProfile::clone ( ) const

pure virtual

Create a copy of this profile. Data that shall not change during the life time of the profile shouldn't be duplicated but shared, like for instance ICC data.

Data that shall be changed like a palette or hdr information such as exposure must be duplicated while cloning.

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ colorantsForType()

void KoColorProfile::colorantsForType	(	ColorPrimaries	primaries,
		KoColorimetryUtils::xy &	whitePoint,
		QList< KoColorimetryUtils::xy > &	colorants,
		const bool	prequantized = false )

static

colorantsForPrimaries fills a QVector<float> with the xy values of the whitepoint and red, green, blue colorants for a given predefined value. Will not change the vector when the primaries are set to 'undefined'.

Parameters

primaries	predefined value.
whitePoint	the white point to fill.
colorants	the vector to fill.
prequantized	whether to get the prequantized values, these are used for precision when encoding to icc only.

Definition at line 166 of file KoColorProfile.cpp.

{
    KoColorimetryUtils::Colorimetry c = KoColorimetryUtils::Colorimetry::BT709;
    switch (ColorPrimaries(primaries)) {
    case PRIMARIES_UNSPECIFIED:
        break;
    case PRIMARIES_ITU_R_BT_470_6_SYSTEM_M:
        // Unquantized.
        c = KoColorimetryUtils::Colorimetry::PAL_M;
        whitePoint = c.white().toxy();
        colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        //Illuminant C
        break;
    case PRIMARIES_ITU_R_BT_470_6_SYSTEM_B_G:
        // Unquantized.
        c = KoColorimetryUtils::Colorimetry::PAL;
        whitePoint = c.white().toxy();
        colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        break;
    case PRIMARIES_ITU_R_BT_601_6:
        c = KoColorimetryUtils::Colorimetry::NTSC;
        whitePoint = c.white().toxy();
        colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        break;
    case PRIMARIES_SMPTE_240M:
        whitePoint = {0.3127, 0.3290};
        colorants = {{0.630, 0.340}};
        colorants.append({0.310, 0.595});
        colorants.append({0.155, 0.070});
        break;
    case PRIMARIES_GENERIC_FILM:
        c = KoColorimetryUtils::Colorimetry::GenericFilm;
        whitePoint = c.white().toxy();
        colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        //Illuminant C
        break;
    case PRIMARIES_ITU_R_BT_2020_2_AND_2100_0:
        //prequantization courtesy of Elle Stone.
 
        if (prequantized) {
            whitePoint = {0.3127, 0.3290};
            colorants = {{0.708012540607, 0.291993664388}};
            colorants.append({0.169991652439, 0.797007778423});
            colorants.append({0.130997824007, 0.045996550894});
        } else {
            c = KoColorimetryUtils::Colorimetry::BT2020;
            whitePoint = c.white().toxy();
            colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        }
        break;
    case PRIMARIES_SMPTE_ST_428_1:
        c = KoColorimetryUtils::Colorimetry::CIEXYZ;
        whitePoint = c.white().toxy();
        colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        break;
    case PRIMARIES_SMPTE_RP_431_2:
        c = KoColorimetryUtils::Colorimetry::DCIP3;
        whitePoint = c.white().toxy();
        colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        break;
    case PRIMARIES_SMPTE_EG_432_1:
        c = KoColorimetryUtils::Colorimetry::DisplayP3;
        whitePoint = c.white().toxy();
        colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        break;
    case PRIMARIES_EBU_Tech_3213_E:
        whitePoint = {0.3127, 0.3290};
        colorants = {{0.63, 0.34}};
        colorants.append({0.295, 0.605});
        colorants.append({0.155, 0.077});
        break;
    case PRIMARIES_PROPHOTO:
 
        if (prequantized) {
            //prequantization courtesy of Elle Stone.
            whitePoint = {0.3457, 0.3585};
            colorants = {{0.7347, 0.2653}};
            colorants.append({0.1596, 0.8404});
            colorants.append({0.0366, 0.0001});
        } else {
            whitePoint = {0.3457, 0.3585};
            colorants = {{0.734699, 0.265301}};
            colorants.append({0.159597, 0.840403});
            colorants.append({0.036598, 0.000105});
        }
 
        break;
    case PRIMARIES_ADOBE_RGB_1998:
        if (prequantized) {
            //prequantization courtesy of Elle Stone.
            whitePoint = {0.3127, 0.3290};
            colorants = {{0.639996511, 0.329996864}};
            colorants.append({0.210005295, 0.710004866});
            colorants.append({0.149997606, 0.060003644});
        }  else {
            c = KoColorimetryUtils::Colorimetry::AdobeRGB;
            whitePoint = c.white().toxy();
            colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        }
        break;
    case PRIMARIES_ITU_R_BT_709_5:
    default:
        if (prequantized) {
            // Prequantized colorants, courtesy of Elle Stone
            whitePoint = {0.3127, 0.3290};
            colorants = {{0.639998686, 0.330010138}};
            colorants.append({0.300003784, 0.600003357});
            colorants.append({0.150002046, 0.059997204});
        }  else {
            c = KoColorimetryUtils::Colorimetry::BT709;
            whitePoint = c.white().toxy();
            colorants = {c.red().toxy(), c.green().toxy(), c.blue().toxy()};
        }
        break;
 
    }
}

◆ colorModelID()

virtual QString KoColorProfile::colorModelID ( ) const

inlinevirtual

Returns: a string for a color model id.

Reimplemented in IccColorProfile.

Definition at line 102 of file KoColorProfile.h.

                                         {
        return QString();
    };

◆ compareTRC()

virtual bool KoColorProfile::compareTRC	(	TransferCharacteristics	characteristics,
		float	error ) const

pure virtual

Comparing profile's TRC against the other with defined error threshold, returns true if profile TRC is matched.

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ copyright()

QString KoColorProfile::copyright ( ) const

Returns: the copyright of the profile

◆ delinearizeFloatValue()

virtual void KoColorProfile::delinearizeFloatValue ( QVector< qreal > & Value ) const

pure virtual

Delinearizes first 3 values of QVector, leaving other values unchanged. Returns the same QVector if it is not possible to delinearize. Effectively undoes LinearizeFloatValue.

Implemented in IccColorProfile.

◆ delinearizeFloatValueFast()

virtual void KoColorProfile::delinearizeFloatValueFast ( QVector< qreal > & Value ) const

pure virtual

Implemented in IccColorProfile.

◆ fileName()

QString KoColorProfile::fileName ( ) const

Returns: the filename of the profile (it might be empty)

◆ getColorantsxyY()

virtual QVector< KoColorimetryUtils::xyY > KoColorProfile::getColorantsxyY ( ) const

pure virtual

Returns: a qvector <KoColorimetryUtils::xyY> with the colorants in xyY

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ getColorantsXYZ()

virtual QVector< KoColorimetryUtils::XYZ > KoColorProfile::getColorantsXYZ ( ) const

pure virtual

Returns: a qvector <KoColorimetryUtils::XYZ> with the RGB colorants in XYZ

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ getColorPrimaries()

ColorPrimaries KoColorProfile::getColorPrimaries ( ) const

virtual

getColorPrimaries

Returns: colorprimaries, defaults to 'unspecified' if no match is possible.

Definition at line 80 of file KoColorProfile.cpp.

{
    if (d->primaries == -1) {
        ColorPrimaries primaries = PRIMARIES_UNSPECIFIED;
        KoColorimetryUtils::xyY wp = getWhitePointxyY();
 
        bool match = false;
        if (hasColorants()) {
            QVector<KoColorimetryUtils::xyY> col = getColorantsxyY();
            if (col.size()<3) {
                KIS_SAFE_ASSERT_RECOVER_RETURN_VALUE(col.size() < 3, PRIMARIES_UNSPECIFIED);
                //too few colorants.
                d->primaries = int(primaries);
                return (primaries);
            }
            QVector<KoColorimetryUtils::xyY> colorants = col;
            colorants.append(wp);
            QList<KoColorimetryUtils::xy> compare;
            KoColorimetryUtils::xy wp2;
 
            QVector<ColorPrimaries> primariesList = {PRIMARIES_ITU_R_BT_709_5, PRIMARIES_ITU_R_BT_601_6, PRIMARIES_ITU_R_BT_470_6_SYSTEM_M,
                                                     PRIMARIES_ITU_R_BT_2020_2_AND_2100_0, PRIMARIES_SMPTE_EG_432_1, PRIMARIES_SMPTE_RP_431_2,
                                                     PRIMARIES_SMPTE_ST_428_1, PRIMARIES_GENERIC_FILM, PRIMARIES_SMPTE_240M, PRIMARIES_EBU_Tech_3213_E,
                                                     PRIMARIES_ADOBE_RGB_1998, PRIMARIES_PROPHOTO, PRIMARIES_ITU_R_BT_470_6_SYSTEM_B_G};
 
            for (ColorPrimaries check: primariesList) {
                colorantsForType(check, wp2, compare);
                if (compare.size() <3) {
                    KIS_SAFE_ASSERT_RECOVER(compare.size() < 3) { continue; }
                    //too few colorants, skip.
                }
                compare.append(wp2);
                match = true;
                for (int i=0; i<colorants.size(); i++) {
                    match = std::fabs(colorants[i].x - compare[i].x) < 0.0001
                        && std::fabs(colorants[i].y - compare[i].y) < 0.0001;
                    if (!match) {
                        break;
                    }
                }
                if (match) {
                    primaries = check;
                }
            }
        }
 
        d->primaries = int(primaries);
    }
    return ColorPrimaries(d->primaries);
}

References colorantsForType(), d, getColorantsxyY(), getWhitePointxyY(), hasColorants(), KIS_SAFE_ASSERT_RECOVER, KIS_SAFE_ASSERT_RECOVER_RETURN_VALUE, primaries, PRIMARIES_ADOBE_RGB_1998, PRIMARIES_EBU_Tech_3213_E, PRIMARIES_GENERIC_FILM, PRIMARIES_ITU_R_BT_2020_2_AND_2100_0, PRIMARIES_ITU_R_BT_470_6_SYSTEM_B_G, PRIMARIES_ITU_R_BT_470_6_SYSTEM_M, PRIMARIES_ITU_R_BT_601_6, PRIMARIES_ITU_R_BT_709_5, PRIMARIES_PROPHOTO, PRIMARIES_SMPTE_240M, PRIMARIES_SMPTE_EG_432_1, PRIMARIES_SMPTE_RP_431_2, PRIMARIES_SMPTE_ST_428_1, and PRIMARIES_UNSPECIFIED.

◆ getColorPrimariesName()

QString KoColorProfile::getColorPrimariesName ( ColorPrimaries primaries )

static

getColorPrimariesName

Parameters

primaries

Returns: human friendly name of the primary.

Definition at line 131 of file KoColorProfile.cpp.

{
    switch (primaries) {
    case PRIMARIES_ITU_R_BT_709_5:
        return QStringLiteral("Rec. 709");
    case PRIMARIES_ITU_R_BT_470_6_SYSTEM_M:
        return QStringLiteral("BT. 470 System M");
    case PRIMARIES_ITU_R_BT_470_6_SYSTEM_B_G:
        return QStringLiteral("BT. 470 System B, G");
    case PRIMARIES_GENERIC_FILM:
        return QStringLiteral("Generic Film");
    case PRIMARIES_SMPTE_240M:
        return QStringLiteral("SMPTE 240 M");
    case PRIMARIES_ITU_R_BT_2020_2_AND_2100_0:
        return QStringLiteral("Rec. 2020");
    case PRIMARIES_ITU_R_BT_601_6:
        return QStringLiteral("Rec. 601");
    case PRIMARIES_SMPTE_EG_432_1:
        return QStringLiteral("Display P3");
    case PRIMARIES_SMPTE_RP_431_2:
        return QStringLiteral("DCI P3");
    case PRIMARIES_SMPTE_ST_428_1:
        return QStringLiteral("XYZ primaries");
    case PRIMARIES_EBU_Tech_3213_E:
        return QStringLiteral("EBU Tech 3213 E");
    case PRIMARIES_PROPHOTO:
        return QStringLiteral("ProPhoto");
    case PRIMARIES_ADOBE_RGB_1998:
        return QStringLiteral("A98");
    case PRIMARIES_UNSPECIFIED:
        break;
    }
    return QStringLiteral("Unspecified");
}

References primaries, PRIMARIES_ADOBE_RGB_1998, PRIMARIES_EBU_Tech_3213_E, PRIMARIES_GENERIC_FILM, PRIMARIES_ITU_R_BT_2020_2_AND_2100_0, PRIMARIES_ITU_R_BT_470_6_SYSTEM_B_G, PRIMARIES_ITU_R_BT_470_6_SYSTEM_M, PRIMARIES_ITU_R_BT_601_6, PRIMARIES_ITU_R_BT_709_5, PRIMARIES_PROPHOTO, PRIMARIES_SMPTE_240M, PRIMARIES_SMPTE_EG_432_1, PRIMARIES_SMPTE_RP_431_2, PRIMARIES_SMPTE_ST_428_1, and PRIMARIES_UNSPECIFIED.

◆ getEstimatedTRC()

virtual QVector< qreal > KoColorProfile::getEstimatedTRC ( ) const

pure virtual

Returns: estimated gamma for RGB and Grayscale profiles

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ getTransferCharacteristicName()

QString KoColorProfile::getTransferCharacteristicName ( TransferCharacteristics curve )

static

getTransferCharacteristicName

Parameters

curve the number

Returns: name of the characteristic

Definition at line 344 of file KoColorProfile.cpp.

{
    switch (curve) {
    case TRC_ITU_R_BT_709_5:
    case TRC_ITU_R_BT_601_6:
    case TRC_ITU_R_BT_2020_2_10bit:
        return QString("rec 709 trc");
    case TRC_ITU_R_BT_2020_2_12bit:
        return QString("rec 2020 12bit trc");
    case TRC_ITU_R_BT_470_6_SYSTEM_M:
        return QString("Gamma 2.2");
    case TRC_ITU_R_BT_470_6_SYSTEM_B_G:
        return QString("Gamma 2.8");
    case TRC_SMPTE_240M:
        return QString("SMPTE 240 trc");
    case TRC_LINEAR:
        return QString("Linear");
    case TRC_LOGARITHMIC_100:
        return QString("Logarithmic 100");
    case TRC_LOGARITHMIC_100_sqrt10:
        return QString("Logarithmic 100 sqrt10");
    case TRC_IEC_61966_2_4:
        return QString("IEC 61966 2.4");
    case TRC_ITU_R_BT_1361:
    case TRC_IEC_61966_2_1:
        return QString("sRGB trc");
    case TRC_SMPTE_ST_428_1:
        return QString("SMPTE ST 428");
    case TRC_ITU_R_BT_2100_0_PQ:
        return QString("Perceptual Quantizer");
    case TRC_ITU_R_BT_2100_0_HLG:
        return QString("Hybrid Log Gamma");
    case TRC_GAMMA_1_8:
        return QString("Gamma 1.8");
    case TRC_GAMMA_2_4:
        return QString("Gamma 2.4");
    case TRC_A98:
        return QString("Gamma A98");
    case TRC_PROPHOTO:
        return QString("ProPhoto trc");
    case TRC_LAB_L:
        return QString("Lab L* trc");
    case TRC_UNSPECIFIED:
        break;
    }
 
    return QString("Unspecified");
}

References TRC_A98, TRC_GAMMA_1_8, TRC_GAMMA_2_4, TRC_IEC_61966_2_1, TRC_IEC_61966_2_4, TRC_ITU_R_BT_1361, TRC_ITU_R_BT_2020_2_10bit, TRC_ITU_R_BT_2020_2_12bit, TRC_ITU_R_BT_2100_0_HLG, TRC_ITU_R_BT_2100_0_PQ, TRC_ITU_R_BT_470_6_SYSTEM_B_G, TRC_ITU_R_BT_470_6_SYSTEM_M, TRC_ITU_R_BT_601_6, TRC_ITU_R_BT_709_5, TRC_LAB_L, TRC_LINEAR, TRC_LOGARITHMIC_100, TRC_LOGARITHMIC_100_sqrt10, TRC_PROPHOTO, TRC_SMPTE_240M, TRC_SMPTE_ST_428_1, and TRC_UNSPECIFIED.

◆ getTransferCharacteristics()

TransferCharacteristics KoColorProfile::getTransferCharacteristics ( ) const

virtual

getTransferCharacteristics This function should be subclassed at some point so we can get the value from the lcms profile.

Returns: transferfunction number.

Definition at line 287 of file KoColorProfile.cpp.

{
    // Parse from an estimated gamma
    const QVector<double> estimatedTRC = getEstimatedTRC();
    const double error = 0.0001;
    // Make sure the TRC is uniform across all channels
    const bool isUniformTRC = (estimatedTRC[0] == estimatedTRC[1] && estimatedTRC[0] == estimatedTRC[2]);
    if (d->characteristics == TRC_UNSPECIFIED && isUniformTRC && hasTRC()) {
        if (isLinear()) {
            d->characteristics = TRC_LINEAR;
        } else if (std::fabs(estimatedTRC[0] - (461.0 / 256.0)) < error) {
            // ICC v2 u8Fixed8Number calculation
            // Or can be prequantized as 1.80078125, courtesy of Elle Stone
            d->characteristics = TRC_GAMMA_1_8;
        } else if (std::fabs(estimatedTRC[0] - (563.0 / 256.0)) < error) {
            // Or can be prequantized as 2.19921875, courtesy of Elle Stone
            d->characteristics = TRC_A98;
        } else if (std::fabs(estimatedTRC[0] - 1.8) < error) {
            d->characteristics = TRC_GAMMA_1_8;
        } else if (std::fabs(estimatedTRC[0] - 2.2) < error) {
            d->characteristics = TRC_ITU_R_BT_470_6_SYSTEM_M;
        } else if (std::fabs(estimatedTRC[0] - 2.4) < error) {
            d->characteristics = TRC_GAMMA_2_4;
        } else if (std::fabs(estimatedTRC[0] - 2.8) < error) {
            d->characteristics = TRC_ITU_R_BT_470_6_SYSTEM_B_G;
        } else {
            // Escort to curve matching if no gamma is matched
            static constexpr std::array<TransferCharacteristics, 12> trcList = {{TRC_ITU_R_BT_709_5,
                                                                                 TRC_ITU_R_BT_470_6_SYSTEM_M,
                                                                                 TRC_ITU_R_BT_470_6_SYSTEM_B_G,
                                                                                 TRC_SMPTE_240M,
                                                                                 TRC_IEC_61966_2_1,
                                                                                 TRC_LOGARITHMIC_100,
                                                                                 TRC_LOGARITHMIC_100_sqrt10,
                                                                                 TRC_PROPHOTO,
                                                                                 TRC_GAMMA_1_8,
                                                                                 TRC_GAMMA_2_4,
                                                                                 TRC_A98,
                                                                                 TRC_LAB_L}};
            const auto characteristic =
                std::find_if(trcList.begin(), trcList.end(), [&](const TransferCharacteristics &check) -> bool {
                    return compareTRC(check, static_cast<float>(error));
                });
            if (characteristic != trcList.end()) {
                d->characteristics = *characteristic;
            }
        }
    }
    return d->characteristics;
}

References d, getEstimatedTRC(), hasTRC(), isLinear(), TRC_A98, TRC_GAMMA_1_8, TRC_GAMMA_2_4, TRC_IEC_61966_2_1, TRC_ITU_R_BT_470_6_SYSTEM_B_G, TRC_ITU_R_BT_470_6_SYSTEM_M, TRC_ITU_R_BT_709_5, TRC_LAB_L, TRC_LINEAR, TRC_LOGARITHMIC_100, TRC_LOGARITHMIC_100_sqrt10, TRC_PROPHOTO, TRC_SMPTE_240M, and TRC_UNSPECIFIED.

◆ getWhitePointxyY()

virtual KoColorimetryUtils::xyY KoColorProfile::getWhitePointxyY ( ) const

pure virtual

Returns: a KoColorimetryUtils::xyY with the whitepoint in xyY

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ getWhitePointXYZ()

virtual KoColorimetryUtils::XYZ KoColorProfile::getWhitePointXYZ ( ) const

pure virtual

Returns: a KoColorimetryUtils::XYZ with the whitepoint in XYZ

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ hasColorants()

virtual bool KoColorProfile::hasColorants ( ) const

pure virtual

Returns: if the profile has colorants.

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ hasTRC()

virtual bool KoColorProfile::hasTRC ( ) const

pure virtual

Returns: if the profile has a TRC(required for linearisation).

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ info()

QString KoColorProfile::info ( ) const

Returns: the info of this profile

◆ isLinear()

virtual bool KoColorProfile::isLinear ( ) const

pure virtual

Returns: if the profile's TRCs are linear.

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ isSuitableForDisplay()

virtual bool KoColorProfile::isSuitableForDisplay ( ) const

pure virtual

Returns: true if this profile is suitable to use for display

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ isSuitableForInput()

virtual bool KoColorProfile::isSuitableForInput ( ) const

pure virtual

Returns: true if this profile can be used to convert color from this one to a different one

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ isSuitableForOutput()

virtual bool KoColorProfile::isSuitableForOutput ( ) const

pure virtual

Returns: true if this profile can be used to convert color from a different profile to this one

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ isSuitableForPrinting()

virtual bool KoColorProfile::isSuitableForPrinting ( ) const

pure virtual

Returns: true if this profile is suitable to use for printing

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ isSuitableForWorkspace()

virtual bool KoColorProfile::isSuitableForWorkspace ( ) const

pure virtual

Returns: true if you can use this profile can be used in Krita

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ linearizeFloatValue()

virtual void KoColorProfile::linearizeFloatValue ( QVector< qreal > & Value ) const

pure virtual

Linearizes first 3 values of QVector, leaving other values unchanged. Returns the same QVector if it is not possible to linearize.

Implemented in IccColorProfile.

◆ linearizeFloatValueFast()

virtual void KoColorProfile::linearizeFloatValueFast ( QVector< qreal > & Value ) const

pure virtual

More imprecise versions of the above(limited to 16bit, and can't delinearize above 1.0.) Use this for filters and images.

Implemented in IccColorProfile.

◆ load()

bool KoColorProfile::load ( )

virtual

Load the profile in memory.

Returns: true if the profile has been successfully loaded

Reimplemented in IccColorProfile.

Definition at line 41 of file KoColorProfile.cpp.

{
    return false;
}

◆ manufacturer()

QString KoColorProfile::manufacturer ( ) const

Returns: manufacturer of the profile

◆ name()

QString KoColorProfile::name ( ) const

Returns: the name of this profile

◆ operator==()

virtual bool KoColorProfile::operator== ( const KoColorProfile & ) const

pure virtual

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ rawData()

virtual QByteArray KoColorProfile::rawData ( ) const

inlinevirtual

Returns: an array with the raw data of the profile

Reimplemented in IccColorProfile.

Definition at line 198 of file KoColorProfile.h.

                                       {
        return QByteArray();
    }

◆ save()

bool KoColorProfile::save ( const QString & fileName )

virtual

Override this function to save the profile.

Parameters

fileName destination

Returns: true if the profile has been successfully saved

Reimplemented in IccColorProfile.

Definition at line 46 of file KoColorProfile.cpp.

{
    Q_UNUSED(filename);
    return false;
}

◆ setCharacteristics()

void KoColorProfile::setCharacteristics	(	ColorPrimaries	primaries,
		TransferCharacteristics	curve )

protected

setCharacteristics ideally, we'd read this from the icc profile curve, but that can be tricky, instead we'll set it on profile creation.

Parameters

curve

Definition at line 338 of file KoColorProfile.cpp.

{
    d->primaries = int(primaries);
    d->characteristics = curve;
}

References d, and primaries.

◆ setCopyright()

void KoColorProfile::setCopyright ( const QString & copyright )

protected

Allows to set the copyright string of that profile.

Definition at line 405 of file KoColorProfile.cpp.

{
    d->copyright = copyright;
}

References copyright, and d.

◆ setFileName()

void KoColorProfile::setFileName ( const QString & filename )

Parameters

filename new filename

Definition at line 75 of file KoColorProfile.cpp.

{
    d->fileName = f;
}

References d.

◆ setInfo()

void KoColorProfile::setInfo ( const QString & info )

protected

Allows to set the information string of that profile.

Definition at line 397 of file KoColorProfile.cpp.

{
    d->info = info;
}

References d, and info.

◆ setManufacturer()

void KoColorProfile::setManufacturer ( const QString & manufacturer )

protected

Allows to set the manufacturer string of that profile.

Definition at line 401 of file KoColorProfile.cpp.

{
    d->manufacturer = manufacturer;
}

References d, and manufacturer.

◆ setName()

void KoColorProfile::setName ( const QString & name )

protected

Allows to define the name of this profile.

Definition at line 393 of file KoColorProfile.cpp.

{
    d->name = name;
}

References d, and name.

◆ supportsAbsolute()

virtual bool KoColorProfile::supportsAbsolute ( ) const

pure virtual

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ supportsPerceptual()

virtual bool KoColorProfile::supportsPerceptual ( ) const

pure virtual

Returns: which rendering intents are supported

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ supportsRelative()

virtual bool KoColorProfile::supportsRelative ( ) const

pure virtual

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ supportsSaturation()

virtual bool KoColorProfile::supportsSaturation ( ) const

pure virtual

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ type()

virtual QString KoColorProfile::type ( ) const

inlinevirtual

Returns: the type of this profile (icc, ctlcs etc)

Reimplemented in IccColorProfile.

Definition at line 37 of file KoColorProfile.h.

                                 {
        return QString();
    }

◆ uniqueId()

virtual QByteArray KoColorProfile::uniqueId ( ) const

pure virtual

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ valid()

virtual bool KoColorProfile::valid ( ) const

pure virtual

Returns: true if the profile is valid, false if it isn't been loaded in memory yet, or if the loaded memory is a bad profile

Implemented in KoDummyColorProfile, and IccColorProfile.

◆ version()

virtual float KoColorProfile::version ( ) const

pure virtual

Return version

Implemented in KoDummyColorProfile, and IccColorProfile.

Member Data Documentation

◆ characteristics

TransferCharacteristics KoColorProfile::characteristics {TRC_UNSPECIFIED}

Definition at line 22 of file KoColorProfile.cpp.

22{TRC_UNSPECIFIED};

◆ copyright

QString KoColorProfile::copyright

Definition at line 20 of file KoColorProfile.cpp.

◆ d

Private* const KoColorProfile::d

private

Definition at line 267 of file KoColorProfile.h.

◆ fileName

QString KoColorProfile::fileName

Definition at line 18 of file KoColorProfile.cpp.

◆ info

QString KoColorProfile::info

Definition at line 17 of file KoColorProfile.cpp.

◆ manufacturer

QString KoColorProfile::manufacturer

Definition at line 19 of file KoColorProfile.cpp.

◆ name

QString KoColorProfile::name

Definition at line 16 of file KoColorProfile.cpp.

◆ primaries

int KoColorProfile::primaries {-1}

Definition at line 21 of file KoColorProfile.cpp.

21{-1};

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

libs/pigment/KoColorProfile.cpp
libs/pigment/KoColorProfile.h

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ KoColorProfile() [1/2]

◆ KoColorProfile() [2/2]

◆ ~KoColorProfile()

Member Function Documentation

◆ clone()

◆ colorantsForType()

◆ colorModelID()

◆ compareTRC()

◆ copyright()

◆ delinearizeFloatValue()

◆ delinearizeFloatValueFast()

◆ fileName()

◆ getColorantsxyY()

◆ getColorantsXYZ()

◆ getColorPrimaries()

◆ getColorPrimariesName()

◆ getEstimatedTRC()

◆ getTransferCharacteristicName()

◆ getTransferCharacteristics()

◆ getWhitePointxyY()

◆ getWhitePointXYZ()

◆ hasColorants()

◆ hasTRC()

◆ info()

◆ isLinear()

◆ isSuitableForDisplay()

◆ isSuitableForInput()

◆ isSuitableForOutput()

◆ isSuitableForPrinting()

◆ isSuitableForWorkspace()

◆ linearizeFloatValue()

◆ linearizeFloatValueFast()

◆ load()

◆ manufacturer()

◆ name()

◆ operator==()

◆ rawData()

◆ save()

◆ setCharacteristics()

◆ setCopyright()

◆ setFileName()

◆ setInfo()

◆ setManufacturer()

◆ setName()

◆ supportsAbsolute()

◆ supportsPerceptual()

◆ supportsRelative()

◆ supportsSaturation()

◆ type()

◆ uniqueId()

◆ valid()

◆ version()

Member Data Documentation

◆ characteristics

◆ copyright

◆ d

◆ fileName

◆ info

◆ manufacturer

◆ name

◆ primaries