So analysieren Sie Bildfarbdaten

Umfassende API-Referenz für Bildfarberkennung und Analysefunktionen der Enterprise-Klasse.

ImageColorData-Eigenschaften

Eigenschaften	Rückgabetyp	Beschreibung
Bild Base64	string	Base64-codierte String-Darstellung der Quellbilddaten, die eine effiziente Speicherung und Übertragung von Bildinhalten über verschiedene Systeme und Plattformen hinweg ermöglicht.
Pixel	Pixelbilddaten[]	Vollständiges Array von Pixelfarbinformationen für das gesamte Bild, das umfassenden Zugriff auf einzelne Pixeldaten für die detaillierte Farbanalyse bietet.
Width	int	Horizontale Abmessung des Bildes, gemessen in Pixeln, definiert die Breite des Bildes für Koordinatenberechnungen und Grenzenvalidierung.
Height	int	Vertikale Abmessung des Bildes, gemessen in Pixeln, definiert die Höhe des Bildes für Koordinatenberechnungen und Grenzenvalidierung.
OffsetPunkt	Punkt?	Optionaler Koordinatenpunkt für die gezielte Pixelanalyse, der eine gezielte Farbextraktion aus bestimmten Bereichen des Bildes ermöglicht.
CenterColor	Pixelbilddaten?	Pixelfarbdaten, die sich in der grafischen Mitte des Bilds befinden und für die Analyse des primären Fokus oder des zentralen Themas nützlich sind.
OffsetPointColor	Pixelbilddaten?	Pixelfarbdaten an den benutzerdefinierten Offset-Koordinaten, die eine präzise Farbabfrage an benutzerdefinierten Standorten ermöglichen, wenn OffsetPoint angegeben ist.
Dominante Farbe	Farbe	Am häufigsten vorkommende Farbe für alle Bildpixel, berechnet durch statistische Häufigkeitsanalyse und euklidischer Abstandsvergleich, um das primäre Farbthema zu identifizieren.
Dominante UIKernfarbe	NUICoreColor	Am häufigsten angepasste UI-Kernfarbklassifizierung innerhalb des Bilds, die mithilfe von euklidischen Abstandsberechnungen zwischen jedem Pixel und den UI-Kernfarben bestimmt wird, dann wird die am häufigsten übereinstimmende Farbe ausgewählt.
Dominante bekannte Farbe	KnownColor	Häufigste standardisierte Systemfarbe im Bild, zugeordnet zu vordefinierten Farbkonstanten mithilfe von euklidischen Abstandsberechnungen für eine konsistente plattformübergreifende Identifizierung.

ImageColorData-Methoden und -Erweiterungen

Method	Rückgabetyp	Beschreibung
Get Pixel Image Data (x, y)	Pixelbilddaten?	Ruft Pixelfarbinformationen an angegebenen Koordinaten ab. Gibt NULL für ungültige Koordinaten oder leere Bilddaten zurück. Führt die Grenzenvalidierung automatisch durch.
GetDominantColor()	Farbe	Analysiert alle Bildpixel und gibt die am häufigsten vorkommende Farbe zurück. Verwendet eine statistische Häufigkeitsanalyse in Kombination mit euklidischen Abstandsberechnungen, um die Farbdominanz zu bestimmen. Gibt Color.Empty für leere Bilder zurück.
GetDominantUICoreColor()	NUICoreColor	Erkennt die am häufigsten vorkommende UI-Kernfarbe im Bild durch Pixelklassifizierung mithilfe von euklidischen Abstandsberechnungen zwischen jedem Pixel und den UI-Kernfarben des Ziels, dann zählt die Häufigkeit der Übereinstimmungen. Gibt NUICoreColor.None für leere Bilder zurück.
GetUICoreColors()	IEnumerable<UICoreColorFrequency>	Erzeugt eine umfassende, nach Häufigkeit geordnete Liste aller im Bild erkannten UI-Kernfarben mithilfe des Euklidischen Abstands, die eine detaillierte Analyse der Farbverteilung ermöglicht.
GetUICoreColors(ColorFilter)	IEnumerable<UICoreColorFrequency>	Gibt gefilterte UI-Kernfarben basierend auf angegebenen Kriterien zurück, sortiert nach Häufigkeit. Wendet benutzerdefinierte Filterlogik an und behält gleichzeitig die euklistische distanzbasierte statistische Genauigkeit bei.
GetDominantKknownColor()	KnownColor	Bestimmt die häufigste standardisierte bekannte Farbe im Bild durch systematischen Farbabgleich mithilfe von euklidischen Abstandsberechnungen. Gibt BekannteFarbe.Transparent für leere Bilder zurück.

PixelImageData-Eigenschaften

Eigenschaften	Rückgabetyp	Beschreibung
X	int	Horizontale Koordinatenposition des Pixels im Bildkoordinatensystem, nullindexiert vom linken Rand.
Y	int	Vertikale Koordinatenposition des Pixels innerhalb des Bildkoordinatensystems, nullindexiert vom oberen Rand.
Wert	int	Verpackter 24-Bit-RGB-Farbwert, der als Integer gespeichert wird, wobei Rot die Bits 16-23, grüne Bits 8-15 und blaue Bits 0-7 belegt.
R	byte	Die Intensität der roten Farbkomponente reicht von 0 (kein Rot) bis 255 (maximale Rotsättigung).
G	byte	Die Intensität der grünen Farbkomponente reicht von 0 (kein Grün) bis 255 (maximale Grünsättigung).
B	byte	Die Intensität der blauen Farbkomponente reicht von 0 (kein Blau) bis 255 (maximale Blausättigung).
Rohfarbe	Farbe	Exakte System.Drawing.Color-Darstellung mit präzisen RGB-Werten unter Beibehaltung der vollen Farbgenauigkeit ohne Annäherung.
Farbe	Farbe	Am ähnlichsten benanntes System.Drawing.Color, das den RGB-Werten des Pixels mithilfe von euklidischen Abstandsberechnungen entspricht und eine visuell lesbare Farbidentifizierung ermöglicht.
Kernfarbe	NUICoreColor	UI-Kernfarbklassifizierung mit der besten Übereinstimmung für das Pixel, bestimmt durch euklidische Abstandsberechnungen im RGB-Farbraum für eine optimale Analyse des Farbschemas für Benutzeroberflächen.
KnownColor	KnownColor	Nächstes Äquivalent aus der System.Drawing.KnownColor-Aufzählung mithilfe des euklidischen Abstandsvergleichs, der eine standardisierte Farbbenennung für alle Anwendungen gewährleistet.

PixelImageData-Erweiterungsmethoden

Method	Rückgabetyp	Beschreibung
Get Color ()	Farbe	Konvertiert Pixeldaten in eine exakte System.Drawing.Color-Darstellung ohne Annäherung, wobei die ursprüngliche Farbgenauigkeit und RGB-Werte erhalten bleiben.
Get Closest Color()	Farbe	Erkennt die am nächsten liegende benannte Farbe aus der System.Drawing.Color-Sammlung mithilfe der Euklidischen Abstandsberechnung im RGB-Farbraum.
GetUICoreColor()	NUICoreColor	Ordnet die Pixelfarbe der am besten geeigneten UI-Kernfarbklassifizierung mithilfe optimierter euklidischer Abstandsalgorithmen im RGB-Farbraum für die Schnittstellenanalyse zu.
Get Bekannte Farbe ()	KnownColor	Entspricht der Pixelfarbe dem nächsten System.Drawing.KnownColor-Aufzählungswert durch einen umfassenden euklidischen Abstandsvergleich im RGB-Farbraum, ohne systemabhängige Farben.

UICoreColorFrequency-Eigenschaften

Eigenschaften	Rückgabetyp	Beschreibung
Farbe	NUICoreColor	Die spezifische UI-Kernfarbe, die im Bild erkannt und analysiert wurde, die eine der vordefinierten Farbklassifizierungen der Benutzeroberfläche darstellt.
Anzahl	int	Die Häufigkeitszahl, die angibt, wie viele Pixel im Bild mit dieser spezifischen UI-Kernfarbe übereinstimmten, wurde durch euklidische Abstandsberechnungen bestimmt und liefert statistische Daten für die Farbverteilungsanalyse.

Beispiele für die UI-Elementfarbanalyse

Die folgenden Beispiele veranschaulichen die Analyse der dominanten Farbe für gängige UI-Elemente in verschiedenen Zuständen:

Symbolstatusanalyse

Symboltyp	Visuelles Beispiel	Status (State)	Dimensionen	Dominante Farbe	Dominante UI-Kernfarbe	Anwendungsfall
Fehlersymbol		Fehler/Fehlgeschlagen	32x32	#e74c3c	Rot	Validierungsfehler, fehlgeschlagene Vorgänge, kritische Warnungen
Warnsymbol		Warnung/Warnung	32x32	#f1c40f	Gelb	Wichtige Hinweise, Aufmerksamkeit erforderlich, Vorsicht
Erfolgsymbol		Erfolgreich/Abgeschlossen	32x32	#27ae60	Grün	Abgeschlossene Aufgaben, erfolgreiche Validierung, Bestätigung
Verifiziert Symbol		Überprüft/Vertrauenswürdig	32x32	#9b59b6	Rot	Verifizierte Konten, vertrauenswürdige Quellen, Premium-Status
Info-Symbol		Informationen	32x32	#3498db	Blau	Informationsmeldungen, Hilfetext, Anleitung

Erkenntnisse der Farbanalyse

• Semantische Farbkonsistenz: Fehlerstatus werden konsistent als rote UI-Kernfarbe analysiert, Erfolg als Grün und Warnungen als Orange/Gelb.
• Marken- vs. Standardfarben: Benutzerdefinierte Markenfarben (z. B. #27ae60) werden durch euklidische Abstandsberechnungen den Standard-UI-Kernfarben (grün) zugeordnet.
• Visuelle Hierarchie: Verschiedene UI-Elemente verwenden Farbinität und Formalität bei gleichzeitiger Beibehaltung der konsistenten semantischen Farbklassifizierung.
• Compliance zur Barrierefreiheit: Die Farbanalyse hilft bei der Überprüfung ausreichender Kontrastverhältnisse und semantischer Bedeutung in verschiedenen UI-Status.
• Automatisierungstests: Die Erkennung der dominanten Farbe ermöglicht die automatisierte Überprüfung von UI-Statusänderungen und visuelles Feedback.