COLOURED

Sintassi

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

Con trasparenza (versione 10.3 della piattaforma e successive):

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

Colorazione dinamica guidata da una variabile:

RETURN value COLOURED BY (variable)

Parametri

Come funziona

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.

La forma dinamica, COLOURED BY, colora ogni segmento della curva in base a una variabile guida calcolata prima nello script. Quando la variabile cambia valore da una bar all'altra, la linea tracciata cambia colore lungo la sua estensione. Il pattern comune calcola una variabile di stato, per esempio 1 mentre una media rapida è sopra una lenta e -1 altrimenti, e lascia che la curva cambi colore a ogni cambio di regime.

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.

Esempi

Esempio 1, Media lenta colorata in base al trend (Indicatore)

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)

La media a 50 periodi è disegnata di un colore mentre la media a 10 periodi è sopra di essa e passa a un altro quando la relazione si inverte, codificando la direzione del trend direttamente sulla linea.

Esempio 2, Colore fisso per una curva di riferimento (Indicatore)

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

Un colore RGB statico distingue la media di lungo periodo dalle altre linee del grafico senza dipendere dall'assegnazione automatica dei colori della piattaforma.

Esempio 3, Linea dell'oscillatore semitrasparente (Indicatore)

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

Il quarto argomento imposta l'alpha a 128 su 255, così l'oscillatore resta visibile senza dominare ciò che è tracciato al di sotto.

Errori e insidie comuni

• La scala dell'alpha è diversa da quella di ColorBetween. L'opacità di COLOURED va da 0 a 255, mentre ColorBetween usa da 0 a 100. Riutilizzare un valore tra le due funzioni altera la trasparenza desiderata.
• L'alpha richiede la versione 10.3 o successiva. La forma a quattro argomenti non funziona sulle versioni più vecchie della piattaforma. La forma RGB a tre argomenti funziona ovunque.
• Grafia britannica. La parola chiave si scrive COLOURED, come documentato. Scriverla COLORED è l'errore di battitura più comune quando la funzione sembra non esistere.
• Solo presentazione. COLOURED cambia il modo in cui la curva viene disegnata, non i suoi valori. Una logica condizionale basata sul colore è impossibile; basa invece le condizioni sulla variabile sottostante.

Istruzioni correlate

• ColorBetween, riempie con un colore l'area tra due curve.
• BACKGROUNDCOLOR, colora lo sfondo del grafico bar per bar.
• FILLCOLOR, controllo del colore di riempimento per le forme disegnate.
• RETURN, emette i valori che COLOURED decora.
• DRAWTEXT, stampa testo sul grafico, un altro strumento di presentazione.
• STYLE, imposta stile e spessore delle linee delle curve tracciate.
• Average, media mobile, un obiettivo frequente per la colorazione condizionale.
• RSI, oscillatore spesso tracciato con colori personalizzati.