Limitar cor à gama
Coloque de volta na escala de 0 a 255 os valores RGB que passaram do limite: vermelho 300, verde −20 e azul 127.5 viram 255, 0 e 127.5, e você vê quais canais mudaram. Nada é arredondado no caminho. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Resistência (Ω)
- 300
- G
- -20
- B
- 127,5
- Resistência (Ω)
- 255
- G
- 0
- Rgb
- rgb(255, 0, 127.5)
- Canais alterados
- r, g
Limite uma cor à gama quando os dados RGB tiverem canais abaixo de zero ou acima de 255. Esta ferramenta determinística valida vermelho, verde e azul e corrige cada canal separadamente para o limite mais próximo do intervalo padrão de oito bits. Valores que já estão dentro do intervalo permanecem iguais, inclusive os fracionários, pois limitar controla as fronteiras e não a precisão. A resposta apresenta os canais corrigidos, uma string RGB pronta para leitura, se algo mudou e quais canais foram ajustados.
O que significa limitar uma cor RGB à gama
Uma cor RGB de oito bits normalmente representa vermelho, verde e azul em uma escala inclusiva de 0 a 255. Dados fora desses limites não podem ser representados diretamente nesse intervalo: um canal vermelho de 300 é alto demais, enquanto um verde de -20 é baixo demais. A limitação corrige esse problema convertendo todo valor abaixo de 0 em 0, todo valor acima de 255 em 255 e mantendo os valores intermediários.
Cada canal é tratado de forma independente, portanto corrigir o vermelho não altera o verde nem o azul. A ferramenta devolve r, g e b limitados, além de uma string da função rgb com o mesmo resultado. A operação é mais específica do que conversão de cores, mapeamento entre espaços ou compressão perceptual.
Ela não transforma HSL, Lab, Display P3 ou CMYK e não tenta preservar a tonalidade percebida após uma conversão. Sua função prática é validar três canais numéricos e colocá-los, de modo transparente e reproduzível, no intervalo permitido de 0 a 255.
Validação, canais fracionários e resultados determinísticos
Todos os canais são obrigatórios e precisam ser números finitos. A notação científica é permitida quando resulta em um número finito. Depois da validação, o algoritmo aplica o mínimo entre 255 e o máximo entre 0 e o valor do canal.
Essa fórmula não contém limiar oculto, regra regional ou desvio dependente da plataforma. Valores fracionários dentro do intervalo são preservados: 127.5 continua 127.5. Isso é intencional, pois limitar e arredondar são operações diferentes.
A implementação não usa rede, data atual, números aleatórios, estado compartilhado nem modelo externo. Assim, entradas válidas idênticas sempre produzem os mesmos dados serializados.
Onde a limitação de RGB se encaixa no fluxo
Valores de cor frequentemente atravessam sistemas com premissas diferentes. Um cálculo de shader pode ultrapassar o limite ao adicionar luz, uma exportação de análise de imagem pode conter um pequeno componente negativo, uma fórmula de planilha pode gerar 255.2 ou um interpolador de animação pode passar brevemente do destino. A limitação é útil na fronteira em que esses valores precisam virar canais RGB comuns para canvas, geradores de CSS, miniaturas, protocolos de dispositivos ou tokens de design.
Coloque-a depois do cálculo que pode extrapolar e antes do consumidor que exige canais delimitados. Os campos de alteração podem alimentar logs e métricas de qualidade: você aceita a cor corrigida para manter a robustez e registra que os dados de origem precisaram de reparo. Não use a limitação para esconder entradas sistematicamente ruins nem como mapeamento perceptual de espaços de ampla gama.
Casos de uso
Estabilizar pipelines de renderização
Limite resultados aritméticos antes de enviá-los a canvas, geradores de CSS ou renderizadores de imagem.
Perguntas frequentes
O que acontece com um canal abaixo de zero?
Ele se torna 0. Os demais canais são avaliados separadamente e não mudam quando já estão no intervalo.
O que acontece com um canal acima de 255?
Ele se torna 255, o limite superior do intervalo de canais RGB aceito.
Valores RGB fracionários são arredondados?
Não. Valores finitos entre 0 e 255 são preservados porque esta capacidade limita fronteiras, sem arredondar a precisão.
Quais valores são recusados em vez de ajustados?
São recusados canais ausentes, palavras, campos em branco e tudo o que não for um número finito. Números escritos como texto e notação científica são aceitos quando resultam em um número real.
Como sei quais canais foram corrigidos?
O resultado informa se algo mudou e lista em ordem os canais ajustados. Com vermelho 300, verde −20 e azul 127.5, aparecem só o vermelho e o verde, porque o azul já estava dentro da faixa.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/color/clamp-gamut \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"r":300,"g":-20,"b":127.5}'const res = await fetch("https://api.kit.forhosting.com/color/clamp-gamut", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"r": 300,
"g": -20,
"b": 127.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/color/clamp-gamut",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"r": 300,
"g": -20,
"b": 127.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/clamp-gamut", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"r":300,"g":-20,"b":127.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"r":300,"g":-20,"b":127.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/clamp-gamut", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"r": 300,
"g": -20,
"b": 127.5
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "color.clamp_gamut",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Você pode usar a ferramenta no navegador para correções rápidas ou a API por US$ 0,002 por solicitação em pipelines, importações, testes e automação de sistemas de design.
O que significa limitar uma cor RGB à gama
Ela também retorna o booleano changed e a lista ordenada channels_changed, permitindo que você diferencie uma entrada limpa de outra reparada sem fazer comparações.
Validação, canais fracionários e resultados determinísticos
Os campos preferenciais são r, g e b, mas os nomes descritivos red, green e blue também são aceitos. Strings estritamente numéricas são válidas para formulários, registros vindos de CSV e parâmetros de consulta; strings vazias, palavras, booleanos, arrays, objetos, Infinity e NaN são recusados com invalid_input. O zero negativo se torna zero, evitando uma representação com sinal desnecessária no JSON. O sinalizador changed só é verdadeiro quando algum valor cruza uma fronteira, e channels_changed lista os nomes curtos afetados na ordem estável vermelho, verde e azul.
Onde a limitação de RGB se encaixa no fluxo
Nos testes, valide os canais e channels_changed para impedir que alterações futuras introduzam retorno cíclico, arredondamento ou rejeição da cor inteira. O navegador executa a mesma implementação pura; na automação, cada chamada bem-sucedida da API custa US$ 0,002.
Casos de integração
Reparar registros RGB importados
Restrinja canais de planilhas, CSV ou API antes de salvá-los como dados RGB padrão.
Criar fixtures de teste determinísticas
Verifique as fronteiras e acompanhe exatamente quais canais RGB o pipeline precisou corrigir.
Perguntas técnicas
Quanto custa uma solicitação da API?
Uma solicitação bem-sucedida da API custa US$ 0,002. Você também pode executar a mesma operação determinística no navegador.
Quais entradas são recusadas?
Canais ausentes, vazios, não numéricos ou não finitos geram invalid_input. Os três canais RGB são obrigatórios.