All files / viewer/src lightColor.ts

100% Statements 34/34
83.78% Branches 31/37
100% Functions 8/8
100% Lines 30/30

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71        5x 5x 5x     108x     48x 48x 48x     45x         56x 3x 3x   53x 53x 53x       20x       56x 4x 16x 16x 10x                   60x   60x       60x         60x 60x   60x 60x 60x 60x 60x    
import { Color } from 'three';
import type { PhotometricDocument } from '@ies-tools/core';
import { declaredColorTemperatures } from './colorMetadata.js';
 
export const DEFAULT_COLOR_TEMPERATURE = 6500;
const MIN_TEMPERATURE = 1667;
const MAX_TEMPERATURE = 25000;
 
function supported(value: number): boolean {
  return Number.isFinite(value) && value >= MIN_TEMPERATURE && value <= MAX_TEMPERATURE;
}
function parseTemperature(text: string): number | undefined {
  const match = /^\s*(?:CCT\s*[:=]?\s*)?(\d+(?:\.\d+)?)\s*(?:°?K|kelvin)?\s*$/i.exec(text);
  const value = match ? Number(match[1]) : NaN;
  return supported(value) ? value : undefined;
}
function uniqueTemperature(values: (number | undefined)[]): number {
  return values.every((value) => value !== undefined && value === values[0]) ? values[0]! : DEFAULT_COLOR_TEMPERATURE;
}
 
/** One uniform CCT per selected configuration. Unknown or ambiguous colors use 6500 K. */
export function documentColorTemperature(document: PhotometricDocument): number {
  if (document.sourceFormat === 'ldt') {
    const lamp = document.lampSets[document.selectedLampSetIndex ?? 0];
    Eif (lamp?.colorTemperature.trim()) return parseTemperature(lamp.colorTemperature) ?? DEFAULT_COLOR_TEMPERATURE;
  }
  const metadata = document.profile.metadata;
  const declared = declaredColorTemperatures(metadata);
  if (declared.length) return uniqueTemperature(declared.map((value) => parseTemperature(value)));
 
  // Only explicit Kelvin units in descriptions: never infer temperature from catalog codes or watts.
  const description =
    document.sourceFormat === 'ldt'
      ? [document.lampSets[document.selectedLampSetIndex ?? 0]?.description, metadata.LUMINAIRE].join(' ')
      : [metadata.LAMP, metadata.LUMINAIRE].join(' ');
  // Reject selectable ranges, including forms such as 2700/3000K and 2700K–6500K.
  if (/\d\s*(?:K\s*)?[-–—/]\s*\d+(?:\.\d+)?\s*°?K\b|\d\s*°?K\s*[-–—/]\s*\d/i.test(description))
    return DEFAULT_COLOR_TEMPERATURE;
  const matches = [...description.matchAll(/(?<![\w.])(\d+(?:\.\d+)?)\s*(?:°?K|kelvin)\b/gi)];
  return matches.length
    ? uniqueTemperature(matches.map((match) => parseTemperature(match[0])))
    : DEFAULT_COLOR_TEMPERATURE;
}
 
/** Planckian-locus approximation, converted from CIE xy to linear sRGB at unit luminance.
 * Kang et al. (2002), valid from 1667 to 25000 K:
 * https://colour.readthedocs.io/en/develop/_modules/colour/temperature/kang2002.html
 * This approximates white-light appearance; it does not model spectra, Duv, or CRI.
 */
export function temperatureColor(kelvin: number): Color {
  const t = supported(kelvin) ? kelvin : DEFAULT_COLOR_TEMPERATURE;
  const x =
    t <= 4000
      ? -0.2661239e9 / t ** 3 - 0.2343589e6 / t ** 2 + 0.8776956e3 / t + 0.17991
      : -3.0258469e9 / t ** 3 + 2.1070379e6 / t ** 2 + 0.2226347e3 / t + 0.24039;
  const y =
    t <= 2222
      ? -1.1063814 * x ** 3 - 1.3481102 * x ** 2 + 2.18555832 * x - 0.20219683
      : t <= 4000
        ? -0.9549476 * x ** 3 - 1.37418593 * x ** 2 + 2.09137015 * x - 0.16748867
        : 3.081758 * x ** 3 - 5.8733867 * x ** 2 + 3.75112997 * x - 0.37001483;
  const X = x / y;
  const Z = (1 - x - y) / y;
  // XYZ (Y=1) to linear sRGB. Clip out-of-gamut negatives, then restore luminance.
  const r = Math.max(0, 3.2406 * X - 1.5372 - 0.4986 * Z);
  const g = Math.max(0, -0.9689 * X + 1.8758 + 0.0415 * Z);
  const b = Math.max(0, 0.0557 * X - 0.204 + 1.057 * Z);
  const luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b;
  return new Color().setRGB(r / luminance, g / luminance, b / luminance);
}