COLOURED

Sintaxis

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

Con transparencia (versión 10.3 de la plataforma y posteriores):

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

Coloreado dinámico determinado por una variable:

RETURN value COLOURED BY (variable)

Parámetros

Cómo funciona

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 dinámica, COLOURED BY, colorea cada segmento de la curva según una variable determinante calculada antes en el script. A medida que la variable cambia de valor de un bar a otro, la línea trazada cambia de color a lo largo de su recorrido. El patrón habitual calcula una variable de estado, por ejemplo 1 mientras una media rápida está por encima de una lenta y -1 en caso contrario, y deja que la curva cambie de color en cada cambio de régimen.

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.

Ejemplos

Ejemplo 1, Media lenta coloreada por tendencia (Indicador)

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 de 50 periodos se dibuja en un color mientras la media de 10 periodos está por encima de ella y cambia a otro cuando la relación se invierte, codificando la dirección de la tendencia directamente en la línea.

Ejemplo 2, Color fijo para una curva de referencia (Indicador)

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

Un color RGB estático distingue la media de largo plazo de las otras líneas del gráfico sin depender de la asignación automática de colores de la plataforma.

Ejemplo 3, Línea de oscilador semitransparente (Indicador)

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

El cuarto argumento fija el alfa en 128 de 255, por lo que el oscilador sigue siendo visible sin dominar nada de lo trazado por debajo de él.

Errores y trampas habituales

• La escala del alfa difiere de la de ColorBetween. La opacidad de COLOURED va de 0 a 255, mientras que ColorBetween utiliza de 0 a 100. Reutilizar un valor entre las dos funciones altera la transparencia prevista.
• El alfa necesita la versión 10.3 o posterior. La forma de cuatro argumentos falla en versiones antiguas de la plataforma. La forma RGB de tres argumentos funciona en todas partes.
• Grafía británica. La palabra clave se escribe COLOURED, tal como está documentado. Escribirla COLORED es el error tipográfico más habitual cuando parece que la función no existe.
• Solo presentación. COLOURED cambia cómo se dibuja la curva, no sus valores. La lógica condicional basada en el color es imposible; en su lugar, basa las condiciones en la variable subyacente.

Instrucciones relacionadas

• ColorBetween, rellena con un color el área entre dos curvas.
• BACKGROUNDCOLOR, colorea el fondo del gráfico bar a bar.
• FILLCOLOR, control del color de relleno para las formas dibujadas.
• RETURN, emite los valores que COLOURED decora.
• DRAWTEXT, imprime texto en el gráfico, otra herramienta de presentación.
• STYLE, establece el estilo y el grosor de línea de las curvas trazadas.
• Average, media móvil, un objetivo frecuente del coloreado condicional.
• RSI, oscilador que a menudo se traza con colores personalizados.