Como analisar os dados de cor da imagem

Referência abrangente de API para recursos de detecção e análise de cores de imagens de nível empresarial.

Propriedades de DadosDeCorDaImagem

Propriedade	Retornar Tipo	Description
Base64 da Imagem	String	Representação de strings codificadas em Base64 dos dados da imagem de origem, permitindo armazenamento e transmissão eficientes do conteúdo de imagens entre diferentes sistemas e plataformas.
Pixels	DadosDaImagemDePixela	Matriz completa de informações de cores de pixels para toda a imagem, fornecendo acesso abrangente a dados de pixels individuais para análise detalhada de cores.
Width	int	Dimensão horizontal da imagem medida em pixels, definindo a largura da imagem para cálculos de coordenadas e validação de limites.
Height	int	Dimensão vertical da imagem medida em pixels, definindo a altura da imagem para cálculos de coordenadas e validação de limites.
PontoDeDeslocamento	Ponto?	Ponto coordenado opcional para análise de pixels direcionada, permitindo a extração de cores focadas de regiões de interesse específicas dentro da imagem.
Cor Central	DadosDeImagemDePixel?	Dados de cores de pixels localizados no centro geográfico da imagem, úteis para analisar o ponto focal primário ou tema central.
CorDoPontoDeDeslocamento	DadosDeImagemDePixel?	Dados de cores de pixels nas coordenadas de deslocamento definidas pelo usuário, fornecendo amostras de cores precisas em locais personalizados quando o PontoDeDeslocamento é especificado.
CorDodonante	Cor	Cor que ocorre mais frequentemente em todos os pixels da imagem, calculada por meio de análise estatística de frequência e comparação de distância euclideana para identificar o tema de cor primária.
CorDaUICoreDomainant	Cor NUI Core	A classificação de cores principais da Interface Gráfica mais predominante na imagem, determinada usando cálculos de distância euclideana entre cada pixel e as cores principais da Interface Gráfica de destino e, depois, selecionando a cor com correspondência mais frequente.
CorConhecidaDoDominante	KnownColor	A cor padronizada mais comum do sistema encontrada na imagem, mapeada para constantes de cores predefinidas usando cálculos de distância euclides para uma identificação consistente entre plataformas.

Métodos e extensões de ImageColorData

Método	Retornar Tipo	Description
GetPixelImageData(x, y)	DadosDeImagemDePixel?	Recupera informações de cor dos pixels em coordenadas especificadas. Retorna nulo para coordenadas inválidas ou dados de imagem vazios. Executa a validação de limites automaticamente.
GetDominantColor()	Cor	Analisa todos os pixels da imagem e retorna a cor que ocorre mais frequentemente. Usa análise estatística de frequência combinada com cálculos de distância euclideana para determinar o domínio das cores. Retorna Color.Empty para imagens vazias.
GetDominantUICoreColor()	Cor NUI Core	Identifica a cor principal da interface gráfica mais predominante na imagem por meio da classificação de pixels, usando cálculos de distância euclides entre cada pixel e as cores principais da interface gráfica de destino e, em seguida, a contagem de frequência das correspondências. Retorna NUICoreColor.None para imagens vazias.
GetUICoreColors()	IEnumerable<UICoreColorFrequency>	Gera uma lista abrangente ordenada por frequência de todas as cores principais da interface gráfica detectadas na imagem usando a correspondência de distância euclidiana, permitindo uma análise detalhada da distribuição de cores.
GetUICoreColors(ColorFilter)	IEnumerable<UICoreColorFrequency>	Retorna as cores principais da interface gráfica filtradas com base nos critérios especificados e classificadas por frequência. Aplica lógica de filtragem personalizada e mantém a precisão estatística euclidiana baseada em distância.
GetDominantKnownColor()	KnownColor	Determina a cor padronizada mais comum conhecida na imagem por meio da correspondência sistemática de cores usando cálculos de distância euclides. RetornaknownColor.Transparent para imagens vazias.

Propriedades de dados de imagem do pixel

Propriedade	Retornar Tipo	Description
X	int	Posição de coordenada horizontal do pixel dentro do sistema de coordenadas de imagem, indexado a zero a partir da borda esquerda.
Y	int	Posição de coordenada vertical do pixel dentro do sistema de coordenadas de imagem, indexada em zero a partir da borda superior.
Valor	int	Valor de cor RGB de 24 bits empacotado e armazenado como um inteiro, com o vermelho ocupando os bits 16-23, o verde 8-15 e o azul 0-7.
R	byte	Intensidade do componente de cor vermelha que varia de 0 (sem vermelho) a 255 (saturação máxima de vermelho).
G	byte	Intensidade do componente de cor verde que varia de 0 (sem verde) a 255 (saturação máxima de verde).
B	byte	Intensidade do componente de cor azul que varia de 0 (sem azul) a 255 (saturação máxima de azul).
Cor Bruta	Cor	Representação exata de System.Drawing.Color com valores RGB precisos, mantendo a fidelidade total das cores sem aproximação.
Cor	Cor	System.Drawing.Color mais próximo nomeado que corresponde aos valores RGB do pixel usando cálculos de distância euclideana, fornecendo identificação de cor legível por humanos.
CorPrincipal	Cor NUI Core	A classificação de cores principais da interface gráfica com a melhor correspondência para o pixel, determinada por meio de cálculos de distância euclideana no espaço de cores RGB para uma análise ideal do esquema de cores da interface do usuário.
KnownColor	KnownColor	Equivalente mais próximo da enumeração System.Drawing.KnownColor usando a comparação de distância euclidiana, garantindo a padronização da nomenclatura das cores em todos os aplicativos.

Métodos da extensão PixelImageData

Método	Retornar Tipo	Description
GetColor()	Cor	Converte dados de pixels na representação exata de System.Drawing.Color sem aproximação, preservando a precisão das cores originais e os valores RGB.
GetClosestColor()	Cor	Identifica a cor nomeada mais próxima da coleção System.Drawing.Color usando o cálculo de distância euclideana no espaço de cor RGB.
GetUICoreColor()	Cor NUI Core	Mapeia a cor de pixel para a classificação de cor principal da interface gráfica mais adequada usando algoritmos de distância euclides otimizados no espaço de cor RGB para análise de interface.
ObterCorConhecida()	KnownColor	Corresponde a cor do pixel com o valor de enumeração System.Drawing.KnownColor mais próximo por meio de uma comparação abrangente de distância euclideana no espaço de cores RGB, excluindo cores dependentes do sistema.

Propriedades de UICoreColorFrequency

Propriedade	Retornar Tipo	Description
Cor	Cor NUI Core	A cor específica do núcleo da interface gráfica que foi detectada e analisada na imagem, representando uma das classificações de cores predefinidas da interface.
Contagem	int	A contagem de frequência indicando quantos pixels na imagem correspondeu a essa cor principal da interface gráfica específica por meio de cálculos de distância euclides, fornecendo dados estatísticas para análise de distribuição de cor.

Amostras de análise de cores de elementos de interface gráfica

Os seguintes exemplos demonstra a análise de cor dominante para elementos de interface gráfica comuns em diferentes estados:

Análise do estado do ícone

Tipo de Ícone	Amostra visual	Estado	Dimensões	Cor Dominante	Cor Predominante do Núcleo da UI	Caso de uso
Ícone de erro	Imagem dos documentos	Erro/Falha	32x32	#e74c3c	Vermelho	Erros de validação, operações com falha, alertas críticos
Ícone de aviso	Imagem dos documentos	Aviso/Alerta	32x32	#f1c40f	Amarelo	Avisos importantes, atenção necessária, cuidado
Ícone de Sucesso	Imagem dos documentos	Sucesso/Concluído	32x32	#27ae60	Verde	Tarefas concluídas, validação bem-sucedida, confirmação
Ícone de Verificado	Imagem dos documentos	Verificado/Confiável	32x32	#9b59b6	Magenta	Contas verificadas, origens confiáveis, status premium
Ícone de informações	Imagem dos documentos	Information	32x32	#3498db	Azul	Mensagens informativas, texto de ajuda, orientação

Insights de análise de cores

• Consistência de cores semânticas: os estados de erro são analisados consistentemente como a cor principal da interface gráfica Red, o Success como verde, os avisos como laranja/amarelo.
• Marca vs cores padrão: cores de marca personalizadas (como #27ae60) mapeadas para cores principais da interface gráfica (Verde) por meio de cálculos de distância euclideana.
• Hierarquia visual: diferentes elementos de interface gráfica usam intensidade e estilo de cor, mantendo consistente classificação de cores semânticas.
• Conformidade de acessibilidade: a análise de cores ajuda a verificar as taxas de contraste e o significado semântico suficientes em diferentes estados de interface gráfica.
• Teste de automação: a detecção de cor predominante permite a verificação automatizada de alterações no estado da interface gráfica e feedback visual.