English
Jetzt beitreten
Befehle/probuilder

ColorBetween

ColorBetween füllt in ProBuilder-Charts die Fläche zwischen zwei Kurven oder Werten mit einer Farbe. Definieren Sie die Füllung mit RGB-Komponenten oder einem benannten Farbwert und Alpha.

Syntax

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

Mit einem benannten Farbwert:

probuilder
ColorBetween(value1, value2, colorName, a)

Parameter

NameTypStandardBeschreibung
value1numerischerforderlichErste Grenze der gefüllten Zone.
value2numerischerforderlichZweite Grenze der gefüllten Zone.
r, g, bGanzzahl 0 bis 255in RGB-Form erforderlichRot-, Grün- und Blau-Komponenten der Füllfarbe.
colorNameZeichenkettein benannter Form erforderlichVordefinierter Farbname wie "red" oder "blue", anstelle von RGB verwendet.
aGanzzahl 0 bis 100deckendTransparenz, 0 vollständig transparent bis 100 vollständig deckend.

So funktioniert es

ColorBetween schattiert auf jedem Bar das vertikale Band zwischen zwei Werten. Wenn die beiden Werte Indikatorkurven sind, fügen sich die schattierten Bänder über die Bars hinweg zu einer durchgehenden gefüllten Fläche zusammen, was die übliche Art ist, den Spread zwischen zwei gleitenden Durchschnitten, das Innere eines Kanals oder den Abstand zwischen Kurs und einer Referenzlinie zu visualisieren.

Die Reihenfolge der beiden Grenzwerte hat keine Bedeutung; die Zone zwischen ihnen wird in jedem Fall gefüllt. Was häufig eine Rolle spielt, ist der bedingte Aufruf der Funktion: ColorBetween-Aufrufe in IF-Blöcke zu fassen, erlaubt es der Füllfarbe, einen Zustand zu kodieren, zum Beispiel grün, wenn der schnelle Durchschnitt über dem langsamen liegt, und andernfalls rot.

Die Füllung liegt über dem Standard-Chart-Hintergrund, aber Farbbefehle, die später im Skript ausgeführt werden, können sie im selben Bereich überschreiben. Die Transparenz wird auf einer Skala von 0 bis 100 angegeben, und moderate Werte um 50 halten die Kerzen durch die Füllung hindurch lesbar.

ColorBetween gehört zum Zeichenwerkzeugsatz für Indikatoren. In ProScreener hat es keine Wirkung, und Strategiecode in ProBacktest und ProOrder zeichnet keine Chart-Füllungen; visueller Kontext für eine Strategie wird normalerweise hinzugefügt, indem ein Indikator mit den ColorBetween-Aufrufen an den Chart angehängt wird.

Beispiele

Beispiel 1, Schattierung des Abstands zwischen zwei gleitenden Durchschnitten (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

Die Fläche zwischen einem 7-Perioden- und einem 20-Perioden-Durchschnitt wird grün schattiert, solange der schnelle Durchschnitt vorn liegt, und rot, solange er zurückliegt, wodurch das aktuelle Regime auf einen Blick erkennbar wird.

Beispiel 2, Füllen eines Bollinger-Kanals (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.

Beispiel 3, Hervorhebung der Kursabweichung von seinem Durchschnitt (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"

Die Füllung erscheint nur auf bars, auf denen der Kurs mehr als zwei ATRs von seinem exponentiellen Durchschnitt entfernt ist, sodass die Schattierung selbst als Signal für eine Überdehnung dient.

Häufige Fehler und Stolperfallen

  • Alpha läuft von 0 bis 100. Die Transparenz von ColorBetween verwendet eine Skala von 0 bis 100, anders als das Alpha von COLOURED, das von 0 bis 255 läuft. Das Übertragen eines Deckkraftwerts von 255 erzeugt ein Argument außerhalb des gültigen Bereichs.
  • Darstellung nur in Indikatoren. Die Funktion zeichnet in ProScreener-, ProBacktest- oder ProOrder-Code nichts. Hängen Sie stattdessen einen Indikator mit der ColorBetween-Logik an den Chart an.
  • Spätere Farben gewinnen. Nachfolgende Farbbefehle im selben Skript können die gefüllte Zone übermalen. Ordnen Sie die Zeichenaufrufe bewusst an, wenn Sie Füllungen, Hintergründe und farbige Kurven kombinieren.
  • Füllungen ohne sichtbare Kurven. 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ärbt eine zurückgegebene Kurve, statisch oder bedingungsabhängig.
  • BACKGROUNDCOLOR, färbt den gesamten Chart-Hintergrund Bar für Bar.
  • FILLCOLOR, Steuerung der Füllfarbe für gezeichnete Formen.
  • DRAWRECTANGLE, zeichnet ein Rechteck zwischen expliziten Koordinaten.
  • Average, gleitender Durchschnitt, eine typische Füllgrenze.
  • BollingerUp, oberes Bollinger-Band, als Zonengrenze verwendbar.
  • BollingerDown, unteres Bollinger-Band, als Zonengrenze verwendbar.
  • RETURN, stellt die Kurven dar, die eine Füllung üblicherweise begleitet.