COLOURED

Syntax

RETURN value COLOURED(R, G, B)
RETURN value COLOURED("colorname")

Mit Transparenz (Plattformversion 10.3 und höher):

RETURN value COLOURED(R, G, B, alpha)

Dynamische Färbung, gesteuert durch eine Variable:

RETURN value COLOURED BY (variable)

Parameter

So funktioniert es

COLOURED attaches color information to a value emitted by RETURN. In its static form, the whole curve takes one fixed color, defined either by three RGB components or by a predefined color name. From platform version 10.3 an optional fourth argument controls opacity on a 0 to 255 scale, allowing semi-transparent lines that do not obscure price.

Die dynamische Form, COLOURED BY, färbt jedes Segment der Kurve entsprechend einer steuernden Variablen, die vorher im Skript berechnet wurde. Wenn die Variable ihren Wert von Bar zu Bar ändert, wechselt die dargestellte Linie über ihre Länge hinweg die Farbe. Das übliche Muster berechnet eine Zustandsvariable, zum Beispiel 1, solange ein schneller Durchschnitt über einem langsamen liegt, und andernfalls -1, und lässt die Kurve bei jedem Regimewechsel die Farbe umschlagen.

COLOURED modifies presentation only. The returned values are unchanged, and scripts that CALL the indicator receive the same numbers regardless of coloring. Because the mechanism rides on RETURN, it belongs to indicator code; strategy and screener programs do not plot curves and have no use for it.

Beispiele

Beispiel 1, Trendgefärbter langsamer Durchschnitt (Indikator)

i1 = average[10](close)
i2 = average[50](close)
// State variable: 1 when the fast average leads, -1 otherwise
IF i1 > i2 THEN
  a = 1
ELSE
  a = -1
ENDIF
RETURN i2 COLOURED BY (a)

Der 50-Perioden-Durchschnitt wird in einer Farbe gezeichnet, solange der 10-Perioden-Durchschnitt darüber liegt, und wechselt zu einer anderen, wenn sich das Verhältnis umkehrt, wodurch die Trendrichtung direkt auf der Linie kodiert wird.

Beispiel 2, Feste Farbe für eine Referenzkurve (Indikator)

// Plot a 200-period average in a fixed orange
longTermMA = average[200](close)
RETURN longTermMA COLOURED(255, 140, 0) AS "MA 200"

Eine statische RGB-Farbe unterscheidet den langfristigen Durchschnitt von anderen Linien im Chart, ohne von der automatischen Farbzuweisung der Plattform abhängig zu sein.

Beispiel 3, Halbtransparente Oszillatorlinie (Indikator)

// RSI drawn dark blue at roughly half opacity
r = RSI[14](close)
RETURN r COLOURED(0, 0, 139, 128) AS "RSI 14"

Das vierte Argument setzt Alpha auf 128 von 255, sodass der Oszillator sichtbar bleibt, ohne das darunter Dargestellte zu dominieren.

Häufige Fehler und Stolperfallen

• Die Alpha-Skala unterscheidet sich von ColorBetween. Die Deckkraft von COLOURED läuft von 0 bis 255, während ColorBetween 0 bis 100 verwendet. Die Wiederverwendung eines Werts zwischen den beiden Funktionen verschiebt die beabsichtigte Transparenz.
• Alpha erfordert Version 10.3 oder höher. Die Form mit vier Argumenten schlägt auf älteren Plattformversionen fehl. Die RGB-Form mit drei Argumenten funktioniert überall.
• Britische Schreibweise. Das Schlüsselwort wird COLOURED geschrieben, wie dokumentiert. Die Schreibweise COLORED ist der häufigste Tippfehler, wenn die Funktion scheinbar nicht existiert.
• Nur Darstellung. COLOURED ändert, wie die Kurve gezeichnet wird, nicht ihre Werte. Bedingte Logik auf Basis der Farbe ist nicht möglich; stützen Sie Bedingungen stattdessen auf die zugrunde liegende Variable.

Verwandte Befehle

• ColorBetween, füllt die Fläche zwischen zwei Kurven mit einer Farbe.
• BACKGROUNDCOLOR, färbt den Chart-Hintergrund Bar für Bar.
• FILLCOLOR, Steuerung der Füllfarbe für gezeichnete Formen.
• RETURN, gibt die Werte aus, die COLOURED gestaltet.
• DRAWTEXT, schreibt Text auf den Chart, ein weiteres Darstellungswerkzeug.
• STYLE, legt Linienstil und Strichstärke dargestellter Kurven fest.
• Average, gleitender Durchschnitt, ein häufiges Ziel für bedingte Färbung.
• RSI, Oszillator, der häufig mit eigenen Farben dargestellt wird.