How does Photoshop calculate Lab values?

EDIT: 31st July 2026 - Three new updates, v2.3 - v2.4 - v2.5:

/*
    Calculates the CIE colour difference (dE76/dE94/dE2000) between either:

      - the Foreground and Background colors
        or
      - Color Sampler 1 and Color Sampler 2 on the active document
        or
      - Manual float entry to two decimal places (Photoshop Lab mode natively supports integers)

    Stephen Marsh
    https://github.com/MarshySwamp/CIE_Color_Difference_Calculator
    https://community.adobe.com/t5/photoshop-ecosystem-discussions/how-does-photoshop-calculate-lab-values/m-p/15028840

    Changelog:
    v1.0 - 10th December 2024:  Private testing.
    v1.1 - 10th December 2024:  Initial public release, no GUI.
    v1.2 - 31st May 2026:       Added (LCh) Lightness, Chroma & hue readings.
    v1.3 - 1st June 2026:       Replaced the native alert with a ScriptUI dialog with copy to clipboard button.
    v1.4 - 9th June 2026:       Added Delta L, a, b, C, h component breakdown & dE traffic light colouring.
    v1.5 - 17th June 2026:      Added editable L, a, b floating value input fields for foreground and background, removed the
                                traffic light colouring due to legibility issues.
    v1.6 - 1st July 2026:       Combined the separate dE76/dE94/dE00 scripts into a single script with radio buttons to
                                switch between the three formulas.
    v1.7 - 1st July 2026:       Changed the colour source from the foreground/background swatches to Color Sampler 1 and
                                Color Sampler 2 on the active document.
    v1.8 - 1st July 2026:       Combined v1.6 and v1.7 into a single script. Added a checkbox to toggle between Foreground/Background
                                and Color Sampler 1 and 2 as the colour source.
    v1.9 - 3rd July 2026:       Minor GUI change, moved the "Enable manual entry" checkbox under the "Use Color Samplers" checkbox.
    v1.10 - 5th July 2026:      Replaced the two source checkboxes with three radio buttons (Foreground/Background, Color Samplers and
                                Manual Entry). The initial Foreground/Background Lab values are stored once and used to restore when
                                switching back from samplers or manual entry.
    v1.11 - 11th July 2026:     Minor GUI change, moved the Manual Entry input panel into the Color Source panel.
    v2.0 - 12th July 2026:      Added range validation/clamping to the Manual Entry fields.
    v2.1 - 13th July 2026:      Fixed a rounding display error in the results panel. Minor GUI changes.
    v2.2 - 27th July 2026:      Swapped Delta L, a, b, C, h subtraction calculation order from reference/sample to sample/reference.
    v2.3 - 31st July 2026:      Added a "Round values" checkbox (to 2 decimal places), when off the results are now truncated to 6
                                decimal places. Checking the box restores the previous rounding behaviour. Minor GUI changes.
    v2.4 - 31st July 2026:      Fixed a bug where a failed switch to Color Samplers (no document / not enough samplers) always reverted the
                                radio button selection to Foreground/Background. It now restores the source that was previously active.
    v2.5 - 31st July 2026:      Once the Manual Entry fields have been edited to no longer match the Foreground/Background values,
                                those custom entries are now remembered and restored if the user switches back to Manual Entry, instead
                                of being silently overwritten and lost. Minor GUI changes.

*/

#target photoshop

main();

function main() {

    // -----------------------------------------------------------------------
    // Start with the Foreground / Background colors - always available,
    // no document or color samplers required.
    // -----------------------------------------------------------------------
    var fgColor = app.foregroundColor.lab;
    var bgColor = app.backgroundColor.lab;

    // -----------------------------------------------------------------------
    // Initial Foreground/Background Lab values. These are kept for the lifetime of the
    // dialog so that the Foreground/Background source can always be restored exactly,
    // even after the user has switched to the Color Sampler or Manual Entry sources.
    // -----------------------------------------------------------------------
    var initialFgLab = [Math.round(fgColor.l), Math.round(fgColor.a), Math.round(fgColor.b)];
    var initialBgLab = [Math.round(bgColor.l), Math.round(bgColor.a), Math.round(bgColor.b)];

    // Tracks which colour source is currently active: "fgbg", "sampler", or "manual"
    var colorSourceMode = "fgbg";

    // -----------------------------------------------------------------------
    // v2.5
    // Remembers the most recent Manual Entry field values. Custom entries can
    // be restored later even after the shared fields have been overwritten.
    // -----------------------------------------------------------------------
    var savedManualLab1 = initialFgLab.slice();
    var savedManualLab2 = initialBgLab.slice();

    // -----------------------------------------------------------------------
    // ScriptUI Dialog
    // -----------------------------------------------------------------------
    var win = new Window("dialog", "CIE Color Difference Calculator (v2.5)");
    win.alignChildren = "fill";
    win.spacing = 12;
    win.margins = 12;
    //win.preferredSize.width = 655;


    // -----------------------------------------------------------------------
    // Colour source panel: Foreground/Background, Color Samplers, Manual Entry
    // -----------------------------------------------------------------------
    var sourcePanel = win.add("panel", undefined, "Color Source");
    sourcePanel.alignChildren = "left";
    sourcePanel.spacing = 12;
    sourcePanel.margins = 12;

    var sourceGroup = sourcePanel.add("group");
    sourceGroup.orientation = "column";
    sourceGroup.alignChildren = "left";
    sourceGroup.spacing = 12;

    var rbFgBg = sourceGroup.add("radiobutton", undefined, "Use Foreground Color (Reference) vs. Background Color (Sample)");
    var rbSampler = sourceGroup.add("radiobutton", undefined, "Use Color Sampler 1 (Reference) vs. Color Sampler 2 (Sample)");
    var rbManual = sourceGroup.add("radiobutton", undefined, "Manual Entry 1 (Reference) vs. Manual Entry 2 (Sample)");
    rbFgBg.value = true; // default: Foreground/Background

    // -----------------------------------------------------------------------
    // Manual entry panel
    // v2.3 - GUI update to columns for visual alignment
    // -----------------------------------------------------------------------
    var manualEntryPanel = sourceGroup.add("panel", undefined, "");
    manualEntryPanel.orientation = "column";
    manualEntryPanel.alignChildren = "left";
    manualEntryPanel.spacing = 12;
    manualEntryPanel.margins = 12;

    // -----------------------------------------------------------------------
    // Manual entry row 1
    // -----------------------------------------------------------------------
    var manOneInputPanel = manualEntryPanel.add("group");
    manOneInputPanel.orientation = "row";
    manOneInputPanel.alignChildren = "center";
    manOneInputPanel.spacing = 12;

    var manOneLabel = manOneInputPanel.add("statictext", undefined, "Manual Entry 1 (Reference):");
    manOneLabel.preferredSize.width = 135; // Space before manual entry fields

    manOneInputPanel.add("statictext", undefined, "L*:");
    var manOneL = manOneInputPanel.add("editnumber", undefined, initialFgLab[0]);
    manOneL.preferredSize.width = 40;
    manOneL.helpTip = "Manual Entry 1 L* (0 to 100.00)";

    manOneInputPanel.add("statictext", undefined, "a*:");
    var manOneA = manOneInputPanel.add("editnumber", undefined, initialFgLab[1]);
    manOneA.preferredSize.width = 40;
    manOneA.helpTip = "Manual Entry 1 a* (-128.00 to +127.00)";

    manOneInputPanel.add("statictext", undefined, "b*:");
    var manOneB = manOneInputPanel.add("editnumber", undefined, initialFgLab[2]);
    manOneB.preferredSize.width = 40;
    manOneB.helpTip = "Manual Entry 1 b* (-128.00 to +127.00)";

    // -----------------------------------------------------------------------
    // Manual entry row 2
    // -----------------------------------------------------------------------
    var manTwoInputPanel = manualEntryPanel.add("group");
    manTwoInputPanel.orientation = "row";
    manTwoInputPanel.alignChildren = "center";
    manTwoInputPanel.spacing = 12;

    var manTwoLabel = manTwoInputPanel.add("statictext", undefined, "Manual Entry 2 (Sample):");
    manTwoLabel.preferredSize.width = 135; // Space before manual entry fields

    manTwoInputPanel.add("statictext", undefined, "L*:");
    var manTwoL = manTwoInputPanel.add("editnumber", undefined, initialBgLab[0]);
    manTwoL.preferredSize.width = 40;
    manTwoL.helpTip = "Manual Entry 2 L* (0 to 100.00)";

    manTwoInputPanel.add("statictext", undefined, "a*:");
    var manTwoA = manTwoInputPanel.add("editnumber", undefined, initialBgLab[1]);
    manTwoA.preferredSize.width = 40;
    manTwoA.helpTip = "Manual Entry 2 a* (-128.00 to +127.00)";

    manTwoInputPanel.add("statictext", undefined, "b*:");
    var manTwoB = manTwoInputPanel.add("editnumber", undefined, initialBgLab[2]);
    manTwoB.preferredSize.width = 40;
    manTwoB.helpTip = "Manual Entry 2 b* (-128.00 to +127.00)";

    // -----------------------------------------------------------------------
    // Results panel
    // -----------------------------------------------------------------------
    var panel = win.add("panel", undefined, "Color Differene Results");
    panel.alignChildren = "left";
    panel.spacing = 12;
    panel.margins = 12;

    // -----------------------------------------------------------------------
    // Radio buttons: dE mode selector (upper left of the results panel)
    // -----------------------------------------------------------------------
    var modeGroup = panel.add("group");
    modeGroup.orientation = "row";
    modeGroup.alignChildren = "left";
    modeGroup.alignment = "left";
    modeGroup.spacing = 12;

    var rbdE76 = modeGroup.add("radiobutton", undefined, "\u0394E76");
    var rbdE94 = modeGroup.add("radiobutton", undefined, "\u0394E94");
    var rbdE00 = modeGroup.add("radiobutton", undefined, "\u0394E00");
    rbdE00.value = true; // default: dE00

    // -----------------------------------------------------------------------
    // Checkbox: toggles whether the 2-decimal-place results below are
    // rounded (2 decimal places) or truncated (6 decimal places)
    // -----------------------------------------------------------------------
    var cbRoundValues = panel.add("checkbox", undefined, "Round Values to 2 Decimal Places");
    cbRoundValues.value = true; // default value
    //cbRoundValues.helpTip = "When checked, results are rounded to 2 decimal places.\nWhen unchecked, results are displayed at 6 decimal places.";

    // -----------------------------------------------------------------------
    // Truncates val to the given number of decimal places (toward zero),
    // guarding against floating-point representation noise (e.g. treating
    // 2.9999999999996 as 3, not 2.99) by cleaning up the value at a much
    // finer precision before truncating.
    // -----------------------------------------------------------------------
    function truncateToFixed(val, decimals) {
        var factor = Math.pow(10, decimals);
        var scaled = val * factor;
        var cleanedScaled = Math.round(scaled * 1e6) / 1e6;
        var truncatedScaled = (cleanedScaled < 0) ? Math.ceil(cleanedScaled) : Math.floor(cleanedScaled);
        return (truncatedScaled / factor).toFixed(decimals);
    }

    // -----------------------------------------------------------------------
    // Formats val, rounding to 2 decimal places or truncating to 6 decimal
    // places depending on the "Round values" checkbox state.
    // -----------------------------------------------------------------------
    function formatDecimal(val) {
        if (cbRoundValues.value) {
            return val.toFixed(2);
        }
        return truncateToFixed(val, 6);
    }

    var headingText = panel.add("statictext", undefined,
        "Foreground vs. Background Color Picker Difference:");
    headingText.preferredSize.width = 470;

    // -----------------------------------------------------------------------
    // dE (bold)
    // -----------------------------------------------------------------------
    var deText = panel.add("statictext", undefined, "");
    deText.preferredSize.width = 470;
    deText.graphics.font = ScriptUI.newFont(
        deText.graphics.font.name,
        ScriptUI.FontStyle.BOLD,
        14
    );

    // -----------------------------------------------------------------------
    // Delta components
    // -----------------------------------------------------------------------
    var dLText = panel.add("statictext", undefined, "");
    dLText.preferredSize.width = 470;

    var dAText = panel.add("statictext", undefined, "");
    dAText.preferredSize.width = 470;

    var dBText = panel.add("statictext", undefined, "");
    dBText.preferredSize.width = 470;

    var dCText = panel.add("statictext", undefined, "");
    dCText.preferredSize.width = 470;

    var dHText = panel.add("statictext", undefined, "");
    dHText.preferredSize.width = 470;

    // -----------------------------------------------------------------------
    // Sampler 1 / Foreground summary label
    // -----------------------------------------------------------------------
    var fgText = panel.add("statictext", undefined, "", {
        multiline: true
    });
    fgText.preferredSize.width = 470;

    // -----------------------------------------------------------------------
    // Sampler 2 / Background summary label
    // -----------------------------------------------------------------------
    var bgText = panel.add("statictext", undefined, "", {
        multiline: true
    });
    bgText.preferredSize.width = 470;

    // -----------------------------------------------------------------------
    // Buttons
    // -----------------------------------------------------------------------
    var btnGroup = win.add("group");
    btnGroup.alignment = "right";
    btnGroup.spacing = 12;

    var cancelBtn = btnGroup.add("button", undefined, "Cancel", {
        name: "cancel"
    });
    var copyBtn = btnGroup.add("button", undefined, "Copy");

    // -----------------------------------------------------------------------
    // Helper: returns the currently selected dE mode as a string
    // -----------------------------------------------------------------------
    function getSelectedMode() {
        if (rbdE76.value) return "dE76";
        if (rbdE94.value) return "dE94";
        return "dE00";
    }

    // -----------------------------------------------------------------------
    // Helper: updates all static text (heading, panel titles, help tips,
    // summary label prefixes) to match the active colour source
    // -----------------------------------------------------------------------
    function updateLabelsForMode() {
        if (colorSourceMode === "sampler") {
            headingText.text = "Color Sampler 1 (Reference) vs. Color Sampler 2 (Sample) Difference:";
        } else if (colorSourceMode === "manual") {
            headingText.text = "Manual Entry 1 (Reference) vs. Manual Entry 2 (Sample) Difference:";
        } else {
            headingText.text = "Foreground (Reference ) vs. Background (Sample) Color Picker Difference:";
        }
    }

    // -----------------------------------------------------------------------
    // Helper: returns the current colour-A / colour-B summary label prefixes
    // -----------------------------------------------------------------------
    function getSummaryPrefixes() {
        if (colorSourceMode === "sampler") {
            return {
                a: "Color Sampler 1",
                b: "Color Sampler 2"
            };
        } else if (colorSourceMode === "manual") {
            return {
                a: "Manual Entry 1",
                b: "Manual Entry 2"
            };
        }
        return {
            a: "Foreground",
            b: "Background"
        };
    }

    // -----------------------------------------------------------------------
    // Central recalculate-and-refresh function
    // -----------------------------------------------------------------------
    function recalculate() {

        var fL = manOneL.value;
        var fA = manOneA.value;
        var fB = manOneB.value;
        if (isNaN(fL)) {
            fL = 0;
        }
        if (isNaN(fA)) {
            fA = 0;
        }
        if (isNaN(fB)) {
            fB = 0;
        }

        var bL = manTwoL.value;
        var bA = manTwoA.value;
        var bB = manTwoB.value;
        if (isNaN(bL)) {
            bL = 0;
        }
        if (isNaN(bA)) {
            bA = 0;
        }
        if (isNaN(bB)) {
            bB = 0;
        }

        var currentFgLab = [fL, fA, fB];
        var currentBgLab = [bL, bA, bB];

        var currentFgLCH = labToLCH(currentFgLab);
        var currentBgLCH = labToLCH(currentBgLab);

        var mode = getSelectedMode();
        var dE, label;

        if (mode === "dE76") {
            dE = calculateCIEdE76(currentFgLab, currentBgLab);
            label = "\u0394E76";
        } else if (mode === "dE94") {
            dE = calculateCIEdE94(currentFgLab, currentBgLab);
            label = "\u0394E94";
        } else {
            dE = calculateCIEdE00(currentFgLab, currentBgLab);
            label = "\u0394E00";
        }

        // -----------------------------------------------------------------------
        // v2.1 - Result value formatting.
        // fmtComponent: for raw L*/a*/b* values and their direct deltas
        // (deltaL/deltaA/deltaB are plain differences, so they stay integer
        // whenever the inputs are integer). FG/BG and Color Sampler inputs
        // are always whole numbers in Photoshop, so those modes display as
        // integers; Manual Entry keeps 2 decimal places.
        // fmt: for derived values (C*, h*, dE, deltaC, deltaH) which involve
        // sqrt/trig and are not guaranteed to be whole numbers even when the
        // L*/a*/b* inputs are integers - always shown to 2 decimal places.
        //
        // v2.2 - Swapped the calculation order of the ref/sample to sample/ref:
        //  ΔL* = Sample (2) - Standard/Reference (1)
        //  Δa* = Sample (2) - Standard/Reference (1)
        //  Δb* = Sample (2) - Standard/Reference (1)
        //  ΔC* = Sample (2) - Standard/Reference (1)
        //  Δh* = Sample (2) - Standard/Reference (1)
        // -----------------------------------------------------------------------
        function fmtComponent(val) {
            if (colorSourceMode === "manual") {
                return formatDecimal(val);
            }
            return Math.round(val).toString();
        }

        function fmt(val) {
            return formatDecimal(val);
        }

        var deltaL = bL - fL;
        var deltaA = bA - fA;
        var deltaB = bB - fB;
        var deltaC = currentBgLCH.C - currentFgLCH.C;

        // -----------------------------------------------------------------------
        // Hue angle difference, normalised to [-180, +180]
        // -----------------------------------------------------------------------
        var deltaH = currentBgLCH.H - currentFgLCH.H;
        if (deltaH > 180) {
            deltaH -= 360;
        }
        if (deltaH < -180) {
            deltaH += 360;
        }

        // -----------------------------------------------------------------------
        // Update dE label text
        // -----------------------------------------------------------------------
        deText.text = label + ": " + fmt(dE);

        // -----------------------------------------------------------------------
        // Update delta component labels
        // -----------------------------------------------------------------------
        dLText.text = "\u0394L*: " + fmtComponent(deltaL);
        dAText.text = "\u0394a*: " + fmtComponent(deltaA);
        dBText.text = "\u0394b*: " + fmtComponent(deltaB);
        dCText.text = "\u0394C*: " + fmt(deltaC);
        dHText.text = "\u0394h*: " + fmt(deltaH) + "\u00B0";

        // -----------------------------------------------------------------------
        // Update footer summary labels using the current color source's prefixes
        // -----------------------------------------------------------------------
        var prefixes = getSummaryPrefixes();

        fgText.text =
            prefixes.a + " (L*: " + fmtComponent(fL) +
            ", a*: " + fmtComponent(fA) +
            ", b*: " + fmtComponent(fB) +
            ", C*: " + fmt(currentFgLCH.C) +
            ", h*: " + fmt(currentFgLCH.H) + "\u00B0)";

        bgText.text =
            prefixes.b + " (L*: " + fmtComponent(bL) +
            ", a*: " + fmtComponent(bA) +
            ", b*: " + fmtComponent(bB) +
            ", C*: " + fmt(currentBgLCH.C) +
            ", h*: " + fmt(currentBgLCH.H) + "\u00B0)";

        // -----------------------------------------------------------------------
        // Keep a live alertText for the Copy button
        // -----------------------------------------------------------------------
        win._alertText =
            headingText.text + "\n\n" +
            label + ": " + fmt(dE) + "\n\n" +
            "\u0394L*: " + fmtComponent(deltaL) + "\n" +
            "\u0394a*: " + fmtComponent(deltaA) + "\n" +
            "\u0394b*: " + fmtComponent(deltaB) + "\n" +
            "\u0394C*: " + fmt(deltaC) + "\n" +
            "\u0394h*: " + fmt(deltaH) + "\u00B0\n\n" +
            fgText.text + "\n" +
            bgText.text;
    }

    // -----------------------------------------------------------------------
    // Radio buttons: switch dE formula and recalculate live
    // -----------------------------------------------------------------------
    rbdE76.onClick = recalculate;
    rbdE94.onClick = recalculate;
    rbdE00.onClick = recalculate;
    cbRoundValues.onClick = recalculate;

    // -----------------------------------------------------------------------
    // Radio buttons: switch between Foreground/Background, Color Sampler 1 & 2,
    // and Manual Entry as the colour source. Only one can be active at a time.
    // -----------------------------------------------------------------------

    // Start disabled - only Manual Entry allows direct editing of the fields
    manOneInputPanel.enabled = false;
    manTwoInputPanel.enabled = false;

    // Foreground / Background - restores the Lab values captured at script
    // start, so the original swatches are always recoverable.
    rbFgBg.onClick = function() {
        manOneL.value = initialFgLab[0];
        manOneA.value = initialFgLab[1];
        manOneB.value = initialFgLab[2];
        manTwoL.value = initialBgLab[0];
        manTwoA.value = initialBgLab[1];
        manTwoB.value = initialBgLab[2];

        colorSourceMode = "fgbg";
        manOneInputPanel.enabled = false;
        manTwoInputPanel.enabled = false;

        updateLabelsForMode();
        recalculate();
    };

    // -----------------------------------------------------------------------
    // Helper: re-checks whichever radio button was active before a failed
    // attempt to switch to the Color Sampler source. colorSourceMode still
    // holds the pre-click mode at this point (it's only reassigned once
    // validation succeeds), and nothing else was touched by the failed
    // attempt, so this simply restores the radio button UI to match reality -
    // without resetting the manual entry fields or panel enabled state.
    // -----------------------------------------------------------------------
    function restorePreviousSourceRadio() {
        if (colorSourceMode === "manual") {
            rbManual.value = true;
        } else {
            rbFgBg.value = true;
        }
    }

    // -----------------------------------------------------------------------
    // Color Samplers - validates that a document with at least 2 color
    // samplers is available before committing to this mode.
    // -----------------------------------------------------------------------
    rbSampler.onClick = function() {

        if (!app.documents.length) {
            alert("No document open.\n\nOpen a document and place at least 2 color samplers before using this mode.");
            restorePreviousSourceRadio();
            return;
        }

        var activeDoc = app.activeDocument;

        if (activeDoc.colorSamplers.length < 2) {
            alert("At least 2 color samplers are required.\n\n" +
                "Currently found: " + activeDoc.colorSamplers.length + "\n\n" +
                "Add color samplers with the Color Sampler tool (I) and try again.\n" +
                "This mode compares Color Sampler 1 vs. Color Sampler 2.");
            restorePreviousSourceRadio();
            return;
        }

        // -----------------------------------------------------------------------
        // Validation passed - pull the Lab values from the two color samplers
        // -----------------------------------------------------------------------
        var sampler1 = activeDoc.colorSamplers[0].color.lab;
        var sampler2 = activeDoc.colorSamplers[1].color.lab;

        manOneL.value = Math.round(sampler1.l);
        manOneA.value = Math.round(sampler1.a);
        manOneB.value = Math.round(sampler1.b);
        manTwoL.value = Math.round(sampler2.l);
        manTwoA.value = Math.round(sampler2.a);
        manTwoB.value = Math.round(sampler2.b);

        colorSourceMode = "sampler";
        manOneInputPanel.enabled = false;
        manTwoInputPanel.enabled = false;

        updateLabelsForMode();
        recalculate();
    };

    // -----------------------------------------------------------------------
    // Helper: true once the Manual Entry fields have actually been edited to
    // differ from the Foreground/Background values captured at script start.
    // Used to decide, when re-entering Manual Entry mode, whether to restore
    // those custom values or just leave whatever the most recently active
    // source (FG/BG or Color Samplers) is currently showing.
    // -----------------------------------------------------------------------
    function manualValuesAreCustomized() {
        return savedManualLab1[0] !== initialFgLab[0] ||
            savedManualLab1[1] !== initialFgLab[1] ||
            savedManualLab1[2] !== initialFgLab[2] ||
            savedManualLab2[0] !== initialBgLab[0] ||
            savedManualLab2[1] !== initialBgLab[1] ||
            savedManualLab2[2] !== initialBgLab[2];
    }

    // -----------------------------------------------------------------------
    // Manual Entry - unlocks both input panels for free editing.
    //
    // If the fields have previously been customized (edited to no longer
    // match the Foreground/Background values), those custom entries are
    // restored so they aren't lost after switching away to FG/BG or Color
    // Samplers and back. Otherwise, the values already showing (whichever
    // source was active) are left in place as a convenient starting point,
    // as before.
    // -----------------------------------------------------------------------
    rbManual.onClick = function() {
        colorSourceMode = "manual";
        manOneInputPanel.enabled = true;
        manTwoInputPanel.enabled = true;

        if (manualValuesAreCustomized()) {
            manOneL.value = savedManualLab1[0];
            manOneA.value = savedManualLab1[1];
            manOneB.value = savedManualLab1[2];
            manTwoL.value = savedManualLab2[0];
            manTwoA.value = savedManualLab2[1];
            manTwoB.value = savedManualLab2[2];
        }

        updateLabelsForMode();
        recalculate();
    };

    // -----------------------------------------------------------------------
    // Manual entry field validation - clamps each field to its valid Lab
    // range and rounds to 2 decimal places, then triggers a live recalculate.
    // L*: 0.00 to 100.00 a*/b*: -128.00 to 127.00 as editable floats.
    // -----------------------------------------------------------------------
    function roundTo2(val) {
        return Math.round(val * 100) / 100;
    }

    function makeManualFieldValidator(field, min, max) {
        return function() {
            var v = field.value;
            if (isNaN(v)) {
                v = 0;
            }
            v = roundTo2(v);
            if (v < min) {
                v = min;
            }
            if (v > max) {
                v = max;
            }
            field.value = v;

            // Keep the saved custom values in sync with live edits so they
            // can be restored later if the user switches away and back.
            if (colorSourceMode === "manual") {
                savedManualLab1 = [manOneL.value, manOneA.value, manOneB.value];
                savedManualLab2 = [manTwoL.value, manTwoA.value, manTwoB.value];
            }

            recalculate();
        };
    }

    // -----------------------------------------------------------------------
    // Set onChange on each editnumber field to validate/clamp and then
    // trigger a live recalculate
    // -----------------------------------------------------------------------
    manOneL.onChange = makeManualFieldValidator(manOneL, 0, 100);
    manOneA.onChange = makeManualFieldValidator(manOneA, -128, 127);
    manOneB.onChange = makeManualFieldValidator(manOneB, -128, 127);
    manTwoL.onChange = makeManualFieldValidator(manTwoL, 0, 100);
    manTwoA.onChange = makeManualFieldValidator(manTwoA, -128, 127);
    manTwoB.onChange = makeManualFieldValidator(manTwoB, -128, 127);

    // -----------------------------------------------------------------------
    // Button handlers
    // -----------------------------------------------------------------------
    cancelBtn.onClick = function() {
        win.close();
    };

    copyBtn.onClick = function() {
        var d = new ActionDescriptor();
        d.putString(stringIDToTypeID("textData"), win._alertText || "");
        executeAction(stringIDToTypeID("textToClipboard"), d, DialogModes.NO);
        win.close();
    };

    // -----------------------------------------------------------------------
    // Populate all display fields with the initial Photoshop values
    // -----------------------------------------------------------------------
    updateLabelsForMode();
    recalculate();

    win.show();
}

// -----------------------------------------------------------------------
// LCh - converts a LAB array [L, a, b] to an LCh object { L, C, H }
// -----------------------------------------------------------------------
function labToLCH(lab) {
    var L = lab[0];
    var C = Math.sqrt(lab[1] * lab[1] + lab[2] * lab[2]);
    var H = (Math.atan2(lab[2], lab[1]) * 180) / Math.PI;
    if (H < 0) {
        H += 360;
    }
    return {
        L: L,
        C: C,
        H: H
    };
}

// -----------------------------------------------------------------------
// I'm unsure of the source for the dE formula's, however, I'm guessing
// that credit should go to Bruce Lindbloom:
// http://www.brucelindbloom.com/Eqn_DeltaE_CIE76.html
// http://www.brucelindbloom.com/Eqn_DeltaE_CIE94.html
// http://www.brucelindbloom.com/Eqn_DeltaE_CIE2000.html
// http://www.brucelindbloom.com/ColorDifferenceCalc.html
// -----------------------------------------------------------------------

// -----------------------------------------------------------------------
// dE76 (CIE76 / dEab) - simple Euclidean distance in Lab space
// -----------------------------------------------------------------------
function calculateCIEdE76(lab1, lab2) {
    var deltaL = lab1[0] - lab2[0];
    var deltaA = lab1[1] - lab2[1];
    var deltaB = lab1[2] - lab2[2];
    return Math.sqrt(deltaL * deltaL + deltaA * deltaA + deltaB * deltaB);
}

// -----------------------------------------------------------------------
// dE94 (CIE94) - Formula improved for perceptual uniformity
// -----------------------------------------------------------------------
function calculateCIEdE94(lab1, lab2) {
    var kL = 1,
        kC = 1,
        kH = 1;
    var K1 = 0.045,
        K2 = 0.015;

    var deltaL = lab1[0] - lab2[0];
    var deltaA = lab1[1] - lab2[1];
    var deltaB = lab1[2] - lab2[2];

    var c1 = Math.sqrt(lab1[1] * lab1[1] + lab1[2] * lab1[2]);
    var c2 = Math.sqrt(lab2[1] * lab2[1] + lab2[2] * lab2[2]);
    var deltaC = c1 - c2;
    var deltaH2 = Math.max(0, deltaA * deltaA + deltaB * deltaB - deltaC * deltaC);

    var sl = 1;
    var sc = 1 + K1 * c1;
    var sh = 1 + K2 * c1;

    return Math.sqrt(
        Math.pow(deltaL / (kL * sl), 2) +
        Math.pow(deltaC / (kC * sc), 2) +
        deltaH2 / Math.pow(kH * sh, 2)
    );
}

// -----------------------------------------------------------------------
// dE00 (CIEDE2000) - Formula "best matches" human vision
// -----------------------------------------------------------------------
function calculateCIEdE00(lab1, lab2) {
    var kL = 1,
        kC = 1,
        kH = 1;

    function degToRad(deg) {
        return (deg * Math.PI) / 180;
    }

    var c1 = Math.sqrt(lab1[1] * lab1[1] + lab1[2] * lab1[2]);
    var c2 = Math.sqrt(lab2[1] * lab2[1] + lab2[2] * lab2[2]);
    var cBar = (c1 + c2) / 2;

    var g = 0.5 * (1 - Math.sqrt(Math.pow(cBar, 7) / (Math.pow(cBar, 7) + Math.pow(25, 7))));

    var a1Prime = lab1[1] * (1 + g);
    var a2Prime = lab2[1] * (1 + g);

    var c1Prime = Math.sqrt(a1Prime * a1Prime + lab1[2] * lab1[2]);
    var c2Prime = Math.sqrt(a2Prime * a2Prime + lab2[2] * lab2[2]);
    var cBarPrime = (c1Prime + c2Prime) / 2;

    var h1Prime = Math.atan2(lab1[2], a1Prime);
    var h2Prime = Math.atan2(lab2[2], a2Prime);
    if (h1Prime < 0) h1Prime += 2 * Math.PI;
    if (h2Prime < 0) h2Prime += 2 * Math.PI;

    var hBarPrime = Math.abs(h1Prime - h2Prime) > Math.PI ?
        (h1Prime + h2Prime + 2 * Math.PI) / 2 :
        (h1Prime + h2Prime) / 2;

    var deltaHPrimeRaw = Math.abs(h1Prime - h2Prime) > Math.PI ?
        h2Prime - h1Prime + 2 * Math.PI * (h2Prime <= h1Prime ? 1 : -1) :
        h2Prime - h1Prime;

    var deltaLPrime = lab2[0] - lab1[0];
    var deltaCPrime = c2Prime - c1Prime;
    var deltaHPrime = 2 * Math.sqrt(c1Prime * c2Prime) * Math.sin(deltaHPrimeRaw / 2);

    var lBar = (lab1[0] + lab2[0]) / 2;
    var t = 1 -
        0.17 * Math.cos(hBarPrime - degToRad(30)) +
        0.24 * Math.cos(2 * hBarPrime) +
        0.32 * Math.cos(3 * hBarPrime + degToRad(6)) -
        0.20 * Math.cos(4 * hBarPrime - degToRad(63));

    var sl = 1 + (0.015 * Math.pow(lBar - 50, 2)) / Math.sqrt(20 + Math.pow(lBar - 50, 2));
    var sc = 1 + 0.045 * cBarPrime;
    var sh = 1 + 0.015 * cBarPrime * t;

    var deltaTheta = degToRad(30) * Math.exp(-Math.pow((hBarPrime - degToRad(275)) / degToRad(25), 2));
    var rc = 2 * Math.sqrt(Math.pow(cBarPrime, 7) / (Math.pow(cBarPrime, 7) + Math.pow(25, 7)));
    var rt = -rc * Math.sin(2 * deltaTheta);

    return Math.sqrt(
        Math.pow(deltaLPrime / (kL * sl), 2) +
        Math.pow(deltaCPrime / (kC * sc), 2) +
        Math.pow(deltaHPrime / (kH * sh), 2) +
        rt * (deltaCPrime / (kC * sc)) * (deltaHPrime / (kH * sh))
    );
}