COLOURED

Syntaks

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

Med gjennomsiktighet (plattformversjon 10.3 og nyere):

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

Dynamisk fargelegging styrt av en variabel:

RETURN value COLOURED BY (variable)

Parametere

Slik fungerer 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 dynamiske formen, COLOURED BY, farger hvert segment av kurven etter en styrende variabel beregnet tidligere i skriptet. Når variabelen endrer verdi fra bar til bar, skifter den plottede linjen farge langs sin lengde. Det vanlige mønsteret beregner en tilstandsvariabel, for eksempel 1 mens et raskt gjennomsnitt er over et langsomt og -1 ellers, og lar kurven snu farge ved hvert regimeskifte.

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.

Eksempler

Eksempel 1, Trendfarget langsomt gjennomsnitt (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-periodes gjennomsnittet tegnes i én farge mens det 10-periodes gjennomsnittet ligger over det, og skifter til en annen når forholdet snur, slik at trendretningen kodes direkte på linjen.

Eksempel 2, Fast farge for en referansekurve (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-farge skiller det langsiktige gjennomsnittet fra andre linjer i diagrammet uten å være avhengig av plattformens automatiske fargetildeling.

Eksempel 3, Halvgjennomsiktig oscillatorlinje (Indikator)

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

Den fjerde parameteren setter alfa til 128 av 255, slik at oscillatoren forblir synlig uten å dominere noe som er plottet under den.

Vanlige feil og fallgruver

• Alfaskalaen er ikke den samme som i ColorBetween. Opasitet i COLOURED går fra 0 til 255, mens ColorBetween bruker 0 til 100. Å gjenbruke en verdi mellom de to funksjonene forskyver den tilsiktede gjennomsiktigheten.
• Alfa krever versjon 10.3 eller nyere. Formen med fire parametere feiler på eldre plattformversjoner. RGB-formen med tre parametere virker overalt.
• Britisk staving. Nøkkelordet skrives COLOURED, slik det er dokumentert. Å skrive det COLORED er den vanligste skrivefeilen når funksjonen ser ut til ikke å finnes.
• Kun presentasjon. COLOURED endrer hvordan kurven tegnes, ikke verdiene. Betinget logikk basert på farge er umulig; bygg i stedet betingelsene på den underliggende variabelen.

Relaterte instruksjoner

• ColorBetween, fyller området mellom to kurver med en farge.
• BACKGROUNDCOLOR, farger diagrambakgrunnen bar for bar.
• FILLCOLOR, kontroll av fyllfarge for tegnede former.
• RETURN, sender ut verdiene som COLOURED dekorerer.
• DRAWTEXT, skriver tekst i diagrammet, et annet presentasjonsverktøy.
• STYLE, angir linjestil og tykkelse på plottede kurver.
• Average, glidende gjennomsnitt, et vanlig mål for betinget fargelegging.
• RSI, oscillator som ofte plottes med egendefinerte farger.