Rejoignez-nous
Graphiques/probuilder

DRAWELLIPSE

DRAWELLIPSE en ProBuilder dessine une ellipse à l'intérieur d'un rectangle englobant défini par deux coins donnés sous forme d'indice de bar et de prix, avec une couleur COLOURED optionnelle.

Syntaxe

probuilder
DRAWELLIPSE(x1, y1, x2, y2) COLOURED(R, G, B, a)

Paramètres

NomTypePar défautDescription
x1entierrequisCoordonnée X du coin supérieur gauche du rectangle englobant, normalement un indice de bar.
y1prixrequisCoordonnée Y du coin supérieur gauche, un prix ou une valeur calculée.
x2entierrequisCoordonnée X du coin inférieur droit du rectangle englobant.
y2prixrequisCoordonnée Y du coin inférieur droit.
R, G, Bentiervaleur par défaut de la plateformeOptionnel COLOURED composantes rouge, verte et bleue, de 0 à 255.
aentier255Alpha optionnel (transparence), 0 totalement transparent à 255 totalement opaque.

Comment ça marche

DRAWELLIPSE s'exécute dans un indicateur ProBuilder. Les deux paires de coordonnées (x1, y1) et (x2, y2) définissent les coins supérieur gauche et inférieur droit d'un rectangle englobant, et l'ellipse est inscrite dans ce rectangle. Les coordonnées x sont des indices de bars et les coordonnées y des prix, la forme couvre donc à la fois une étendue de temps et de prix. C'est adapté pour entourer une zone d'intérêt ou une figure sans modifier les données sous-jacentes.

Le paramètre facultatif COLOURED clause définit la couleur et la transparence. Comme pour les autres objets de dessin, les scripts définissent couramment DEFPARAM DrawOnLastBarOnly = true pour que l'ellipse ne soit dessinée qu'une fois.

Exemples

Exemple 1, Une seule ellipse colorée (Indicateur)

probuilder
// Ellipse inside the box from (10, 20) to (50, 60), red at half opacity
DRAWELLIPSE(10, 20, 50, 60) COLOURED(255, 0, 0, 128)
RETURN

Conservé de la source : les coins définissent le rectangle englobant et l'ellipse le remplit, dessinée en rouge avec 50 pour cent de transparence.

Exemple 2, Entourer un swing récent (Indicateur)

probuilder
// 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)
RETURN

Le rectangle englobant couvre 10 bars et la plage récente, l'ellipse marque donc ce swing.

Exemple 3, Ellipse avec un remplissage (Indicateur)

probuilder
// 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)
RETURN

FILLCOLOR ombre l'intérieur tandis que COLOURED définit le contour.

Erreurs et pièges courants

  • Indicateur uniquement. DRAWELLIPSE n'a aucun effet dans ProScreener, ProOrder ou ProBacktest. Réservez-le à un indicateur ProBuilder.
  • Des coins, pas un centre et un rayon. Les quatre valeurs sont deux coins opposés d'un rectangle englobant, pas un point central et des rayons.
  • X est un indice de bar. Passer un prix à x1 ou x2 place mal la forme horizontalement. Utilisez BarIndex ou des décalages par rapport à celui-ci.
  • Coût du redessin. Sans DrawOnLastBarOnly = true, l'ellipse est tracée sur chaque bar et ralentit le graphique.
  • DRAWRECTANGLE, dessine le rectangle englobant lui-même.
  • DRAWTRIANGLE, trace une forme à trois sommets.
  • DRAWPOINT, dessine un point de marquage unique.
  • COLOURED, définit la couleur du contour et la transparence.
  • FILLCOLOR, définit la couleur de remplissage intérieure.
  • DrawOnLastBarOnly, limite le tracé au dernier bar pour des raisons de performance.
  • BarIndex, fournit les coordonnées x.
  • Highest, trouve le sommet d'un range à encadrer.