COLOURED

Syntaxis

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

Met transparantie (platformversie 10.3 en later):

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

Dynamische kleuring gestuurd door een variabele:

RETURN value COLOURED BY (variable)

Parameters

Hoe het werkt

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.

De dynamische vorm, COLOURED BY, kleurt elk segment van de curve volgens een sturende variabele die eerder in het script is berekend. Terwijl de variabele van bar tot bar van waarde verandert, verandert de geplotte lijn over zijn lengte van kleur. Het gangbare patroon berekent een toestandsvariabele, bijvoorbeeld 1 zolang een snel gemiddelde boven een langzaam ligt en anders -1, en laat de curve bij elke regimewissel van kleur omslaan.

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.

Voorbeelden

Voorbeeld 1, Langzaam gemiddelde gekleurd naar trend (Indicator)

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)

Het gemiddelde over 50 periodes wordt in één kleur getekend zolang het gemiddelde over 10 periodes erboven ligt en schakelt over naar een andere kleur wanneer de verhouding omkeert, waardoor de trendrichting direct op de lijn te zien is.

Voorbeeld 2, Vaste kleur voor een referentiecurve (Indicator)

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

Een statische RGB-kleur onderscheidt het langetermijngemiddelde van andere lijnen op de grafiek zonder afhankelijk te zijn van de automatische kleurtoewijzing van het platform.

Voorbeeld 3, Halftransparante oscillatorlijn (Indicator)

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

Het vierde argument zet alpha op 128 van 255, zodat de oscillator zichtbaar blijft zonder te domineren over wat eronder is geplot.

Veelvoorkomende fouten en valkuilen

• De alphaschaal wijkt af van die van ColorBetween. De dekking van COLOURED loopt van 0 tot 255, terwijl ColorBetween 0 tot 100 gebruikt. Een waarde tussen de twee functies hergebruiken verschuift de bedoelde transparantie.
• Alpha vereist versie 10.3 of later. De vorm met vier argumenten werkt niet op oudere platformversies. De RGB-vorm met drie argumenten werkt overal.
• Britse spelling. Het keyword wordt geschreven als COLOURED, zoals gedocumenteerd. Het spellen als COLORED is de meest voorkomende typefout wanneer de functie niet lijkt te bestaan.
• Alleen presentatie. COLOURED verandert hoe de curve wordt getekend, niet zijn waarden. Voorwaardelijke logica op basis van kleur is onmogelijk; baseer voorwaarden in plaats daarvan op de onderliggende variabele.

Gerelateerde instructies

• ColorBetween, vult het gebied tussen twee curves met een kleur.
• BACKGROUNDCOLOR, kleurt de achtergrond van de grafiek bar voor bar.
• FILLCOLOR, regelt de vulkleur van getekende vormen.
• RETURN, geeft de waarden uit die COLOURED opmaakt.
• DRAWTEXT, drukt tekst af op de grafiek, nog een presentatiemiddel.
• STYLE, stelt lijnstijl en dikte van geplotte curves in.
• Average, moving average, een veelvoorkomend doel voor voorwaardelijke kleuring.
• RSI, oscillator die vaak met eigen kleuren wordt geplot.