Перейти к содержанию

ETrace.GetPoints

ETraceGetPoints1

ETrace.GetPoints - возвращает заданное количество точек (ArrayX, ArrayY) из таблицы данных объекта типа ETrace, начиная с указанного индекса строки таблицы.

Свойства

Входной аргумент Тип аргумента Тип переменной Описание
ETrace Variable ETrace Объект типа ETrace
All Variable Boolean Если значение пременной = "True" блок вернет все точки трейса
Index Variable Int Начальный индекс, с которого будет выполняться чтение точек трейса
Count Variable Int Количество точек трейса, которое необходимо считать
Выходной аргумент Тип аргумента Тип переменной Описание
ArrayX Variable Double[] Массив значений X
ArrayY Variable Double[] Массив значений Y

Пример

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

ETraceGetPoints2

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

ETrace – переменная типа ETrace, из которой мы будем получать точки.

Xpoints – массив точек X.

Ypoints – массив точек Y.

pointIndex – начальный индекс чтения точек из массива данных трейса.

pointsNum – количество считываемых точек.

ETraceGetPoints3

Создадим интерфейс пользователя. Нажмем правой кнопкой по заголовку программы и выберем пункт меню «Добавить новый элемент».

ETrace20

Выберем элемент «Панель управления» и введем имя элемента. Нажмем кнопку «Создать»

ETrace21

Добавим на панель управления следующие элементы:

Интерактивные элементы -> Кнопка;

Визуализация данных -> Декартова диаграмма.

Ввод данных -> Числовой ввод (2 элемента);

ETraceGetPoints4

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

Индекс точки: значение -> переменная pointIndex;

Количество точек: значение -> переменная pointsNum;

Пример привязки элемента панели управления «Индекс точки» к переменной pointIndex показан на следующем рисунке.

ETraceGetPoints5

Включим событие «Click» и введем имя в свойствах кнопки.

ETraceGetPoints6

Нажмем правой кнопкой мыши по графику и выберем пункт меню «Настройка». Выполним настройку графика, как показано на следующем рисунке.

ETraceGraphSettings

Перейдем на холст выполняемой программы. Действия программы будут происходить по нажатию пользователем на кнопку «Получить точки». Для этого запуск программы должен начинаться с отображения дашборда, Добавим блок «ShowDashboard» и выберем созданную панель управления в меню настройки:

ETraceShowDash

Блок обработки события свяжем с программным алгоритмом, обеспечивающим соответствующие манипуляции с переменной ETrace. Добавим на холст блок ETrace.GetPoints.

ETraceGetPoints7

В блоке Handler выберем созданное событие нажатия кнопки.

ETraceGetPoints8

Следующий блок - ETrace.GetPoints. Здесь мы можем получить заданное количество точек pointsNum в массивы «Xpoints» и «Ypoints» из переменной ETrace начиная с заданного индекса строки таблицы, указанного в переменной pointIndex. В приведенном примере переменной All присвоено значение "True", в этом случае значения переменных pointsNum и pointIndex игнорируются, в вышеуказанные массивы будут переданы все точки из переменной ETrace. Массивы Xpoints и Ypoints также являются источником значений X и Y для графика на панели управления.

ETraceGetPoints9

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

ETraceGraphUpdate

Нажмем правой кнопкой мыши по переменной ETrace и выберем пункт меню «Редактировать начальное значение», как показано на следующем рисунке, чтобы внести данные, которые будут храниться в трейсе при запуске программы.

ETraceGetPoints10

Посмотрим, как работает пример.

ETraceGetPoints11

Мы также можем просмотреть значения масивов «Xpoints» и «Ypoints» после выполнения блока ETrace.GetPoints. Для этого перейдем в меню контекста и нажмем на кнопку просмотра значения переменной, как показано на следующем рисунке.

ETraceGetPoints12