Generatore ANSI truecolor

Inserisca un valore esadecimale breve o completo, oppure un colore rgb(), e scelga primo piano o sfondo. Il risultato comprende il carattere di escape reale per l’uso diretto, una forma con escape visibile comoda nel codice sorgente e nella configurazione, i canali normalizzati e la sequenza standard di ripristino. È deterministico, rapido e adatto a strumenti shell, script di compilazione, sistemi di registrazione e interfacce a riga di comando.

Scelga un colore e la parte del terminale da modificare

Parta da un colore in uno dei formati accettati: esadecimale a tre cifre come <code>#3af</code>, esadecimale a sei cifre come <code>#33AAFF</code>, le stesse sei cifre senza cancelletto oppure una funzione RGB come <code>rgb(51, 170, 255)</code>. Le lettere esadecimali non distinguono tra maiuscole e minuscole e sono ammessi spazi nella funzione RGB. Ogni canale RGB deve essere un numero intero compreso tra zero e 255. Scelga quindi se applicare il colore al primo piano, che normalmente indica il testo, oppure allo sfondo dietro al testo. L’impostazione predefinita è il primo piano, perché rappresenta l’esigenza più comune nell’output dei comandi. Il generatore espande i valori esadecimali abbreviati, normalizza il colore finale in sei cifre esadecimali maiuscole e restituisce i canali rosso, verde e blu in formato decimale. In questo modo Lei può controllare facilmente il risultato prima di inserirlo in uno script. I canali alfa, i nomi di colori CSS, le percentuali e i canali fuori intervallo vengono rifiutati intenzionalmente: le sequenze ANSI truecolor codificano esattamente tre canali di colore a otto bit e non prevedono una componente alfa. Una convalida chiara impedisce che un valore CSS accidentale diventi silenziosamente un colore inatteso nel terminale.

Usi in sicurezza la sequenza di escape generata

Un colore ANSI a ventiquattro bit utilizza un carattere di escape seguito da un elenco di parametri SGR. I colori di primo piano iniziano con <code>38;2</code>, mentre quelli di sfondo iniziano con <code>48;2</code>; seguono i tre canali decimali nell’ordine rosso, verde e blu, e la sequenza termina con <code>m</code>. La risposta offre due rappresentazioni della stessa istruzione. Il campo <code>sequence</code> contiene il vero carattere ESC, quindi un programma può concatenarlo direttamente al testo. Il campo <code>escaped</code> inizia con i caratteri visibili <code>\x1b</code>, spesso più semplici da copiare in JavaScript, shell, modelli JSON o documentazione, dove un carattere di controllo letterale potrebbe creare confusione. Il modo in cui una stringa con escape viene interpretata dipende dal linguaggio che la ospita; scelga quindi la rappresentazione adatta al Suo ambiente. Aggiunga il ripristino restituito dopo il tratto colorato, così i prompt e le righe di log successive non erediteranno lo stile. Concettualmente, componga l’output come sequenza del colore, messaggio e ripristino. Eviti i codici colore negli output destinati alle macchine, a meno che i consumatori non li supportino esplicitamente: i caratteri di controllo invisibili possono compromettere confronti, parser e snapshot.

Valuti il supporto del terminale e il comportamento in produzione

Truecolor è ampiamente supportato dagli emulatori di terminale moderni, ma il protocollo ANSI non impone a ogni destinazione di visualizzare colori a ventiquattro bit. Un file reindirizzato, un terminale essenziale, un visualizzatore di log di integrazione continua o un’applicazione configurata per rimuovere lo stile potrebbe non mostrare alcun colore oppure esporre i caratteri di controllo. Consideri il colore come presentazione, non come informazione: etichette, livelli di gravità e messaggi di stato devono restare comprensibili anche quando lo stile viene rimosso. Molti programmi a riga di comando abilitano il colore solo quando lo standard output è collegato a un terminale interattivo e offrono un’opzione o una variabile d’ambiente per forzarlo o disabilitarlo. Questo generatore non esamina il terminale del chiamante, perché ciò renderebbe il risultato puro dell’API dipendente da un ambiente di esecuzione estraneo. Crea semplicemente la sequenza di byte corretta per il colore richiesto. L’algoritmo non effettua richieste di rete, non usa casualità e non conserva l’input. Input identici restituiscono quindi JSON identico. L’uso dell’API costa $0.002 per richiesta, mentre l’esecuzione nel browser utilizza la medesima logica pura di conversione. Nei sistemi di registrazione, inserisca preferibilmente le sequenze solo nel renderer finale destinato alle persone, invece di salvarle negli eventi strutturati; così ricerche ed esportazioni successive restano pulite senza rinunciare a un output gradevole in console.