ColorBetween

Sintaxis

ColorBetween(value1, value2, r, g, b, a)

Con un color con nombre:

ColorBetween(value1, value2, colorName, a)

Parámetros

Cómo funciona

ColorBetween sombrea la banda vertical entre dos valores en cada bar. Cuando los dos valores son curvas de indicador, las bandas sombreadas se unen a lo largo de los bars formando una región rellena continua, que es la forma habitual de visualizar el spread entre dos medias móviles, el interior de un canal o la distancia entre el precio y una línea de referencia.

El orden de los dos valores límite no tiene significado; la zona entre ellos se rellena en cualquier caso. Lo que a menudo sí importa es llamar a la función de forma condicional: envolver las llamadas a ColorBetween en bloques IF permite que el color de relleno codifique un estado, por ejemplo verde cuando la media rápida está por encima de la lenta y rojo en caso contrario.

El relleno se superpone al fondo predeterminado del gráfico, pero las instrucciones de color que se ejecutan más tarde en el script pueden anularlo en la misma región. La transparencia se especifica en una escala de 0 a 100, y los valores moderados en torno a 50 mantienen las velas legibles a través del relleno.

ColorBetween pertenece al conjunto de herramientas de dibujo de los indicadores. No tiene efecto en ProScreener, y el código de estrategia en ProBacktest y ProOrder no representa rellenos en el gráfico; el contexto visual de una estrategia se añade normalmente adjuntando al gráfico un indicador que contenga las llamadas a ColorBetween.

Ejemplos

Ejemplo 1, Sombrear la diferencia entre dos medias móviles (Indicador)

ma1 = average[7]
ma2 = average[20]

IF ma1 > ma2 THEN
  ColorBetween(ma1, ma2, 0, 255, 0, 50) // green fill at 50 percent opacity
ELSE
  ColorBetween(ma1, ma2, "red", 50) // red fill at 50 percent opacity
ENDIF

RETURN

El área entre una media de 7 periodos y una de 20 periodos se sombrea en verde mientras la media rápida va por delante y en rojo mientras va por detrás, lo que hace legible de un vistazo el régimen actual.

Ejemplo 2, Rellenar un canal de Bollinger (Indicador)

upper = BollingerUp[20](close)
lower = BollingerDown[20](close)

// Light blue fill across the whole band
ColorBetween(upper, lower, 100, 149, 237, 25)

RETURN upper AS "Upper band", lower AS "Lower band"

A single ColorBetween call shades the full Bollinger channel with a faint fill, while the RETURN statement still plots the band boundaries as lines.

Ejemplo 3, Resaltar la extensión del precio respecto a su media (Indicador)

baseline = ExponentialAverage[50](close)
gap = ABS(close - baseline)
threshold = AverageTrueRange[14](close) * 2

// Shade only when price is stretched more than two ATRs from the baseline
IF gap > threshold THEN
  ColorBetween(close, baseline, 255, 165, 0, 60) // orange warning fill
ENDIF

RETURN baseline AS "EMA 50"

El relleno aparece solo en los bars en los que el precio está extendido más de dos ATR respecto a su media exponencial, por lo que el propio sombreado actúa como señal de sobreextensión.

Errores y trampas habituales

• El alfa va de 0 a 100. La transparencia de ColorBetween utiliza una escala de 0 a 100, a diferencia del alfa de COLOURED, que va de 0 a 255. Copiar un valor de opacidad de 255 de una a otra produce un argumento fuera de rango.
• Representación solo en indicadores. La función no dibuja nada en el código de ProScreener, ProBacktest ni ProOrder. En su lugar, adjunta al gráfico un indicador con la lógica de ColorBetween.
• Los colores posteriores prevalecen. Las instrucciones de color posteriores del mismo script pueden pintar sobre la zona rellena. Ordena las llamadas de dibujo de forma deliberada al combinar rellenos, fondos y curvas coloreadas.
• Rellenos sin curvas visibles. ColorBetween shades between values whether or not they are returned. Unless the boundary series are also plotted via RETURN, the fill appears to float, which is sometimes intended and sometimes a forgotten RETURN.

Instrucciones relacionadas

• COLOURED, colorea una curva devuelta, de forma estática o por condición.
• BACKGROUNDCOLOR, colorea todo el fondo del gráfico bar a bar.
• FILLCOLOR, control del color de relleno para las formas dibujadas.
• DRAWRECTANGLE, dibuja un rectángulo entre coordenadas explícitas.
• Average, media móvil, un límite de relleno típico.
• BollingerUp, banda de Bollinger superior, utilizable como límite de zona.
• BollingerDown, banda de Bollinger inferior, utilizable como límite de zona.
• RETURN, traza las curvas a las que suele acompañar un relleno.