Calculez l’histogramme de chaque canal d’une image

Indiquez un ou plusieurs canaux nommés, choisissez le nombre de classes et obtenez une liste ordonnée de comptes pour chaque canal. Cet outil convient lorsque l’image est déjà décodée et que vous souhaitez des statistiques reproductibles sans téléverser ni réencoder le fichier d’origine. Chaque valeur est contrôlée dans la plage 8 bits, chaque pixel rejoint une seule classe et toute liste vide provoque une erreur.

Préparez les valeurs de chaque canal

Transmettez les pixels décodés dans le tableau channels. Chaque élément doit comporter un nom de canal unique et un tableau values d’intensités entières comprises entre 0 et 255. Les noms red, green, blue, alpha et gray sont courants, mais le calculateur n’impose aucun modèle colorimétrique : tout composant utilisant le même domaine 8 bits convient. L’ordre des valeurs n’influence pas l’histogramme, puisque seule leur fréquence compte. Chaque canal doit contenir au moins un pixel. La requête est refusée si la liste externe ou une liste values est vide, si un nom manque ou apparaît deux fois, ou si une valeur est décimale ou hors limites. Ces contrôles évitent qu’une source incomplète ressemble à une distribution valable. Vous pouvez fournir jusqu’à seize canaux et un million de valeurs par canal.

Comprenez le classement des intensités

Choisissez un nombre entier de classes compris entre 1 et 256, ou omettez ce réglage pour en utiliser 16. Le domaine complet des intensités 8 bits est partagé en intervalles de même largeur, de 0 à 255. Avec 16 classes, la première compte les valeurs de 0 à 15, la deuxième celles de 16 à 31 et la dernière celles de 240 à 255. En règle générale, l’indice correspond à la partie entière inférieure de la valeur multipliée par le nombre de classes puis divisée par 256. La borne supérieure est explicitement conservée dans la dernière classe, si bien que 255 n’est jamais perdu. La définition reste déterministe même si le nombre choisi ne divise pas 256 exactement. Chaque pixel incrémente un seul compteur et leur somme correspond donc à pixel_count.

Lisez, comparez et vérifiez le résultat

La réponse fournit bins, les limites fixes value_min et value_max, ainsi qu’un objet d’histogramme par canal reçu. Chaque objet conserve le nom du canal, indique pixel_count et renvoie counts par intensité croissante. La première position représente toujours l’intervalle le plus sombre et la dernière le plus clair, ce qui simplifie les graphiques et les comparaisons. Additionnez counts et vérifiez que le total égale pixel_count afin de repérer une éventuelle troncature dans votre chaîne de traitement. Un histogramme résume des fréquences, pas l’organisation spatiale : deux images visuellement différentes peuvent donc produire le même résultat. L’outil ne décode pas les fichiers, ne détermine pas l’espace colorimétrique, ne normalise pas l’exposition et ne fusionne pas les canaux. Décodez d’abord la source, puis utilisez cette capacité pour le comptage. Dans le navigateur, les données restent locales ; l’automatisation par API coûte $0.002 par requête.