Word nu lid
Grafisch/probuilder

BACKGROUNDCOLOR

BACKGROUNDCOLOR in ProBuilder kleurt de achtergrond van de grafiek per bar met RGB en een alphawaarde, om voorwaarden op een indicator te markeren. Syntaxis en voorbeelden.

Syntaxis

probuilder
BACKGROUNDCOLOR(R, G, B, a)

Parameters

NaamTypeStandaardBeschrijving
Rgeheel getalverplichtRoodcomponent van de kleur, 0 tot 255.
Ggeheel getalverplichtGroencomponent van de kleur, 0 tot 255.
Bgeheel getalverplichtBlauwcomponent van de kleur, 0 tot 255.
ageheel getalverplichtAlpha (transparantie), 0 volledig transparant tot 255 volledig dekkend.

Hoe het werkt

BACKGROUNDCOLOR werkt binnen een ProBuilder-indicator. Op elke bar waarop hij wordt aangeroepen, stelt hij de kleur van de grafiekachtergrond achter die bar in. Omdat hij per bar werkt, wordt hij normaal door een voorwaarde gestuurd, zodat reeksen bars worden ingekleurd om een regime, een drempeldoorbreking of een directionele bias te markeren.

Een gematigde alfawaarde houdt de tint achter de prijsbars leesbaar. Kleuren worden gegeven als RGB-componenten, hetzelfde additieve model dat wordt gebruikt door COLOURED en FILLCOLOR. In tegenstelling tot FILLCOLOR, die een getekend object vult, BACKGROUNDCOLOR kleurt de hele achtergrondkolom bij die bar.

Voorbeelden

Voorbeeld 1, Inkleuren op basis van stochastische bias (Indicator)

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

De direction variabele draagt het laatste signaal door, waardoor de achtergrond groen of rood blijft tot de volgende crossover.

Voorbeeld 2, Een overbought zone markeren (Indicator)

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

Alleen de overbought bars worden ingekleurd, met gedeeltelijke dekking.

Voorbeeld 3, Een sessievenster markeren (Indicator)

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

De tint beslaat de bars binnen het gekozen tijdvenster.

Veelvoorkomende fouten en valkuilen

  • Alleen indicator. BACKGROUNDCOLOR heeft geen effect in ProScreener, ProOrder of ProBacktest. Houd het in een ProBuilder-indicator.
  • Per bar, niet eenmalig. Het kleurt alleen de bar waarop het wordt uitgevoerd. Om een reeks bars in te kleuren, roep je het op elk van die bars aan, meestal via een voorwaarde.
  • Alpha doet ertoe. Een hoge alpha verbergt de prijsbars. Gebruik een gematigde waarde zodat de candles zichtbaar blijven.
  • Draag de status mee. Om een kleur tot het volgende signaal te behouden, houd je de bias in een variabele, zoals in Voorbeeld 1, in plaats van alleen de signaalbar te kleuren.
  • FILLCOLOR, vult een getekend object in plaats van de hele achtergrond.
  • COLOURED, stelt de kleur van lijnen en tekeningen in.
  • ColorBetween, arceert het gebied tussen twee reeksen.
  • DRAWARROWUP, een pijl die combineert met een achtergrondtint.
  • DRAWARROWDOWN, een pijl die combineert met een achtergrondtint.
  • DrawOnLastBarOnly, beperkt andere tekeningen tot de laatste bar.
  • IF, stelt de kleur afhankelijk van een voorwaarde.
  • RETURN, beëindigt de indicator na de tekenaanroepen.