DRAWELLIPSE
DRAWELLIPSE en ProBuilder dibuja una elipse dentro de un rectángulo delimitador definido por dos esquinas dadas como índice de barra y precio, con un color COLOURED opcional.
Sintaxis
DRAWELLIPSE(x1, y1, x2, y2) COLOURED(R, G, B, a)Parámetros
| Nombre | Tipo | Por defecto | Descripción |
|---|---|---|---|
x1 | entero | obligatorio | Coordenada X de la esquina superior izquierda del rectángulo delimitador, normalmente un índice de barra. |
y1 | precio | obligatorio | Coordenada Y de la esquina superior izquierda, un precio o un valor calculado. |
x2 | entero | obligatorio | Coordenada X de la esquina inferior derecha del rectángulo delimitador. |
y2 | precio | obligatorio | Coordenada Y de la esquina inferior derecha. |
R, G, B | entero | valor por defecto de la plataforma | Opcional COLOURED componentes rojo, verde y azul, de 0 a 255. |
a | entero | 255 | Alfa opcional (transparencia), de 0 totalmente transparente a 255 totalmente opaco. |
Cómo funciona
DRAWELLIPSE se ejecuta dentro de un indicador ProBuilder. Los dos pares de coordenadas (x1, y1) y (x2, y2) definen las esquinas superior izquierda e inferior derecha de un rectángulo delimitador, y la elipse queda inscrita en ese rectángulo. Las coordenadas x son índices de bar y las coordenadas y son precios, de modo que la figura abarca un tramo de tiempo y de precio. Esto sirve para rodear una zona de interés o un patrón sin alterar los datos subyacentes.
El opcional COLOURED define el color y la transparencia. Como con otros objetos de dibujo, los scripts suelen establecer DEFPARAM DrawOnLastBarOnly = true así la elipse se dibuja una sola vez.
Ejemplos
Ejemplo 1, Una única elipse de color (Indicador)
// Ellipse inside the box from (10, 20) to (50, 60), red at half opacity
DRAWELLIPSE(10, 20, 50, 60) COLOURED(255, 0, 0, 128)
RETURNConservado de la fuente: las esquinas definen el rectángulo delimitador y la elipse lo rellena, dibujada en rojo con un 50 por ciento de transparencia.
Ejemplo 2, Rodear un swing reciente (Indicador)
// Enclose the last 10 bars around the recent high
DEFPARAM DrawOnLastBarOnly = true
hh = Highest[10](high)
ll = Lowest[10](low)
DRAWELLIPSE(BarIndex-10, hh, BarIndex, ll) COLOURED(0, 120, 255, 150)
RETURNEl rectángulo delimitador abarca 10 barras y el rango reciente, por lo que la elipse marca ese swing.
Ejemplo 3, Elipse con relleno (Indicador)
// Blue outline with a light fill around the current bar
DEFPARAM DrawOnLastBarOnly = true
DRAWELLIPSE(BarIndex-3, high, BarIndex+3, low) COLOURED(0, 0, 200) FILLCOLOR(200, 220, 255)
RETURNFILLCOLOR sombrea el interior mientras COLOURED define el contorno.
Errores y trampas habituales
- Solo en indicadores.
DRAWELLIPSEno tiene efecto en ProScreener, ProOrder ni ProBacktest. Resérvalo para un indicador de ProBuilder. - Esquinas, no centro y radio. Los cuatro valores son dos esquinas opuestas de un rectángulo delimitador, no un punto central y radios.
- X es un índice de bar. Pasar un precio a
x1ox2coloca mal la figura en horizontal. UsaBarIndexo desplazamientos desde él. - Coste del redibujado. Sin
DrawOnLastBarOnly = true, la elipse se dibuja en cada bar y ralentiza el gráfico.
Instrucciones relacionadas
DRAWRECTANGLE, dibuja el propio rectángulo delimitador.DRAWTRIANGLE, dibuja una forma de tres vértices.DRAWPOINT, dibuja un único punto marcador.COLOURED, define el color del contorno y la transparencia.FILLCOLOR, define el color de relleno interior.DrawOnLastBarOnly, limita el dibujo al último bar por rendimiento.BarIndex, aporta las coordenadas x.Highest, encuentra el techo de un rango para encerrarlo.