MQL4 · Indicateurs
iCustom en MQL4 : appeler un indicateur personnalisé depuis un EA
iCustom lit n’importe quel buffer d’un indicateur personnalisé compilé. Signature, chemin du fichier, ordre des paramètres, numéro de buffer, valeurs vides et méthode pour vérifier ce que vous lisez.
iCustom() permet à un Expert Advisor MQL4 de lire la valeur d’un indicateur personnalisé compilé, exactement comme iMA() lit une moyenne mobile intégrée. Vous indiquez le nom du fichier de l’indicateur, ses paramètres dans l’ordre de leur déclaration, le numéro du buffer à lire et la bougie voulue ; la fonction renvoie un double. C’est le moyen le plus simple de réutiliser dans un robot un indicateur existant, qu’il ait été écrit par vous ou téléchargé, sans recopier son code. C’est aussi une source d’erreurs silencieuses : un paramètre décalé ou un mauvais numéro de buffer produit des valeurs plausibles mais fausses. Cette page explique comment écrire l’appel, le vérifier, et interpréter les valeurs vides.
La signature de iCustom
double iCustom(
string symbol, // symbole, NULL = symbole courant
int timeframe, // unité de temps, 0 = celle du graphique
string name, // nom de l'indicateur compilé, relatif à MQL4\Indicators
... // paramètres d'entrée de l'indicateur, dans l'ordre
int mode, // numéro du buffer à lire
int shift // bougie lue : 0 = en cours, 1 = dernière clôturée
);
L’exemple de la documentation officielle, iCustom(NULL, 0, "SampleInd", 13, 1, 0), appelle l’indicateur SampleInd avec deux paramètres, 13 et 1, puis lit le buffer 0 sur la bougie 0. Remarquez que rien ne sépare les paramètres de l’indicateur des deux derniers arguments : c’est leur position qui compte. La logique est la même qu’en MQL5, à la différence près qu’en MQL5 iCustom() renvoie un handle, comme le montre la page iCustom en MQL5.
Le nom et l’emplacement du fichier
L’indicateur doit être compilé (fichier .ex4) et placé dans le dossier MQL4\Indicators du répertoire de données du terminal, que vous ouvrez depuis le menu Fichier > Ouvrir le dossier des données. Le nom se donne sans extension et relativement à ce dossier. Pour un indicateur rangé dans un sous-dossier, utilisez une double barre oblique inverse comme séparateur : "Examples\\Heiken Ashi", car une barre seule serait interprétée comme un caractère d’échappement dans la chaîne.
Si le fichier est introuvable, iCustom() ne provoque pas d’erreur de compilation : le problème n’apparaît qu’à l’exécution, dans l’onglet Journal ou Experts. Après toute installation, vérifiez que le nom de fichier correspond exactement, espaces compris. La page Compiler et installer un EA MQL4 rappelle l’organisation des dossiers.
Transmettre les paramètres dans le bon ordre
Les valeurs transmises après le nom doivent correspondre, dans l’ordre et dans le type, aux variables input ou extern déclarées dans l’indicateur. Prenons un indicateur qui commence ainsi :
// Extrait de l'indicateur MonCanal.mq4
input int Periode = 20; // 1er paramètre
input double Ecart = 1.5; // 2e paramètre
input bool Alertes = false; // 3e paramètre
L’appel correct depuis un EA est alors iCustom(NULL, 0, "MonCanal", 20, 1.5, false, 0, 1). Si vous omettez des paramètres, les derniers prennent leur valeur par défaut : iCustom(NULL, 0, "MonCanal", 20, 0, 1) fonctionne aussi, avec Ecart = 1.5 et Alertes = false. Mais vous ne pouvez omettre que des paramètres en fin de liste : impossible de sauter le premier pour ne changer que le deuxième.
Le piège classique est un indicateur qui commence par une variable de type string utilisée comme séparateur visuel dans la fenêtre des paramètres. Elle compte comme un paramètre à part entière : oubliez-la, et tous les suivants sont décalés d’un cran. Ouvrez donc toujours le code source ou la fenêtre des paramètres de l’indicateur pour dresser la liste exacte avant d’écrire l’appel.
Choisir le bon numéro de buffer
Le paramètre mode désigne l’index du buffer, tel qu’il est déclaré par SetIndexBuffer() dans l’indicateur. La documentation de iCustom() indique un index compris entre 0 et 7. Sans le code source, deux moyens permettent de retrouver le bon numéro :
- l’onglet Couleurs de la fenêtre de propriétés de l’indicateur liste ses tracés dans l’ordre de leurs index ;
- la fenêtre des données (Ctrl+D) affiche la valeur de chaque buffer étiqueté pour la bougie survolée ; comparez-la à ce que votre EA imprime.
Les buffers de calcul internes, non affichés, ont aussi un index, généralement placé après les buffers visibles. La page Buffers d’indicateur en MQL4 explique comment ils sont déclarés.
Les valeurs vides : EMPTY_VALUE
Beaucoup d’indicateurs ne remplissent pas tous leurs buffers sur toutes les bougies : un indicateur de flèches n’a de valeur que sur les bougies de signal. Sur les autres, le buffer contient la valeur vide, par défaut la constante EMPTY_VALUE (2147483647), ou une autre valeur choisie par l’auteur avec SetIndexEmptyValue(), souvent 0. Votre code doit tester explicitement ces cas :
double fleche = iCustom(NULL, 0, "MesFleches", 14, 0, 1); // buffer 0, bougie 1
bool signalAchat = (fleche != EMPTY_VALUE && fleche != 0);
Comparer directement fleche > 0 serait une erreur : EMPTY_VALUE est un nombre positif très grand, et la condition serait vraie sur toutes les bougies sans flèche.
Exemple complet : EA piloté par un indicateur personnalisé
L’exemple utilise l’indicateur Heiken Ashi livré avec MetaTrader 4 dans le sous-dossier Examples. Ouvrez son code source dans MetaEditor pour confirmer l’ordre de ses paramètres et de ses buffers avant de l’utiliser : l’EA ci-dessous suppose que les buffers 2 et 3 contiennent l’ouverture et la clôture des bougies lissées, ce que vous devez vérifier sur votre installation.
#property strict
input string NomIndic = "Examples\\Heiken Ashi";
input int BufOuv = 2; // buffer de l'ouverture lissée (à vérifier)
input int BufClo = 3; // buffer de la clôture lissée (à vérifier)
input int StopPoints = 400;
input double Lots = 0.10;
input int Magic = 41012;
datetime derniereBougie = 0;
// Lecture d'un buffer sans transmettre de paramètres : valeurs par défaut de l'indicateur
double HA(int buffer, int shift)
{
return(iCustom(NULL, 0, NomIndic, buffer, shift));
}
int OnInit()
{
double test = HA(BufClo, 1);
int err = GetLastError();
if(err != 0) Print("Lecture initiale de ", NomIndic, " : erreur ", err);
return(INIT_SUCCEEDED);
}
void OnTick()
{
if(Time[0] == derniereBougie) return;
derniereBougie = Time[0];
double o1 = HA(BufOuv, 1), c1 = HA(BufClo, 1);
double o2 = HA(BufOuv, 2), c2 = HA(BufClo, 2);
if(o1 == EMPTY_VALUE || o2 == EMPTY_VALUE) return;
bool passeHaussier = (c2 < o2 && c1 > o1); // bougie lissée rouge puis verte
if(!passeHaussier || OrdresEA() > 0) return;
double sl = NormalizeDouble(Ask - StopPoints * Point, Digits);
if(OrderSend(Symbol(), OP_BUY, Lots, Ask, 3, sl, 0, "HA", Magic, 0, clrBlue) < 0)
Print("OrderSend : erreur ", GetLastError());
}
int OrdresEA()
{
int n = 0;
for(int i = OrdersTotal() - 1; i >= 0; i--)
if(OrderSelect(i, SELECT_BY_POS, MODE_TRADES)
&& OrderSymbol() == Symbol() && OrderMagicNumber() == Magic) n++;
return(n);
}
Les numéros de buffers sont exposés en input : si votre vérification montre un ordre différent, vous les corrigez sans recompiler. Dans le testeur de stratégie, l’indicateur appelé est chargé automatiquement ; il doit simplement être présent dans le dossier MQL4\Indicators.
Vérifier ce que vous lisez
Avant de faire confiance à un appel iCustom(), imprimez les valeurs lues sur quelques bougies et comparez-les à la fenêtre des données, avec l’indicateur posé sur le graphique avec les mêmes paramètres. Si elles diffèrent, vérifiez dans l’ordre : le nom du fichier, la liste et l’ordre des paramètres, le numéro de buffer, puis le shift. Cette vérification prend quelques minutes et évite d’optimiser un robot qui lit en réalité une autre ligne que celle prévue.
Pièges spécifiques
- Indicateurs qui repeignent : certains indicateurs modifient leurs valeurs passées à mesure que de nouvelles bougies arrivent (zigzags, certaines flèches). Un EA qui les lit obtiendra en temps réel des valeurs différentes de celles du backtest. Observez l’indicateur en temps réel ou en test visuel avant de l’utiliser.
- Indicateurs lents : un indicateur qui recalcule tout l’historique à chaque tick ralentit fortement l’EA, surtout en optimisation. Un indicateur bien écrit ne recalcule que les nouvelles bougies, comme l’explique IndicatorCounted et prev_calculated.
- Fichier .ex4 sans source : vous dépendez alors d’un code que vous ne pouvez ni vérifier ni corriger. Préférez les indicateurs dont vous avez le code source.
Pour écrire vos propres indicateurs, consultez Créer un indicateur en MQL4 et la rubrique Indicateurs en MQL4.
FAQ
Où placer l’indicateur pour que iCustom le trouve ?
Le fichier .ex4 doit se trouver dans le dossier MQL4\Indicators du répertoire de données du terminal, ou dans un de ses sous-dossiers. Indiquez le nom sans extension, avec une double barre oblique inverse pour les sous-dossiers.
Dois-je transmettre tous les paramètres de l’indicateur ?
Non. Les paramètres omis en fin de liste prennent leur valeur par défaut. En revanche, vous ne pouvez pas en sauter un au milieu : tous ceux qui précèdent le dernier transmis doivent figurer, dans l’ordre.
Pourquoi iCustom renvoie 2147483647 ?
C’est la valeur de EMPTY_VALUE : le buffer n’a pas de valeur sur cette bougie. C’est normal pour un indicateur de flèches ou de signaux ; testez cette valeur avant d’utiliser le résultat.
Comment savoir quel buffer correspond à quelle ligne ?
Consultez le code source à la recherche des appels SetIndexBuffer(), ou comparez les valeurs imprimées par l’EA avec celles de la fenêtre des données pour la même bougie.
