Gerador ANSI truecolor

Informe um valor hexadecimal curto ou completo, ou uma cor rgb(), e escolha primeiro plano ou fundo. O resultado inclui o caractere de escape real para uso direto, uma forma com escape visível adequada para código-fonte e configuração, os canais normalizados e a sequência padrão de redefinição. A conversão é determinística, rápida e útil em ferramentas de shell, scripts de build, sistemas de logs e interfaces de linha de comando.

Escolha a cor e a parte do terminal que será alterada

Comece com uma cor em um dos formatos aceitos: hexadecimal de três dígitos, como <code>#3af</code>, hexadecimal de seis dígitos, como <code>#33AAFF</code>, os mesmos seis dígitos sem cerquilha ou uma função RGB, como <code>rgb(51, 170, 255)</code>. Letras hexadecimais não diferenciam maiúsculas de minúsculas, e espaços dentro da função RGB são permitidos. Cada canal RGB deve ser um número inteiro entre zero e 255. Depois, selecione se a cor será aplicada ao primeiro plano, normalmente o texto, ou ao fundo atrás dele. O padrão é primeiro plano, pois esse é o uso mais comum em saídas de comandos. O gerador expande valores hexadecimais abreviados, normaliza a cor final em hexadecimal de seis dígitos maiúsculos e devolve os canais vermelho, verde e azul em decimal. Assim, você pode conferir o resultado antes de inseri-lo em um script. Canais alfa, nomes de cores CSS, porcentagens e canais fora da faixa são rejeitados de propósito, pois sequências ANSI truecolor codificam exatamente três canais de oito bits e não têm componente alfa. Uma validação clara impede que um valor CSS acidental se transforme silenciosamente em uma cor inesperada no terminal.

Use a sequência de escape gerada com segurança

Uma cor ANSI de vinte e quatro bits usa um caractere de escape seguido por uma lista de parâmetros SGR. Cores de primeiro plano começam com <code>38;2</code>, enquanto cores de fundo começam com <code>48;2</code>; os três canais decimais aparecem em seguida, na ordem vermelho, verde e azul, e a sequência termina com <code>m</code>. A resposta fornece duas representações da mesma instrução. O campo <code>sequence</code> contém o caractere ESC real, portanto um programa pode concatená-lo diretamente ao texto. O campo <code>escaped</code> começa com os caracteres visíveis <code>\x1b</code>, que geralmente são mais fáceis de copiar para JavaScript, shell, modelos JSON ou documentação, onde um caractere de controle literal causaria confusão. A interpretação de uma string com escape depende da linguagem que a contém; use a representação adequada ao seu ambiente. Acrescente a redefinição retornada depois do trecho colorido para impedir que prompts e linhas de log seguintes herdem o estilo. Conceitualmente, monte a saída como sequência de cor, mensagem e redefinição. Evite códigos de cor em saídas legíveis por máquinas, a menos que os consumidores os aceitem explicitamente, pois caracteres de controle invisíveis podem quebrar comparações, analisadores e snapshots.

Entenda o suporte do terminal e o comportamento em produção

Truecolor é amplamente aceito por emuladores de terminal modernos, mas o protocolo ANSI não obriga todo destino de saída a renderizar cores de vinte e quatro bits. Um arquivo redirecionado, um terminal básico, um visualizador de logs de integração contínua ou um aplicativo configurado para remover estilos pode não mostrar cores ou pode expor caracteres de controle. Trate a cor como apresentação, não como informação: rótulos, níveis de gravidade e mensagens de status devem continuar compreensíveis quando o estilo for removido. Muitos programas de linha de comando ativam cores apenas quando a saída padrão está ligada a um terminal interativo e oferecem uma opção ou variável de ambiente para forçar ou desativar esse comportamento. Este gerador não inspeciona o terminal de quem faz a chamada, porque isso faria um resultado puro da API depender de um ambiente de execução não relacionado. Ele apenas cria a sequência de bytes correta para a cor solicitada. O algoritmo não faz solicitações de rede, não usa aleatoriedade e não armazena a entrada. Entradas idênticas, portanto, retornam JSON idêntico. O uso da API custa US$ 0,002 por solicitação, enquanto a execução no navegador utiliza a mesma lógica pura de conversão. Em sistemas de logs, prefira inserir as sequências somente no renderizador final destinado a pessoas, em vez de armazená-las em eventos estruturados; assim, pesquisas e exportações posteriores permanecem limpas sem sacrificar uma saída de console atraente.