Jump to content

Documentation/Fonctions Calc/COULEUR

From The Document Foundation Wiki
This page is a translated version of the page Documentation/Calc Functions/COLOR and the translation is 100% complete.


Nom de la fonction :

COULEUR

Catégorie :

Mathématique

Résumé :

Combine les valeurs spécifiées des canaux rouge, vert, bleu et alpha d'une représentation de couleur RGBA pour produire une seule valeur codée.

Syntaxe :

COULEUR(Rouge; Vert; Bleu[; Alpha])

Renvoie :

Renvoie un entier dans la plage [0, 232-1] qui est la valeur de couleur construite à partir des composants spécifiés.

Arguments :

Rouge est un entier dans la plage [0, 255], ou une référence à une cellule contenant ce nombre, qui est l'intensité de la couleur rouge.

Vert est un entier dans la plage [0, 255], ou une référence à une cellule contenant ce nombre, qui est l'intensité de la couleur verte.

Bleu est un entier dans la plage [0, 255], ou une référence à une cellule contenant ce nombre, qui est l'intensité de la couleur bleue.

Alpha est un entier compris entre [0 et 255], ou une référence à une cellule contenant ce nombre, qui correspond à la valeur du canal alpha. S'il est omis, la valeur par défaut est 0. Une valeur de 0 signifie que la couleur est totalement transparente, tandis qu'une valeur de 255 donne une couleur totalement opaque.

  • Si un argument n'est pas numérique, alors COULEUR signale une erreur #VALEUR !.
  • Si un argument est une valeur non entière, alors COULEUR le convertit en un entier en prenant sa valeur plancher.
  • Si un argument est inférieur à 0 ou supérieur à 255, alors COULEUR signale une erreur d'argument non valide (Err :502).

Détails complémentaires :

  • La valeur renvoyée par COULEUR contient l'échantillon alpha dans ses 8 bits les plus significatifs, suivi de l'échantillon rouge, de l'échantillon vert et enfin de l'échantillon bleu dans les 8 bits les moins significatifs.
  • COULEUR combine les échantillons à l'aide de la formule suivante :
    [math]\displaystyle{ \text{COULEUR}(rouge, vert, bleu, alpha)~=~256*256*256*alpha~+~ 256*256*rouge~+~256*vert~+~bleu }[/math]
  • 232 est égal à 4294967296.

Exemples :

Formule Description Renvoie
=COULEUR(255; 255; 255; 255) Tous les composants prennent leurs valeurs maximales et COULEUR renvoie la valeur 4294967295 (hex 0xFFFFFFFF). 4294967295
=COULEUR(D1; D2; D3; D4) où les cellules D1, D2, D3 et D4 contiennent toutes le nombre 119. Tous les composants prennent la valeur 119 et COULEUR renvoie la valeur 2004318071 (hex 0x77777777). 2004318071
=COULEUR(119,2; 119,7; 119,5; 119,9) COULEUR prend la valeur plancher de chaque argument. Après troncature, tous les composants prennent la valeur 119 et COULEUR renvoie la valeur 2004318071 (hex 0x77777777). 2004318071
=COULEUR(255; 255; 255) Ici, aucune valeur pour le canal alpha n'est spécifiée et la valeur par défaut de 0 est supposée. COULEUR renvoie la valeur 16777215 (hex 0x00FFFFFF). 16777215
=COULEUR(11; 12; 13; 10) Cet exemple est utile pour confirmer comment la fonction construit la valeur codée en visualisant sa structure au format hexadécimal. COULEUR renvoie la valeur 168496141 (hex 0x0A0B0C0D). 168496141

Fonctions LibreOffice associées :

Aucun.

Standard ODF :

Aucun.

Fonctions Excel relatives (ou similaires) :

Aucun.