Exemples d'utilisation • Spécification du modèle de couleur • Liste des noms de couleurs

De nombreuses options et méthodes d'ImageMagick prennent une couleur comme argument. La couleur peut alors être donnée sous forme de nom de couleur (il en existe un ensemble limité mais vaste ; voir ci-dessous) ou sous forme d'un ensemble de nombres (en décimal ou hexadécimal), chacun correspondant à un canal d'un modèle de couleur RGB ou RGBA. Les modèles de couleur HSL, HSLA, HSB, HSBA, CMYK ou CMYKA peuvent également être spécifiés. Ces sujets sont brièvement décrits dans les sections ci-dessous.

Utilisez le Color Converter pour fournir n'importe quelle spécification de couleur ImageMagick valide telle que décrite ci-dessous, afin de voir un échantillon de cette couleur et de la convertir vers tous les autres modèles de couleur.

Exemples d'utilisation

Chacune des commandes suivantes produit la même bordure lime autour de l'image. (Utilisez des « guillemets doubles » sous 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

La liste des noms de couleurs reconnus (par exemple aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, yellow et autres) est présentée dans un tableau plus bas.

Spécification du modèle de couleur

Les modèles de couleur sRGB, CMYK, HSL et HSB sont utilisés dans les spécifications numériques de couleur. Ces exemples spécifient tous la même couleur rouge sRGB :

#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)            un entier dans la plage 0—255 pour chaque composante
rgb(100.0%, 0.0%, 0.0%)   un flottant dans la plage 0—100% pour chaque composante

Le format d'une valeur sRGB en notation hexadécimale est un « # » immédiatement suivi de 3 à 32 caractères hexadécimaux. La notation sRGB à trois chiffres (#rgb) est convertie en forme à six chiffres (#rrggbb) en répliquant les chiffres, et non en ajoutant des zéros. Par exemple, #fb0 se développe en #ffbb00. Cela garantit que le blanc (#ffffff) peut être spécifié avec la notation courte (#fff) et supprime toute dépendance à la profondeur de couleur de l'image. Utilisez la notation hexadécimale chaque fois que la performance est en jeu. ImageMagick n'a pas besoin de charger l'imposante table de couleurs pour interpréter une couleur hexadécimale, par exemple #000000, mais il le fait si black est utilisé à la place.

Le format d'une valeur sRGB en notation fonctionnelle est « rgb(r,g,b) », où r, g et b sont soit trois valeurs entières ou flottantes dans la plage 0—255, soit trois valeurs entières ou flottantes en pourcentage dans la plage 0—100%. La valeur 255 correspond à 100%, et à #F ou #FF en notation hexadécimale : rgb(255, 255, 255) = rgb(100%, 100%, 100%) = #FFF = #FFFFFF. Notez que, depuis ImageMagick 7.0.10-53, les virgules ne sont plus nécessaires et la barre oblique peut précéder la valeur alpha, par exemple rgb(255 128 0 / 50%).

Des caractères d'espacement sont autorisés autour des valeurs numériques, du moins si l'argument de couleur entier est entouré de guillemets (« guillemets simples » pour les systèmes de type Linux, « guillemets doubles » pour Windows).

Le modèle de couleur sRGB est étendu dans cette spécification pour inclure l'alpha afin de permettre la spécification de la transparence d'une couleur. Ces exemples spécifient tous la même couleur :

rgb(255, 0, 0)                 plage 0 - 255
rgba(255, 0, 0, 1.0)           la même, avec une valeur alpha explicite
rgb(100%, 0%, 0%)              plage 0.0% - 100.0%
rgba(100%, 0%, 0%, 1.0)        la même, avec une valeur alpha explicite

Le format d'une valeur RGBA en notation fonctionnelle est « rgba(r,g,b,a) », où r, g et b sont tels que décrits ci-dessus pour la notation fonctionnelle RGB, et où la valeur alpha a varie de 0.0 (entièrement transparent) à 1.0 (entièrement opaque).

Il existe également une couleur appelée « none » qui est entièrement transparente. Cette couleur est un raccourci pour rgba(0, 0, 0, 0.0).

Les valeurs de gris non linéaires se définissent commodément avec un nom, une valeur d'intensité unique ou une valeur d'intensité et une valeur alpha :

gray50            gris presque moyen
gray(127)         gris presque moyen
gray(50%)         gris moyen
graya(50%, 0.5)   gris moyen semi-transparent

Pour les valeurs de gris linéaires, ajoutez -colorspace RGB -colorspace Gray ou -colorspace LinearGray lors de la création de couleurs grises. Cette dernière est nouvelle depuis Imagemagick 6.9.9-29 et 7.0.7-17.

Le modèle de couleur d'ImageMagick prend également en charge les couleurs teinte-saturation-luminosité (HSL) et teinte-saturation-brillance (HSB) comme complément aux couleurs sRGB numériques. Les couleurs HSL sont codées sous forme d'un triplet (teinte, saturation, luminosité). De même, les couleurs HSB sont codées sous forme d'un triplet (teinte, saturation, brillance). Les triplets HSL ou HSB sont soit des valeurs directes (teinte 0—360, saturation 0—255, luminosité ou brillance 0—255), soit avec S, L, B comme valeurs en pourcentage relatives à ces plages.

Le système de couleur HSB est représenté géométriquement comme un cône dont l'apex pointe vers le bas. La teinte est mesurée autour du périmètre. La saturation est mesurée depuis l'axe vers l'extérieur. La brillance est mesurée depuis l'apex vers le haut.

Le système de couleur HSL est représenté géométriquement comme un double cône empilé, l'un des apex pointant vers le bas et l'autre vers le haut. Les extrémités les plus larges des deux cônes sont empilées l'une sur l'autre. La teinte est mesurée autour du périmètre. La saturation est mesurée depuis l'axe vers l'extérieur. La luminosité est mesurée depuis l'apex du bas vers le haut.

Voir http://en.wikipedia.org/wiki/HSL_and_HSV pour plus de détails sur les systèmes de couleur HSL et HSB.

La teinte est représentée comme un angle de la couleur autour du périmètre circulaire du ou des cônes (c'est-à-dire l'arc-en-ciel représenté dans un cercle). Les valeurs de teinte sont des entiers ou des flottants dans la plage 0—360. Par définition, red=0=360, et les autres couleurs sont réparties autour du cercle, donc green=120, blue=240, etc. En tant qu'angle, il s'enroule implicitement de sorte que -120=240 et 480=120, par exemple. (Les étudiants en trigonométrie diraient ici que « les angles coterminaux sont équivalents » ; un angle θ peut être standardisé en calculant l'angle équivalent, θ mod 360.)

La saturation est mesurée vers l'extérieur depuis l'axe central du ou des cônes vers le périmètre du ou des cônes. La saturation peut être exprimée comme un entier ou un flottant dans la plage 0—255 ou comme un pourcentage entier ou flottant dans la plage 0—100. La saturation peut être considérée comme l'absence de tout « blanc » mélangé à la couleur de base. Ainsi 255 ou 100% correspond à la saturation maximale et à un point sur la surface extérieure du cône (HSB) ou du double cône (HSL). Ce sera la région la plus « colorée ». 0 ou 0% correspond à une absence de saturation, ce qui donne une nuance de gris. Cela se produit le long de l'axe central du cône ou du double cône, avec le noir à l'apex du bas et le blanc en haut.

La brillance (Brightness) et la luminosité (Lightness) peuvent également être représentées comme des entiers ou des flottants dans la plage 0—255 ou comme des pourcentages entiers ou flottants dans la plage 0—100%. La brillance et la luminosité sont mesurées depuis l'apex du bas vers le haut du cône ou du double cône, le long de l'axe central du ou des cônes. 0 ou 0% correspond à l'apex du bas et 255 ou 100% correspond au centre supérieur du cône pour la brillance et à l'apex supérieur du double cône pour la luminosité.

Le système de couleur HSB est un peu plus facile à comprendre que le système de couleur HSL. Dans le système de couleur HSB, le noir est à l'apex du bas et le blanc au centre supérieur du cône, sur l'axe central. Les couleurs les plus colorées ou les plus saturées se trouvent alors au bord extérieur du sommet du cône, à sa partie la plus large. Ainsi, à Saturation=100% et Brillance=100% :

hsb(0,   100%,  100%)    or    hsb(0,   255,   255)       rouge plein
hsb(120, 100%,  100%)    or    hsb(120, 255,   255)       vert plein
hsb(120, 100%,  75%)     or    hsb(120, 255,   191.25)    vert moyen
hsb(120, 100%,  50%)     or    hsb(120, 255,   127.5)     vert foncé
hsb(120, 100%,  25%)     or    hsb(120, 255,   63.75)     vert très foncé
hsb(120, 50%,   50%)     or    hsb(120, 127.5, 127.5)     vert pastel

Dans le système de couleur HSL, le noir est à l'apex du bas et le blanc à l'apex du haut. Cependant, la saturation est maximale au milieu du double cône, sur son périmètre extérieur, et donc à une valeur de luminosité de 50%. Les couleurs les plus colorées ou les plus saturées se trouvent alors au bord extérieur du double cône, à sa partie la plus large. Ainsi, à Saturation=100% et Brillance=50% :

hsl(0,   100%,  50%)     or    hsl(0,   255,   127.5)     rouge plein
hsl(120, 100%,  100%)    or    hsl(120, 255,   255)       blanc
hsl(120, 100%,  75%)     or    hsl(120, 255,   191.25)    vert pastel
hsl(120, 100%,  50%)     or    hsl(120, 255,   127.5)     vert plein
hsl(120, 100%,  25%)     or    hsl(120, 255,   63.75)     vert foncé
hsl(120, 50%,   50%)     or    hsl(120, 127.5, 127.5)     vert moyen

Un avantage de HSB ou HSL sur RGB est qu'il peut être plus intuitif : vous pouvez deviner les couleurs que vous voulez, puis les ajuster. Il est également plus facile de créer des ensembles de couleurs assorties (en gardant la même teinte et en faisant varier la brillance ou la luminosité et la saturation, par exemple).

Tout comme la notation fonctionnelle « rgb() » possède son équivalent alpha « rgba() », les notations fonctionnelles « hsl() » et « hsb() » possèdent leurs équivalents alpha « hsla() » « hsba() ». Ces exemples spécifient la même couleur :

hsb(120, 100%,  100%)              vert plein en hsb
hsba(120, 100%,  100%,  1.0)       le même, avec une valeur alpha de 1.0
hsb(120, 255,  255)                vert plein en hsb
hsba(120, 255,  255,  1.0)         le même, avec une valeur alpha de 1.0

hsl(120, 100%,  50%)               vert plein en hsl
hsla(120, 100%,  50%,  1.0)        le même, avec une valeur alpha de 1.0
hsl(120, 255,  127.5)              vert plein en hsl
hsla(120, 255,  127.5,  1.0)       le même, avec une valeur alpha de 1.0

Pour ImageMagick entre 6.5.6-6 et 6.9.2-0, HSL (HSB) ne pouvait être spécifié qu'avec la teinte en pourcentage dans la plage 0—100%, lorsque la saturation et la luminosité (brillance) étaient également spécifiées en pourcentage dans la plage 0—100%.

Spécifiez les couleurs Lab de cette façon :

cielab(62.253188, 23.950124, 48.410653)

Notez que les composantes a et b de toute couleur Lab que vous spécifiez sont biaisées en interne de 50% pour garantir qu'elle tient dans la plage quantique (typiquement 0 à 65535). Le biais est conservé lors de l'écriture dans les formats d'image TIFF et MIFF. Cependant, le format TXT prend en charge les valeurs de pixel négatives, de sorte que le biais est supprimé lors de l'écriture dans ce format :

$ 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 spécifiez des couleurs de manière générique avec le mot-clé icc-color, par exemple :

icc-color(cmyk, 0.11, 0.48, 0.83, 0.00)  cymk
icc-color(rgb, 1, 0, 0)                  rgb linéaire
icc-color(rgb, red)                      rgb linéaire
icc-color(lineargray, 0.5)               gris linéaire
icc-color(srgb, 1, 0, 0)                 rgb non linéaire
icc-color(srgb, red)                     rgb non linéaire
icc-color(gray, 0.5)                     gris non linéaire

Ou spécifiez des couleurs de périphérique non calibrées avec le mot-clé device-, par exemple :

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

ImageMagick prend également en charge les couleurs à large gamut telles que Lab, LCH et Display-P3.

Liste des noms de couleurs

Le tableau ci-dessous fournit une liste des couleurs nommées reconnues par ImageMagick :