Comment analyser les données de couleur d'image

Référence d'API complète pour les capacités de détection et d'analyse des couleurs d'image de qualité professionnelle.

Propriétés ImageColorData

Propriété	Type de retour	Description
Image Base64	string	Représentation de chaîne encodée en Base64 des données de l'image source, permettant un stockage et une transmission efficaces du contenu de l'image à travers différents systèmes et plates-formes.
pixels	DonnéesImagePixels[]	Tableau complet d'informations de pixels de couleur pour l'image entière, fournissant un accès complet aux données de pixels individuels pour une analyse détaillée des couleurs.
Width	int	Dimension horizontale de l'image mesurée en pixels, définissant la largeur de l'image pour les calculs de coordonnées et la validation des limites.
Height	int	Dimension verticale de l'image mesurée en pixels, définissant la hauteur de l'image pour les calculs de coordonnées et la validation des limites.
PointDéplacement	Pointer ?	Point de coordonnée facultatif pour l'analyse de pixels ciblée, permettant l'extraction de couleurs ciblées à partir de régions d'intérêt spécifiques dans l'image.
CouleurCentre	DonnéesImagePixels ?	Données de couleur de pixels situées au centre géographique de l'image, utiles pour analyser le point focal principal ou le thème central.
CouleurPointDéplacement	DonnéesImagePixels ?	Données de couleur de pixels aux coordonnées de décalage définies par l'utilisateur, fournissant un échantillon de couleur précis aux emplacements personnalisés lorsque OffsetPoint est spécifié.
CouleurDomain	Couleur	La couleur la plus fréquente sur tous les pixels de l'image, calculée via l'analyse de la fréquence et la comparaison de la distance Eclidienne, permet d'identifier le thème de couleur principal.
CouleurCoreUIDomain	Couleur de base (NUICore)	Classification des couleurs de base de l'interface utilisateur la plus courante dans l'image, déterminée à l'aide des calculs de distance Ecludean entre chaque pixels et les couleurs cibles de base d'interface utilisateur, puis en sélectionnant la couleur la plus fréquemment correspondante.
CouleurConnueDomain	KnownColor	Couleur système standardisée la plus courante trouvée dans l'image, mappée à des constantes de couleur prédéfinies à l'aide des calculs de distance Ecludean pour une identification multiplate-forme cohérente.

Méthodes et extensions ImageColorData

Method	Type de retour	Description
ObtenirDonnéesImagePixel(x, y)	DonnéesImagePixels ?	Récupère les informations de couleur aux coordonnées spécifiées. Renvoie la valeur null pour les coordonnées non valides ou les données d'image vides. Effectue automatiquement la validation des limites.
GetDominantColor()	Couleur	Analyse tous les pixels de l'image et renvoie la couleur la plus fréquente. Utilise l'analyse de la fréquence statistique combinée à des calculs de distance Eocludean pour déterminer la dominance de la couleur. Renvoie Color.Empty pour les images vides.
GetDominantUICoreColor()	Couleur de base (NUICore)	Identifie la couleur de base de l'interface utilisateur la plus courante dans l'image grâce à la classification des pixels à l'aide des calculs de distance Ecludean entre chaque pixels et les couleurs de base de l'interface utilisateur cibles, puis au comptage de la fréquence des correspondances. Renvoie NUICoreColor.None pour les images vides.
GetUICoreColor()	IEnumerable<UICoreColorFrequency>	Génère une liste complète, classée par fréquence, de toutes les couleurs de base d'IU détectées dans l'image à l'aide de la correspondance de distance Ecludean, permettant une analyse détaillée de la distribution des couleurs.
GetUICoreColors(ColorFilter)	IEnumerable<UICoreColorFrequency>	Renvoie les couleurs de base d’IU filtrées en fonction des critères spécifiés, triée par fréquence. Applique une logique de filtrage personnalisée tout en conservant la précision statistique basée sur la distance.
GetDominantKnownColor()	KnownColor	Détermine la couleur standardisée connue de l'image grâce à une correspondance des couleurs systématique basée sur les calculs de distance Ecludean. Renvoie Connaissances (KnownColor.Transparent) pour les images vides.

Propriétés DonnéesImagePixels

Propriété	Type de retour	Description
X	int	Position de la coordonnée horizontale du pixels dans le système de coordonnées de l'image, indexée à zéro à partir du bord gauche.
Y	int	Position de la coordonnée verticale du pixels dans le système de coordonnées de l'image, indexé zéro à partir du bord supérieur.
Valeur (Value)	int	Valeur de couleur RVB 24 bits packagée stockée en tant qu'entier, avec le rouge occupant les bits 16-23, les bits vert 8-15 et les bits bleu 0-7.
R	byte	Composant d'intensité de couleur rouge allant de 0 (pas de rouge) à 255 (situation maximale du rouge).
G	byte	Composant d'intensité de couleur verte allant de 0 (pas de vert) à 255 (s saturation maximale du vert).
B	byte	Composant d'intensité de couleur bleue allant de 0 (pas de bleu) à 255 (situation maximale du bleu).
CouleurBrute	Couleur	Représentation exacte de System.Drawing.Color avec des valeurs RVB précises, maintenant la fidélité des couleurs complète sans approximation.
Couleur	Couleur	Nom le plus proche System.Drawing.Color qui correspond aux valeurs RVB du pixels à l'aide des calculs de distance Ecludean, fournissant ainsi une identification de couleur lisible par un humain.
CouleurCore	Couleur de base (NUICore)	La meilleure classification de couleur de base d'interface utilisateur pour le pixels, déterminée par le biais de calculs de distance Ecludean dans l'espace de couleurs RVB pour une analyse optimale du schéma de couleurs de l'interface utilisateur.
KnownColor	KnownColor	Équilibre le plus proche de l'énumération System.Drawing.KnownColor utilisant la comparaison de la distance Ecludean, garantissant une affectation de nom de couleur standardisée pour toutes les applications.

Méthodes d'extension pixelsImageData

Method	Type de retour	Description
GetColor()	Couleur	Convertit les données pixels en représentation exacte de System.Drawing.Color sans approximation, en préservant la précision des couleurs et les valeurs RVB d’origine.
GetClosestColor()	Couleur	Identifie la couleur nommée la plus proche de la collection System.Drawing.Color en utilisant le calcul de la distance Ecludean dans l'espace colorimétrique RVB.
GetUICoreColor()	Couleur de base (NUICore)	Mappe la couleur du pixels à la classification de couleur de base d’IU la plus appropriée en utilisant des algorithmes de distance Ecludean optimisés dans l’espace de couleur RVB pour l’analyse de l’interface.
GetKnownColor()	KnownColor	Correspond à la couleur du pixels de la valeur d’énumération System.Drawing.KnownColor la plus proche grâce à une comparaison complète de la distance Ecludean dans l’espace colorimétrique RVB, en excluant les couleurs dépendantes du système.

Propriétés UICoreColorFrequency

Propriété	Type de retour	Description
Couleur	Couleur de base (NUICore)	La couleur spécifique du noyau de l’interface utilisateur qui a été détectée et analysée dans l’image, représentant l’une des classifications prédéfinies des couleurs de l’interface.
Nombre	int	Le nombre de fréquences indiquant le nombre de pixels dans l'image correspondant à cette couleur spécifique du noyau de l'interface utilisateur via les calculs de distance Ecludean, fournissant des données statistiques pour l'analyse de la distribution des couleurs.

Échantillon d'analyse d'élément de couleur d'interface utilisateur

Les exemples suivants montrent l'analyse des couleurs dominantes pour les éléments d'IU courants dans différents états :

Analyse de l'état de l'icône

Type d’icône	Exemple visuel	État (State)	Dimensions	Couleur dominante	Couleur de base de l’interface utilisateur Automation	Cas d'utilisation
Icône d’erreur		Erreur/Échec	32x32	#e74c3c	Rouge	Erreurs de validation, opérations ayant échoué, alertes critiques
Icône d’avertissement		Avertissement/alerte	32x32	#f1c40f	Jaune	Avis importants, attention requise, prudence
Icône Réussite		Réussite/Terminé	32x32	#27ae60	Vert	Tâches terminées, validation réussie, confirmation
Icône vérifiée		Vérifié/approuvé	32x32	#9b59b6	Magenta	Comptes vérifiés, sources approuvées, statut premium
Icône d’information		Information	32x32	#3498db	Bleu	Messages d’information, texte d’aide, conseils

Insights sur l'analyse des couleurs

• Cohérence de couleur sémantique : les états d'erreur sont systématiquement analysés comme couleur de base de l'interface utilisateur, Réussite comme vert, Avertissements comme orange/jaune.
• Couleurs de marque vs couleurs standard : les couleurs de marque personnalisées (comme #27ae60) sont mappées aux couleurs standard de l'interface utilisateur (vert) via les calculs de distance Ecludean.
• Hiérarchie visuelle : différents éléments d'IU utilisent une intensité de couleur et un style tout en conservant une classification de couleur sémantique cohérente.
• Conformité à l'accessibilité : l'analyse des couleurs permet de vérifier des taux de contraste suffisants et une signification sémantique entre les différents états de l'interface utilisateur.
• Test d'automatisation : la détection de la couleur dominante permet une vérification automatisée des modifications de l'état de l'interface utilisateur et des commentaires visuels.