ColorBetween

Syntaxe

ColorBetween(value1, value2, r, g, b, a)

Avec une couleur nommée :

ColorBetween(value1, value2, colorName, a)

Paramètres

Comment ça marche

ColorBetween ombre la bande verticale entre deux valeurs sur chaque bar. Lorsque les deux valeurs sont des courbes d'indicateur, les bandes ombrées se rejoignent d'une bar à l'autre pour former une région remplie continue, ce qui est la façon habituelle de visualiser le spread entre deux moyennes mobiles, l'intérieur d'un canal, ou la distance entre le prix et une ligne de référence.

L'ordre des deux valeurs limites n'a pas de signification ; la zone située entre elles est remplie dans les deux cas. Ce qui compte souvent, en revanche, c'est d'appeler la fonction de façon conditionnelle : encadrer les appels à ColorBetween dans des blocs IF permet à la couleur de remplissage d'encoder un état, par exemple vert lorsque la moyenne rapide est au-dessus de la lente et rouge sinon.

Le remplissage se superpose à l'arrière-plan par défaut du graphique, mais les instructions de couleur exécutées plus tard dans le script peuvent le remplacer dans la même région. La transparence se spécifie sur une échelle de 0 à 100, et des valeurs modérées autour de 50 permettent de garder les chandeliers lisibles à travers le remplissage.

ColorBetween fait partie des outils de dessin des indicateurs. Il n'a aucun effet dans ProScreener, et le code de stratégie dans ProBacktest et ProOrder ne restitue pas les remplissages graphiques ; le contexte visuel d'une stratégie s'ajoute normalement en attachant au graphique un indicateur contenant les appels à ColorBetween.

Exemples

Exemple 1, Ombrer l'écart entre deux moyennes mobiles (Indicateur)

ma1 = average[7]
ma2 = average[20]

IF ma1 > ma2 THEN
  ColorBetween(ma1, ma2, 0, 255, 0, 50) // green fill at 50 percent opacity
ELSE
  ColorBetween(ma1, ma2, "red", 50) // red fill at 50 percent opacity
ENDIF

RETURN

La zone entre une moyenne à 7 périodes et une moyenne à 20 périodes est ombrée en vert tant que la moyenne rapide est devant et en rouge tant qu'elle est derrière, ce qui rend le régime en cours lisible d'un coup d'œil.

Exemple 2, Remplir un canal de Bollinger (Indicateur)

upper = BollingerUp[20](close)
lower = BollingerDown[20](close)

// Light blue fill across the whole band
ColorBetween(upper, lower, 100, 149, 237, 25)

RETURN upper AS "Upper band", lower AS "Lower band"

A single ColorBetween call shades the full Bollinger channel with a faint fill, while the RETURN statement still plots the band boundaries as lines.

Exemple 3, Mettre en évidence l'écartement du prix par rapport à sa moyenne (Indicateur)

baseline = ExponentialAverage[50](close)
gap = ABS(close - baseline)
threshold = AverageTrueRange[14](close) * 2

// Shade only when price is stretched more than two ATRs from the baseline
IF gap > threshold THEN
  ColorBetween(close, baseline, 255, 165, 0, 60) // orange warning fill
ENDIF

RETURN baseline AS "EMA 50"

Le remplissage n'apparaît que sur les bars où le prix s'écarte de plus de deux ATR de sa moyenne exponentielle, de sorte que l'ombrage lui-même fait office de signal de sur-extension.

Erreurs et pièges courants

• L'alpha va de 0 à 100. La transparence de ColorBetween utilise une échelle de 0 à 100, contrairement à l'alpha de COLOURED qui va de 0 à 255. Reporter une valeur d'opacité de 255 produit un argument hors plage.
• Rendu réservé aux indicateurs. La fonction ne dessine rien dans le code ProScreener, ProBacktest ou ProOrder. Attachez plutôt au graphique un indicateur contenant la logique ColorBetween.
• Les couleurs appliquées ensuite l'emportent. Les instructions de couleur suivantes dans le même script peuvent recouvrir la zone remplie. Ordonnez délibérément les appels de dessin lorsque vous combinez remplissages, arrière-plans et courbes colorées.
• Remplissages sans courbes visibles. ColorBetween shades between values whether or not they are returned. Unless the boundary series are also plotted via RETURN, the fill appears to float, which is sometimes intended and sometimes a forgotten RETURN.

Instructions liées

• COLOURED, colore une courbe renvoyée, de façon statique ou selon une condition.
• BACKGROUNDCOLOR, colore tout l'arrière-plan du graphique bar par bar.
• FILLCOLOR, contrôle de la couleur de remplissage des formes tracées.
• DRAWRECTANGLE, dessine un rectangle entre des coordonnées explicites.
• Average, moyenne mobile, une limite de remplissage typique.
• BollingerUp, bande de Bollinger supérieure, utilisable comme limite de zone.
• BollingerDown, bande de Bollinger inférieure, utilisable comme limite de zone.
• RETURN, trace les courbes qu'un remplissage accompagne habituellement.