English
Únete hoy
Gráficos/probuilder

DRAWCANDLE

DRAWCANDLE en ProBuilder dibuja una vela OHLC personalizada a partir de los valores open, high, low y close, con cuerpo COLOURED y BORDERCOLOR opcionales. Sintaxis y ejemplos.

Sintaxis

probuilder
DRAWCANDLE(open, high, low, close) COLOURED(R, G, B) BORDERCOLOR(R, G, B)

Parámetros

NombreTipoPor defectoDescripción
openprecioobligatorioValor de apertura del cuerpo de la vela.
highprecioobligatorioValor más alto, el extremo de la mecha superior.
lowprecioobligatorioValor más bajo, el extremo de la mecha inferior.
closeprecioobligatorioValor de cierre del cuerpo de la vela.
R, G, B (COLOURED)enterovalor por defecto de la plataformaComponentes del color de relleno del cuerpo, 0 a 255.
R, G, B (BORDERCOLOR)enterovalor por defecto de la plataformaComponentes del color del borde, de 0 a 255.

Cómo funciona

DRAWCANDLE se ejecuta dentro de un indicador ProBuilder. Dibuja una vela en el bar actual a partir de los cuatro valores que recibe, que pueden ser constantes, variables o expresiones en lugar del precio en bruto. Esto la convierte en una forma de representar una serie de velas derivada, como una vela suavizada o de estilo Heikin-Ashi, sobre el precio o junto a él. La vela se dibuja una vez por cada bar en el que se llama, por lo que no hace falta un argumento de índice de bar.

COLOURED define el relleno del cuerpo y BORDERCOLOR define el contorno. Cuando se omiten ambos se aplican los colores por defecto de la plataforma.

Ejemplos

Ejemplo 1, Velas Heikin-Ashi suavizadas (Indicador)

probuilder
// Build averaged Heikin-Ashi candles and colour by direction
period = 20
IF BarIndex > period THEN
    avgO = Average[period](open)
    avgH = Average[period](high)
    avgL = Average[period](low)
    avgC = Average[period](close)
    HAClose = (avgO + avgH + avgL + avgC) / 4
    HAOpen = (HAOpen[1] + HAClose[1]) / 2
    HAHigh = MAX(avgH, MAX(HAOpen, HAClose))
    HALow = MIN(avgL, MIN(HAOpen, HAClose))
    IF avgO <= avgC THEN
        DRAWCANDLE(HAOpen, HAHigh, HALow, HAClose) COLOURED(0, 255, 0)
    ELSE
        DRAWCANDLE(HAOpen, HAHigh, HALow, HAClose) COLOURED(255, 0, 0)
    ENDIF
ENDIF
RETURN

La vela es verde cuando la apertura promediada se sitúa en o por debajo del cierre promediado, y roja en caso contrario.

Ejemplo 2, Una vela en bruto recoloreada (Indicador)

probuilder
// Redraw the current candle in a fixed colour
DRAWCANDLE(open, high, low, close) COLOURED(0, 120, 255) BORDERCOLOR(0, 0, 0)
RETURN

Pasar los valores OHLC en bruto reproduce la barra con el relleno y el borde elegidos.

Ejemplo 3, Vela a partir de una serie desplazada (Indicador)

probuilder
// Draw a candle offset up by a fixed amount for comparison
off = 10 * pointsize
DRAWCANDLE(open + off, high + off, low + off, close + off) COLOURED(200, 200, 0)
RETURN

Desplazar cada valor con el mismo offset coloca una vela de comparación por encima del precio.

Errores y trampas habituales

  • Solo en indicadores. DRAWCANDLE no tiene efecto en ProScreener, ProOrder ni ProBacktest. Resérvalo para un indicador de ProBuilder.
  • Orden de los argumentos. El orden es open, high, low, close. Intercambiar high y low, u open y close, dibuja una vela mal formada.
  • Sin argumento de índice de bar. La vela se dibuja en la barra en la que se ejecuta la llamada, por lo que se sitúa según el punto del bucle en el que se ejecuta, no por una coordenada x.
  • El open recursivo necesita una protección. Las aperturas de estilo Heikin-Ashi hacen referencia a HAOpen[1], así que condiciona el bloque con un BarIndex comprobación para evitar un primer valor indefinido.
  • DRAWBARCHART, dibuja una barra OHLC personalizada en lugar de una vela.
  • Open, la fuente del precio de apertura.
  • High, la fuente del precio máximo.
  • Low, la fuente del precio mínimo.
  • Close, la fuente del precio de cierre.
  • COLOURED, establece el color del cuerpo.
  • DrawOnLastBarOnly, limita el dibujo al último bar.
  • Average, suaviza los valores OHLC antes de dibujar.