Rejoignez-nous
Graphiques/probuilder

BACKGROUNDCOLOR

BACKGROUNDCOLOR en ProBuilder teinte le fond du graphique bar par bar à l'aide d'une valeur RGB et d'un alpha, pour mettre en évidence des conditions sur un indicateur. Syntaxe et exemples.

Syntaxe

probuilder
BACKGROUNDCOLOR(R, G, B, a)

Paramètres

NomTypePar défautDescription
RentierrequisComposante rouge de la couleur, de 0 à 255.
GentierrequisComposante verte de la couleur, de 0 à 255.
BentierrequisComposante bleue de la couleur, de 0 à 255.
aentierrequisAlpha (transparence), de 0 totalement transparent à 255 totalement opaque.

Comment ça marche

BACKGROUNDCOLOR s'exécute dans un indicateur ProBuilder. Sur chaque bar où elle est appelée, elle définit la couleur du fond du graphique derrière ce bar. Comme elle s'applique bar par bar, elle est normalement pilotée par une condition, de sorte que des plages de bars sont colorées pour marquer un régime, le franchissement d'un seuil ou un biais directionnel.

Une valeur alpha modérée garde lisible la teinte derrière les bars de prix. Les couleurs sont données en composantes RGB, le même modèle additif que celui utilisé par COLOURED et FILLCOLOR. Contrairement à FILLCOLOR, qui remplit un objet dessiné, BACKGROUNDCOLOR colore toute la colonne d'arrière-plan à ce bar.

Exemples

Exemple 1, Ombrer selon le biais du stochastique (Indicateur)

probuilder
// Green background while bullish, red while bearish
sto = Stochastic[10,3](close)
signal = Average[5](sto)
rge = AverageTrueRange[10](close)
IF sto[1] > 80 AND sto CROSSES UNDER signal THEN
    DRAWARROWDOWN(BarIndex[1], high[1] + rge/2) COLOURED(255, 10, 10)
    direction = -1
ELSIF sto[1] < 20 AND sto CROSSES OVER signal THEN
    DRAWARROWUP(BarIndex[1], low[1] - rge/2) COLOURED(10, 255, 10)
    direction = 1
ENDIF
IF direction > 0 THEN
    BACKGROUNDCOLOR(10, 255, 10, 100)
ELSE
    BACKGROUNDCOLOR(255, 10, 10, 100)
ENDIF
RETURN

Le direction variable reporte le dernier signal, donc l'arrière-plan reste vert ou rouge jusqu'au croisement suivant.

Exemple 2, Mettre en évidence une zone de surachat (Indicateur)

probuilder
// Tint the background when RSI is above 70
IF RSI[14] > 70 THEN
    BACKGROUNDCOLOR(255, 200, 200, 120)
ENDIF
RETURN

Seuls les bars en surachat sont ombrés, en opacité partielle.

Exemple 3, Marquer une plage de séance (Indicateur)

probuilder
// Light blue background during the morning hours
IF OpenTime >= 090000 AND OpenTime < 120000 THEN
    BACKGROUNDCOLOR(200, 220, 255, 100)
ENDIF
RETURN

La teinte couvre les bars situés dans la plage horaire choisie.

Erreurs et pièges courants

  • Indicateur uniquement. BACKGROUNDCOLOR n'a aucun effet dans ProScreener, ProOrder ou ProBacktest. Réservez-le à un indicateur ProBuilder.
  • Par bar, pas une seule fois. Elle colore uniquement le bar sur lequel elle s'exécute. Pour ombrer une série de bars, appelez-la sur chacun d'eux, généralement via une condition.
  • L'alpha compte. Un alpha élevé masque les bars de prix. Utilisez une valeur modérée pour que les bougies restent visibles.
  • Conserver l'état. Pour conserver une couleur jusqu'au signal suivant, gardez le biais dans une variable, comme dans l'exemple 1, plutôt que de colorer uniquement le bar du signal.
  • FILLCOLOR, remplit un objet dessiné plutôt que l'ensemble du fond.
  • COLOURED, définit la couleur des lignes et des dessins.
  • ColorBetween, colorie la zone entre deux séries.
  • DRAWARROWUP, une flèche qui s'associe à une teinte de fond.
  • DRAWARROWDOWN, une flèche qui s'associe à une teinte de fond.
  • DrawOnLastBarOnly, limite les autres dessins au dernier bar.
  • IF, conditionne la couleur à une condition.
  • RETURN, termine l'indicateur après les appels de dessin.