LcmsPredefinedPipelineFunctions Class Reference

The LcmsPredfinedPipelineFunctions class This class defines static functions to help create ICC profiles with LCMS. More...

#include <LcmsPredefinedPipelineFunctions.h>

Static Public Member Functions
static bool	setDiffuseWhitePerceptualQuantizer (cmsHPROFILE iccProfile, double diffuseWhiteNits=80.0)
	setDiffuseWhitePerceptualQuantizer This adds a dictionary with an CRWL entry to the profile.
static bool	setPerceptualQuantizerAToBDummyPipeline (cmsHPROFILE iccProfile, cmsTagSignature tag, ColorPrimaries primaries, double diffuseWhiteNits=80.0)
static bool	setPerceptualQuantizerBToADummyPipeline (cmsHPROFILE iccProfile, cmsTagSignature tag, ColorPrimaries primaries, double diffuseWhiteNits=80.0)

Detailed Description

The LcmsPredfinedPipelineFunctions class This class defines static functions to help create ICC profiles with LCMS.

Definition at line 19 of file LcmsPredefinedPipelineFunctions.h.

Member Function Documentation

setDiffuseWhitePerceptualQuantizer()

bool LcmsPredefinedPipelineFunctions::setDiffuseWhitePerceptualQuantizer ( cmsHPROFILE iccProfile, double diffuseWhiteNits = 80.0 )

static

setDiffuseWhitePerceptualQuantizer This adds a dictionary with an CRWL entry to the profile.

Returns

whether it was successfully written.

Definition at line 235 of file LcmsPredefinedPipelineFunctions.cpp.

{
    bool success = false;
    cmsHANDLE dictionary = cmsDictAlloc(nullptr);
 
 
 
    // https://registry.color.org/dicttype-metadata/crwl
    cmsMLU *mluName = cmsMLUalloc (NULL, 1);
    QString name("CRWL");
    cmsMLUsetASCII (mluName, "en", "US", name.toLatin1());
 
    // Hack to avoid having to figure out how to get the value.
    int count = cmsMLUgetWide(mluName, "en", "US", nullptr, 0);
    std::vector<wchar_t> nameArray(count);
    cmsMLUgetWide(mluName, "en", "US", nameArray.data(), count);
 
    cmsMLU *mluValue = cmsMLUalloc (NULL, 1);
    QString value = KisDomUtils::toString(diffuseWhiteNits);
    cmsMLUsetASCII (mluValue, "en", "US", value.toLatin1());
    count = cmsMLUgetWide(mluValue, "en", "US", nullptr, 0);
    std::vector<wchar_t> valArray(count);
    cmsMLUgetWide(mluValue, "en", "US", valArray.data(), count);
 
    success = cmsDictAddEntry(dictionary, nameArray.data(), valArray.data(), mluName, mluValue);
 
    if (success) {
        success = cmsWriteTag(iccProfile, cmsSigMetaTag, dictionary);
    }
 
    cmsMLUfree(mluName);
    cmsMLUfree(mluValue);
    cmsDictFree(dictionary);
    return success;
}

References KisDomUtils::toString(), and value().

setPerceptualQuantizerAToBDummyPipeline()

bool LcmsPredefinedPipelineFunctions::setPerceptualQuantizerAToBDummyPipeline ( cmsHPROFILE iccProfile, cmsTagSignature tag, ColorPrimaries primaries, double diffuseWhiteNits = 80.0 )

static

Definition at line 136 of file LcmsPredefinedPipelineFunctions.cpp.

{
    // From profile space to XYZ.
    const double factor = 1.0;
    const int lutSize = 4;
 
    double luma[3];
    const QMatrix4x4 tf = rgbMatrix(primaries, factor, luma);
 
    // linear curves, obligatory for A2B with both matrix and clut: linear-clut-curves-matrix-linear.
    cmsPipeline *a2B = cmsPipelineAlloc(nullptr, 3, 3);
 
    cmsToneCurve *linearCurves[3];
    linearCurves[0] = linearCurves[1] = linearCurves[2] = cmsBuildGamma(nullptr, 1.0);
    cmsStage *lCurveStage = cmsStageAllocToneCurves(nullptr, 3, linearCurves);
    cmsPipelineInsertStage(a2B, cmsAT_END, lCurveStage);
 
    cmsStage *clutStage = cmsStageAllocCLut16bit(nullptr, lutSize, 3, 3, nullptr);
    perceptualDummyHelper helper;
    helper.toXYZ = true;
    helper.luma = luma;
    helper.diffuseWhiteNits = diffuseWhiteNits;
    cmsStageSampleCLut16bit(clutStage, &samplePQDummyClut, &helper, 0);
    cmsPipelineInsertStage(a2B, cmsAT_END, clutStage);
 
    // close to "PQ" curve
    cmsToneCurve *curve[3];
    curve[0] = curve[1] = curve[2] = cmsBuildGamma(nullptr, 2.2);
    cmsStage *curveStage = cmsStageAllocToneCurves(nullptr, 3, curve);
    cmsPipelineInsertStage(a2B, cmsAT_END, curveStage);
 
    // matrix
 
    double m[] = {
        tf(0, 0), tf(0, 1), tf(0, 2),
        tf(1, 0), tf(1, 1), tf(1, 2),
        tf(2, 0), tf(2, 1), tf(2, 2)
    };
 
    cmsStage* matrixStage = cmsStageAllocMatrix(nullptr, 3, 3, m, nullptr);
    cmsPipelineInsertStage(a2B, cmsAT_END, matrixStage);
 
    // curves, linear
    cmsPipelineInsertStage(a2B, cmsAT_END, cmsStageDup(lCurveStage));
 
    bool success = cmsWriteTag(iccProfile, tag, a2B);
    cmsFreeToneCurve(curve[0]);
    cmsFreeToneCurve(linearCurves[0]);
    cmsPipelineFree(a2B);
    return success;
}

References perceptualDummyHelper::diffuseWhiteNits, perceptualDummyHelper::luma, rgbMatrix(), samplePQDummyClut(), and perceptualDummyHelper::toXYZ.

setPerceptualQuantizerBToADummyPipeline()

bool LcmsPredefinedPipelineFunctions::setPerceptualQuantizerBToADummyPipeline ( cmsHPROFILE iccProfile, cmsTagSignature tag, ColorPrimaries primaries, double diffuseWhiteNits = 80.0 )

static

Definition at line 188 of file LcmsPredefinedPipelineFunctions.cpp.

{
    // From XYZ to profile space.
    const double factor = 1.0;
    const int lutSize = 4;
    cmsPipeline *b2A = cmsPipelineAlloc(nullptr, 3, 3);
 
           // curves, linear
    cmsToneCurve *linearCurves[3];
    linearCurves[0] = linearCurves[1] = linearCurves[2] = cmsBuildGamma(nullptr, 1.0);
    cmsStage *lCurveStage = cmsStageAllocToneCurves(nullptr, 3, linearCurves);
    cmsPipelineInsertStage(b2A, cmsAT_END, lCurveStage);
 
    // matrix
    double luma[3];
    const QMatrix4x4 tf = rgbMatrix(primaries, factor, luma).inverted();
    double m[] = {
        tf(0, 0), tf(0, 1), tf(0, 2),
        tf(1, 0), tf(1, 1), tf(1, 2),
        tf(2, 0), tf(2, 1), tf(2, 2)
    };
 
    cmsStage* matrixStage = cmsStageAllocMatrix(nullptr, 3, 3, m, nullptr);
    cmsPipelineInsertStage(b2A, cmsAT_END, matrixStage);
    // pq curve
    cmsToneCurve *curve[3];
    curve[0] = curve[1] = curve[2] = cmsBuildGamma(nullptr, 1/2.2);
    cmsStage *curveStage = cmsStageAllocToneCurves(nullptr, 3, curve);
    cmsPipelineInsertStage(b2A, cmsAT_END, curveStage);
 
    cmsStage *clutStage = cmsStageAllocCLut16bit(nullptr, lutSize, 3, 3, nullptr);
    perceptualDummyHelper helper;
    helper.toXYZ = false;
    helper.luma = luma;
    helper.diffuseWhiteNits = diffuseWhiteNits;
    cmsStageSampleCLut16bit(clutStage, &samplePQDummyClut, &helper, 0);
    cmsPipelineInsertStage(b2A, cmsAT_END, clutStage);
 
    cmsPipelineInsertStage(b2A, cmsAT_END, cmsStageDup(lCurveStage));
 
    bool success = cmsWriteTag(iccProfile, tag, b2A);
    cmsFreeToneCurve(curve[0]);
    cmsFreeToneCurve(linearCurves[0]);
    cmsPipelineFree(b2A);
    return success;
}

References perceptualDummyHelper::diffuseWhiteNits, perceptualDummyHelper::luma, rgbMatrix(), samplePQDummyClut(), and perceptualDummyHelper::toXYZ.

---

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

• plugins/color/lcms2engine/colorprofiles/LcmsPredefinedPipelineFunctions.h
• plugins/color/lcms2engine/colorprofiles/LcmsPredefinedPipelineFunctions.cpp