DocumentationAPI de diffusion et de rendu d’images Dynamic Media

couleur

Dernière mise à jour : 5 mai 2025
  • Rubriques :

Créé pour :

  • Développeur
  • Utilisateur ou utilisatrice

Valeurs de couleur. Vous pouvez spécifier des valeurs de couleur à l’aide d’une notation hexadécimale, d’une liste de valeurs de composant séparées par des virgules ou de décimales.

color

{{ gray[, alpha][g]}|

{ red, green, blue[ , rgbAlpha][r]}|

{ cyan, magenta, jaune, noir[,alpha]k}|

{0x{hex2|hex4}[g]}|{1

{[0x]{ hex6| hex8[r]}|

{[0x]{ hex8| hex10}k}}[s]

rouge, vert, bleu, rgbAlphavaleur du composant de couleur (0...255, décimal int)
cyan, magenta, jaune, noir, alphaValeur du composant de couleur CMJN (0,100 %, décimal int)
gray, alphavaleur du composant de couleur grise (0...100 %, décimal int)
hex2valeur de couleur grise hexadécimale hexadécimale (GG) bondée de deux chiffres
hex4pack de quatre chiffres hex gray avec valeur de couleur alpha (GGAA)
hex6valeur hexadécimale de RGB à six chiffres (RRGBB) compressée
hex8valeur de couleur hexadécimale RGBA (RRGBBAA) ou CMJN (CCMYYKK) compressée à huit chiffres (si spécifiée avec le suffixe 'k')
hex10CMJN hexadécimal à dix chiffres avec valeur alpha (CCYMMKAA)

Les valeurs des composants décimaux des couleurs du RGB sont comprises entre 0 et 255. Les valeurs des composants décimaux pour CMJN et gris se situent dans la plage 0,100 %. Toutes les valeurs du composant hexadécimal se trouvent dans la plage 0…0xFF.

Les valeurs des composants de couleur sont supposées être indépendantes de la valeur alpha (non pré-multipliée).

Toutes les valeurs de couleur, préfixes et suffixes ne sont pas sensibles à la casse.

Le suffixe de type "k" est requis pour les valeurs de couleur CMJN. Vous pouvez éventuellement spécifier un suffixe de type pour les valeurs de couleur RGB et grise.

Le préfixe "0x" est requis pour les valeurs hexadécimales de gris.

Le suffixe 's' spécifie que la valeur de couleur est associée à l’espace colorimétrique d’entrée (source) correspondant au type de pixel de la valeur de couleur (défini avec attribute::IccProfileSrc*). Si ce suffixe n’est pas présent, la valeur de couleur est associée à l’espace colorimétrique de sortie (destination) (défini avec icc= ou attribute::IccProfile*).

Par défaut

Si une valeur alpha n’est pas spécifiée explicitement, elle est supposée être de 255, 0xFF ou 100 % (totalement opaque).

Exemples

Voici quelques exemples de paramètres de couleurs valides, ainsi que le type de pixel, la valeur de couleur, la valeur alpha et l’espace colorimétrique par défaut correspondant :

colorType de pixelValeur de couleurValeur d’AlphaEspace colorimétrique par défaut
0 100 200RVB0 100 200255IccProfileRgb
0 100 200 200 rsRVB0 100 200200IccProfileSrcRgb
0x010203SRVB1,2,3255IccProfileSrcRgb
a0b1c2d3RRVB160 177 194211IccProfileRgb
100 Sgris100 %100 %IccProfileSrcGray
50,75ggris50 %75 %IccProfileGray
0X70Ggris44 %44 %IccProfileGray
0xddeegsgris87 %93 %IccProfileSrcGray
94,11,50,33kCMJN94-11-50-33 %100 %IccProfileCmyk
22,23,24,25,26 KSCMJN22-23-24-25 %26 %IccProfileSrcCmyk
38393A3bKCMJN56-57-58-59 %100 %IccProfileCmyk
0x0a0b0C0d0eksCMJN10-11-12-13 %14 %IccProfileSrcCmyk

L’espace colorimétrique de sortie spécifié avec icc= s’applique à la place de l’espace colorimétrique par défaut lorsque le type de pixel d’une couleur de sortie correspond au type de pixel de l’image de sortie.

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49