ColorBetween

Syntaxis

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

Met een benoemde kleur:

ColorBetween(value1, value2, colorName, a)

Parameters

Hoe het werkt

ColorBetween arceert op elke bar de verticale band tussen twee waarden. Wanneer de twee waarden indicatorcurves zijn, voegen de gearceerde banden zich over de bars samen tot een doorlopend gevuld gebied, wat de gebruikelijke manier is om de spread tussen twee moving averages, de binnenkant van een kanaal of de afstand tussen prijs en een referentielijn te visualiseren.

De volgorde van de twee grenswaarden heeft geen betekenis; de zone ertussen wordt in beide gevallen gevuld. Wat vaak wel uitmaakt is de functie voorwaardelijk aanroepen: door ColorBetween-aanroepen in IF-blokken te zetten kan de vulkleur een toestand weergeven, bijvoorbeeld groen wanneer het snelle gemiddelde boven het langzame ligt en anders rood.

De vulling wordt boven de standaard grafiekachtergrond gelegd, maar kleurinstructies die later in het script worden uitgevoerd kunnen hem in hetzelfde gebied overschrijven. De transparantie wordt opgegeven op een schaal van 0 tot 100, en gematigde waarden rond 50 houden de candles door de vulling heen leesbaar.

ColorBetween hoort bij de tekengereedschappen voor indicatoren. Het heeft geen effect in ProScreener, en strategiecode in ProBacktest en ProOrder rendert geen grafiekvullingen; visuele context voor een strategie wordt normaal toegevoegd door een indicator met de ColorBetween-aanroepen aan de grafiek te koppelen.

Voorbeelden

Voorbeeld 1, De afstand tussen twee moving averages arceren (Indicator)

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

Het gebied tussen een gemiddelde over 7 periodes en een over 20 periodes wordt groen gearceerd zolang het snelle gemiddelde voorop loopt en rood zolang het achterblijft, waardoor het huidige regime in één oogopslag leesbaar is.

Voorbeeld 2, Een Bollinger-kanaal vullen (Indicator)

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.

Voorbeeld 3, De afwijking van de prijs ten opzichte van zijn gemiddelde markeren (Indicator)

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"

De vulling verschijnt alleen op bars waar de prijs meer dan twee ATR's van zijn exponentiële gemiddelde is afgeweken, zodat de arcering zelf als signaal van overextensie werkt.

Veelvoorkomende fouten en valkuilen

• Alpha loopt van 0 tot 100. De transparantie van ColorBetween gebruikt een schaal van 0 tot 100, in tegenstelling tot de alpha van COLOURED die van 0 tot 255 loopt. Een dekkingswaarde van 255 overnemen levert een argument buiten het bereik op.
• Rendering alleen in indicatoren. De functie tekent niets in ProScreener-, ProBacktest- of ProOrder-code. Koppel in plaats daarvan een indicator met de ColorBetween-logica aan de grafiek.
• Latere kleuren winnen. Latere kleurinstructies in hetzelfde script kunnen over de gevulde zone heen schilderen. Zet de tekenaanroepen bewust op volgorde wanneer je vullingen, achtergronden en gekleurde curves combineert.
• Vullingen zonder zichtbare curves. 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.

Gerelateerde instructies

• COLOURED, kleurt een teruggegeven curve, statisch of op voorwaarde.
• BACKGROUNDCOLOR, kleurt de volledige achtergrond van de grafiek per bar.
• FILLCOLOR, regelt de vulkleur van getekende vormen.
• DRAWRECTANGLE, tekent een rechthoek tussen expliciete coördinaten.
• Average, moving average, een typische vulgrens.
• BollingerUp, bovenste Bollinger band, te gebruiken als zonegrens.
• BollingerDown, onderste Bollinger band, te gebruiken als zonegrens.
• RETURN, plot de curves waar een vulling gewoonlijk bij hoort.