Полевой инструмент Звуковой уровень (8) предназначен для подачи звукового сигнала.

Разрешения. Полевой инструмент Звуковой уровень устанавливается на ценовой график и не устанавливается на ордера.

Ограничения.

Требования (столбец).

Для установки инструмента Звуковой уровень никакие другие инструменты не требуются.

Установка.

Для установки инструмента необходимо взять мышью значок инструмента на Панели инструментов и установить в любом месте ценового графика. Значок инструмента отобразится в координатах: цены - в соответствии с ценой исполнения инструмента, времени - на том баре, на котором пользователь отпустил кнопку мыши. Установка инструмента сопровождается выводом сообщения об успешной установке и подтверждающим звуком.

Общее количество установленных инструментов Звуковой уровень не должно превышать 30. Если общее количество установленных инструментов достигло 30, то попытка установить ещё один инструмент расценивается приложением AutoGraf 4 как некорректное действие. В этом случае инструмент Звуковой уровень не устанавливается, выводится сообщение об ошибочном действии пользователя, сопровождаемое звуком ошибки.

На одну цену может быть установлен только один инструмент Звуковой уровень. Попытка установить на одну цену более одного инструмента Звуковой уровень расценивается приложением AutoGraf 4 как некорректное действие. В этом случае инструмент Звуковой уровень не устанавливается, выводится сообщение об ошибочном действии пользователя, сопровождаемое звуком ошибки.

Параметры.

Инструмент Звуковой уровень характеризуется параметрами:

Индексы параметров инструмента соответствуют индексам этих параметров в массиве Instrument [0][2][i][j], где:
0 - неизменяемый индекс для инструмента Звуковой уровень в первом измерении массива Instrument [][][][];
2 - неизменяемый индекс для инструмента Звуковой уровень во втором измерении массива Instrument [][][][];
i - количественный номер инструмента Звуковой уровень; может принимать значения от 1 до 30 (строка);
j - индекс параметра инструмента Звуковой уровень.
Instrument [0][2][0][0] - количество установленных инструментов Звуковой уровень.

- факт установки инструмента; изменение параметра в ручном режиме осуществляется путём установки и удаления инструмента;

- индекс бара, на котором установлен инструмент; изменение параметра в ручном режиме осуществляется путём перемещения значка инструмента в пределах ценового графика (по горизонтали).

- цена исполнения инструмента; в момент установки инструмента параметр принимает значение координаты цены значка инструмента.

 Перемещение значка инструмента вниз уменьшает цену исполнения, вверх - увеличивает. Цена исполнения принимается равной координате цены значка инструмента в момент, когда пользователь отпустил кнопку мыши (установил значок инструмента на новую цену).

Перемещение значка инструмента по вертикали позволяет изменять цену исполнения инструмента с точностью до цены деления одного пикселя. Если необходимо установить цену исполнения инструмента с заданной точностью, нужно указать желаемое значение на панели настроек инструмента. Для вызова панели необходимо выделить значок инструмента и правой кнопкой мыши вызвать контекстное меню (выбрать Свойства). На появившейся панели свойств объекта (Параметры - Значение) можно указать желаемую цену исполнения инструмента. После изменения настроечного параметра значок инструмента отобразится в соответствии с указанным значением цены.

- индекс мелодии; может принимать значение от 1 до 7, значение индекса соответствует номеру мелодии.

Индекс мелодии задаётся перед установкой инструмента.  Задать индекс мелодии можно путём выбора желаемого значения на шкале значений параметра. Для вывода шкалы необходимо сдвинуть на небольшое расстояние цифру-значок инструмента на панели инструментов. Значение, выбранное пользователем на шкале, принимается в качестве нового значения параметра. Каждому индексу мелодии соответствует цвет значка инструмента. Изменить мелодию установленного инструмента нельзя. В случае необходимости можно удалить инструмент с заданной мелодией и установить новый инструмент с желаемой мелодией.

- знак; может принимать значения +1.0 или -1.0 :

+1.0 - инструмент установлен выше рыночной цены, исполняется при движении рыночной цены снизу вверх;

 -1.0 - инструмент установлен ниже рыночной цены, исполняется при движении рыночной цены сверху вниз.

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

- сторона котировки; может принимать значения 0.0 и 1.0 :

0.0 - инструмент исполняется при достижении цены исполнения инструмента рыночной ценой Ask;

1.0 - инструмент исполняется при достижении цены исполнения инструмента рыночной ценой Bid.

Для изменения этого параметра в ручном режиме необходимо сдвинуть на небольшое расстояние букву-значок справа от значка инструмента. Результатом такого действия будет изменение стороны котировки на противоположную - a изменится на b, или наоборот, b изменится на а.

Исполнение.

При исполнении инструмента Звуковой уровень подаётся звуковой сигнал, значок инструмента начинает моргать. Звуковой сигнал подаётся с периодичностью, установленной пользователем. Период исполнения звукового сигнала задаётся в переменной Step_Sound на панели настроек приложения (предустановлено 5 сек).

Исполнение инструмента Звуковой уровень не предполагает формирование торговых приказов и никак не связано с какими-либо другими инструментами и их настройками.

Удаление.

Все инструменты в приложении AutoGraf  4 исполняются до тех пор, пока они установлены. Для прекращения исполнения установленного инструмента его необходимо удалить. Инструмент может быть удалён пользователем вручную или программно. Допускается одновременное удаление нескольких инструментов.

Для удаления инструмента Звуковой уровень вручную необходимо выделить значок инструмента и нажать клавишу Delete. Такое управляющее действие исполняется приложением AutoGraf 4 всегда, без отказов (в отличие от торговых приказов, исполняемых на стороне сервера). При удалении инструментов вручную необходимо следить за тем, чтобы не были выделены другие инструменты или ордерные линии. Если одновременно с удалением значка установленного инструмента удаляются другие объекты, то (в зависимости от того, что это за объекты) это может привести к удалению других инструментов, а также формированию незапланированных торговых приказов - удалению и модификации ордеров.

Программный способ установки и удаления инструмента Звуковой уровень.

В процессе работы с приложением AutoGraf 4 пользователь может изменить количество установленных инструментов Звуковой уровень (установить новые или удалить установленные). В результате этого в приложении AutoGraf 4 выполняется упорядочивание массива Instrument [][][][], с целью удаления пустых строк. Необходимые вычисления выполняются непосредственно перед передачей управления в пользовательскую функцию AG_AT(), т.е. на каждой новой итерации в пользовательскую функцию передаются обновлённые массивы.

Например, всего установлено три инструмента Звуковой уровень. Параметры установленных инструментов учтены в массиве Instrument [][][][] в строках Instrument [0][2][1][j], Instrument [0][2][2][j] и Instrument [0][2][3][j] (j - индекс параметра). Если в дальнейшем был удалён инструмент с индексом 2, то массив Instrument [][][][] упорядочивается - строка значений Instrument [0][2][1][j] остаётся без изменений, значения строки Instrument [0][2][3][j] переписываются в освободившуюся строку Instrument [0][2][2][j], после чего значения строки Instrument [0][2][3][j] обнуляются. В результате инструмент, ранее учтённый с индексом 3, теперь будет иметь индекс 2:
 

Если включён режим автоматической торговли (значок АТ вверху), управление на каждой итерации приложения AutoGraf 4 передаётся в функцию AG_AT() лишь после того, как все массивы, в том числе массив Instrument [][][][], будут упорядочены.