ProRealTime · ProBuilder
DRAWTEXT, DRAWARROW et objets graphiques en ProBuilder
Dessiner flèches, textes, segments, rectangles, zones colorées et tableaux de bord en ProBuilder : coordonnées, paramètres, ANCHOR, DRAWONLASTBARONLY et un indicateur de signaux annotés.
ProBuilder permet de dessiner directement sur le graphique : flèches de signal avec DRAWARROWUP et DRAWARROWDOWN, textes avec DRAWTEXT, segments, lignes, rectangles, triangles, ellipses, points, bougies personnalisées, couleurs de fond et zones colorées entre deux courbes. Chaque objet se positionne avec des coordonnées : en abscisse un numéro de barre (BarIndex), en ordonnée une valeur sur l’échelle du prix ou de l’indicateur. Ces instructions se placent dans le corps du code, souvent à l’intérieur d’un IF, et l’indicateur se termine généralement par un RETURN vide.
Cette page présente les instructions graphiques documentées, leurs paramètres et les bonnes pratiques pour garder un graphique lisible et rapide. Elle fait partie de la rubrique Le langage ProBuilder et complète le guide RETURN et affichage des courbes, consacré aux courbes.
Le système de coordonnées
Par défaut, l’axe horizontal est exprimé en numéro de barre et l’axe vertical en valeur, sur l’échelle du panneau où l’indicateur est affiché. Pour dessiner sur la barre courante, on utilise BarIndex ; pour la barre précédente, BarIndex - 1 ou BarIndex[1]. L’ordonnée est un prix si l’indicateur est superposé au cours, ou une valeur d’oscillateur s’il est dans un panneau séparé. Le fonctionnement de BarIndex est détaillé dans le guide ONCE et BarIndex.
Deux outils permettent de sortir de ce repère : DateToBarIndex(date) convertit une date en numéro de barre, et ANCHOR, présenté plus bas, place un objet par rapport aux bords de la fenêtre.
Les flèches
| Instruction | Objet |
|---|---|
DRAWARROWUP(x, y) | flèche vers le haut, typiquement sous une bougie d’achat |
DRAWARROWDOWN(x, y) | flèche vers le bas, typiquement au-dessus d’une bougie de vente |
DRAWARROW(x, y) | flèche pointant vers la droite |
Toutes acceptent COLOURED(R, V, B) ou COLOURED(R, V, B, alpha). Pour que la flèche ne recouvre pas la bougie, on la décale d’une fraction de la volatilité, par exemple la moitié de l’ATR sous le plus bas. Utiliser un décalage proportionnel plutôt qu’un nombre de points fixe garantit un rendu correct sur tous les marchés. L’ATR est présenté sur la page AverageTrueRange.
Le texte : DRAWTEXT
DRAWTEXT("Texte", x, y, SERIF, BOLD, 10) COLOURED(0, 0, 0)
Les trois premiers paramètres sont obligatoires : le texte entre guillemets, l’abscisse et l’ordonnée. Les trois suivants sont facultatifs : la police (DIALOG, MONOSPACED, SANSERIF, SERIF), le style (STANDARD, BOLD, ITALIC, BOLDITALIC) et la taille. Pour insérer la valeur d’une variable dans le texte, on encadre son nom par des dièses : DRAWTEXT("RSI : #r#", BarIndex, High) affiche la valeur courante de r. Arrondissez la variable avant de l’afficher (r = ROUND(r, 1)) pour éviter des décimales inutiles.
Lignes, segments et formes
| Instruction | Objet dessiné |
|---|---|
DRAWSEGMENT(x1, y1, x2, y2) | segment entre deux points |
DRAWLINE(x1, y1, x2, y2) | droite passant par deux points |
DRAWRAY(x1, y1, x2, y2) | demi-droite partant du premier point |
DRAWHLINE(y) | ligne horizontale au niveau y |
DRAWVLINE(x) | ligne verticale sur la barre x |
DRAWRECTANGLE(x1, y1, x2, y2) | rectangle défini par deux coins |
DRAWTRIANGLE(x1, y1, x2, y2, x3, y3) | triangle défini par trois points |
DRAWELLIPSE(x1, y1, x2, y2) | ellipse inscrite dans le rectangle |
DRAWPOINT(x, y, taille) | point d’une taille donnée |
DRAWCANDLE(o, h, l, c) | bougie personnalisée |
DRAWBARCHART(o, h, l, c) | barre OHLC personnalisée |
Plusieurs paramètres complémentaires s’ajoutent à ces instructions. COLOURED fixe la couleur, BORDERCOLOR la couleur de bordure des formes (hors lignes et flèches), et STYLE(style, épaisseur) le type de trait : LINE ou DOTTEDLINE à DOTTEDLINE4, avec une épaisseur de 1 à 5. Les styles HISTOGRAM et POINT sont réservés aux valeurs d’un RETURN.
DRAWCANDLE et DRAWBARCHART servent à construire des représentations alternatives des prix, par exemple des bougies lissées ou recalculées : les quatre paramètres peuvent être des constantes de prix ou des variables calculées.
Les couleurs de fond et les zones
BACKGROUNDCOLOR(R, V, B, alpha) colore le fond du graphique sur la barre en cours : placé dans un IF, il met en évidence certaines périodes (une séance, un régime de volatilité). COLORBETWEEN(valeur1, valeur2, couleur) remplit l’espace entre deux valeurs, par exemple entre deux moyennes mobiles, avec une couleur RVB ou nommée. C’est la façon la plus lisible de visualiser un écart ou un canal.
Positionner par rapport à la fenêtre : ANCHOR
ANCHOR(point, unitéX, unitéY) place un objet par rapport à un point de référence de la fenêtre plutôt que par rapport aux bougies. Le point peut être TOPLEFT, TOP, TOPRIGHT, RIGHT, BOTTOMRIGHT, BOTTOM, BOTTOMLEFT, LEFT ou MIDDLE. L’unité horizontale est INDEX (numéro de barre) ou XSHIFT (décalage en pixels) ; l’unité verticale est VALUE (prix) ou YSHIFT (pixels). C’est la méthode pour afficher un tableau de bord fixe dans un coin du graphique, qui ne se déplace pas quand on fait défiler l’historique.
Exemple complet : signaux RSI annotés
Cet indicateur, à superposer au graphique des prix, dessine une flèche verte sous la bougie lorsque le RSI sort de la zone de survente et une flèche rouge au-dessus lorsqu’il sort de la zone de surachat, chacune accompagnée de la valeur du RSI. Le fonctionnement du RSI est expliqué sur la page RSI.
// Signaux RSI annotés sur le graphique des prix
atr = AverageTrueRange[14](Close) // sert à décaler les objets proportionnellement à la volatilité
r = ROUND(RSI[14](Close), 1) // RSI arrondi à une décimale pour l'affichage
IF r CROSSES OVER 30 THEN
// flèche sous le plus bas, texte encore un peu plus bas
DRAWARROWUP(BarIndex, Low - atr * 0.5) COLOURED(0, 160, 0)
DRAWTEXT("RSI #r#", BarIndex, Low - atr * 1.2, SANSERIF, BOLD, 10) COLOURED(0, 120, 0)
ENDIF
IF r CROSSES UNDER 70 THEN
// flèche au-dessus du plus haut, texte encore un peu plus haut
DRAWARROWDOWN(BarIndex, High + atr * 0.5) COLOURED(200, 0, 0)
DRAWTEXT("RSI #r#", BarIndex, High + atr * 1.2, SANSERIF, BOLD, 10) COLOURED(160, 0, 0)
ENDIF
RETURN // aucune courbe : l'indicateur ne fait que dessiner
L’indicateur s’applique sur le prix : les ordonnées (Low, High) sont des prix. Appliqué dans un panneau séparé, il dessinerait les objets hors de l’échelle de ce panneau.
Dessiner seulement sur la dernière barre
Par défaut, un objet dessiné dans un IF l’est sur toutes les barres où la condition est vraie, dans tout l’historique. Pour un tableau de bord ou une ligne de niveau actuel, ce n’est pas souhaitable. DEFPARAM DRAWONLASTBARONLY = true, placé en tout début de code, limite le dessin à la dernière barre : les objets sont redessinés à chaque mise à jour et ne s’accumulent pas. La documentation suggère de le combiner avec DEFPARAM CALCULATEONLASTBARS pour alléger les calculs. Attention : ce paramètre s’applique à tous les objets du code, y compris aux flèches de signal.
Bonnes pratiques et pièges
- Ne surchargez pas le graphique : des centaines de textes rendent la lecture impossible et ralentissent l’affichage.
- Décalez les objets avec la volatilité plutôt qu’avec une valeur fixe.
- Signal sur barre non clôturée : en temps réel, une flèche dessinée sur la barre en cours peut apparaître puis disparaître. Pour des signaux définitifs, testez la condition sur la barre précédente et dessinez sur
BarIndex - 1. - Mauvaise échelle : un objet positionné avec un prix dans un panneau d’oscillateur sera invisible.
- Objets multiples via des boucles : dessinez-les sur la dernière barre uniquement, comme dans l’exemple du guide Tableaux ($tableau).
FAQ
Comment afficher la valeur d’une variable dans un texte ?
Encadrez le nom de la variable par des dièses dans la chaîne de DRAWTEXT, par exemple DRAWTEXT(« Valeur : #maVariable# », BarIndex, High). Arrondissez la variable au préalable avec ROUND pour limiter les décimales.
Pourquoi mes flèches n’apparaissent-elles pas ?
Vérifiez trois points : la condition est-elle réellement vraie (affichez-la avec RETURN ou PRINT) ; l’ordonnée est-elle sur la bonne échelle (prix sur le graphique des prix) ; DRAWONLASTBARONLY n’est-il pas activé, ce qui limiterait le dessin à la dernière barre.
Comment colorer la zone entre deux moyennes mobiles ?
Utilisez COLORBETWEEN(moyenne1, moyenne2, couleur). Placé dans un IF … ELSE, il permet par exemple de colorer la zone en vert quand la moyenne rapide est au-dessus et en rouge dans le cas contraire.
Peut-on dessiner dans le futur, à droite de la dernière barre ?
Oui, en passant une abscisse supérieure au BarIndex courant, par exemple BarIndex + 10, ou en utilisant DRAWRAY et DRAWLINE, qui se prolongent au-delà de leurs points de définition.
