DRAWCANDLE

Syntaxe

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

Paramètres

Comment ça marche

DRAWCANDLE s'exécute dans un indicateur ProBuilder. Elle dessine une chandelle sur le bar courant à partir des quatre valeurs transmises, qui peuvent être des constantes, des variables ou des expressions plutôt que le prix brut. C'est donc un moyen d'afficher une série de chandelles dérivée, par exemple des chandelles lissées ou de type Heikin-Ashi, par-dessus ou à côté du prix. La chandelle est dessinée une fois par bar où l'instruction est appelée, aucun argument d'indice de bar n'est donc nécessaire.

COLOURED définit le remplissage du corps et BORDERCOLOR définit le contour. Lorsque les deux sont omis, les couleurs par défaut de la plateforme s'appliquent.

Exemples

Exemple 1, Bougies Heikin-Ashi lissées (Indicateur)

// 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 bougie est verte lorsque l'ouverture moyennée se situe au niveau de la clôture moyennée ou en dessous, et rouge sinon.

Exemple 2, Une bougie brute recolorée (Indicateur)

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

Passer les valeurs OHLC brutes reproduit le bar avec un remplissage et une bordure choisis.

Exemple 3, Bougie issue d'une série décalée (Indicateur)

// 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

Décaler chaque valeur du même offset place une bougie de comparaison au-dessus du prix.

Erreurs et pièges courants

• Indicateur uniquement. DRAWCANDLE n'a aucun effet dans ProScreener, ProOrder ou ProBacktest. Réservez-le à un indicateur ProBuilder.
• Ordre des arguments. L'ordre est ouverture, plus haut, plus bas, clôture. Inverser plus haut et plus bas, ou ouverture et clôture, dessine une bougie mal formée.
• Pas d'argument d'indice de bar. La bougie est dessinée sur le bar où l'appel s'exécute, elle est donc positionnée selon l'endroit de la boucle où il s'exécute, pas selon une coordonnée x.
• Un open récursif nécessite une protection. Les ouvertures de style Heikin-Ashi font référence à HAOpen[1], donc conditionnez le bloc avec un BarIndex test pour éviter une première valeur indéfinie.

Instructions liées

• DRAWBARCHART, dessine un bar OHLC personnalisé au lieu d'une bougie.
• Open, la source du prix d'ouverture.
• High, la source du prix le plus haut.
• Low, la source du prix le plus bas.
• Close, la source du prix de clôture.
• COLOURED, définit la couleur du corps.
• DrawOnLastBarOnly, limite le tracé au dernier bar.
• Average, lisse les valeurs OHLC avant le tracé.