English
Únete hoy
Gráficos/probuilder

BACKGROUNDCOLOR

BACKGROUNDCOLOR en ProBuilder tiñe el fondo del gráfico bar a bar mediante RGB y un valor alfa, para resaltar condiciones en un indicador. Sintaxis y ejemplos.

Sintaxis

probuilder
BACKGROUNDCOLOR(R, G, B, a)

Parámetros

NombreTipoPor defectoDescripción
RenteroobligatorioComponente rojo del color, de 0 a 255.
GenteroobligatorioComponente verde del color, de 0 a 255.
BenteroobligatorioComponente azul del color, de 0 a 255.
aenteroobligatorioAlfa (transparencia), de 0 totalmente transparente a 255 totalmente opaco.

Cómo funciona

BACKGROUNDCOLOR se ejecuta dentro de un indicador ProBuilder. En cada bar en el que se llama establece el color del fondo del gráfico detrás de ese bar. Como se aplica por bar, normalmente se gobierna con una condición, de modo que se sombrean tramos de bars para marcar un régimen, la superación de un umbral o un sesgo direccional.

Un valor alfa moderado mantiene legible el tinte detrás de los bars de precio. Los colores se indican como componentes RGB, el mismo modelo aditivo que usan COLOURED y FILLCOLOR. A diferencia de FILLCOLOR, que rellena un objeto dibujado, BACKGROUNDCOLOR tiñe toda la columna de fondo en esa barra.

Ejemplos

Ejemplo 1, Sombrear según el sesgo del estocástico (Indicador)

probuilder
// Green background while bullish, red while bearish
sto = Stochastic[10,3](close)
signal = Average[5](sto)
rge = AverageTrueRange[10](close)
IF sto[1] > 80 AND sto CROSSES UNDER signal THEN
    DRAWARROWDOWN(BarIndex[1], high[1] + rge/2) COLOURED(255, 10, 10)
    direction = -1
ELSIF sto[1] < 20 AND sto CROSSES OVER signal THEN
    DRAWARROWUP(BarIndex[1], low[1] - rge/2) COLOURED(10, 255, 10)
    direction = 1
ENDIF
IF direction > 0 THEN
    BACKGROUNDCOLOR(10, 255, 10, 100)
ELSE
    BACKGROUNDCOLOR(255, 10, 10, 100)
ENDIF
RETURN

El direction variable arrastra la última señal, por lo que el fondo se mantiene verde o rojo hasta el siguiente cruce.

Ejemplo 2, Resaltar una zona de sobrecompra (Indicador)

probuilder
// Tint the background when RSI is above 70
IF RSI[14] > 70 THEN
    BACKGROUNDCOLOR(255, 200, 200, 120)
ENDIF
RETURN

Solo se sombrean los bars en sobrecompra, con opacidad parcial.

Ejemplo 3, Marcar una ventana de sesión (Indicador)

probuilder
// Light blue background during the morning hours
IF OpenTime >= 090000 AND OpenTime < 120000 THEN
    BACKGROUNDCOLOR(200, 220, 255, 100)
ENDIF
RETURN

El tinte abarca los bars dentro de la ventana temporal elegida.

Errores y trampas habituales

  • Solo en indicadores. BACKGROUNDCOLOR no tiene efecto en ProScreener, ProOrder ni ProBacktest. Resérvalo para un indicador de ProBuilder.
  • Por bar, no una sola vez. Solo colorea el bar en el que se ejecuta. Para sombrear una serie de bars, hay que llamarlo en cada uno de ellos, normalmente mediante una condición.
  • El alfa importa. Un alfa alto oculta los bars de precio. Usa un valor moderado para que las velas sigan visibles.
  • Mantén el estado. Para mantener un color hasta la siguiente señal, guarda el sesgo en una variable, como en el Ejemplo 1, en lugar de colorear solo el bar de la señal.
  • FILLCOLOR, rellena un objeto dibujado en lugar de todo el fondo.
  • COLOURED, establece el color de las líneas y los dibujos.
  • ColorBetween, sombrea el área entre dos series.
  • DRAWARROWUP, una flecha que combina con un tinte de fondo.
  • DRAWARROWDOWN, una flecha que combina con un tinte de fondo.
  • DrawOnLastBarOnly, restringe otros dibujos al último bar.
  • IF, condiciona el color a una condición.
  • RETURN, finaliza el indicador después de las llamadas de dibujo.