Exemplos de Uso • Especificação do Modelo de Cor • Lista de Nomes de Cores

Diversas opções e métodos do ImageMagick recebem uma cor como argumento. A cor pode então ser informada como um nome de cor (há um conjunto limitado, porém grande, deles; veja abaixo) ou como um conjunto de números (em decimal ou hexadecimal), cada um correspondendo a um canal de um modelo de cor RGB ou RGBA. Os modelos de cor HSL, HSLA, HSB, HSBA, CMYK ou CMYKA também podem ser especificados. Esses tópicos são descritos brevemente nas seções abaixo.

Use o Color Converter para fornecer qualquer especificação de cor válida do ImageMagick, conforme descrito abaixo, para ver uma amostra dessa cor e convertê-la para todos os outros modelos de cor.

Exemplos de Uso

Cada um dos comandos a seguir produz a mesma borda lima ao redor da imagem. (Use "aspas duplas" no Windows.)

magick -bordercolor lime -border 10 image.jpg image.png
magick -bordercolor '#0f0' -border 10 image.jpg image.png
magick -bordercolor '#00ff00' -border 10 image.jpg image.png
magick -bordercolor 'rgb(0,255,0)' -border 10 image.jpg image.png
magick -bordercolor 'rgb(0,100%,0)' -border 10 image.jpg image.png

A lista de nomes de cores reconhecidos (por exemplo, aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, yellow e outros) é mostrada em uma tabela mais abaixo.

Especificação do Modelo de Cor

Os modelos de cor sRGB, CMYK, HSL e HSB são usados em especificações numéricas de cor. Estes exemplos especificam todos a mesma cor sRGB vermelha:

#f00                       4-bit  #rgb
#ff0000                    8-bit  #rrggbb
#ff0000ff                  8-bit  #rrggbbaa
#fff000000                12-bit  #rrrgggbbb
#ffff00000000             16-bit  #rrrrggggbbbb
#ffff00000000ffff         16-bit  #rrrrggggbbbbaaaa
#ffffffff0000000000000000ffffffff
                          32-bit  #rrrrrrrrggggggggbbbbbbbbaaaaaaaa
rgb(255, 0, 0)            um inteiro no intervalo 0—255 para cada componente
rgb(100.0%, 0.0%, 0.0%)   um número de ponto flutuante no intervalo 0—100% para cada componente

O formato de um valor sRGB em notação hexadecimal é um '#' imediatamente seguido por 3 a 32 caracteres hexadecimais. A notação sRGB de três dígitos (#rgb) é convertida na forma de seis dígitos (#rrggbb) replicando os dígitos, não adicionando zeros. Por exemplo, #fb0 se expande para #ffbb00. Isso garante que o branco (#ffffff) possa ser especificado com a notação curta (#fff) e remove qualquer dependência da profundidade de cor da imagem. Use a notação hexadecimal sempre que o desempenho for uma preocupação. O ImageMagick não precisa carregar a extensa tabela de cores para interpretar uma cor hexadecimal, por exemplo #000000, mas precisa se black for usado em vez disso.

O formato de um valor sRGB na notação funcional é 'rgb(r,g,b)', onde r, g e b são três valores inteiros ou de ponto flutuante no intervalo 0—255 ou três valores percentuais inteiros ou de ponto flutuante no intervalo 0—100%. O valor 255 corresponde a 100% e a #F ou #FF na notação hexadecimal: rgb(255, 255, 255) = rgb(100%, 100%, 100%) = #FFF = #FFFFFF. Observe que, a partir do ImageMagick 7.0.10-53, as vírgulas não são mais necessárias e a barra pode anteceder o valor alfa, por exemplo rgb(255 128 0 / 50%).

Caracteres de espaço em branco são permitidos ao redor dos valores numéricos, pelo menos se todo o argumento de cor estiver entre aspas ('aspas simples' para sistemas semelhantes ao Linux, "aspas duplas" para o Windows).

O modelo de cor sRGB é estendido nesta especificação para incluir alfa, permitindo a especificação da transparência de uma cor. Estes exemplos especificam todos a mesma cor:

rgb(255, 0, 0)                 intervalo 0 - 255
rgba(255, 0, 0, 1.0)           o mesmo, com um valor alfa explícito
rgb(100%, 0%, 0%)              intervalo 0.0% - 100.0%
rgba(100%, 0%, 0%, 1.0)        o mesmo, com um valor alfa explícito

O formato de um valor RGBA na notação funcional é 'rgba(r,g,b,a)', onde r, g e b são como descrito acima para a notação funcional RGB, e onde o valor alfa a varia de 0.0 (totalmente transparente) a 1.0 (totalmente opaco).

Há também uma cor chamada 'none' que é totalmente transparente. Essa cor é uma abreviação de rgba(0, 0, 0, 0.0).

Valores de cinza não lineares são convenientemente definidos com um nome, um único valor de intensidade ou um valor de intensidade e um valor alfa:

gray50            cinza próximo ao médio
gray(127)         cinza próximo ao médio
gray(50%)         cinza médio
graya(50%, 0.5)   cinza médio semitransparente

Para valores de cinza lineares, adicione -colorspace RGB -colorspace Gray ou -colorspace LinearGray ao criar cores cinza. Este último é novo a partir do Imagemagick 6.9.9-29 e 7.0.7-17.

O modelo de cor do ImageMagick também suporta cores matiz-saturação-luminosidade (HSL) e matiz-saturação-brilho (HSB) como complemento às cores sRGB numéricas. As cores HSL são codificadas como uma tripla (matiz, saturação, luminosidade). Da mesma forma, as cores HSB são codificadas como uma tripla (matiz, saturação, brilho). As triplas HSL ou HSB são valores diretos (matiz 0—360, saturação 0—255, luminosidade ou brilho 0—255) ou com S, L, B como valores percentuais relativos a esses intervalos.

O sistema de cor HSB é representado geometricamente como um cone com seu ápice apontando para baixo. A matiz é medida ao longo do perímetro. A saturação é medida do eixo para fora. O brilho é medido do ápice para cima.

O sistema de cor HSL é representado geometricamente como um cone duplo empilhado, com um ápice apontando para baixo e o outro para cima. As extremidades mais largas de ambos os cones são empilhadas uma sobre a outra. A matiz é medida ao longo do perímetro. A saturação é medida do eixo para fora. A luminosidade é medida do ápice inferior para cima.

Veja http://en.wikipedia.org/wiki/HSL_and_HSV para mais detalhes sobre os sistemas de cor HSL e HSB.

A matiz é representada como um ângulo da cor ao redor do perímetro circular do(s) cone(s) (ou seja, o arco-íris representado em um círculo). Os valores de matiz são inteiros ou números de ponto flutuante no intervalo 0—360. Por definição, red=0=360, e as outras cores se distribuem ao redor do círculo, de modo que green=120, blue=240, etc. Como um ângulo, ele implicitamente dá a volta, de modo que -120=240 e 480=120, por exemplo. (Estudantes de trigonometria diriam que "ângulos cotermianos são equivalentes" aqui; um ângulo θ pode ser padronizado calculando o ângulo equivalente, θ mod 360.)

A saturação é medida para fora a partir do eixo central do(s) cone(s) em direção ao perímetro do(s) cone(s). A saturação pode ser expressa como um inteiro ou número de ponto flutuante no intervalo 0—255 ou como um percentual inteiro ou de ponto flutuante no intervalo 0—100. A saturação pode ser entendida como a ausência de qualquer "branco" misturado à cor base. Assim, 255 ou 100% é a saturação total e corresponde a um ponto na superfície externa do cone (HSB) ou cone duplo (HSL). Será a região mais "colorida". 0 ou 0% é a ausência de saturação, o que resulta em algum tom de cinza. Ocorre ao longo do eixo central do cone ou cone duplo, com preto no ápice inferior e branco no superior.

O brilho (Brightness) e a luminosidade (Lightness) também podem ser representados como inteiros ou números de ponto flutuante no intervalo 0—255 ou como percentuais inteiros ou de ponto flutuante no intervalo 0—100%. O brilho e a luminosidade são medidos do ápice inferior para cima até o topo do cone ou cone duplo, ao longo do eixo central do(s) cone(s). 0 ou 0% corresponde ao ápice inferior e 255 ou 100% corresponde ao centro superior do cone para o brilho e ao ápice superior do cone duplo para a luminosidade.

O sistema de cor HSB é um pouco mais fácil de entender do que o sistema de cor HSL. No sistema de cor HSB, o preto está no ápice inferior e o branco no centro superior do cone, sobre o eixo central. As cores mais coloridas ou saturadas estarão, então, na borda externa do topo do cone, em sua parte mais larga. Assim, com Saturação=100% e Brilho=100%

hsb(0,   100%,  100%)    or    hsb(0,   255,   255)       vermelho pleno
hsb(120, 100%,  100%)    or    hsb(120, 255,   255)       verde pleno
hsb(120, 100%,  75%)     or    hsb(120, 255,   191.25)    verde médio
hsb(120, 100%,  50%)     or    hsb(120, 255,   127.5)     verde escuro
hsb(120, 100%,  25%)     or    hsb(120, 255,   63.75)     verde muito escuro
hsb(120, 50%,   50%)     or    hsb(120, 127.5, 127.5)     verde pastel

No sistema de cor HSL, o preto está no ápice inferior e o branco no ápice superior. Contudo, a saturação é máxima no meio do cone duplo, em seu perímetro externo, e portanto em um valor de luminosidade de 50%. As cores mais coloridas ou saturadas estarão, então, na borda externa do cone duplo, em sua parte mais larga. Assim, com Saturação=100% e Brilho=50%

hsl(0,   100%,  50%)     or    hsl(0,   255,   127.5)     vermelho pleno
hsl(120, 100%,  100%)    or    hsl(120, 255,   255)       branco
hsl(120, 100%,  75%)     or    hsl(120, 255,   191.25)    verde pastel
hsl(120, 100%,  50%)     or    hsl(120, 255,   127.5)     verde pleno
hsl(120, 100%,  25%)     or    hsl(120, 255,   63.75)     verde escuro
hsl(120, 50%,   50%)     or    hsl(120, 127.5, 127.5)     verde médio

Uma vantagem do HSB ou HSL sobre o RGB é que pode ser mais intuitivo: você pode adivinhar as cores que deseja e depois ajustá-las. Também é mais fácil criar conjuntos de cores combinando (mantendo a matiz igual e variando o brilho ou a luminosidade e a saturação, por exemplo).

Assim como a notação funcional 'rgb()' tem sua contraparte alfa 'rgba()', as notações funcionais 'hsl()' e 'hsb()' têm suas contrapartes alfa 'hsla()' e 'hsba()'. Estes exemplos especificam a mesma cor:

hsb(120, 100%,  100%)              verde pleno em hsb
hsba(120, 100%,  100%,  1.0)       o mesmo, com um valor alfa de 1.0
hsb(120, 255,  255)                verde pleno em hsb
hsba(120, 255,  255,  1.0)         o mesmo, com um valor alfa de 1.0

hsl(120, 100%,  50%)               verde pleno em hsl
hsla(120, 100%,  50%,  1.0)        o mesmo, com um valor alfa de 1.0
hsl(120, 255,  127.5)              verde pleno em hsl
hsla(120, 255,  127.5,  1.0)       o mesmo, com um valor alfa de 1.0

Para o ImageMagick entre 6.5.6-6 e 6.9.2-0, HSL (HSB) só podia ser especificado com a matiz como percentual no intervalo 0—100%, quando a saturação e a luminosidade (brilho) também eram especificadas como percentual no intervalo 0—100%.

Especifique as cores Lab assim:

cielab(62.253188, 23.950124, 48.410653)

Observe que os componentes a e b de qualquer cor Lab que você especificar são internamente enviesados em 50% para garantir que se ajustem ao intervalo do quantum (tipicamente 0 a 65535). O viés é mantido ao gravar nos formatos de imagem TIFF e MIFF. No entanto, o formato TXT suporta valores de pixel negativos, então o viés é removido ao gravar nesse formato:

$ magick xc:cyan -colorspace LAB txt:
# ImageMagick pixel enumeration: 1,1,65535,cielab
0,0: (59711,20409.5,-3632.9)  #E93F4FBA71CF  cielab(91.1132,-48.0855,-14.1358)

$ magick -size 100x100 xc:"cielab(91.1132,-48.0855,-14.1358)" -colorspace sRGB cyan.png

Ou especifique as cores de forma genérica com a palavra-chave icc-color, por exemplo:

icc-color(cmyk, 0.11, 0.48, 0.83, 0.00)  cymk
icc-color(rgb, 1, 0, 0)                  rgb linear
icc-color(rgb, red)                      rgb linear
icc-color(lineargray, 0.5)               cinza linear
icc-color(srgb, 1, 0, 0)                 rgb não linear
icc-color(srgb, red)                     rgb não linear
icc-color(gray, 0.5)                     cinza não linear

Ou especifique cores de dispositivo não calibradas com a palavra-chave device-, por exemplo:

device-gray(0.5)
device-rgb(0.5, 1.0, 0.0)
device-cmyk(0.11, 0.48, 0.83, 0.00)

O ImageMagick também suporta cor de amplo gamute, como Lab, LCH e Display-P3.

Lista de Nomes de Cores

A tabela abaixo fornece uma lista de cores nomeadas reconhecidas pelo ImageMagick: