DRAWCANDLE
DRAWCANDLE tekent in ProBuilder een eigen OHLC-candlestick op basis van open-, high-, low- en close-waarden, met optionele COLOURED body en BORDERCOLOR. Syntaxis en voorbeelden.
Syntaxis
DRAWCANDLE(open, high, low, close) COLOURED(R, G, B) BORDERCOLOR(R, G, B)Parameters
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
open | prijs | verplicht | Openingswaarde van de body van de candle. |
high | prijs | verplicht | Hoogste waarde, de bovenkant van de bovenste wick. |
low | prijs | verplicht | Laagste waarde, de onderkant van de onderste wick. |
close | prijs | verplicht | Slotwaarde van de body van de candle. |
R, G, B (COLOURED) | geheel getal | platformstandaard | Kleurcomponenten van de vulling van de body, 0 tot 255. |
R, G, B (BORDERCOLOR) | geheel getal | platformstandaard | Componenten van de randkleur, 0 tot 255. |
Hoe het werkt
DRAWCANDLE werkt binnen een ProBuilder-indicator. Hij tekent een candlestick op de huidige bar op basis van de vier meegegeven waarden, die constanten, variabelen of expressies kunnen zijn in plaats van de ruwe koers. Daarmee is het een manier om een afgeleide candlereeks weer te geven, zoals een gesmoothe of Heikin-Ashi-achtige candle, bovenop of naast de koers. De candle wordt eenmaal per bar getekend waarop hij wordt aangeroepen, dus een bar-index-argument is niet nodig.
COLOURED stelt de bodyvulling in en BORDERCOLOR stelt de omlijning in. Als beide worden weggelaten, gelden de standaardkleuren van het platform.
Voorbeelden
Voorbeeld 1, Vloeiende Heikin-Ashi-candles (Indicator)
// 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
RETURNDe candle is groen wanneer de gemiddelde open op of onder de gemiddelde close ligt, en anders rood.
Voorbeeld 2, Een ruwe candle in een andere kleur (Indicator)
// Redraw the current candle in a fixed colour
DRAWCANDLE(open, high, low, close) COLOURED(0, 120, 255) BORDERCOLOR(0, 0, 0)
RETURNHet doorgeven van de ruwe OHLC-waarden reproduceert de bar met een gekozen vulling en rand.
Voorbeeld 3, Candle uit een verschoven reeks (Indicator)
// 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)
RETURNDoor elke waarde met dezelfde offset te verschuiven wordt een vergelijkingscandle boven de koers geplaatst.
Veelvoorkomende fouten en valkuilen
- Alleen indicator.
DRAWCANDLEheeft geen effect in ProScreener, ProOrder of ProBacktest. Houd het in een ProBuilder-indicator. - Volgorde van de argumenten. De volgorde is open, high, low, close. Het verwisselen van high en low of van open en close tekent een onjuist gevormde candle.
- Geen bar-index-argument. De candle wordt getekend op de bar waarop de aanroep wordt uitgevoerd, dus hij wordt geplaatst door waar in de loop hij wordt uitgevoerd, niet door een x-coördinaat.
- Recursief open vereist een beveiliging. Opens in Heikin-Ashi-stijl verwijzen naar
HAOpen[1], dus scherm het blok af met eenBarIndextest om een ongedefinieerde eerste waarde te voorkomen.
Gerelateerde instructies
DRAWBARCHART, tekent een eigen OHLC-bar in plaats van een candle.Open, de prijsbron van de open.High, de prijsbron van de high.Low, de prijsbron van de low.Close, de prijsbron van de close.COLOURED, stelt de kleur van de body in.DrawOnLastBarOnly, beperkt het tekenen tot de laatste bar.Average, vlakt de OHLC-waarden af voordat er wordt getekend.