Implementación de CIEDE2000 en Haxe

Versión de la función: v1.0.0
Estadísticas del sitio
Número de visitas417
Número de archivos consultados290 + 398

Esta página presenta una implementación de referencia de la fórmula de diferencia de color CIEDE2000 en Haxe. Si desea garantizar una compatibilidad perfecta (hasta el décimo decimal) con algunas implementaciones de terceros, es posible que tenga que modificar los comentarios del código fuente. Para facilitarlo, el siguiente enlace automatiza esta operación.

Diagrama de la fórmula CIEDE2000 completa con los componentes L*a*b* y los ajustes

La función ΔE2000 en Haxe

Consideremos la más común y académica (Sharma, 2005) de las dos formulaciones.

// Esta función escrita en Haxe es de dominio público y no
// está afiliada a la CIE (Comisión Internacional de Iluminación).

// Definir explícitamente π garantiza que el código funcione en todas las plataformas.
public static inline var M_PI:Float = 3.14159265358979323846264338328;

// La implementación clásica de CIEDE2000 que recibe dos colores L*a*b* y devuelve su diferencia.
// El componente "L" varía de 0 a 100. "a" y "b" normalmente se proyectan entre -128 y 127.
public static function ciede_2000(l_1:Float, a_1:Float, b_1:Float, l_2:Float, a_2:Float, b_2:Float):Float {
	// Ejecuta el cálculo de diferencia de color CIEDE2000 en Haxe.
	// k_l, k_c y k_h son factores paramétricos a ajustar según
	// sus necesidades de visualización (texturas, fondos).
	var k_l = 1.0;
	var k_c = 1.0;
	var k_h = 1.0;
	var n = (Math.sqrt(a_1 * a_1 + b_1 * b_1) + Math.sqrt(a_2 * a_2 + b_2 * b_2)) * 0.5;
	n = n * n * n * n * n * n * n;
	// Un factor que implica la croma elevada a la potencia 7,
	// diseñado para tener más en cuenta la influencia de la croma.
	n = 1.0 + 0.5 * (1.0 - Math.sqrt(n / (n + 6103515625.0)));
	// Aplicación del factor de corrección de la croma para compensar su no linealidad.
	var c_1 = Math.sqrt(a_1 * a_1 * n * n + b_1 * b_1);
	var c_2 = Math.sqrt(a_2 * a_2 * n * n + b_2 * b_2);
	// La función atan2 es preferible a atan porque calcula el ángulo de un
	// punto (x, y) en todos los cuadrantes, teniendo en cuenta el signo de x e y.
	var h_1 = Math.atan2(b_1, a_1 * n);
	var h_2 = Math.atan2(b_2, a_2 * n);
	if (h_1 < 0.0) h_1 += 2.0 * M_PI;
	if (h_2 < 0.0) h_2 += 2.0 * M_PI;
	n = Math.abs(h_2 - h_1);
	// Evita que la rama dependa del RoundingMode del lenguaje de programación.
	if (M_PI - 1E-14 < n && n < M_PI + 1E-14) n = M_PI;
	// Cuando los ángulos de tono se encuentran en diferentes cuadrantes,
	// la media aritmética simple puede dar un ángulo incorrecto, las
	// líneas siguientes aplican la corrección angular necesaria.
	var h_m = (h_1 + h_2) * 0.5;
	var h_d = (h_2 - h_1) * 0.5;
	if (M_PI < n) {
		h_d += M_PI;
		// 📜 La formulación de Sharma no utiliza la línea siguiente, sino la que le sigue.
		// Nota: estas dos variantes sólo difieren en ±0,0003 en la diferencia de color final.
		h_m += M_PI;
		// h_m += h_m < M_PI ? M_PI : -M_PI;
	}
	var p = 36.0 * h_m - 55.0 * M_PI;
	n = (c_1 + c_2) * 0.5;
	n = n * n * n * n * n * n * n;
	// El término de corrección de la rotación del tono mejora la precisión
	// del algoritmo, especialmente cuando la comparación se refiere a azules.
	var r_t = -2.0 * Math.sqrt(n / (n + 6103515625.0))
				* Math.sin(M_PI / 3.0 * Math.exp(p * p / (-25.0 * M_PI * M_PI)));
	n = (l_1 + l_2) * 0.5;
	n = (n - 50.0) * (n - 50.0);
	//  Luminosidad .
	var l = (l_2 - l_1) / (k_l * (1.0 + 0.015 * n / Math.sqrt(20.0 + n)));
	// Estos coeficientes se utilizan para modular la influencia de
	// los componentes armónicos en el cálculo de la diferencia de tono.
	var t = 1.0	+ 0.24 * Math.sin(2.0 * h_m + M_PI / 2.0)
			+ 0.32 * Math.sin(3.0 * h_m + 8.0 * M_PI / 15.0)
			- 0.17 * Math.sin(h_m + M_PI / 3.0)
			- 0.20 * Math.sin(4.0 * h_m + 3.0 * M_PI / 20.0);
	n = c_1 + c_2;
	// Tono.
	var h = 2.0 * Math.sqrt(c_1 * c_2) * Math.sin(h_d) / (k_h * (1.0 + 0.0075 * n * t));
	// Croma.
	var c = (c_2 - c_1) / (k_c * (1.0 + 0.0225 * n));
	// Devolver la raíz cuadrada garantiza que dE00 representa una distancia
	// geométrica (que va de 0 a aproximadamente 185) en el espacio CIELAB.
	return Math.sqrt(l * l + h * h + c * c + c * h * r_t);
}

//    Proyecto GitHub : https://github.com/michel-leonard/ciede2000-color-matching
//   Pruebas en línea : https://michel-leonard.github.io/ciede2000-color-matching

// L1 = 44.6   a1 = 19.9   b1 = 5.5
// L2 = 45.1   a2 = 14.6   b2 = -3.1
// CIE ΔE00 = 6.7625351227 (Bruce Lindbloom, Netflix’s VMAF, ...)
// CIE ΔE00 = 6.7625487710 (Gaurav Sharma, OpenJDK, ...)
// Desviación entre implementaciones ≈ 1.4e-5

// Consulte los comentarios del código fuente para pasar de una de estas variantes de implementación ΔE*00 a la otra.

Parámetros k_l, k_c y k_h

Los parámetros k_l, k_c y k_h de la fórmula CIEDE2000 son factores de ponderación que se aplican a los componentes de luminosidad (ΔL*), croma (ΔC*) y tono (ΔH*), respectivamente. En el código fuente, se definen como constantes cuyo valor por defecto es 1, lo que se corresponde con las condiciones de observación estándar establecidas por la Comisión Internacional de Iluminación (CIE). En la práctica, puede ser necesario ajustar estos coeficientes para reflejar condiciones específicas: por ejemplo, k_l = 2 se utiliza a veces para dar más peso a las diferencias de brillo (algo habitual en la industria textil), mientras que k_c o k_h pueden reducirse para aumentar la tolerancia a las variaciones de saturación o tono. En resumen, estos coeficientes suelen oscilar entre 0,5 y 2, siendo 1 el valor más habitual.

Precisión y fiabilidad del código fuente

La diferencia entre la formulación académica de Sharma y la simplificada de Lindbloom no supera ±0,0003 en el ΔE2000 final. La implementación que aquí se presenta es de 64 bits y garantiza una precisión de más de 10 decimales; por lo tanto, la elección de una formulación en lugar de otra es un detalle técnico. En la parte superior de esta página, puedes elegir entre las dos formulaciones; la que se muestra actualmente es la formulación simplificada.

¿Cómo determinar si una implementación determinada de CIEDE2000 es académica o simplificada?

¿Cómo se convierten los colores RGB a L*a*b*?

Vaya a la página AWK, C, Dart, Java, JavaScript, Kotlin, Lua, PHP, Python, Ruby o Rust, donde ya está implementado dicho conversor (que utiliza el iluminante D65), además de la función de comparación de colores.

Rangos de valores en CIELAB e interpretación del ΔE2000

En el espacio de color CIELAB, el componente L* representa la luminosidad y suele variar de 0 (negro) a 100 (blanco). Los componentes a* y b* definen los ejes de color: a* va del verde al rojo, y b* del azul al amarillo. En la práctica, los valores de a* y b* casi siempre se limitan a un intervalo comprendido entre -128 y +127, aunque la norma no establece un límite oficial para estos dos componentes.

Ejemplo de dos colores que presentan una diferencia apenas perceptible (JND) según CIEDE2000
Color 1Color 2Valor de ΔE2000
1
2
3
Ejemplos de valores CIEDE2000 calculados entre dos colores distintos
Color 1Color 2Valor de ΔE2000
5
10
15

ΔE2000 (CIEDE2000) cuantifica la diferencia perceptible entre dos colores: 0 significa que son idénticos, y valores más altos (hasta 185 y más) indican una diferencia más notable. Por ejemplo, un ΔE2000 alrededor de 5 indica colores cercanos, mientras que alrededor de 15 indica colores claramente distintos. Cuando el valor ΔE2000 supera 40, los colores comparados ya casi no tienen nada en común, y no podemos extraer de ellos información precisa.

Ejemplo de uso en Haxe

// Compute the Delta E (CIEDE2000) color difference between two L*a*b* colors in Haxe

// Color 1: l1 = 64.9   a1 = 12.6   b1 = 3.0
// Color 2: l2 = 66.8   a2 = 18.3   b2 = -4.3

var deltaE: Float = ciede_2000(l1, a1, b1, l2, a2, b2);
trace(deltaE);

// .................................................. This shows a ΔE2000 of 6.6360262302
// As explained in the comments, compliance with Gaurav Sharma would display 6.6360100975

Los resultados de las pruebas

Nuestro programa de pruebas, escrito en C99, incluye 250 pruebas estáticas precisas. Los resultados muestran que esta función de CIEDE2000 en Haxe es interoperable con los otros 41 lenguajes de programación.

CIEDE2000 Verification Summary :
  First Verified Line : 11,-68.86,59.9,1,-69.38,-117.7,66.5323051729542101
             Duration : 136.05 s
            Successes : 10000000
               Errors : 0
      Average Delta E : 62.9504
    Average Deviation : 4.2509125594558664e-15
    Maximum Deviation : 1.1368683772161603e-13

Archivos para descargar

Siéntase libre de utilizar estos archivos puestos a disposición por Michel, incluso con fines comerciales.

Estadísticas del sitio : descargas de archivos
ArchivoTamañoNúmero de clics
ciede-2000.hx4 KB87
ciede-2000-driver.hx6 KB86
ciede-2000-random.hx6 KB75
test-hx.yml4 KB42
reference-dataset.txt4 KB398
Haga clic en hx.zip para descargar todos estos archivos en un archivo.

Comunidad

¿Qué opina de este código fuente o de CIEDE2000? Su opinión es importante para nosotros. El libro de visitas ya contiene 9 mensajes - incluyendo 1 en español. Eche un vistazo y comparta su opinión.