Interpolar dos colores en HSL por la ruta de tono más corta

Indique dos colores hexadecimales y una fracción entre cero y uno; la capacidad devuelve el punto intermedio como valores hex, RGB y HSL normalizados. El tono recorre el lado más corto del círculo cromático y aplica una regla fija cuando existe un empate de media vuelta, por lo que una misma solicitud siempre genera el mismo resultado. La validación estricta permite usarla en herramientas de diseño, canalizaciones de tokens, fotogramas de animación y pruebas repetibles.

Cómo funciona la interpolación HSL por la ruta más corta

Cada entrada comienza como un color hexadecimal de 3 o 6 dígitos, con almohadilla inicial o sin ella. El motor expande la forma abreviada, normaliza las mayúsculas y minúsculas, convierte los canales sRGB enteros a HSL y trata el tono como un ángulo, no como un número lineal común. Esta diferencia es esencial cerca del límite del círculo cromático. Una mezcla de 350 grados a 10 grados debe avanzar 20 grados a través del rojo, no recorrer en sentido largo casi todos los demás tonos. Por eso, la diferencia con signo se normaliza en el intervalo semiabierto desde -180 grados, incluido, hasta 180 grados, excluido. Un empate exacto de 180 grados siempre toma el sentido negativo y resuelve de forma determinista una elección que sería ambigua. La saturación y la luminosidad se interpolan directamente con la misma fracción. El color HSL resultante vuelve a convertirse en canales RGB enteros redondeados y en una cadena hexadecimal de 6 dígitos en minúsculas. Los componentes HSL y el delta de tono se redondean a 6 decimales para conservar un JSON estable y una precisión útil. No intervienen la red, valores aleatorios, el reloj ni estado mutable alguno.

Cómo elegir la fracción e interpretar la respuesta

Asigne a t el valor 0 para obtener el color inicial, 1 para obtener el final o un decimal intermedio para calcular un punto entre ambos. El valor 0.25 recorre una cuarta parte de cada componente HSL interpolado, mientras que 0.5 selecciona el punto medio. La respuesta repite los dos colores extremos normalizados y la fracción exacta; después entrega hex, un objeto rgb con canales enteros r, g y b, y un objeto hsl donde h se expresa en grados y s y l en porcentajes. El campo hue_delta muestra todo el recorrido angular con signo elegido antes de multiplicarlo por t. El campo asociado hue_path indica increasing, decreasing o none, información útil para depurar degradados que cruzan cero grados o reproducir el trayecto en otro renderizador. Los extremos en escala de grises reciben el tono convencional calculado de cero porque un color RGB acromático no posee un tono visible definido. La interpolación continúa siendo determinista, aunque añadir saturación entre un gris y un extremo cromático puede revelar el tono convencional del gris. Envíe t como número JSON, no como texto entre comillas.

Uso seguro en flujos de diseño y producción

Esta operación resulta apropiada cuando un sistema necesita un color reproducible entre dos paradas conocidas. Un generador de temas puede crear tokens para estados de puntero, pulsación o transición sin incorporar una biblioteca de color. Un servicio de gráficos puede solicitar muestras equidistantes con fracciones como 0, 0.25, 0.5, 0.75 y 1. Una canalización de animación puede calcular fotogramas cuyo tono no atraviese de manera inesperada el arco largo por el verde o el azul. También es práctica para pruebas de regresión, pues la entrada normalizada y el redondeo acotado facilitan las comparaciones. El endpoint acepta deliberadamente solo colores RGB hexadecimales; los canales alfa, nombres CSS, cadenas rgb(), cadenas HSL y espacios de gama amplia quedan fuera del contrato. Las longitudes incorrectas, caracteres no hexadecimales, campos ausentes, fracciones no finitas o valores fuera del intervalo fallan en la validación. Cada ejecución correcta de la API cuesta $0.002 por elemento, y el navegador emplea el mismo motor puro. HSL no es perceptualmente uniforme; use una herramienta basada en LAB si necesita pasos visuales de apariencia equidistante.