English
Word nu lid
Grafisch/probuilder

DRAWELLIPSE

DRAWELLIPSE tekent in ProBuilder een ellips binnen een bounding box die wordt bepaald door twee hoeken, opgegeven als barindex en koers, met een optionele COLOURED kleur.

Syntaxis

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

Parameters

NaamTypeStandaardBeschrijving
x1geheel getalverplichtX-coördinaat van de hoek linksboven van de bounding box, normaal een barindex.
y1prijsverplichtY-coördinaat van de hoek linksboven, een koers of berekende waarde.
x2geheel getalverplichtX-coördinaat van de hoek rechtsonder van de bounding box.
y2prijsverplichtY-coördinaat van de hoek rechtsonder.
R, G, Bgeheel getalplatformstandaardOptioneel COLOURED rood-, groen- en blauwcomponenten, 0 tot 255.
ageheel getal255Optionele alpha (transparantie), 0 volledig transparant tot 255 volledig dekkend.

Hoe het werkt

DRAWELLIPSE werkt binnen een ProBuilder-indicator. De twee coördinatenparen (x1, y1) en (x2, y2) definiëren de linkerbovenhoek en de rechteronderhoek van een omhullende rechthoek, en de ellips wordt binnen die rechthoek ingeschreven. De x-coördinaten zijn bar-indices en de y-coördinaten zijn koersen, dus de vorm beslaat een bereik in zowel tijd als prijs. Dat is geschikt om een interessante zone of een patroon te omcirkelen zonder de onderliggende data te wijzigen.

De optionele COLOURED clausule stelt kleur en transparantie in. Zoals bij andere tekenobjecten stellen scripts doorgaans DEFPARAM DrawOnLastBarOnly = true zodat de ellips eenmaal wordt getekend.

Voorbeelden

Voorbeeld 1, Een enkele gekleurde ellips (Indicator)

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

Overgenomen uit de bron: de hoeken bepalen de bounding box en de ellips vult deze, getekend in rood met 50 procent transparantie.

Voorbeeld 2, Een recente swing omcirkelen (Indicator)

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

De bounding box beslaat 10 bars en de recente range, dus de ellips markeert die swing.

Voorbeeld 3, Ellips met een vulling (Indicator)

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 vult het binnenvlak terwijl COLOURED stelt de omlijning in.

Veelvoorkomende fouten en valkuilen

  • Alleen indicator. DRAWELLIPSE heeft geen effect in ProScreener, ProOrder of ProBacktest. Houd het in een ProBuilder-indicator.
  • Hoeken, niet middelpunt en radius. De vier waarden zijn twee tegenoverliggende hoeken van een bounding box, niet een middelpunt en radii.
  • X is een bar-index. Een prijs doorgeven aan x1 of x2 plaatst de vorm horizontaal verkeerd. Gebruik BarIndex of offsets daarvan.
  • Kosten van opnieuw tekenen. Zonder DrawOnLastBarOnly = true, wordt de ellips op elke bar getekend en wordt de grafiek langzamer.