Comptez les couleurs uniques d’une image et affichez le top 5

Il indique le nombre exact de triplets RGB distincts, le total de pixels représentés et les cinq couleurs les plus fréquentes. Les enregistrements répétés sont automatiquement fusionnés, tandis qu’un décompte facultatif permet à un échantillon de représenter plusieurs pixels identiques. Le calcul est déterministe et repose sur les valeurs exactes des canaux, sans regrouper les teintes voisines. Il convient donc aux images indexées, aux captures, aux exports graphiques et aux tests exigeant une égalité précise.

Préparez des échantillons de pixels pour un décompte exact

Fournissez les pixels sous forme d’enregistrements RGB dont les canaux rouge, vert et bleu vont de 0 à 255. Chaque enregistrement représente un pixel, sauf si vous ajoutez un décompte positif, pratique lorsqu’un décodeur ou un histogramme a déjà regroupé les valeurs répétées. Une couleur n’est considérée comme unique que si son triplet RGB complet diffère. Ainsi, RGB 20, 40, 60 et RGB 20, 40, 61 sont deux couleurs distinctes, même si elles semblent presque identiques. Le canal alpha est volontairement exclu du contrat : vos échantillons doivent donc déjà appliquer la politique de transparence ou de composition de votre processus. Vous pouvez transmettre plusieurs fois la même valeur RGB ; toutes les occurrences et tous les décomptes sont additionnés avant le classement. Les flux de pixels bruts et les histogrammes compacts conservent ainsi le même sens. Une liste vide ne décrit aucun échantillon et provoque une erreur plutôt qu’un zéro trompeur. Les canaux ou décomptes incorrects, les champs non pris en charge et les listes trop longues sont également refusés afin que les problèmes de format restent visibles.

Interprétez le nombre distinct et le classement des cinq premières couleurs

Le total distinct correspond à la taille de la table des fréquences RGB exactes après fusion des doublons. Le total de pixels est la somme du décompte de chaque enregistrement, avec une valeur de un lorsqu’il est omis. La liste principale comprend au maximum cinq éléments et peut en contenir moins si moins de cinq couleurs uniques sont présentes. Les éléments sont classés du décompte le plus élevé au plus faible. En cas d’égalité, la plus petite valeur rouge précède la plus petite valeur verte, puis bleue, afin de garantir un résultat stable entre les appels et les machines. Chaque élément contient une notation hexadécimale en majuscules, les canaux RGB d’origine, le décompte absolu et sa fréquence par rapport au total représenté. La fréquence est arrondie à six décimales pour produire un JSON compact et reproductible. Il ne s’agit pas d’un extracteur de palette perceptuelle : les teintes voisines restent séparées. Cette distinction est essentielle pour contrôler des ressources indexées, repérer des couleurs d’anticrénelage inattendues ou confirmer exactement le résultat d’une transformation. Préférez un outil de regroupement de palette lorsque la ressemblance visuelle prime sur l’identité exacte.

Exploitez le résultat pour les audits, l’optimisation et les tests

Le décompte des couleurs fournit un diagnostic compact des chaînes graphiques. Avant de publier une icône, comparez le total distinct à la taille de palette prévue ; une hausse inattendue peut révéler un anticrénelage, un mode d’export incorrect ou un arrière-plan aplati avec des valeurs légèrement différentes. Pour la compression, les cinq fréquences dominantes montrent si quelques couleurs occupent l’essentiel de l’image et peuvent guider un futur encodage indexé ou une réduction de palette. Dans des tests automatisés, conservez le total distinct et les couleurs principales comme assertions après rendu, redimensionnement ou conversion, tout en sachant qu’une interpolation peut légitimement créer de nouvelles valeurs RGB. Le champ de décompte convient aussi aux décodeurs serveur qui produisent déjà des histogrammes : ils peuvent envoyer un enregistrement par couleur observée. Cette capacité ne récupère ni ne décode de fichier ; votre application fournit les échantillons. Le traitement est local et déterministe, sans réseau, hasard ni état conservé. Vous pouvez effectuer un contrôle interactif dans le navigateur ou intégrer le même calcul par API pour $0.002.