COLOURED

Syntax

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

Med transparens (plattformsversion 10.3 och senare):

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

Dynamisk färgläggning styrd av en variabel:

RETURN value COLOURED BY (variable)

Parametrar

Så fungerar det

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.

Den dynamiska formen, COLOURED BY, färgar varje segment av kurvan enligt en styrande variabel som beräknas tidigare i skriptet. När variabeln ändrar värde från bar till bar ändrar den ritade linjen färg längs sin längd. Det vanliga mönstret beräknar en tillståndsvariabel, till exempel 1 medan ett snabbt medelvärde ligger över ett långsamt och -1 annars, och låter kurvan byta färg vid varje regimskifte.

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.

Exempel

Exempel 1, Trendfärgat långsamt medelvärde (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)

Det 50-periods medelvärdet ritas i en färg medan det 10-periods medelvärdet ligger över det och byter till en annan när förhållandet inverteras, vilket kodar trendriktningen direkt på linjen.

Exempel 2, Fast färg för en referenskurva (Indikator)

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

En statisk RGB-färg skiljer det långsiktiga medelvärdet från andra linjer i diagrammet utan att bero på plattformens automatiska färgtilldelning.

Exempel 3, Halvtransparent oscillatorlinje (Indikator)

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

Det fjärde argumentet sätter alpha till 128 av 255, så att oscillatorn förblir synlig utan att dominera något som ritas under den.

Vanliga fel och fallgropar

• Alpha-skalan skiljer sig från ColorBetween. COLOURED-opaciteten går från 0 till 255, medan ColorBetween använder 0 till 100. Att återanvända ett värde mellan de två funktionerna förskjuter den avsedda transparensen.
• Alpha kräver version 10.3 eller senare. Formen med fyra argument fungerar inte på äldre plattformsversioner. RGB-formen med tre argument fungerar överallt.
• Brittisk stavning. Nyckelordet skrivs COLOURED, enligt dokumentationen. Att stava det COLORED är det vanligaste skrivfelet när funktionen verkar saknas.
• Endast presentation. COLOURED ändrar hur kurvan ritas, inte dess värden. Villkorslogik baserad på färg är omöjlig; basera i stället villkoren på den underliggande variabeln.

Relaterade instruktioner

• ColorBetween, fyller området mellan två kurvor med en färg.
• BACKGROUNDCOLOR, färgar diagrammets bakgrund bar för bar.
• FILLCOLOR, kontroll av fyllnadsfärg för ritade former.
• RETURN, returnerar de värden som COLOURED dekorerar.
• DRAWTEXT, skriver ut text i diagrammet, ett annat presentationsverktyg.
• STYLE, ställer in linjestil och tjocklek på ritade kurvor.
• Average, glidande medelvärde, ett vanligt mål för villkorlig färgläggning.
• RSI, oscillator som ofta ritas med egna färger.