Interpolare due colori HSL sul percorso di tonalità più breve

Fornisca due colori esadecimali e una frazione compresa tra zero e uno: la capacità restituisce il punto intermedio come valori hex, RGB e HSL normalizzati. La tonalità percorre il lato più breve della ruota cromatica e applica una regola fissa nei pareggi di mezzo giro, quindi la stessa richiesta produce sempre lo stesso risultato. La validazione rigorosa rende il servizio adatto a strumenti di design, pipeline di token, fotogrammi chiave e test ripetibili.

Come funziona l’interpolazione HSL sul percorso più breve

Ogni input parte da un colore esadecimale di 3 o 6 cifre, con o senza cancelletto iniziale. Il motore espande la forma abbreviata, normalizza maiuscole e minuscole, converte i canali sRGB interi in HSL e considera la tonalità come un angolo anziché come un normale numero lineare. La distinzione è importante vicino al confine della ruota cromatica. Una miscela da 350 gradi a 10 gradi deve percorrere 20 gradi attraverso il rosso, non compiere il tragitto lungo passando per quasi tutte le altre tonalità. La differenza con segno viene quindi normalizzata nell’intervallo semiaperto da -180 gradi incluso a 180 gradi escluso. Un pareggio esatto di 180 gradi sceglie sempre la direzione negativa, rendendo deterministica una decisione altrimenti ambigua. Saturazione e luminosità vengono interpolate direttamente con la stessa frazione. Il colore HSL risultante viene riconvertito in canali RGB interi arrotondati e in una stringa esadecimale minuscola di 6 cifre. I componenti HSL e il delta di tonalità sono arrotondati a 6 decimali per mantenere stabile il JSON senza perdere precisione utile. Il calcolo non utilizza rete, valori casuali, orologio o stato mutabile.

Come scegliere la frazione e leggere la risposta

Imposti t su 0 per ricevere il colore iniziale, su 1 per ottenere quello finale oppure su un decimale intermedio per calcolare un punto tra i due. Il valore 0.25 percorre un quarto di ciascun componente HSL interpolato, mentre 0.5 seleziona il punto medio. La risposta ripete entrambi gli estremi normalizzati e la frazione esatta, quindi fornisce hex, un oggetto rgb con i canali interi r, g e b e un oggetto hsl nel quale h è espresso in gradi e s e l in percentuale. Il campo hue_delta mostra l’intero percorso angolare con segno scelto prima di moltiplicarlo per t. Il relativo hue_path vale increasing, decreasing o none ed è utile per verificare gradienti che attraversano zero gradi o per riprodurre il tragitto in un altro renderer. Agli estremi in scala di grigi viene assegnata la tonalità convenzionale zero, perché un colore RGB acromatico non ha una tonalità visivamente definita. L’interpolazione resta deterministica, ma aggiungere saturazione tra un grigio e un colore cromatico può rendere visibile tale convenzione. Invii t come numero JSON e non come stringa tra virgolette.

Uso sicuro nei flussi di design e produzione

Questa operazione è adatta a qualsiasi sistema che richieda un colore riproducibile tra due punti noti. Un generatore di temi può creare token per passaggio del puntatore, pressione o transizione senza includere una libreria cromatica. Un servizio di grafici può richiedere campioni equidistanti usando frazioni come 0, 0.25, 0.5, 0.75 e 1. Una pipeline di animazione può calcolare fotogrammi chiave la cui tonalità non attraversi inaspettatamente l’arco lungo attraverso il verde o il blu. Input normalizzati e arrotondamento limitato agevolano anche i test di regressione. L’endpoint accetta intenzionalmente solo colori RGB esadecimali; canali alfa, nomi CSS, stringhe rgb(), stringhe HSL e spazi ad ampia gamma non fanno parte del contratto. Lunghezze errate, caratteri non esadecimali, campi assenti, frazioni non finite e valori fuori intervallo non superano la validazione. Un’esecuzione API riuscita costa $0.002 per elemento, mentre il browser usa lo stesso motore puro. HSL non è percettivamente uniforme: scelga uno strumento basato su LAB quando servono passaggi visivi di aspetto equidistante.