Calcule o histograma de cada canal de uma imagem

Informe um ou mais canais nomeados, escolha a quantidade de faixas e receba uma lista ordenada de contagens para cada canal. Ela é útil quando a imagem já foi decodificada e você precisa de estatísticas reproduzíveis sem enviar nem recodificar o arquivo original. Cada valor é validado no intervalo de 8 bits, cada pixel entra em exatamente uma faixa e uma lista vazia gera erro.

Prepare os valores dos canais

Forneça os pixels decodificados no array channels. Cada item precisa ter um nome de canal exclusivo e um array values com intensidades inteiras de 0 a 255. Nomes como red, green, blue, alpha e gray são convencionais, mas a calculadora não impõe um modelo de cor; qualquer componente no mesmo domínio de 8 bits pode ser usado. A ordem dos valores não muda o histograma, pois somente a frequência importa. Cada canal deve conter pelo menos um pixel. A solicitação é recusada quando a lista externa ou uma lista values está vazia, quando o nome não existe ou se repete, ou quando algum valor é fracionário ou sai da faixa permitida. Essas verificações evitam que dados incompletos pareçam uma distribuição válida. São aceitos até dezesseis canais e um milhão de valores por canal.

Entenda a distribuição nas faixas

Escolha uma quantidade inteira de 1 a 256 faixas ou omita o campo para usar 16. Todo o domínio de intensidade de 8 bits é dividido em intervalos de mesma largura, começando em 0 e terminando em 255. Com 16 faixas, a primeira conta de 0 a 15, a segunda de 16 a 31 e a última de 240 a 255. De modo geral, o índice é a parte inteira inferior do valor multiplicado pela quantidade de faixas e dividido por 256. O limite superior é mantido explicitamente na última faixa, portanto 255 nunca escapa do array. A regra continua determinística mesmo quando a quantidade escolhida não divide 256 por igual. Cada pixel aumenta um único contador, e a soma das contagens de um canal sempre corresponde ao seu pixel_count.

Leia, compare e valide a resposta

A resposta apresenta bins, os limites fixos value_min e value_max e um objeto de histograma para cada canal informado. Cada objeto preserva o nome do canal, informa pixel_count e retorna counts em ordem crescente de intensidade. A primeira posição corresponde sempre à faixa mais escura e a última, à mais clara, facilitando gráficos e comparações. Some o array counts e confirme que o total equivale a pixel_count; o algoritmo garante essa relação, e a conferência pode revelar truncamentos em outra etapa. Histogramas resumem frequências, não a disposição espacial, então imagens muito diferentes podem ter resultados iguais. O recurso também não decodifica arquivos, identifica espaços de cor, normaliza exposição nem combina canais. Decodifique a fonte primeiro e use esta capacidade para a contagem. No navegador, os dados ficam locais; a automação por API custa US$ 0,002 por solicitação.