English
Bli medlem idag
Instruktioner/probuilder

ColorBetween

ColorBetween fyller området mellan två kurvor eller värden med en färg i ProBuilder-diagram. Definiera fyllningen med RGB-komponenter eller en namngiven färg och alpha.

Syntax

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

Med en namngiven färg:

probuilder
ColorBetween(value1, value2, colorName, a)

Parametrar

NamnTypStandardBeskrivning
value1numeriskobligatoriskFörsta gränsen för den fyllda zonen.
value2numeriskobligatoriskAndra gränsen för den fyllda zonen.
r, g, bheltal 0 till 255obligatorisk i RGB-formRöd, grön och blå komponent i fyllningsfärgen.
colorNamesträngobligatorisk i namngiven formFördefinierat färgnamn såsom "red" eller "blue", som används i stället för RGB.
aheltal 0 till 100opakTransparens, 0 helt transparent till 100 helt opak.

Så fungerar det

ColorBetween skuggar det vertikala bandet mellan två värden på varje bar. När de två värdena är indikatorkurvor fogas de skuggade banden samman över barerna till ett sammanhängande fyllt område, vilket är det vanliga sättet att visualisera spread mellan två glidande medelvärden, insidan av en kanal eller avståndet mellan priset och en referenslinje.

Ordningen mellan de två gränsvärdena har ingen betydelse; zonen mellan dem fylls i båda fallen. Vad som ofta har betydelse är att anropa funktionen villkorligt: att lägga ColorBetween-anrop i IF-block gör att fyllningsfärgen kan koda tillstånd, till exempel grönt när det snabba medelvärdet ligger över det långsamma och rött annars.

Fyllningen läggs ovanpå diagrammets standardbakgrund, men färginstruktioner som körs senare i skriptet kan åsidosätta den i samma område. Transparensen anges på en skala från 0 till 100, och måttliga värden kring 50 håller ljusstakarna läsbara genom fyllningen.

ColorBetween hör till indikatorernas ritverktyg. Den har ingen effekt i ProScreener, och strategikod i ProBacktest och ProOrder renderar inte diagramfyllningar; visuell kontext för en strategi läggs normalt till genom att en indikator med ColorBetween-anropen kopplas till diagrammet.

Exempel

Exempel 1, Skugga avståndet mellan två glidande medelvärden (Indikator)

probuilder
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

Området mellan ett 7-periods och ett 20-periods medelvärde skuggas grönt när det snabba medelvärdet ligger före och rött när det ligger efter, vilket gör den aktuella regimen läsbar vid en snabb blick.

Exempel 2, Fylla en Bollinger-kanal (Indikator)

probuilder
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.

Exempel 3, Markera prisets utsträckning från sitt medelvärde (Indikator)

probuilder
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"

Fyllningen visas endast på barer där priset är utsträckt mer än två ATR från sitt exponentiella medelvärde, så skuggningen fungerar själv som en signal om överutsträckning.

Vanliga fel och fallgropar

  • Alpha går från 0 till 100. ColorBetween-transparensen använder en skala från 0 till 100, till skillnad från COLOURED-alpha som går från 0 till 255. Att kopiera över ett opacitetsvärde på 255 ger ett argument utanför det tillåtna intervallet.
  • Rendering endast i indikatorer. Funktionen ritar ingenting i kod för ProScreener, ProBacktest eller ProOrder. Koppla i stället en indikator med ColorBetween-logiken till diagrammet.
  • Senare färger vinner. Efterföljande färginstruktioner i samma skript kan måla över den fyllda zonen. Ordna ritanropen medvetet när du kombinerar fyllningar, bakgrunder och färgade kurvor.
  • Fyllningar utan synliga kurvor. 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.
  • COLOURED, färgar en returnerad kurva, statiskt eller enligt villkor.
  • BACKGROUNDCOLOR, färgar hela diagrammets bakgrund bar för bar.
  • FILLCOLOR, kontroll av fyllnadsfärg för ritade former.
  • DRAWRECTANGLE, ritar en rektangel mellan explicita koordinater.
  • Average, glidande medelvärde, en typisk fyllningsgräns.
  • BollingerUp, övre Bollinger-bandet, användbart som zongräns.
  • BollingerDown, nedre Bollinger-bandet, användbart som zongräns.
  • RETURN, ritar de kurvor som en fyllning vanligtvis följer.