ForHosting KIT · Utilidades de desarrollo

Convertidor de XYZ a xyY

El convertidor de XYZ a xyY transforma tres valores triestímulo CIE en dos coordenadas de cromaticidad y un valor de luminancia independiente.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Así puede comparar el color al margen del brillo y conservar a la vez el componente Y original para trabajos sensibles a la luminancia. Introduzca X, Y y Z no negativos en una escala coherente; el convertidor valida los datos, rechaza la cromaticidad indefinida del negro y devuelve resultados numéricos estables con las ecuaciones de normalización CIE estándar.

Comprenda qué cambia entre XYZ y xyY

CIE XYZ representa un estímulo mediante tres valores triestímulo, pero mezcla la magnitud de esos valores con sus proporciones. La representación xyY separa ambos conceptos. Sus coordenadas x e y minúsculas describen la cromaticidad, es decir, a grandes rasgos, el color sin la intensidad global. La Y mayúscula conserva el componente triestímulo original relacionado con la luminancia. Esta separación resulta útil si usted necesita situar colores en un diagrama de cromaticidad CIE 1931, comparar mediciones tomadas con distintos niveles de brillo o guardar la luminancia junto con un par compacto de coordenadas. La conversión no aplica adaptación del punto blanco, curva gamma, matriz RGB ni corrección perceptual; solo normaliza los valores XYZ facilitados. Por tanto, el observador, el iluminante, las condiciones de medición y la escala XYZ siguen dependiendo del flujo colorimétrico externo. Convertir a xyY dos ternas obtenidas bajo referencias diferentes no iguala esas condiciones. Utilice valores pertenecientes al mismo contexto colorimétrico e interprete allí las coordenadas devueltas.

Cómo funciona el cálculo determinista

El convertidor comprueba primero que X, Y y Z sean números finitos y no negativos. Después calcula la suma X + Y + Z. La x minúscula es X dividida por esa suma, y la y minúscula es Y dividida por el mismo denominador. La Y mayúscula del resultado se copia de la entrada sin normalizar, por lo que conserva la magnitud relacionada con la luminancia y su escala original. Como ambas coordenadas usan un denominador común, x e y no dependen de la escala: multiplicar los tres datos XYZ por el mismo factor positivo no cambia x ni y, aunque sí multiplica Y por dicho factor. Los resultados se redondean con una precisión significativa estable para producir valores JSON coherentes en ejecuciones repetidas. No intervienen solicitudes de red, azar, reloj, tablas de consulta ni perfiles de color del entorno. La terna X = 0, Y = 0, Z = 0 se rechaza porque el denominador es cero y un estímulo totalmente oscuro carece de cromaticidad definida. También se rechazan sumas que desborden el intervalo numérico finito.

Prepare los datos e interprete la salida con seguridad

Utilice una única escala coherente para las tres entradas. XYZ suele expresarse con un blanco de referencia cercano a Y = 100, pero los valores normalizados próximos a Y = 1 son igualmente válidos; esta herramienta no presupone ninguna de las dos convenciones. La Y mayúscula devuelta permanece en la escala que usted haya usado. Las coordenadas x e y minúsculas son cocientes y, por ello, no tienen unidad. Con entradas XYZ válidas y no negativas, cada coordenada está entre cero y uno, y x + y no supera uno; si un cálculo posterior necesita la tercera coordenada implícita, esta es z = 1 - x - y. No confunda y con Y: la primera es una coordenada normalizada de cromaticidad y la segunda es el valor triestímulo original relacionado con la luminancia. Recuerde además que xyY no es perceptualmente uniforme, de modo que distancias geométricas iguales en un diagrama xy no garantizan diferencias visuales iguales. Emplee la conversión para intercambio normalizado, gráficos, instrumentación o cálculos intermedios; para diferencias perceptuales, continúe en un espacio adecuado como CIELAB con las reglas de adaptación y blanco necesarias.

Representar un color medido

Convierta la salida XYZ de un espectrofotómetro en coordenadas x e y para un diagrama CIE 1931 sin perder la luminancia.

Comparar cromaticidad con distintos brillos

Normalice mediciones XYZ escaladas proporcionalmente para comparar sus coordenadas de cromaticidad al margen de Y.

Preparar datos colorimétricos

Transforme registros XYZ en la representación xyY que esperan los programas de iluminación, pantallas, imagen o calibración.

¿Cuánto cuesta la conversión?

El precio de la API es $0.002 por solicitud. La versión del navegador es gratuita.

¿Qué escala XYZ debo utilizar?

Cualquier escala coherente es válida. Use la misma para X, Y y Z; la Y mayúscula de la salida conserva esa escala.

¿Por qué se rechaza una entrada XYZ formada por ceros?

Las fórmulas dividen entre X + Y + Z. Para un estímulo totalmente nulo, la suma es cero y la cromaticidad no está definida matemáticamente.

¿Realiza este convertidor una adaptación cromática?

No. Solo normaliza XYZ como coordenadas xy y conserva Y; no modifica puntos blancos ni condiciones del observador.

¿Por qué son diferentes la y minúscula y la Y mayúscula?

La y minúscula es una proporción de cromaticidad sin unidad. La Y mayúscula es el componente XYZ original relacionado con la luminancia.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/color/xyz-xyy

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/color/xyz-xyy \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x_value":41.24,"y_value":21.26,"z_value":1.93}'
{
  "x_value": 41.24,
  "y_value": 21.26,
  "z_value": 1.93
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.xyz_xyy",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →