MQL5 · Indicateurs
Buffers et styles de tracé en MQL5 : la comptabilité d’un indicateur
Buffers de données, de couleur et de calcul, tracés et styles DRAW_ : comment les compter, les lier avec SetIndexBuffer et les régler avec PlotIndexSetInteger, avec un exemple complet.
Dans un indicateur MQL5, un buffer est un tableau double géré par le terminal, et un tracé (plot) est une série graphique qui consomme un ou plusieurs de ces buffers selon son style. La règle à retenir : indicator_buffers compte tous les tableaux (données, couleurs, calculs intermédiaires), indicator_plots compte seulement les séries dessinées, et chaque style de tracé impose un nombre précis de buffers, à lier dans un ordre précis avec SetIndexBuffer(). Presque tous les bugs d’affichage d’un indicateur personnalisé viennent d’un décalage dans cette comptabilité. Cette page la rend explicite.
Buffers et tracés : deux numérotations différentes
Prenons un indicateur qui dessine un histogramme bicolore et une ligne. Il possède deux tracés, mais trois buffers au minimum : l’histogramme coloré a besoin d’un buffer de valeurs et d’un buffer d’index de couleur, la ligne d’un buffer de valeurs. Si l’indicateur conserve en plus une moyenne intermédiaire, il en faut un quatrième, non dessiné.
Les deux numérotations commencent à 0 dans les fonctions :
SetIndexBuffer(n, ...)utilise l’index de buffer ;PlotIndexSetInteger(p, ...),PlotIndexSetDouble(p, ...)etPlotIndexSetString(p, ...)utilisent l’index de tracé.
Les directives #property indicator_typeN, indicator_colorN, indicator_widthN, indicator_styleN et indicator_labelN utilisent, elles, l’index de tracé à partir de 1. Dans l’exemple ci-dessus, la ligne est le tracé 1 dans les fonctions, indicator_type2 dans les directives, et ses valeurs sont dans le buffer 2.
Combien de buffers par style ?
La documentation des styles de dessin donne, pour chacun, le nombre de buffers de données et de couleur :
| Style | Buffers de données | Buffer de couleur |
|---|---|---|
DRAW_NONE, DRAW_LINE, DRAW_SECTION, DRAW_HISTOGRAM, DRAW_ARROW | 1 | 0 |
DRAW_HISTOGRAM2, DRAW_ZIGZAG, DRAW_FILLING | 2 | 0 |
DRAW_BARS, DRAW_CANDLES | 4 | 0 |
DRAW_COLOR_LINE, DRAW_COLOR_SECTION, DRAW_COLOR_HISTOGRAM, DRAW_COLOR_ARROW | 1 | 1 |
DRAW_COLOR_HISTOGRAM2, DRAW_COLOR_ZIGZAG | 2 | 1 |
DRAW_COLOR_BARS, DRAW_COLOR_CANDLES | 4 | 1 |
Les buffers d’un même tracé sont consécutifs : d’abord les buffers de données, puis le buffer de couleur s’il existe. Le tracé suivant commence au buffer libre suivant. Les buffers de calcul (INDICATOR_CALCULATIONS) se placent après tous les buffers de tracés.
Les trois types de buffers
SetIndexBuffer() prend un troisième argument de type ENUM_INDEXBUFFER_TYPE :
INDICATOR_DATA(valeur par défaut) : des valeurs destinées à être dessinées ;INDICATOR_COLOR_INDEX: pour chaque bougie, le numéro de la couleur à utiliser pour le buffer de données qui précède ; la documentation indique que jusqu’à 64 couleurs peuvent être déclarées dansindicator_colorN;INDICATOR_CALCULATIONS: un tableau de calcul intermédiaire, géré par le terminal comme les autres mais jamais dessiné.
Pourquoi faire gérer un tableau de calcul par le terminal plutôt que de déclarer un simple tableau dynamique ? Parce que le terminal le dimensionne automatiquement au nombre de bougies et le décale correctement quand une nouvelle bougie apparaît. Un tableau ordinaire devrait être redimensionné et entretenu à la main.
Exemple complet : histogramme bicolore, ligne de signal et buffer de calcul
L’indicateur suivant affiche, dans une sous-fenêtre, l’écart entre la clôture et sa moyenne simple, en points. L’histogramme est vert quand l’écart progresse, rouge quand il recule ; une ligne trace la moyenne exponentielle de cet écart. Il illustre les trois types de buffers et les deux numérotations.
//+------------------------------------------------------------------+
//| EcartMoyenne.mq5 - 2 tracés, 4 buffers |
//+------------------------------------------------------------------+
#property indicator_separate_window
#property indicator_buffers 4 // 2 (histogramme) + 1 (ligne) + 1 (calcul)
#property indicator_plots 2
//--- tracé 1 (index 0) : histogramme coloré -> buffers 0 (valeurs) et 1 (couleurs)
#property indicator_type1 DRAW_COLOR_HISTOGRAM
#property indicator_color1 clrSeaGreen, clrTomato // couleur 0 et couleur 1
#property indicator_width1 2
#property indicator_label1 "Écart (pts)"
//--- tracé 2 (index 1) : ligne -> buffer 2
#property indicator_type2 DRAW_LINE
#property indicator_color2 clrDodgerBlue
#property indicator_style2 STYLE_SOLID
#property indicator_label2 "Signal"
input int InpMaPeriod = 20; // période de la moyenne simple
input int InpSignalPeriod = 9; // période du lissage exponentiel
double GapBuffer[]; // buffer 0 : INDICATOR_DATA
double ColorBuffer[]; // buffer 1 : INDICATOR_COLOR_INDEX
double SignalBuffer[]; // buffer 2 : INDICATOR_DATA
double SmaBuffer[]; // buffer 3 : INDICATOR_CALCULATIONS
int OnInit()
{
SetIndexBuffer(0, GapBuffer, INDICATOR_DATA);
SetIndexBuffer(1, ColorBuffer, INDICATOR_COLOR_INDEX);
SetIndexBuffer(2, SignalBuffer, INDICATOR_DATA);
SetIndexBuffer(3, SmaBuffer, INDICATOR_CALCULATIONS);
//--- propriétés par index de TRACÉ (0 = histogramme, 1 = ligne)
PlotIndexSetInteger(0, PLOT_DRAW_BEGIN, InpMaPeriod);
PlotIndexSetInteger(1, PLOT_DRAW_BEGIN, InpMaPeriod + InpSignalPeriod);
PlotIndexSetDouble(0, PLOT_EMPTY_VALUE, 0.0);
PlotIndexSetDouble(1, PLOT_EMPTY_VALUE, 0.0);
PlotIndexSetString(1, PLOT_LABEL, StringFormat("Signal(%d)", InpSignalPeriod));
IndicatorSetString(INDICATOR_SHORTNAME,
StringFormat("EcartMoyenne(%d,%d)", InpMaPeriod, InpSignalPeriod));
IndicatorSetInteger(INDICATOR_DIGITS, 1);
return(INIT_SUCCEEDED);
}
int OnCalculate(const int rates_total, const int prev_calculated,
const datetime &time[], const double &open[], const double &high[],
const double &low[], const double &close[], const long &tick_volume[],
const long &volume[], const int &spread[])
{
if(rates_total <= InpMaPeriod)
return(0);
ArraySetAsSeries(close, false);
double alpha = 2.0 / (InpSignalPeriod + 1.0);
int start = (prev_calculated == 0) ? 0 : prev_calculated - 1;
for(int i = start; i < rates_total; i++)
{
if(i < InpMaPeriod - 1) // moyenne pas encore définie
{
SmaBuffer[i] = 0.0; GapBuffer[i] = 0.0; ColorBuffer[i] = 0; SignalBuffer[i] = 0.0;
continue;
}
double sum = 0.0;
for(int k = 0; k < InpMaPeriod; k++)
sum += close[i - k];
SmaBuffer[i] = sum / InpMaPeriod;
GapBuffer[i] = (close[i] - SmaBuffer[i]) / _Point;
//--- index de couleur : 0 = vert (écart en hausse), 1 = rouge (en baisse)
ColorBuffer[i] = (i > InpMaPeriod - 1 && GapBuffer[i] < GapBuffer[i - 1]) ? 1 : 0;
//--- lissage exponentiel de l'écart
SignalBuffer[i] = (i == InpMaPeriod - 1) ? GapBuffer[i]
: alpha * GapBuffer[i] + (1.0 - alpha) * SignalBuffer[i - 1];
}
return(rates_total);
}
Remarquez que le buffer de couleur contient des numéros (0 ou 1), pas des couleurs : ce sont des positions dans la liste déclarée par indicator_color1. Changer de palette ne demande donc aucune modification du calcul. Notez aussi le choix PLOT_EMPTY_VALUE = 0.0 : les bougies de chauffe valent 0 et ne sont pas dessinées. Cela suppose qu’un écart réellement nul ne soit pas à tracer, ce qui est acceptable ici ; pour une série où 0 est une valeur significative, gardez EMPTY_VALUE.
Choisir le bon style
Le choix du style découle de la nature de la donnée. Une valeur continue (moyenne, oscillateur) se trace en DRAW_LINE. Une valeur dont le signe ou l’amplitude compte plus que la continuité (écart, volume, momentum) se lit mieux en DRAW_HISTOGRAM. Un événement ponctuel (signal, fractale, croisement) se marque en DRAW_ARROW, en laissant les autres bougies vides. Une zone entre deux courbes, comme un canal, se colore avec DRAW_FILLING, qui consomme deux buffers. Enfin, DRAW_SECTION et DRAW_ZIGZAG relient seulement les points non vides, ce qui convient aux tracés de sommets et de creux. Passer à la variante DRAW_COLOR_... ne coûte qu’un buffer supplémentaire et permet d’encoder un état (hausse, baisse, neutre) sans ajouter de tracé.
Modifier les couleurs par programme
PlotIndexSetInteger() existe en deux variantes. La seconde prend un modificateur, utilisé pour les propriétés de couleur indexées : PlotIndexSetInteger(0, PLOT_LINE_COLOR, 1, clrOrange) remplace la couleur numéro 1 du tracé 0. La propriété PLOT_COLOR_INDEXES fixe le nombre de couleurs utilisables par un tracé coloré. Ces réglages permettent par exemple de proposer les couleurs en paramètres input, ce que les directives #property ne savent pas faire.
Les autres propriétés entières de l’énumération ENUM_PLOT_PROPERTY_INTEGER sont : PLOT_ARROW et PLOT_ARROW_SHIFT (pour les flèches), PLOT_DRAW_BEGIN, PLOT_DRAW_TYPE, PLOT_SHOW_DATA, PLOT_SHIFT, PLOT_LINE_STYLE et PLOT_LINE_WIDTH. Côté réel, PLOT_EMPTY_VALUE ; côté texte, PLOT_LABEL. La documentation précise que les styles de ligne pointillés ou tiretés ne s’appliquent qu’aux épaisseurs 0 et 1.
Vérifier sa comptabilité
Avant de compiler, faites ce petit contrôle sur papier :
- listez les tracés dans l’ordre, avec leur style ;
- pour chacun, écrivez le nombre de buffers de données et de couleur selon le tableau ci-dessus ;
- additionnez, ajoutez les buffers de calcul : le total doit égaler
indicator_buffers; - vérifiez que les index passés à
SetIndexBuffer()suivent exactement cet ordre.
Un indicateur dont la ligne s’affiche avec les valeurs de l’histogramme, ou dont l’histogramme est entièrement d’une seule couleur, a presque toujours un buffer lié au mauvais index.
Pièges et conséquences pour les autres programmes
- Les EA lisent des buffers, pas des tracés. Un Expert Advisor qui appelle cet indicateur avec iCustom lira la ligne de signal dans le buffer 2, pas dans le buffer 1, qui contient des index de couleur.
- Ne redimensionnez jamais un buffer. La documentation l’interdit : le terminal gère la taille de ces tableaux.
- L’indexation après liaison. Un buffer lié est indexé comme un tableau classique, même s’il avait été déclaré en série auparavant. Pour changer de sens, appelez
ArraySetAsSeries()aprèsSetIndexBuffer(). La page ArraySetAsSeries et indexation des séries détaille ce point. DRAW_NONEpour exposer une valeur. Un tracéDRAW_NONEn’est pas dessiné, mais son buffer reste lisible pariCustom()comme n’importe quel autre. C’est une façon simple de mettre à disposition d’un EA une valeur qui n’a pas besoin d’être affichée.
Pour le squelette complet d’un indicateur, voyez Créer un indicateur personnalisé ; pour la logique de calcul, OnCalculate et prev_calculated. Toutes les pages de la rubrique sont listées sur Indicateurs en MQL5.
FAQ
Quelle différence entre indicator_buffers et indicator_plots ?
indicator_buffers compte tous les tableaux gérés par le terminal : données, couleurs et calculs. indicator_plots compte seulement les séries dessinées. Un tracé coloré consomme au moins deux buffers, d’où un premier nombre souvent supérieur au second.
Pourquoi mon histogramme coloré reste-t-il d’une seule couleur ?
Le buffer de couleur n’est probablement pas lié avec INDICATOR_COLOR_INDEX juste après son buffer de données, ou il contient toujours le même index. Vérifiez l’ordre des SetIndexBuffer() et les valeurs écrites dans le buffer de couleur.
Combien de couleurs peut avoir un tracé coloré ?
La documentation de SetIndexBuffer() indique jusqu’à 64 couleurs déclarées dans indicator_colorN. Le buffer de couleur contient l’index de la couleur à utiliser pour chaque bougie.
Les directives #property et PlotIndexSetInteger utilisent-elles la même numérotation ?
Non. Les directives numérotent les tracés à partir de 1 (indicator_type1), les fonctions PlotIndexSet... à partir de 0.
- Handles d’indicateurs et CopyBuffer
- iMA : moyennes mobiles
- iRSI : Relative Strength Index
- iMACD
- iBands : bandes de Bollinger
- iATR : Average True Range
- iStochastic
- iADX
- iCCI
- iMomentum
- iIchimoku
- iSAR : Parabolic SAR
- iEnvelopes
- iWPR : Williams %R
- iAO : Awesome Oscillator
- iAC : Accelerator Oscillator
- iAlligator
- iFractals
- iOBV : On Balance Volume
- iMFI : Money Flow Index
- iVolumes
- iStdDev : écart-type
- iDeMarker
- iBearsPower et iBullsPower
- iForce
- iOsMA
- iRVI
- iAMA : moyenne mobile adaptative
- iDEMA et iTEMA
- iFrAMA
- iCustom : appeler un indicateur personnalisé
- Créer un indicateur personnalisé
- OnCalculate et prev_calculated
- Indicateur multi-timeframe
- Objets graphiques (ObjectCreate)
