Conte as cores únicas de uma imagem e veja as cinco principais

O contador de cores únicas transforma amostras de pixels RGB em um inventário claro das cores realmente presentes. Ele informa o número exato de trincas RGB distintas, o total de pixels representados e as cinco cores mais frequentes. Registros repetidos são combinados automaticamente, enquanto uma contagem opcional permite que uma amostra represente muitos pixels idênticos. O cálculo é determinístico e usa valores exatos dos canais, sem agrupar tons próximos, sendo útil para artes exportadas, imagens indexadas, capturas de tela e testes nos quais a igualdade precisa é essencial.

Prepare amostras de pixels para uma contagem exata

Forneça os pixels como registros RGB com canais vermelho, verde e azul de 0 a 255. Cada registro representa um pixel, a menos que você inclua uma contagem positiva, útil quando um decodificador ou histograma já consolidou valores repetidos. A ferramenta considera uma cor única somente quando a trinca RGB completa é diferente.

Por exemplo, RGB 20, 40, 60 e RGB 20, 40, 61 são duas cores distintas, embora pareçam quase iguais. O canal alfa fica deliberadamente fora deste contrato; portanto, as amostras já devem refletir a política de transparência ou composição adotada no seu fluxo. Você pode enviar o mesmo valor RGB mais de uma vez: todas as ocorrências e contagens são somadas antes da classificação.

Assim, tanto sequências brutas de pixels quanto histogramas compactos mantêm o mesmo significado. Uma lista vazia não descreve uma amostra e retorna um erro, em vez de um zero enganoso. Canais e contagens inválidos, campos não aceitos e listas grandes demais também são rejeitados para tornar visíveis os problemas no formato dos dados.

Entenda as cores distintas e a classificação das cinco principais

O total de cores distintas corresponde ao tamanho do mapa de frequências RGB exatas depois da consolidação dos registros duplicados. O total de pixels soma a contagem de cada registro, usando um quando ela não é informada. A lista principal contém no máximo cinco itens e pode ter menos quando existem menos de cinco cores únicas.

Os itens são ordenados da maior para a menor contagem. Em caso de empate, aparecem primeiro os menores valores de vermelho, depois verde e azul, garantindo resultados estáveis entre chamadas e máquinas. Cada item traz notação hexadecimal em maiúsculas, canais RGB originais, contagem absoluta e frequência em relação ao total representado.

Esta não é uma ferramenta de paleta perceptual: tons vizinhos continuam separados e não são misturados em um centro de agrupamento. Essa diferença é importante ao verificar recursos indexados, detectar cores inesperadas de antisserrilhamento ou confirmar a saída exata de uma transformação. Use um extrator de paleta dominante quando a semelhança visual for mais importante que a identidade exata.

Use o resultado em auditorias, otimização e testes

A contagem de cores é um diagnóstico compacto para fluxos gráficos. Antes de publicar um ícone, compare o total distinto com o tamanho pretendido da paleta; um aumento inesperado pode revelar antisserrilhamento, modo de exportação incorreto ou fundo achatado com valores ligeiramente diferentes. Em trabalhos de compressão, as cinco maiores frequências mostram se poucas cores dominam a imagem e podem orientar uma futura codificação indexada ou redução de paleta.

Em testes automatizados, armazene o total distinto e as cores principais como asserções após renderização, redimensionamento ou conversão, lembrando que operações com interpolação podem criar legitimamente novos valores RGB. O campo de contagem também facilita o uso com decodificadores no servidor que já geram histogramas, pois eles podem enviar um registro por cor observada. Esta capacidade não busca nem decodifica arquivos de imagem: seu aplicativo fornece as amostras.

O processamento é local e determinístico, sem rede, aleatoriedade ou estado retido.