Справочник по языку программирования MQL5

Подождите немного. Документ загружается.

Пользовательские индикаторы

711

Пользовательские индикаторы

Группа функций, используемых при оформлении пользовательских индикаторов. Данные функции

нельзя использовать при написании советников и скриптов.

Функция

Действие

SetIndexBuffer

Связывает указанный индикаторный буфер с

одномерным динамическим массивом типа

double

IndicatorSetDouble

Задает значение свойства индикатора,

имеющего тип double

IndicatorSetInteger

Задает значение свойства индикатора,

имеющего тип int

IndicatorSetString

Задает значение свойства индикатора,

имеющего тип string

PlotIndexSetDouble

Задает значение свойства линии

индикатора, имеющего тип double

PlotIndexSetInteger

Задает значение свойства линии

индикатора, имеющего тип int

PlotIndexSetString

Задает значение свойства линии

индикатора, имеющего тип string

PlotIndexGetInteger

Возвращает значение свойства линии

индикатора, имеющего целый тип

Свойства индикаторов можно устанавливать как с помощью директив компилятора, так и с

помощью функций. Для лучшего понимания рекомендуется изучить стили индикаторов в примерах

Все необходимые расчеты пользовательских индикаторов необходимо размещать в

предопределенной функции OnCalculate(). Если используется короткая форма вызова функции

OnCalculate() вида

int OnCalculate (const int rates_total, const int prev_calculated, const int begin, const double& price[])

то переменная rates_total содержит значение общего количество элементов массива price[],

переданного в качестве входного параметра для расчета значений индикатора.

Параметр prev_calculated – результат выполнения функции OnCalculate() на предыдущем вызове и

позволяет организовать экономный алгоритм расчета значений индикатора. Например, если

текущее значение rates_total=1000, а prev_calculated=999, то, возможно, нам достаточно сделать

расчеты только для одного значения каждого индикаторного буфера.

Если бы информация о размере входного массива price была бы недоступна, то это привело к

необходимости производить расчеты для 1000 значений каждого индикаторного буфера. При

первом вызове функции OnCalculate() значение prev_calculated=0. Если массив price[] каким-либо

образом изменился, то в этом случае prev_calculated также равно 0.

Пользовательские индикаторы

712

Параметр begin сообщает количество начальных значений массива price, которые не содержат

данных для расчета. Например, если в качестве входного массива были использованы значения

индикатора Accelerator Oscillator (для которого первые 37 значений не рассчитываются), то

begin=37. Для примера рассмотрим простой индикатор:

#property indicator_chart_window

#property indicator_buffers 1

#property indicator_plots 1

//---- plot Label1

#property indicator_label1 "Label1"

#property indicator_type1 DRAW_LINE

#property indicator_color1 clrRed

#property indicator_style1 STYLE_SOLID

#property indicator_width1 1

//--- indicator buffers

double Label1Buffer[];

//+------------------------------------------------------------------+

//| Custom indicator initialization function |

//+------------------------------------------------------------------+

void OnInit()

{

//--- indicator buffers mapping

SetIndexBuffer(0,Label1Buffer,INDICATOR_DATA);

//---

}

//+------------------------------------------------------------------+

//| Custom indicator iteration function |

//+------------------------------------------------------------------+

int OnCalculate(const int rates_total,

const int prev_calculated,

const int begin,

const double &price[])

{

//---

Print("begin = ",begin," prev_calculated = ",prev_calculated," rates_total = ",rates_total);

//--- return value of prev_calculated for next call

return(rates_total);

}

Перетащим его из окна "Навигатора" на окно индикатора Accelerator Oscillator и укажем, что

расчеты будут производиться на значениях предыдущего индикатора:

Пользовательские индикаторы

713

В результате при первом вызове функции OnCalculate() значение prev_calculated окажется равным

нулю, а при последующих вызовах оно будет равно значению rates_total (до тех пор, пока не

увеличится количество баров на ценовом графике).

Значение параметра begin будет в точности равно количеству начальных баров, для которых

значения индикатора Accelerator не рассчитывается в соответствие с логикой этого индикатора.

Если мы посмотрим исходный код пользовательского индикатора Accelerator.mq5, то увидим в

функции OnInit() такие строчки:

//--- sets first bar from what index will be drawn

PlotIndexSetInteger(0,PLOT_DRAW_BEGIN,37);

Именно функцией PlotIndexSetInteger(0, PLOT_DRAW_BEGIN, empty_first_values) мы сообщаем

количество несущественных первых значений в нулевом индикаторном массиве

Пользовательские индикаторы

714

пользовательского индикатора, которые нам не нужно принимать для расчетов

(empty_first_values). Таким образом, у нас есть механизмы, чтобы:

1. сообщить о количестве начальных значений индикатора, которые не стоит использовать для

расчетов в другом пользовательском индикаторе;

2. получить информацию о количестве первых значений, которые необходимо игнорировать при

вызове другого пользовательского индикатора, не вдаваясь в логику его расчетов.

Пользовательские индикаторы

715

Стили индикаторов в примерах

В клиентский терминал MetaTrader 5 встроено 38 технических индикаторов, которые можно

использовать в программах MQL5 с помощью соответствующих функций. Но главное достоинство

языка MQL5 – возможность создавать свои собственные пользовательские индикаторы, которые

потом можно использовать в советниках для получения значений или просто накладывать на

ценовые графики для проведения технического анализа.

Все множество индикаторов можно получить на основе нескольких базовых стилей рисования,

называемых графическими построениями. Под построением понимается способ отображения

данных, которые индикатор рассчитывает, хранит и выдает по запросу. Всего таких базовых

построений семь:

1. линия,

2. секция (отрезок),

3. гистограмма,

4. стрелка (символ),

5. закрашиваемая область (канал с заливкой),

6. бары,

7. японские свечи.

Каждое построение требует для своего отображения от одного до пяти массивов типа double, в

которых хранятся значения индикатора. Эти массивы для удобства работы индикатора

связываются с индикаторными буферами. Количество буферов в индикаторе необходимо

объявить заранее с помощью директивы компилятора, пример:

#property indicator_buffers 3 // количество буферов

#property indicator_plots 2 // количество графических построений

Количество буферов в индикаторе всегда больше или равно количеству построений в индикаторе.

Так как каждое базовое графическое построение может иметь цветовые вариации или специфику

отображения, то реальное количество построений в языке MQL5 составляет 18:

Построение

Описание

Буферов значений

Буферов цвета

DRAW_NONE

На графике

визуально не

отображается, но

значения

соответствующего

буфера можно

посмотреть в "Окне

данных"

DRAW_LINE

Строится линия по

значения

соответствующего

буфера (пустые

значения в буфере

нежелательны)

Пользовательские индикаторы

716

DRAW_SECTION

Рисуется отрезками

между значениями

соответствующего

буфера (обычно

пустых значений

много)

DRAW_HISTOGRAM

Рисуется

гистограммой от

нулевой линии до

значений

соответствующего

буфера (допускаются

пустые значения)

DRAW_HISTOGRAM2

Рисуется

гистограммой на

двух индикаторных

буферах

(допускаются пустые

значения)

DRAW_ARROW

Отображается

символами

(допускаются пустые

значения)

DRAW_ZIGZAG

Похож на стиль

DRAW_SECTION, но в

отличие от него

может строить

вертикальные

отрезки на одном

баре

DRAW_FILLING

Цветовая заливка

между двумя

линиями. В "Окне

данных"

показываются 2

значения

соответствующих

буферов

DRAW_BARS

Отображение на

графике в виде

баров. В "Окне

данных"

показываются 4

значения

соответствующих

буферов

DRAW_CANDLES

Отображение в виде

Пользовательские индикаторы

717

японских свечей. В

"Окне данных"

показываются 4

значения

соответствующих

буферов

DRAW_COLOR_LINE

Линия, для которой

можно чередовать

цвет как на разных

барах, так и сменить

ее цвет в любой

момент времени

DRAW_COLOR_SECTIO

Похож на стиль

DRAW_SECTION, но

цвет каждой секции

можно задавать

индивидуально,

можно задавать цвет

динамически

DRAW_COLOR_HISTO

GRAM

Похож на стиль

DRAW_HISTOGRAM,

но каждая полоска

может иметь свой

цвет, можно

задавать цвет

динамически

DRAW_COLOR_HISTO

GRAM2

Похож на

DRAW_HISTOGRAM2,

но каждая полоска

может иметь свой

цвет, цвет можно

задавать

динамически

DRAW_COLOR_ARRO

Похож на стиль

DRAW_ARROW, но

каждый символ

может иметь свой

цвет. Цвет можно

менять динамически

DRAW_COLOR_ZIGZAG

Стиль DRAW_ZIGZAG

с возможностями

индивидуальной

раскраски секций и

динамической смены

цвета

DRAW_COLOR_BARS

Стиль DRAW_BARS с

возможностями

Пользовательские индикаторы

718

индивидуальной

раскраски баров и

динамической смены

цвета

DRAW_COLOR_CANDL

Стиль

DRAW_CANDLES с

возможностями

индивидуальной

раскраски свечей и

динамической смены

цвета

Разница между индикаторным буфером и массивом

В каждом индикаторе необходимо объявить на глобальном уровне один или более массивов типа

double, который затем должен быть использован в качестве индикаторного буфера с помощью

функции SetIndexBuffer(). Для рисования графических построений индикатора используются

только значения из индикаторных буферов, какие-либо другие массивы для этого использовать

нельзя. Кроме того, значения буферов показываются в "Окне данных".

Индикаторный буфер должен быть динамическим и не требует указания размера – размер

массива, использованного в качестве индикаторного буфера, устанавливается исполняющей

подсистемой терминала автоматически.

Направление индексации после связывания массива с индикаторным буфером по умолчанию

устанавливается как в обычных массивах, но при необходимости можно применить функцию

ArraySetAsSeries() для изменения способа доступа к элементам массива. По умолчанию

индикаторный буфер используется для хранения данных, предназначенных для отрисовки (

INDICATOR_DATA).

Если для расчетов значений индикатора требуется проводить промежуточные вычисления и

хранить для каждого бара вспомогательное значение, то при связывании такой массив можно

объявить в качестве расчетного буфера ( INDICATOR_CALCULATIONS). Можно использовать для

промежуточных значений и обычный массив, но в этом случае программист должен

самостоятельно управлять размером такого массива.

Некоторые построения позволяют задавать для каждого бара цвет отображения. Для хранения

информации о цвете используются цветовые буфера (INDICATOR_COLOR_INDEX). Цвет представлен

целочисленным типом color, но все индикаторные буфера должны иметь тип double. Значения

цветовых и вспомогательных (INDICATOR_CALCULATIONS) буферов нельзя получить с помощью

функции CopyBuffer().

Количество индикаторных буферов должно быть указано директивой компилятора #property

indicator_buffers количество_буферов:

#property indicator_buffers 3 // индикатор имеет 3 буфера

Максимально допустимое количество буферов в одном индикаторе - 512.

Пользовательские индикаторы

719

Соответствие индикаторных буферов и графических построений

Каждое графическое построение базируется на одном или более индикаторных буферах. Так, для

отображения простых японских свечей требуется четыре значения - цены Open, High, Low и Close.

Соответственно, для отображения индикатора в виде японских свечей необходимо объявить 4

индикаторных буфера и 4 массива типа double под них. Например:

//--- в индикаторе четыре индикаторных буфера

#property indicator_buffers 4

//--- в индикаторе одно графическое построение

#property indicator_plots 1

//--- графическое построение под номером 1 будет отображаться японскими свечами

#property indicator_type1 DRAW_CANDLES

//--- японские свечи будут рисоваться цветом clrDodgerBlue

#property indicator_color1 clrDodgerBlue

//--- 4 массива под индикаторные буферы

double OBuffer[];

double HBuffer[];

double LBuffer[];

double CBuffer[];

Графические построения автоматически используют индикаторные буфера в соответствии с

номером построения. Номера построения начинаются с единицы, номера буферов начинаются с

нуля. Если первое построение требует 4 индикаторных буфера, то для отрисовки будут

использованы 4 первых индикаторных буфера. Эти четыре буфера должны быть связаны

функцией SetIndexBuffer() с соответствующими массивами с правильной индексацией.

//--- связывание массивов с индикаторными буферами

SetIndexBuffer(0,OBuffer,INDICATOR_DATA); // первый буфер соответствует нулевому индексу

SetIndexBuffer(1,HBuffer,INDICATOR_DATA); // второй буфер соответствует индексу 1

SetIndexBuffer(2,LBuffer,INDICATOR_DATA); // третий буфер соответствует индексу 2

SetIndexBuffer(3,CBuffer,INDICATOR_DATA); // четвертый буфер соответствует индексу 3

При отрисовке японских свечей индикатор будет использовать именно первые четыре буфера,

потому что построение "японские свечи" было объявлено под первым номером.

Изменим немного пример, добавим построение в виде простой линии - DRAW_LINE. Пусть теперь

линия будет иметь номер 1, а японские свечи будет подномером 2. Количество буферов и

количество

//--- в индикаторе четыре индикаторных буфера

#property indicator_buffers 4

//--- в индикаторе одно графическое построение

#property indicator_plots 1

//--- графическое построение под номером 1 будет отображаться японскими свечами

#property indicator_type1 DRAW_CANDLES

//--- японские свечи будут рисоваться цветом clrDodgerBlue

#property indicator_color1 clrDodgerBlue

//--- 4 массива под индикаторные буферы

Пользовательские индикаторы

720

double OBuffer[];

double HBuffer[];

double LBuffer[];

double CBuffer[];

Порядок следования построений изменился, теперь первым идет линия, следом японские свечи.

Поэтому и порядок следования буферов будет таким же - сначала объявим под нулевым

индексом буфер для линии, а затем четыре буфера для отображения японских свечей.

SetIndexBuffer(0,LineBuffer,INDICATOR_DATA); // второй буфер соответствует индексу 0

//--- связывание массивов с индикаторными буферами под японские свечи

SetIndexBuffer(1,OBuffer,INDICATOR_DATA); // второй буфер соответствует индексу 1

SetIndexBuffer(2,HBuffer,INDICATOR_DATA); // третий буфер соответствует индексу 2

SetIndexBuffer(3,LBuffer,INDICATOR_DATA); // четвертый буфер соответствует индексу 3

SetIndexBuffer(4,CBuffer,INDICATOR_DATA); // пятый буфер соответствует индексу 4

Количество буферов и графических построений можно задавать только с помощью директив

компилятора, динамическое изменение этих свойств с помощью функций невозможно.

Цветовые версии стилей

Как можно увидеть в таблице, стили делятся на две группы. Первая группа — это стили, у которых

в названии нет слова COLOR, назовем эти стили базовыми:

DRAW_LINE

DRAW_SECTION

DRAW_HISTOGRAM

DRAW_HISTOGRAM2

DRAW_ARROW

DRAW_ZIGZAG

DRAW_FILLING

DRAW_BARS

DRAW_CANDLES

Вторая группа стилей содержит в названии слово COLOR, назовем их цветовыми версиями:

DRAW_COLOR_LINE

DRAW_COLOR_SECTION

DRAW_COLOR_HISTOGRAM

DRAW_COLOR_HISTOGRAM2

DRAW_COLOR_ARROW

DRAW_COLOR_ZIGZAG

DRAW_COLOR_BARS

DRAW_COLOR_CANDLES