validatecolor

Valida uma especificação de cor e a retorna como um trio RGB.

Categoria: Programming > Functions

Sintaxe

rgb = validatecolor(c)

Converte uma cor dada como nome, nome curto, código hexadecimal ou linha RGB em uma linha RGB 1 por 3, ou gera erro se for inválida.

rgb = validatecolor(c, 'multiple')

Aceita várias cores (uma matriz m por 3, um cell array ou um array de strings) e retorna uma matriz m por 3.

Descrição

A função aceita as mesmas formas de cor que as funções de gráfico e as normaliza para RGB numérico, o que é útil antes de armazenar ou interpolar cores. Um nome não reconhecido, um código hexadecimal malformado ou um valor RGB fora de 0 a 1 gera um erro que explica o que é aceito.

Argumentos de entrada

c
Um nome de cor como 'red', um nome curto como 'r', um código hexadecimal como '#FF8000' ou '#F80', ou um trio RGB com valores de 0 a 1.

Argumentos de saída

rgb
Valores RGB double entre 0 e 1, uma linha por cor.

Exemplo

Nomes, códigos hexadecimais e várias cores

validatecolor('r')
validatecolor('#FF8000')
validatecolor([1 0 0; 0 1 0], 'multiple')
Saída
ans = 1×3

     1     0     0
ans = 1×3

    1.0000    0.5020         0
ans = 2×3

     1     0     0
     0     1     0

Observações

O MatLivre retorna apenas a saída RGB.

Veja também

colormap rgb2hsv hex2dec plot