Cómo analizar los datos de color de la imagen

Referencia completa de API para capacidades de detección y análisis de color de imagen de nivel empresarial.

Propiedades de DatosDeColorDeImagen

Propiedad	Tipo de devolución	Descripción
Base64 de imagen	String	Representación de cadena codificada en Base64 de los datos de la imagen de origen, lo que permite el almacenamiento y la transmisión eficientes del contenido de la imagen en diferentes sistemas y plataformas.
Píxeles	DatosDeImagenDePíxel[]	Conjunto completo de información de color de píxeles para toda la imagen, que proporciona un acceso completo a los datos de píxeles individuales para un análisis de color detallado.
Width	int	Dimensión horizontal de la imagen medida en píxeles, que define el ancho de la imagen para los cálculos de coordenadas y la validación de límites.
Height	int	Dimensión vertical de la imagen medida en píxeles, que define la altura de la imagen para los cálculos de coordenadas y la validación de límites.
PuntoDeDesplazamiento	¿Punto?	Punto de coordenadas opcional para el análisis de píxeles específicos, lo que permite la extracción de color enfocada de regiones específicas de interés dentro de la imagen.
ColorDeCentro	¿DatosDeImagenDelPíxel?	Datos de color de píxeles ubicados en el centro geométrico de la imagen, útiles para analizar el punto focal principal o el tema central.
ColorDePuntoDeDesplazamiento	¿DatosDeImagenDelPíxel?	Datos de color de píxeles en las coordenadas de desplazamiento definidas por el usuario, lo que proporciona un muestreo de color preciso en ubicaciones personalizadas cuando se especifica OffsetPoint.
ColorDominante	Color	Color más frecuente en todos los píxeles de la imagen, calculado mediante análisis de frecuencia estadística y comparación de distancia euclidiana para identificar el tema de color primario.
ColorDeNúcleoUIDominante	ColorDeNUICore	Clasificación del color principal de la IU más frecuente dentro de la imagen, determinada mediante cálculos de distancia euclidiana entre cada píxel y los colores principales de la IU de destino, y luego seleccionando el color que coincide con más frecuencia.
ColorConocidoDominante	KnownColor	El color de sistema estandarizado más común que se encuentra en la imagen, asignado a constantes de color predefinidas utilizando cálculos de distancia euclidiana para una identificación multiplataforma coherente.

Métodos y extensiones de ImageColorData

Método	Tipo de devolución	Descripción
ObtenerDatosDeImagenDePíxel(x, y)	¿DatosDeImagenDelPíxel?	Recupera información de color de píxeles en las coordenadas especificadas. Devuelve nulo para coordenadas no válidas o datos de imagen vacíos. Realiza la validación de límites automáticamente.
ObtenerColorDominante()	Color	Analiza todos los píxeles de la imagen y devuelve el color más frecuente. Utiliza el análisis de frecuencia estadística combinado con los cálculos de distancia euclidiana para determinar la dominancia del color. Devuelve Color.Vacío para imágenes vacías.
ObtenerColorDeNúcleoUIDominante()	ColorDeNUICore	Identifica el color principal de la IU más frecuente dentro de la imagen a través de la clasificación de píxeles utilizando cálculos de distancia euclidiana entre cada píxel y los colores principales de la IU de destino, y luego el recuento de frecuencia de las coincidencias. Devuelve NUICoreColor.None para imágenes vacías.
ObtenerColoresDeNúcleoUI()	IEnumerable<UICoreColorFrequency>	Genera una lista completa ordenada por frecuencia de todos los colores básicos de la IU detectados en la imagen utilizando la coincidencia de distancia euclidiana, lo que permite un análisis detallado de la distribución del color.
ObtenerColoresDeNúcleoUI(filtroDeColor)	IEnumerable<UICoreColorFrequency>	Devuelve los colores básicos de la IU filtrados en función de los criterios especificados, ordenados por frecuencia. Aplica una lógica de filtrado personalizada manteniendo la precisión estadística basada en la distancia euclidiana.
ObtenerColorDominanteConocido()	KnownColor	Determina el color conocido estandarizado más común en la imagen mediante la coincidencia de colores sistemática utilizando cálculos de distancia euclidiana. Devuelve ColorConocido.Transparente para imágenes vacías.

Propiedades de DatosDeImagenDePíxeles

Propiedad	Tipo de devolución	Descripción
X	int	Posición de las coordenadas horizontales del píxel dentro del sistema de coordenadas de la imagen, indexado a cero desde el borde izquierdo.
Y	int	Posición de coordenadas verticales del píxel dentro del sistema de coordenadas de la imagen, indexado a cero desde el borde superior.
Valor	int	Valor de color RGB empaquetado de 24 bits almacenado como un número entero, con el rojo ocupando los bits 16-23, los bits verdes 8-15 y los bits azules 0-7.
R	byte	Intensidad del componente de color rojo que va de 0 (sin rojo) a 255 (saturación de rojo máxima).
G	byte	Intensidad del componente de color verde que va de 0 (sin verde) a 255 (saturación de verde máxima).
B	byte	Intensidad del componente de color azul que va de 0 (sin azul) a 255 (saturación máxima de azul).
Color sin procesar	Color	Representación exacta de System.Drawing.Color con valores RGB precisos, manteniendo la fidelidad de color completa sin aproximación.
Color	Color	System.Drawing.Color con el nombre más cercano que coincide con los valores RGB del píxel utilizando cálculos de distancia euclidiana, proporcionando una identificación de color legible por humanos.
Color del núcleo	ColorDeNUICore	La mejor clasificación de colores del núcleo de la interfaz de usuario para el píxel, determinada a través de los cálculos de la distancia euclidiana en el espacio de color RGB para un análisis óptimo del esquema de color de la interfaz de usuario.
KnownColor	KnownColor	El equivalente más cercano de la enumeración System.Drawing.KnownColor utilizando la comparación de distancia euclidiana, lo que garantiza la nomenclatura de colores estandarizada en todas las aplicaciones.

Métodos de extensión de PixelImageData

Método	Tipo de devolución	Descripción
ObtenerColor()	Color	Convierte los datos de píxeles en una representación System.Drawing.Color exacta sin aproximación, conservando la precisión del color original y los valores RGB.
ObtenerColorMásCercano()	Color	Identifica el color con nombre más cercano de la colección System.Drawing.Color utilizando el cálculo de la distancia euclidiana en el espacio de color RGB.
ObtenerColorDeNúcleoUI()	ColorDeNUICore	Asigna el color de los píxeles a la clasificación de colores del núcleo de la interfaz de usuario más adecuada utilizando algoritmos de distancia euclidiana optimizados en el espacio de color RGB para el análisis de la interfaz.
ObtenerColorConocido()	KnownColor	Hace coincidir el color del píxel con el valor de enumeración System.Drawing.KnownColor más cercano a través de una comparación de distancia euclidiana completa en el espacio de color RGB, excluyendo los colores dependientes del sistema.

Propiedades de UICoreColorFrequency

Propiedad	Tipo de devolución	Descripción
Color	ColorDeNUICore	El color del núcleo de la interfaz de usuario específico que se detectó y analizó dentro de la imagen, que representa una de las clasificaciones de color de la interfaz predefinidas.
Recuento	int	El recuento de frecuencia que indica cuántos píxeles de la imagen coinciden con este color central de la IU específico a través de los cálculos de distancia euclidiana, proporcionando datos estadísticos para el análisis de distribución de color.

Muestras de análisis de color de elementos de IU

Los siguientes ejemplos demuestran el análisis de color dominante para elementos comunes de la IU en diferentes estados:

Análisis de estado de icono

Tipo de icono	Muestra visual	Estado	Dimensiones	Color dominante	Color principal de la IU dominante	Caso de uso
Icono de error		Error/fallido	32x32	#e74c3c	Rojo	Errores de validación, operaciones fallidas, alertas críticas
Icono de advertencia		Advertencia/Alerta	32x32	#f1c40f	Amarillo	Avisos importantes, atención requerida, precaución
Icono de éxito		Correcto/Completado	32x32	#27ae60	Verde	Tareas completadas, validación correcta, confirmación
Icono verificado		Verificado/De confianza	32x32	#9b59b6	Magenta	Cuentas verificadas, fuentes de confianza, estado premium
Icono de información		Information	32x32	#3498db	Azul	Mensajes informativos, texto de ayuda, orientación

Información de análisis de color

• Coherencia semántica del color: los estados de error se analizan de forma coherente como color rojo del núcleo de la IU, Correcto como verde, Advertencias como naranja/amarillo.
• Colores de marca frente a colores estándar: los colores de marca personalizados (como #27ae60) se asignan a los colores básicos de la interfaz de usuario estándar (verde) a través de los cálculos de distancia euclidiana.
• Jerarquía visual: los diferentes elementos de la interfaz de usuario utilizan la intensidad del color y el estilo al tiempo que mantienen una clasificación de color semántica coherente.
• Cumplimiento de la accesibilidad: el análisis de color ayuda a verificar relaciones de contraste suficientes y significado semántico en diferentes estados de la interfaz de usuario.
• Pruebas de automatización: la detección de color dominante permite la verificación automatizada de los cambios de estado de la IU y la retroalimentación visual.