Тимур Машнин
Язык программирования MQL5: Продвинутое использование торговой платформы MetaTrader 5
Параметры ввода и переменные индикатора
Параметры ввода это те параметры индикатора, которые отображаются пользователю перед присоединением индикатора к графику во вкладке Inputs диалогового окна.
Например, для индикатора MACD:
Тут пользователь может поменять параметры индикатора по умолчанию, и индикатор присоединится к графику с уже измененными параметрами.
Также пользователь может поменять параметры индикатора после присоединения индикатора к графику, щелкнув правой кнопкой мышки на индикаторе и выбрав свойства индикатора.
В коде индикатора такие параметры задаются Input переменными с модификатором input, который указывается перед типом данных. Как правило, Input переменные объявляются сразу после свойств индикатора.
Например, для индикатора MACD:
// – - input parameters
input int InpFastEMA=12; // Fast EMA period
input int InpSlowEMA=26; // Slow EMA period
input int InpSignalSMA=9; // Signal SMA period
input ENUM_APPLIED_PRICE InpAppliedPrice=PRICE_CLOSE; // Applied price
Здесь надо отметить то, что в диалоговом окне присоединения индикатора к графику отображаются не имена переменных, а комментарии к ним.
Если убрать комментарии, входные параметры отобразятся следующим образом:
Здесь уже отображаются имена переменных.
Как вы сами, наверное, уже догадались, комментарии используются для отображения, чтобы облегчить пользователю понимание их предназначения.
Здесь также видно, что входными параметрами могут быть не только отдельные переменные, но и перечисления, которые отображаются в виде выпадающих списков.
Для индикатора MACD используется встроенное перечисление ENUM_APPLIED_PRICE, но можно также определить и свое перечисление.
В справочнике приводится соответствующий пример:
#property script_show_inputs
// – - day of week
enum dayOfWeek
{
S=0, // Sunday
M=1, // Monday
T=2, // Tuesday
W=3, // Wednesday
Th=4, // Thursday
Fr=5, // Friday,
St=6, // Saturday
};
// – - input parameters
input dayOfWeek swapday=W;
В этом примере команда #property script_show_inputs используется для скриптов, для индикаторов ее можно опустить.
Основное отличие Input переменных от других типов переменных состоит в том, что изменить их значение может только пользователь в диалоговом окне индикатора.
Если в коде индикатора попытаться изменить значение входного параметра, при компиляции возникнет ошибка:
Поэтому, если вы хотите при расчетах использовать измененное значение входного параметра, нужно использовать промежуточную переменную:
Помимо Input переменных MQL5-код использует локальные переменные, статические переменные, глобальные переменные и Extern переменные.
С локальными переменными в принципе все понятно, они объявляются в блоке кода, например, в цикле или функции, там же инициализируются, и, после выполнения блока кода, память, выделенная под локальные переменные в программном стеке, освобождается.
Тут особо надо отметить, что для локальных объектов, созданных с помощью оператора new, в конце блока кода нужно применить оператор delete для освобождения памяти.
Глобальные переменные, как правило, объявляются после свойств индикатора, входных параметров и массивов буферов индикатора, перед функциями.
Глобальные переменные видны в пределах всей программы, их значение может быть изменено в любом месте программы и память, выделяемая под глобальные переменные вне программного стека, освобождается при выгрузке программы.
Здесь видно, что Input переменные это те же глобальные переменные, за исключением опции – их значение не может быть изменено в любом месте программы.
Если глобальную или локальную переменную объявить со спецификатором const – это так же не позволит изменять значение этой переменной в процессе выполнения программы.
Статические переменные определяются модификатором static, который указывается перед типом данных.
Со статическими переменными все немного сложнее, но легче всего их понять, сравнивая статические переменные с локальными и глобальными переменными.
В принципе, статическая переменная, объявленная там же, где и глобальная переменная, ничем не отличается от глобальной переменной.
Хитрость начинается, если локальную переменную объявить с модификатором static.
В этом случае, после выполнения блока кода, память, выделенная под статическую переменную, не освобождается. И при следующем выполнении того же блока кода, предыдущее значение статической переменной можно использовать.
Хотя область видимости такой статической переменной ограничивается те же самым блоком кода, в котором она была объявлена.
Extern переменные это аналог статических глобальных переменных. Нельзя объявить локальную переменную с модификатором extern.
Отличие Extern переменных от статических глобальных переменных проще всего продемонстрировать на индикаторе MACD.
Индикатор MACD имеет включаемый файл MovingAverages:
#include <MovingAverages.mqh>
расположенный в папке Include.
Если в файле MovingAverages и файле MACD одновременно объявить Extern-переменную:
extern int a=0;
то при компиляции обоих файлов все пройдет удачно, и переменную можно будет использовать.
Если же в файле MovingAverages и файле MACD одновременно объявить статическую глобальную переменную:
static int a=0;
то при компиляции обоих файлов возникнет ошибка:
Помимо команды #include полезной является также директива #define, которая позволяет делать подстановку выражения вместо идентификатора, например:
#define PI 3.14
Хэндл индикатора
Начнем с цитаты:
HANDLE идентифицирует объект, которым Вы можете манипулировать. Джеффри РИХТЕР «Windows для профессионалов».
Переменные типа handle представляют собой указатель на некоторую системную структуру или индекс в некоторой системной таблице, которая содержит адрес структуры.
Таким образом, получив хэндл некоторого индикатора, мы можем использовать его данные для построения своего индикатора.
Хэндл индикатора представляет собой переменную типа int и объявляется, как правило, после объявления массивов буферов индикатора, вместе с глобальными переменными, например в индикаторе MACD:
// – - indicator buffers
double ExtMacdBuffer [];
double ExtSignalBuffer [];
double ExtFastMaBuffer [];
double ExtSlowMaBuffer [];
// – - MA handles
int ExtFastMaHandle;
int ExtSlowMaHandle;
Здесь хэндлы индикаторов – это указатели на индикатор скользящего среднего с разными периодами 12 и 26.
Объявив эти переменные, мы естественно реально ничего не получаем, так как объекта индикатора, данные которого мы хотим использовать, еще не существует.
Создать в глобальном кеше клиентского терминала копию соответствующего технического индикатора и получить ссылку на нее можно несколькими способами.
Если это стандартный индикатор, проще всего получить его хэндл можно с помощью стандартной функции для работы с техническими индикаторами.
Стандартная функция для индикатора скользящего среднего это:
int iMA (
string symbol, // имя символа
ENUM_TIMEFRAMES period, // период
int ma_period, // период усреднения
int ma_shift, // смещение индикатора по горизонтали
ENUM_MA_METHOD ma_method, // тип сглаживания
ENUM_APPLIED_PRICE applied_price // тип цены или handle
);
И в индикаторе MACD хэндлы индикатора скользящего среднего получаются с помощью вызова функции iMA в функции OnInit ():
// – - get MA handles
ExtFastMaHandle=iMA (NULL,0,InpFastEMA,0,MODE_EMA, InpAppliedPrice);
ExtSlowMaHandle=iMA (NULL,0,InpSlowEMA,0,MODE_EMA, InpAppliedPrice);
где используются свойства индикатора:
// – - input parameters
input int InpFastEMA=12; // Fast EMA period
input int InpSlowEMA=26; // Slow EMA period
input ENUM_APPLIED_PRICE InpAppliedPrice=PRICE_CLOSE; // Applied price
Предположим, что мы хотим использовать не стандартный, а пользовательский индикатор.
В папке Indicators/Examples редактора MQL5 есть нужный нам индикатор – это файл Custom Moving Average.mq5.
Для вызова того индикатора воспользуемся функцией iCustom:
int iCustom (
string symbol, // имя символа
ENUM_TIMEFRAMES period, // период
string name // папка/имя_пользовательского индикатора
…// список входных параметров индикатора
);
В функции OnInit () индикатора MACD изменим код:
// ExtFastMaHandle=iMA (NULL,0,InpFastEMA,0,MODE_EMA, InpAppliedPrice);
// ExtSlowMaHandle=iMA (NULL,0,InpSlowEMA,0,MODE_EMA, InpAppliedPrice);
ExtFastMaHandle=iCustom (NULL,0,«Examples\\Custom Moving Average», InpFastEMA,0,MODE_EMA, InpAppliedPrice);
ExtSlowMaHandle=iCustom (NULL,0,«Examples\\Custom Moving Average», InpSlowEMA,0,MODE_EMA, InpAppliedPrice);
После компиляции индикатора мы увидим, что его отображение никак не изменилось:
Еще один способ получить хэндл пользовательского индикатора, это использовать функцию IndicatorCreate:
int IndicatorCreate (
string symbol, // имя символа
ENUM_TIMEFRAMES period, // период
ENUM_INDICATOR indicator_type, // тип индикатора из перечисления ENUM_INDICATOR
int parameters_cnt=0, // количество параметров
const MqlParam& parameters_array [] =NULL, // массив параметров
);
В функции OnInit () индикатора MACD изменим код:
MqlParam params [];
ArrayResize (params,5);
params [0].type =TYPE_STRING;
params[0].string_value=«Examples\\Custom Moving Average»;
// – - set ma_period
params [1].type =TYPE_INT;
params[1].integer_value=InpFastEMA;
// – - set ma_shift
params [2].type =TYPE_INT;
params[2].integer_value=0;
// – - set ma_method
params [3].type =TYPE_INT;
params[3].integer_value=MODE_EMA;
// – - set applied_price
params [4].type =TYPE_INT;
params[4].integer_value=InpAppliedPrice;
// – - initialization done
ExtFastMaHandle=IndicatorCreate (NULL, NULL, IND_CUSTOM,4,params);
params[1].integer_value=InpSlowEMA;
ExtSlowMaHandle=IndicatorCreate (NULL, NULL, IND_CUSTOM,4,params);
После компиляции индикатора мы опять увидим, что его отображение никак не изменилось.
После получения хэндла индикатора, если он используется в коде один раз, для экономии памяти неплохо использовать функцию IndicatorRelease:
bool IndicatorRelease (
int indicator_handle // handle индикатора
);
которая удаляет хэндл индикатора и освобождает расчетную часть индикатора.
Хорошо, хэндл индикатора мы получили. Как же теперь извлечь его данные?
Делается это в функции OnCalculate с помощью функции CopyBuffer:
int CopyBuffer (
int indicator_handle, // handle индикатора
int buffer_num, // номер буфера индикатора
int start_pos, // откуда начнем
int count, // сколько копируем
double buffer [] // массив, куда будут скопированы данные
);
При этом функция CopyBuffer () распределяет размер принимающего массива под размер копируемых данных.
Напомним, что это работает, если принимающий массив является просто динамическим массивом.
Если же принимающий массив связан с буфером индикатора, тогда клиентский терминал сам заботится о том, чтобы размер такого массива соответствовал количеству баров, доступных индикатору для расчета.
В индикаторе MACD именно такая ситуация. Промежуточные массивы ExtFastMaBuffer [] и ExtSlowMaBuffer [] привязаны к буферам индикатора:
SetIndexBuffer (2,ExtFastMaBuffer, INDICATOR_CALCULATIONS);
SetIndexBuffer (3,ExtSlowMaBuffer, INDICATOR_CALCULATIONS);
И в эти массивы производится копирование буфера индикатора Moving Average на основе его хэндлов:
if (CopyBuffer (ExtFastMaHandle,0,0,to_copy, ExtFastMaBuffer) <=0)
{
Print («Getting fast EMA is failed! Error», GetLastError ());
return (0);
}
if (CopyBuffer (ExtSlowMaHandle,0,0,to_copy, ExtSlowMaBuffer) <=0)
{
Print («Getting slow SMA is failed! Error», GetLastError ());
return (0);
}
Если убрать привязку массивов ExtFastMaBuffer [] и ExtSlowMaBuffer [] к буферам индикатора, тогда клиентский терминал выдаст ошибку:
Происходит это потому, что при загрузке индикатора значение to_copy равно размеру ценовой истории, а дальше to_copy=1 и производится частичное копирование в массивы ExtFastMaBuffer [] и ExtSlowMaBuffer [], при этом их размеры становятся равны 1.
В этом случае применением функции ArrayResize проблему не решить, так как функция CopyBuffer все равно будет уменьшать размер массива до 1.
Можно конечно использовать еще один массив-посредник, в который копировать один элемент. И уже из этого массива-посредника производить копирование в промежуточный массив, но проще всего, конечно, просто привязать промежуточный массив к буферу индикатора.
Функции OnInit (), OnDeinit (), OnCalculate ()
Как уже говорилось, функции OnInit (), OnDeinit (), OnCalculate () вызываются клиентским терминалом при наступлении определенных событий.
Функция OnInit ()
Функция OnInit () вызывается сразу после загрузки индикатора и соответственно используется для его инициализации.
Инициализация индикатора включает в себя привязку массивов к буферам индикатора, инициализацию глобальных переменных, включая инициализацию хэндлеров используемых индикаторов, а также программную установку свойств индикатора.
Давайте разберем некоторые из этих пунктов более подробно.
Как уже было показано, привязка массивов к буферам индикатора осуществляется с помощью функции SetIndexBuffer:
bool SetIndexBuffer (
int index, // индекс буфера
double buffer [], // массив
ENUM_INDEXBUFFER_TYPE data_type // что будем хранить
);
Где data_type может быть INDICATOR_DATA (данные индикатора для отрисовки, по умолчанию, можно не указывать), INDICATOR_COLOR_INDEX (цвет индикатора), INDICATOR_CALCULATIONS (буфер промежуточных расчетов индикатора).
После применения функции SetIndexBuffer к динамическому массиву, его размер автоматически поддерживается равным количеству баров, доступных индикатору для расчета.
Каждый индекс массива типа INDICATOR_COLOR_INDEX соответствует индексу массива типа INDICATOR_DATA, а значение индекса массива типа INDICATOR_COLOR_INDEX определяет цвет отображения индекса массива типа INDICATOR_DATA.
Значение индекса массива типа INDICATOR_COLOR_INDEX, при его установке, берется из свойства #property indicator_colorN как индекс цвета в строке.
Индекс буфера типа INDICATOR_COLOR_INDEX должен следовать за индексом буфера типа INDICATOR_DATA.
После привязки динамического массива к буферу индикатора можно поменять порядок доступа к массиву от конца к началу, т.е. значение массива с индексом 0 будет соответствовать последнему полученному значению индикатора. Сделать это можно с помощью функции ArraySetAsSeries:
bool ArraySetAsSeries (
const void& array [], // массив по ссылке
bool flag // true означает обратный порядок индексации
);
При применении функции ArraySetAsSeries физическое хранение данных массива не меняется, в памяти массив, как и прежде, хранится в порядке от первого значения до последнего значения.
Функция ArraySetAsSeries меняет лишь программный доступ к элементам массива – от последнего элемента массива к первому элементу массива.
В функции OnInit () также может осуществляться проверка входных параметров на корректность, так как пользователь может ввести все, что угодно.
При этом значение входного параметра переназначается с помощью глобальной переменной, и далее в расчетах используется уже значение глобальной переменной.
Например, для индикатора ADX это выглядит так:
// – - check for input parameters
if (InpPeriodADX> =100 || InpPeriodADX <=0)
{
ExtADXPeriod=14;
printf («Incorrect value for input variable Period_ADX=%d. Indicator will use value=%d for calculations.», InpPeriodADX, ExtADXPeriod);
}
else ExtADXPeriod=InpPeriodADX;
здесь ExtADXPeriod – глобальная переменная, а InpPeriodADX – входной параметр.
При использовании хэндлов индикатора, необходимо указывать символ (финансовый инструмент) для которого индикатор будет создаваться.
При этом такой символ может определяться пользователем.
В функции OnInit () также полезно проверить этот входной параметр на корректность.
Пусть определен входной параметр:
input string symbol=" "; // символ
Объявим глобальную переменную:
string name=symbol;
В функции OnInit () произведем проверку:
// – - удалим пробелы слева и справа
StringTrimRight (name);
StringTrimLeft (name);
// – - если после этого длина строки name нулевая
if (StringLen (name) ==0)
{
// – - возьмем символ с графика, на котором запущен индикатор
name=_Symbol;
}
Программная установка свойств индикатора осуществляется с помощью функций IndicatorSetDouble, IndicatorSetInteger, IndicatorSetString, PlotIndexSetDouble, PlotIndexSetInteger, PlotIndexSetString.
Функция IndicatorSetDouble позволяет программным способом определять такие свойства индикатора как indicator_minimum, indicator_maximum и indicator_levelN, например:
IndicatorSetDouble (INDICATOR_LEVELVALUE, 0, 50)
является аналогом:
property indicator_level1 50
Функция IndicatorSetInteger позволяет программным способом определять такие свойства индикатора как indicator_height, indicator_levelcolor, indicator_levelwidth, indicator_levelstyle.
При этом для уровней необходимо определить их количество, используя функцию IndicatorSetInteger. Например, для индикатора RSI это выглядит следующим образом.
Свойства индикатора:
//#property indicator_level1 30
//#property indicator_level2 70
//#property indicator_levelcolor Red
//#property indicator_levelstyle STYLE_SOLID
//#property indicator_levelwidth 1
Заменяем на код:
IndicatorSetInteger (INDICATOR_LEVELS,2);
IndicatorSetDouble (INDICATOR_LEVELVALUE,0,30);
IndicatorSetDouble (INDICATOR_LEVELVALUE,1,70);
IndicatorSetInteger (INDICATOR_LEVELCOLOR,0,0xff0);
IndicatorSetInteger (INDICATOR_LEVELCOLOR,1,0xff0);
IndicatorSetInteger (INDICATOR_LEVELSTYLE,0,STYLE_SOLID);
IndicatorSetInteger (INDICATOR_LEVELSTYLE,1,STYLE_SOLID);
IndicatorSetInteger (INDICATOR_LEVELWIDTH,0,1);
IndicatorSetInteger (INDICATOR_LEVELWIDTH,1,1);
Функция IndicatorSetInteger также позволяет определить точность индикатора, например:
IndicatorSetInteger (INDICATOR_DIGITS,2);
В результате будут отображаться только два знака после запятой значения индикатора.
Для функции IndicatorSetString нет соответствующих ей свойств индикатора.
С помощью функции IndicatorSetString можно определить короткое наименование индикатора, например для индикатора MACD:
IndicatorSetString (INDICATOR_SHORTNAME,«MACD (»+string (InpFastEMA) +»,»+string (InpSlowEMA) +»,»+string (InpSignalSMA) +»)»);
Соответственно имя индикатора будет отображаться в окне индикатора как:
Кроме того, функция IndicatorSetString позволяет установить подписи к уровням индикатора, например для индикатора RSI:
IndicatorSetString (INDICATOR_LEVELTEXT, 0,«Oversold»);
IndicatorSetString (INDICATOR_LEVELTEXT, 1,«Overbought»)
С помощью функции PlotIndexSetDouble определяют, какое значение буфера индикатора является пустым и не участвует в отрисовке диаграммы индикатора.
Диаграмма индикатора рисуется от одного непустого значения до другого непустого значения индикаторного буфера, пустые значения пропускаются. Чтобы указать, какое значение следует считать «пустым», необходимо определить это значение в свойстве PLOT_EMPTY_VALUE. Например, если индикатор должен рисоваться по ненулевым значениям, то нужно задать нулевое значение в качестве пустого значения буфера индикатора:
PlotIndexSetDouble (индекс_построения, PLOT_EMPTY_VALUE,0);
Функция PlotIndexSetInteger позволяет программным способом, динамически, задавать такие свойства диаграммы индикатора, как код стрелки для стиля DRAW_ARROW, смещение стрелок по вертикали для стиля DRAW_ARROW, количество начальных баров без отрисовки и значений в DataWindow, тип графического построения, признак отображения значений построения в окне DataWindow, сдвиг графического построения индикатора по оси времени в барах, стиль линии отрисовки, толщина линии отрисовки, количество цветов, индекс буфера, содержащего цвет отрисовки.
Давайте разберем каждое из этих свойств по порядку на примере индикатора Custom Moving Average.
Изменим свойство indicator_type1 индикатора Custom Moving Average:
#property indicator_type1 DRAW_ARROW
В функции OnInit () добавим вызов функции PlotIndexSetInteger, определяя различный код стрелки для стиля DRAW_ARROW:
PlotIndexSetInteger (0,PLOT_ARROW,2);
PlotIndexSetInteger (0,PLOT_ARROW,3);
PlotIndexSetInteger (0,PLOT_ARROW,4);
PlotIndexSetInteger (0,PLOT_ARROW,5);
PlotIndexSetInteger (0,PLOT_ARROW,6);
PlotIndexSetInteger (0,PLOT_ARROW,7);
PlotIndexSetInteger (0,PLOT_ARROW,8);
PlotIndexSetInteger (0,PLOT_ARROW,11);
PlotIndexSetInteger (0,PLOT_ARROW,12);
PlotIndexSetInteger (0,PLOT_ARROW,14);
PlotIndexSetInteger (0,PLOT_ARROW,15);
И так далее. Я думаю, этого будет достаточно для демонстрации этой опции.
В функции OnInit () добавим вызов функции PlotIndexSetInteger, определяя смещение стрелок по вертикали для стиля DRAW_ARROW:
PlotIndexSetInteger (0,PLOT_ARROW_SHIFT,0);
PlotIndexSetInteger (0,PLOT_ARROW_SHIFT,100)
В результате диаграмма индикатора сдвинулась вниз.
В индикаторе Custom Moving Average для определения количества начальных баров без отрисовки и значений в DataWindow используется вызов функции PlotIndexSetInteger:
PlotIndexSetInteger (0,PLOT_DRAW_BEGIN, InpMAPeriod);
где InpMAPeriod – период скользящей средней.
Идентификатор свойства PLOT_DRAW_TYPE функции PlotIndexSetInteger позволяет программным способом задать свойство индикатора indicator_typeN, например:
PlotIndexSetInteger (0, PLOT_DRAW_TYPE, DRAW_ARROW);
Причем, если одновременно задано свойство indicator_typeN и сделан вызов функции PlotIndexSetInteger с идентификатором PLOT_DRAW_TYPE – действовать будет тип диаграммы, заданный функцией PlotIndexSetInteger.
Убрать отображение текущих значений диаграммы индикатора в окне DataWindow при наведении курсора мышки можно с помощью вызова функции PlotIndexSetInteger с идентификатором PLOT_SHOW_DATA:
PlotIndexSetInteger (0, PLOT_SHOW_DATA, false);
В индикаторе Custom Moving Average для определения сдвига графического построения индикатора по оси времени в барах используется вызов функции PlotIndexSetInteger:
PlotIndexSetInteger (0,PLOT_SHIFT, InpMAShift);
При InpMAShift=0:
При InpMAShift=10:
Такой сдвиг делается для имитации предсказательности индикатора.
Идентификатор свойства PLOT_LINE_STYLE функции PlotIndexSetInteger позволяет программным способом задать свойство индикатора indicator_styleN, стиль линии отрисовки, например:
PlotIndexSetInteger (0, PLOT_LINE_STYLE, STYLE_DASHDOT);
Идентификатор свойства PLOT_LINE_WIDTH функции PlotIndexSetInteger позволяет программным способом задать свойство индикатора indicator_widthN, толщину линии отрисовки, например:
PlotIndexSetInteger (0, PLOT_LINE_WIDTH, 2);
Программным способом задать свойство индикатора indicator_colorN позволяет вызов функции PlotIndexSetInteger с идентификаторами PLOT_COLOR_INDEXES и PLOT_LINE_COLOR, например:
#property indicator_color1 clrGreen, clrRed
Или
PlotIndexSetInteger (0,PLOT_COLOR_INDEXES,2);
PlotIndexSetInteger (0,PLOT_LINE_COLOR,0,clrGreen);
PlotIndexSetInteger (0,PLOT_LINE_COLOR,1,clrRed);
Функция PlotIndexSetString позволяет программным способом задать свойство индикатора indicator_labelN. Например, для индикатора MACD это будет выглядеть следующим образом:
#property indicator_label1 «MACD»
#property indicator_label2 «Signal»
Или
PlotIndexSetString (0, PLOT_LABEL, «MACD»);
PlotIndexSetString (1, PLOT_LABEL, «Signal»);
Рассмотренные выше функции программной установки свойств индикатора можно конечно вызывать и в функции обратного вызова OnCalculate, но глубокого смысла в этом нет, так как они не могут быть применены только к части диаграммы индикатора – они применяются сразу ко всей диаграмме индикатора. Поэтому для экономии ресурсов лучше всего вызывать эти функции в функции обратного вызова OnInit ().
