COLOURED

Syntaxe

RETURN value COLOURED(R, G, B)
RETURN value COLOURED("colorname")

Avec transparence (version 10.3 de la plateforme et ultérieure) :

RETURN value COLOURED(R, G, B, alpha)

Coloration dynamique pilotée par une variable :

RETURN value COLOURED BY (variable)

Paramètres

Comment ça marche

COLOURED attaches color information to a value emitted by RETURN. In its static form, the whole curve takes one fixed color, defined either by three RGB components or by a predefined color name. From platform version 10.3 an optional fourth argument controls opacity on a 0 to 255 scale, allowing semi-transparent lines that do not obscure price.

La forme dynamique, COLOURED BY, colore chaque segment de la courbe selon une variable pilote calculée plus tôt dans le script. À mesure que la variable change de valeur d'une bar à l'autre, la ligne tracée change de couleur sur toute sa longueur. Le schéma courant calcule une variable d'état, par exemple 1 tant qu'une moyenne rapide est au-dessus d'une moyenne lente et -1 sinon, et laisse la courbe changer de couleur à chaque changement de régime.

COLOURED modifies presentation only. The returned values are unchanged, and scripts that CALL the indicator receive the same numbers regardless of coloring. Because the mechanism rides on RETURN, it belongs to indicator code; strategy and screener programs do not plot curves and have no use for it.

Exemples

Exemple 1, Moyenne lente colorée selon la tendance (Indicateur)

i1 = average[10](close)
i2 = average[50](close)
// State variable: 1 when the fast average leads, -1 otherwise
IF i1 > i2 THEN
  a = 1
ELSE
  a = -1
ENDIF
RETURN i2 COLOURED BY (a)

La moyenne à 50 périodes est tracée dans une couleur tant que la moyenne à 10 périodes est au-dessus d'elle et passe à une autre lorsque la relation s'inverse, ce qui encode la direction de la tendance directement sur la ligne.

Exemple 2, Couleur fixe pour une courbe de référence (Indicateur)

// Plot a 200-period average in a fixed orange
longTermMA = average[200](close)
RETURN longTermMA COLOURED(255, 140, 0) AS "MA 200"

Une couleur RGB statique distingue la moyenne de long terme des autres lignes du graphique sans dépendre de l'attribution automatique des couleurs par la plateforme.

Exemple 3, Ligne d'oscillateur semi-transparente (Indicateur)

// RSI drawn dark blue at roughly half opacity
r = RSI[14](close)
RETURN r COLOURED(0, 0, 139, 128) AS "RSI 14"

Le quatrième argument fixe l'alpha à 128 sur 255, de sorte que l'oscillateur reste visible sans dominer ce qui est tracé en dessous.

Erreurs et pièges courants

• L'échelle d'alpha diffère de celle de ColorBetween. L'opacité de COLOURED va de 0 à 255, tandis que ColorBetween utilise 0 à 100. Réutiliser une valeur d'une fonction à l'autre décale la transparence voulue.
• L'alpha nécessite la version 10.3 ou ultérieure. La forme à quatre arguments échoue sur les versions plus anciennes de la plateforme. La forme RGB à trois arguments fonctionne partout.
• Orthographe britannique. Le mot-clé s'écrit COLOURED, comme documenté. L'écrire COLORED est la faute de frappe la plus courante lorsque la fonction semble ne pas exister.
• Présentation uniquement. COLOURED modifie la façon dont la courbe est dessinée, pas ses valeurs. Une logique conditionnelle fondée sur la couleur est impossible ; basez plutôt vos conditions sur la variable sous-jacente.

Instructions liées

• ColorBetween, remplit d'une couleur la zone entre deux courbes.
• BACKGROUNDCOLOR, colore l'arrière-plan du graphique bar par bar.
• FILLCOLOR, contrôle de la couleur de remplissage des formes tracées.
• RETURN, émet les valeurs que COLOURED décore.
• DRAWTEXT, affiche du texte sur le graphique, un autre outil de présentation.
• STYLE, définit le style et l'épaisseur des courbes tracées.
• Average, moyenne mobile, cible fréquente d'une coloration conditionnelle.
• RSI, oscillateur souvent tracé avec des couleurs personnalisées.